typia 3.5.8 → 3.6.0-dev.20230225

package/src/executable/setup/ArgumentParser.ts

@@ -1,91 +1,91 @@
-import type CommanderModule from "commander";
-import type * as InquirerModule from "inquirer";
-import path from "path";
-
-import { FileRetriever } from "./FileRetriever";
-import { PackageManager } from "./PackageManager";
-
-export namespace ArgumentParser {
-    export type Inquiry<T> = (
-        pack: PackageManager,
-        command: CommanderModule.Command,
-        prompt: (
-            opt?: InquirerModule.StreamOptions,
-        ) => InquirerModule.PromptModule,
-        action: (closure: (options: Partial<T>) => Promise<T>) => Promise<T>,
-    ) => Promise<T>;
-
-    export const parse =
-        (pack: PackageManager) =>
-        (erase: boolean) =>
-        async <T>(
-            inquiry: (
-                pack: PackageManager,
-                command: CommanderModule.Command,
-                prompt: (
-                    opt?: InquirerModule.StreamOptions,
-                ) => InquirerModule.PromptModule,
-                action: (
-                    closure: (options: Partial<T>) => Promise<T>,
-                ) => Promise<T>,
-            ) => Promise<T>,
-        ): Promise<T> => {
-            // INSTALL TEMPORARY PACKAGES
-            const newbie = {
-                commander: pack.install({
-                    dev: true,
-                    modulo: "commander",
-                    version: "10.0.0",
-                    silent: true,
-                }),
-                inquirer: pack.install({
-                    dev: true,
-                    modulo: "inquirer",
-                    version: "8.2.5",
-                    silent: true,
-                }),
-            };
-
-            // LOAD INSTALLED MODULES
-            const { program: command }: typeof CommanderModule =
-                await FileRetriever.require(
-                    path.join("node_modules", "commander"),
-                )(pack.directory);
-            const { createPromptModule: prompt }: typeof InquirerModule =
-                await FileRetriever.require(
-                    path.join("node_modules", "inquirer"),
-                )(pack.directory);
-
-            // TAKE OPTIONS
-            const action = (closure: (options: Partial<T>) => Promise<T>) =>
-                new Promise<T>((resolve, reject) => {
-                    command.action(async (options) => {
-                        try {
-                            resolve(await closure(options));
-                        } catch (exp) {
-                            reject(exp);
-                        }
-                    });
-                    command.parseAsync().catch(reject);
-                });
-            const output: T | Error = await (async () => {
-                try {
-                    return await inquiry(pack, command, prompt, action);
-                } catch (error) {
-                    return error as Error;
-                }
-            })();
-
-            // REMOVE TEMPORARY PACKAGES
-            if (erase === true) {
-                if (newbie.commander)
-                    pack.erase({ modulo: "commander", silent: true });
-                if (newbie.inquirer)
-                    pack.erase({ modulo: "inquirer", silent: true });
-            }
-
-            // RETURNS
-            if (output instanceof Error) throw output;
-            return output;
-        };
-}
+import type CommanderModule from "commander";
+import type * as InquirerModule from "inquirer";
+import path from "path";
+
+import { FileRetriever } from "./FileRetriever";
+import { PackageManager } from "./PackageManager";
+
+export namespace ArgumentParser {
+    export type Inquiry<T> = (
+        pack: PackageManager,
+        command: CommanderModule.Command,
+        prompt: (
+            opt?: InquirerModule.StreamOptions,
+        ) => InquirerModule.PromptModule,
+        action: (closure: (options: Partial<T>) => Promise<T>) => Promise<T>,
+    ) => Promise<T>;
+
+    export const parse =
+        (pack: PackageManager) =>
+        (erase: boolean) =>
+        async <T>(
+            inquiry: (
+                pack: PackageManager,
+                command: CommanderModule.Command,
+                prompt: (
+                    opt?: InquirerModule.StreamOptions,
+                ) => InquirerModule.PromptModule,
+                action: (
+                    closure: (options: Partial<T>) => Promise<T>,
+                ) => Promise<T>,
+            ) => Promise<T>,
+        ): Promise<T> => {
+            // INSTALL TEMPORARY PACKAGES
+            const newbie = {
+                commander: pack.install({
+                    dev: true,
+                    modulo: "commander",
+                    version: "10.0.0",
+                    silent: true,
+                }),
+                inquirer: pack.install({
+                    dev: true,
+                    modulo: "inquirer",
+                    version: "8.2.5",
+                    silent: true,
+                }),
+            };
+
+            // LOAD INSTALLED MODULES
+            const { program: command }: typeof CommanderModule =
+                await FileRetriever.require(
+                    path.join("node_modules", "commander"),
+                )(pack.directory);
+            const { createPromptModule: prompt }: typeof InquirerModule =
+                await FileRetriever.require(
+                    path.join("node_modules", "inquirer"),
+                )(pack.directory);
+
+            // TAKE OPTIONS
+            const action = (closure: (options: Partial<T>) => Promise<T>) =>
+                new Promise<T>((resolve, reject) => {
+                    command.action(async (options) => {
+                        try {
+                            resolve(await closure(options));
+                        } catch (exp) {
+                            reject(exp);
+                        }
+                    });
+                    command.parseAsync().catch(reject);
+                });
+            const output: T | Error = await (async () => {
+                try {
+                    return await inquiry(pack, command, prompt, action);
+                } catch (error) {
+                    return error as Error;
+                }
+            })();
+
+            // REMOVE TEMPORARY PACKAGES
+            if (erase === true) {
+                if (newbie.commander)
+                    pack.erase({ modulo: "commander", silent: true });
+                if (newbie.inquirer)
+                    pack.erase({ modulo: "inquirer", silent: true });
+            }
+
+            // RETURNS
+            if (output instanceof Error) throw output;
+            return output;
+        };
+}

package/src/executable/setup/CommandExecutor.ts

@@ -1,8 +1,8 @@
-import cp from "child_process";
-
-export namespace CommandExecutor {
-    export function run(str: string, silent: boolean): void {
-        if (silent === false) console.log(str);
-        cp.execSync(str, { stdio: "ignore" });
-    }
-}
+import cp from "child_process";
+
+export namespace CommandExecutor {
+    export function run(str: string, silent: boolean): void {
+        if (silent === false) console.log(str);
+        cp.execSync(str, { stdio: "ignore" });
+    }
+}

package/src/executable/setup/FileRetriever.ts

@@ -1,33 +1,33 @@
-import fs from "fs";
-import path from "path";
-
-export namespace FileRetriever {
-    export const directory =
-        (name: string) =>
-        (dir: string, depth: number = 0): string | null => {
-            const location: string = path.join(dir, name);
-            if (fs.existsSync(location)) return dir;
-            else if (depth > 2) return null;
-            return directory(name)(path.join(dir, ".."), depth + 1);
-        };
-
-    export const file =
-        (name: string) =>
-        (directory: string, depth: number = 0): string | null => {
-            const location: string = path.join(directory, name);
-            if (fs.existsSync(location)) return location;
-            else if (depth > 2) return null;
-            return file(name)(path.join(directory, ".."), depth + 1);
-        };
-
-    export const require =
-        (name: string) =>
-        async (directory: string, depth: number = 0) => {
-            const location: string | null = file(name)(directory, depth);
-            if (location === null)
-                throw new Error(
-                    `Unable to find installed module. Please report to the nestia - https://github.com/samchon/nestia/issues`,
-                );
-            return import(location);
-        };
-}
+import fs from "fs";
+import path from "path";
+
+export namespace FileRetriever {
+    export const directory =
+        (name: string) =>
+        (dir: string, depth: number = 0): string | null => {
+            const location: string = path.join(dir, name);
+            if (fs.existsSync(location)) return dir;
+            else if (depth > 2) return null;
+            return directory(name)(path.join(dir, ".."), depth + 1);
+        };
+
+    export const file =
+        (name: string) =>
+        (directory: string, depth: number = 0): string | null => {
+            const location: string = path.join(directory, name);
+            if (fs.existsSync(location)) return location;
+            else if (depth > 2) return null;
+            return file(name)(path.join(directory, ".."), depth + 1);
+        };
+
+    export const require =
+        (name: string) =>
+        async (directory: string, depth: number = 0) => {
+            const location: string | null = file(name)(directory, depth);
+            if (location === null)
+                throw new Error(
+                    `Unable to find installed module. Please report to the nestia - https://github.com/samchon/nestia/issues`,
+                );
+            return import(location);
+        };
+}

package/src/executable/setup/PackageManager.ts

@@ -1,92 +1,92 @@
-import fs from "fs";
-import path from "path";
-
-import { CommandExecutor } from "./CommandExecutor";
-import { FileRetriever } from "./FileRetriever";
-
-export class PackageManager {
-    public manager: string = "npm";
-    public get file(): string {
-        return path.join(this.directory, "package.json");
-    }
-
-    public static async mount(): Promise<PackageManager> {
-        const location: string | null = await FileRetriever.directory(
-            "package.json",
-        )(process.cwd());
-        if (location === null)
-            throw new Error(`Unable to find "package.json" file`);
-
-        return new PackageManager(
-            location,
-            await this.load(path.join(location, "package.json")),
-        );
-    }
-
-    public async save(modifier: (data: Package.Data) => void): Promise<void> {
-        const content: string = await fs.promises.readFile(this.file, "utf8");
-        this.data = JSON.parse(content);
-        modifier(this.data);
-
-        return fs.promises.writeFile(
-            this.file,
-            JSON.stringify(this.data, null, 2),
-            "utf8",
-        );
-    }
-
-    public install(props: {
-        dev: boolean;
-        silent?: boolean;
-        modulo: string;
-        version?: string;
-    }): boolean {
-        const container = props.dev
-            ? this.data.devDependencies
-            : this.data.dependencies;
-        if (
-            !!container?.[props.modulo] &&
-            FileRetriever.file(path.join("node_modules", props.modulo))(
-                this.directory,
-            ) !== null
-        )
-            return false;
-
-        const middle: string =
-            this.manager === "yarn"
-                ? `add${props.dev ? " -D" : ""}`
-                : `install ${props.dev ? "--save-dev" : "--save"}`;
-        CommandExecutor.run(
-            `${this.manager} ${middle} ${props.modulo}${
-                props.version ? `@${props.version}` : ""
-            }`,
-            !!props.silent,
-        );
-        return true;
-    }
-
-    public erase(props: { modulo: string; silent?: boolean }): void {
-        const middle: string = this.manager === "yarn" ? "remove" : "uninstall";
-        CommandExecutor.run(
-            `${this.manager} ${middle} ${props.modulo}`,
-            !!props.silent,
-        );
-    }
-
-    private constructor(
-        public readonly directory: string,
-        public data: Package.Data,
-    ) {}
-
-    private static async load(file: string): Promise<Package.Data> {
-        const content: string = await fs.promises.readFile(file, "utf8");
-        return JSON.parse(content);
-    }
-}
-export namespace Package {
-    export interface Data {
-        scripts?: Record<string, string>;
-        dependencies?: Record<string, string>;
-        devDependencies?: Record<string, string>;
-    }
-}
+import fs from "fs";
+import path from "path";
+
+import { CommandExecutor } from "./CommandExecutor";
+import { FileRetriever } from "./FileRetriever";
+
+export class PackageManager {
+    public manager: string = "npm";
+    public get file(): string {
+        return path.join(this.directory, "package.json");
+    }
+
+    public static async mount(): Promise<PackageManager> {
+        const location: string | null = await FileRetriever.directory(
+            "package.json",
+        )(process.cwd());
+        if (location === null)
+            throw new Error(`Unable to find "package.json" file`);
+
+        return new PackageManager(
+            location,
+            await this.load(path.join(location, "package.json")),
+        );
+    }
+
+    public async save(modifier: (data: Package.Data) => void): Promise<void> {
+        const content: string = await fs.promises.readFile(this.file, "utf8");
+        this.data = JSON.parse(content);
+        modifier(this.data);
+
+        return fs.promises.writeFile(
+            this.file,
+            JSON.stringify(this.data, null, 2),
+            "utf8",
+        );
+    }
+
+    public install(props: {
+        dev: boolean;
+        silent?: boolean;
+        modulo: string;
+        version?: string;
+    }): boolean {
+        const container = props.dev
+            ? this.data.devDependencies
+            : this.data.dependencies;
+        if (
+            !!container?.[props.modulo] &&
+            FileRetriever.file(path.join("node_modules", props.modulo))(
+                this.directory,
+            ) !== null
+        )
+            return false;
+
+        const middle: string =
+            this.manager === "yarn"
+                ? `add${props.dev ? " -D" : ""}`
+                : `install ${props.dev ? "--save-dev" : "--save"}`;
+        CommandExecutor.run(
+            `${this.manager} ${middle} ${props.modulo}${
+                props.version ? `@${props.version}` : ""
+            }`,
+            !!props.silent,
+        );
+        return true;
+    }
+
+    public erase(props: { modulo: string; silent?: boolean }): void {
+        const middle: string = this.manager === "yarn" ? "remove" : "uninstall";
+        CommandExecutor.run(
+            `${this.manager} ${middle} ${props.modulo}`,
+            !!props.silent,
+        );
+    }
+
+    private constructor(
+        public readonly directory: string,
+        public data: Package.Data,
+    ) {}
+
+    private static async load(file: string): Promise<Package.Data> {
+        const content: string = await fs.promises.readFile(file, "utf8");
+        return JSON.parse(content);
+    }
+}
+export namespace Package {
+    export interface Data {
+        scripts?: Record<string, string>;
+        dependencies?: Record<string, string>;
+        devDependencies?: Record<string, string>;
+    }
+}

package/src/executable/setup/PluginConfigurator.ts

@@ -1,99 +1,99 @@
-import type Comment from "comment-json";
-import fs from "fs";
-import path from "path";
-
-import { TypiaSetupWizard } from "../TypiaSetupWizard";
-import { FileRetriever } from "./FileRetriever";
-import { PackageManager } from "./PackageManager";
-
-export namespace PluginConfigurator {
-    export async function configure(
-        pack: PackageManager,
-        args: TypiaSetupWizard.IArguments,
-    ): Promise<void> {
-        // INSTALL COMMENT-JSON
-        const installed: boolean = pack.install({
-            dev: true,
-            modulo: "comment-json",
-            version: "4.2.3",
-            silent: true,
-        });
-
-        // DO CONFIGURE
-        const error: Error | null = await (async () => {
-            try {
-                await _Configure(pack, args);
-                return null;
-            } catch (exp) {
-                return exp as Error;
-            }
-        })();
-
-        // REMOVE IT
-        if (installed)
-            pack.erase({
-                modulo: "comment-json",
-                silent: true,
-            });
-        if (error !== null) throw error;
-    }
-
-    async function _Configure(
-        pack: PackageManager,
-        args: TypiaSetupWizard.IArguments,
-    ): Promise<void> {
-        // GET COMPILER-OPTIONS
-        const Comment: typeof import("comment-json") =
-            await FileRetriever.require(
-                path.join("node_modules", "comment-json"),
-            )(pack.directory);
-
-        const config: Comment.CommentObject = Comment.parse(
-            await fs.promises.readFile(args.project!, "utf8"),
-        ) as Comment.CommentObject;
-        const compilerOptions = config.compilerOptions as
-            | Comment.CommentObject
-            | undefined;
-        if (compilerOptions === undefined)
-            throw new Error(
-                `${args.project} file does not have "compilerOptions" property.`,
-            );
-
-        // PREPARE PLUGINS
-        const plugins: Comment.CommentArray<Comment.CommentObject> = (() => {
-            const plugins = compilerOptions.plugins as
-                | Comment.CommentArray<Comment.CommentObject>
-                | undefined;
-            if (plugins === undefined)
-                return (compilerOptions.plugins = [] as any);
-            else if (!Array.isArray(plugins))
-                throw new Error(
-                    `"plugins" property of ${args.project} must be array type.`,
-                );
-            return plugins;
-        })();
-
-        const strict: boolean = compilerOptions.strict === true;
-        const oldbie: Comment.CommentObject | undefined = plugins.find(
-            (p) =>
-                typeof p === "object" &&
-                p !== null &&
-                p.transform === "typia/lib/transform",
-        );
-        if (strict === true && oldbie !== undefined) return;
-
-        // DO CONFIGURE
-        compilerOptions.strict = true;
-        if (oldbie === undefined)
-            plugins.push(
-                Comment.parse(`
-                        {
-                            "transform": "typia/lib/transform"
-                        }`) as Comment.CommentObject,
-            );
-        await fs.promises.writeFile(
-            args.project!,
-            Comment.stringify(config, null, 2),
-        );
-    }
-}
+import type Comment from "comment-json";
+import fs from "fs";
+import path from "path";
+
+import { TypiaSetupWizard } from "../TypiaSetupWizard";
+import { FileRetriever } from "./FileRetriever";
+import { PackageManager } from "./PackageManager";
+
+export namespace PluginConfigurator {
+    export async function configure(
+        pack: PackageManager,
+        args: TypiaSetupWizard.IArguments,
+    ): Promise<void> {
+        // INSTALL COMMENT-JSON
+        const installed: boolean = pack.install({
+            dev: true,
+            modulo: "comment-json",
+            version: "4.2.3",
+            silent: true,
+        });
+
+        // DO CONFIGURE
+        const error: Error | null = await (async () => {
+            try {
+                await _Configure(pack, args);
+                return null;
+            } catch (exp) {
+                return exp as Error;
+            }
+        })();
+
+        // REMOVE IT
+        if (installed)
+            pack.erase({
+                modulo: "comment-json",
+                silent: true,
+            });
+        if (error !== null) throw error;
+    }
+
+    async function _Configure(
+        pack: PackageManager,
+        args: TypiaSetupWizard.IArguments,
+    ): Promise<void> {
+        // GET COMPILER-OPTIONS
+        const Comment: typeof import("comment-json") =
+            await FileRetriever.require(
+                path.join("node_modules", "comment-json"),
+            )(pack.directory);
+
+        const config: Comment.CommentObject = Comment.parse(
+            await fs.promises.readFile(args.project!, "utf8"),
+        ) as Comment.CommentObject;
+        const compilerOptions = config.compilerOptions as
+            | Comment.CommentObject
+            | undefined;
+        if (compilerOptions === undefined)
+            throw new Error(
+                `${args.project} file does not have "compilerOptions" property.`,
+            );
+
+        // PREPARE PLUGINS
+        const plugins: Comment.CommentArray<Comment.CommentObject> = (() => {
+            const plugins = compilerOptions.plugins as
+                | Comment.CommentArray<Comment.CommentObject>
+                | undefined;
+            if (plugins === undefined)
+                return (compilerOptions.plugins = [] as any);
+            else if (!Array.isArray(plugins))
+                throw new Error(
+                    `"plugins" property of ${args.project} must be array type.`,
+                );
+            return plugins;
+        })();
+
+        const strict: boolean = compilerOptions.strict === true;
+        const oldbie: Comment.CommentObject | undefined = plugins.find(
+            (p) =>
+                typeof p === "object" &&
+                p !== null &&
+                p.transform === "typia/lib/transform",
+        );
+        if (strict === true && oldbie !== undefined) return;
+
+        // DO CONFIGURE
+        compilerOptions.strict = true;
+        if (oldbie === undefined)
+            plugins.push(
+                Comment.parse(`
+                        {
+                            "transform": "typia/lib/transform"
+                        }`) as Comment.CommentObject,
+            );
+        await fs.promises.writeFile(
+            args.project!,
+            Comment.stringify(config, null, 2),
+        );
+    }
+}