@nestia/migrate 0.5.0 → 0.6.0

package/src/executable/migrate.ts

@@ -1,60 +1,59 @@
-#!/usr/bin/env node
-import fs from "fs";
-import path from "path";
-
-import { NestiaMigrateApplication } from "../NestiaMigrateApplication";
-import { ISwagger } from "../structures/ISwagger";
-import { SetupWizard } from "../utils/SetupWizard";
-
-const USAGE = `Wrong command has been detected. Use like below:
-
-npx @nestia/migrate [input] [output]
-
-  ex) npx @nestia/migrate swagger.json my-new-project
-`;
-
-function halt(desc: string): never {
-    console.error(desc);
-    process.exit(-1);
-}
-
-const main = (argv: string[]) => {
-    const resolve = (str: string | undefined) =>
-        str ? path.resolve(str).split("\\").join("/") : undefined;
-    const input: string | undefined = resolve(argv[0]);
-    const output: string | undefined = resolve(argv[1]);
-
-    // VALIDATE ARGUMENTS
-    if (input === undefined || output === undefined) halt(USAGE);
-
-    // VALIDATE OUTPUT DIRECTORY
-    const parent: string = resolve(output + "/..")!;
-    if (fs.existsSync(output)) halt("Output directory alreay exists.");
-    else if (fs.existsSync(parent) === false)
-        halt("Output directory's parent directory does not exist.");
-    else if (fs.statSync(parent).isDirectory() === false)
-        halt("Output directory's parent is not a directory.");
-
-    // READ SWAGGER
-    const swagger: ISwagger = (() => {
-        if (fs.existsSync(input) === false)
-            halt("Unable to find the input swagger.json file.");
-        const stats: fs.Stats = fs.statSync(input);
-        if (stats.isFile() === false)
-            halt("The input swagger.json is not a file.");
-        const content: string = fs.readFileSync(input, "utf-8");
-        const swagger: ISwagger = JSON.parse(content);
-        return swagger;
-    })();
-
-    // DO GENERATE
-    const app = new NestiaMigrateApplication(swagger);
-    app.generate({
-        mkdir: fs.mkdirSync,
-        writeFile: (path, content) => fs.writeFileSync(path, content, "utf8"),
-    })(output);
-
-    // RUN SCRIPTS
-    SetupWizard.setup(output);
-};
-main(process.argv.slice(2));
+#!/usr/bin/env node
+import fs from "fs";
+import path from "path";
+
+import { NestiaMigrateApplication } from "../NestiaMigrateApplication";
+import { ISwagger } from "../structures/ISwagger";
+import { SetupWizard } from "../utils/SetupWizard";
+
+const USAGE = `Wrong command has been detected. Use like below:
+
+npx @nestia/migrate [input] [output]
+
+  ex) npx @nestia/migrate swagger.json my-new-project
+`;
+
+function halt(desc: string): never {
+  console.error(desc);
+  process.exit(-1);
+}
+
+const main = (argv: string[]) => {
+  const resolve = (str: string | undefined) =>
+    str ? path.resolve(str).split("\\").join("/") : undefined;
+  const input: string | undefined = resolve(argv[0]);
+  const output: string | undefined = resolve(argv[1]);
+
+  // VALIDATE ARGUMENTS
+  if (input === undefined || output === undefined) halt(USAGE);
+
+  // VALIDATE OUTPUT DIRECTORY
+  const parent: string = resolve(output + "/..")!;
+  if (fs.existsSync(output)) halt("Output directory alreay exists.");
+  else if (fs.existsSync(parent) === false)
+    halt("Output directory's parent directory does not exist.");
+  else if (fs.statSync(parent).isDirectory() === false)
+    halt("Output directory's parent is not a directory.");
+
+  // READ SWAGGER
+  const swagger: ISwagger = (() => {
+    if (fs.existsSync(input) === false)
+      halt("Unable to find the input swagger.json file.");
+    const stats: fs.Stats = fs.statSync(input);
+    if (stats.isFile() === false) halt("The input swagger.json is not a file.");
+    const content: string = fs.readFileSync(input, "utf-8");
+    const swagger: ISwagger = JSON.parse(content);
+    return swagger;
+  })();
+
+  // DO GENERATE
+  const app = new NestiaMigrateApplication(swagger);
+  app.generate({
+    mkdir: fs.mkdirSync,
+    writeFile: (path, content) => fs.writeFileSync(path, content, "utf8"),
+  })(output);
+
+  // RUN SCRIPTS
+  SetupWizard.setup(output);
+};
+main(process.argv.slice(2));

package/src/index.ts

@@ -1,4 +1,4 @@
-import * as migrate from "./module";
-
-export default migrate;
-export * from "./module";
+import * as migrate from "./module";
+
+export default migrate;
+export * from "./module";

package/src/module.ts

@@ -1,4 +1,4 @@
-export * from "./NestiaMigrateApplication";
-
-export * from "./structures/ISwagger";
-export * from "./structures/IMigrateProgram";
+export * from "./NestiaMigrateApplication";
+
+export * from "./structures/ISwagger";
+export * from "./structures/IMigrateProgram";

package/src/programmers/ControllerProgrammer.ts

@@ -1,157 +1,155 @@
-import { IMigrateController } from "../structures/IMigrateController";
-import { IMigrateRoute } from "../structures/IMigrateRoute";
-import { ISwaggerSchema } from "../structures/ISwaggeSchema";
-import { ISwagger } from "../structures/ISwagger";
-import { ISwaggerComponents } from "../structures/ISwaggerComponents";
-import { MapUtil } from "../utils/MapUtil";
-import { StringUtil } from "../utils/StringUtil";
-import { ImportProgrammer } from "./ImportProgrammer";
-import { RouteProgrammer } from "./RouteProgrammer";
-
-export namespace ControllerProgrammer {
-    export const analyze = (swagger: ISwagger): IMigrateController[] => {
-        const dict: Map<string, IMigrateRoute[]> = new Map();
-
-        // GATHER ROUTES
-        for (const [path, collection] of Object.entries(swagger.paths)) {
-            // PREPARE DIRECTORIES
-            const location: string = StringUtil.splitWithNormalization(path)
-                .filter((str) => str[0] !== "{" && str[0] !== ":")
-                .join("/");
-            for (const s of sequence(location)) MapUtil.take(dict)(s)(() => []);
-
-            // INSERT ROUTES TO THE LAST DIRECTORY
-            const routes: IMigrateRoute[] = MapUtil.take(dict)(location)(
-                () => [],
-            );
-            for (const [method, value] of Object.entries(collection)) {
-                const r: IMigrateRoute | null = RouteProgrammer.analyze(
-                    swagger,
-                )({
-                    path,
-                    method,
-                })(value);
-                if (r !== null) routes.push(r);
-            }
-        }
-
-        // ABSORB STANDALONE ROUTES
-        const emended: Map<string, IMigrateRoute[]> = new Map(
-            [...dict.entries()].sort((a, b) => a[0].localeCompare(b[0])),
-        );
-        for (const [location, routes] of emended) {
-            if (routes.length !== 1) continue;
-            for (const s of sequence(location).slice(0, 1)) {
-                const parent = emended.get(s);
-                if (parent) {
-                    parent.push(...routes);
-                    emended.delete(location);
-                    break;
-                }
-            }
-        }
-
-        // GENERATE CONTROLLERS
-        return [...emended.entries()]
-            .filter(([_l, routes]) => !!routes.length)
-            .map(([location, routes]) => {
-                const prefix: string = StringUtil.commonPrefix(
-                    routes.map((r) => r.path),
-                );
-                for (const r of routes)
-                    r.path = StringUtil.reJoinWithDecimalParameters(
-                        r.path.replace(prefix, ""),
-                    );
-                const controller: IMigrateController = {
-                    name: StringUtil.pascal(location) + "Controller",
-                    path: StringUtil.reJoinWithDecimalParameters(prefix),
-                    location: "src/controllers/" + location,
-                    routes,
-                };
-                if (controller.name === "Controller")
-                    controller.name = "__Controller";
-                naming(controller);
-                return controller;
-            });
-    };
-
-    const sequence = (location: string): string[] =>
-        StringUtil.splitWithNormalization(location)
-            .map((_str, i, entire) => entire.slice(0, i + 1).join("/"))
-            .slice(0, -1)
-            .reverse();
-
-    const naming = (controller: IMigrateController): void => {
-        interface IRouteCapsule {
-            variables: string[];
-            route: IMigrateRoute;
-        }
-        const dict: Map<string, IRouteCapsule[]> = new Map();
-        for (const route of controller.routes) {
-            const additional: string[] = StringUtil.splitWithNormalization(
-                route.path,
-            );
-            const statics: string[] = additional.filter(
-                (str) => str[0] !== ":",
-            );
-            if (statics.length)
-                route.name = StringUtil.camel(statics.join("/"));
-            else
-                MapUtil.take(dict)(route.method)(() => []).push({
-                    variables: additional
-                        .filter((str) => str[0] === ":")
-                        .map((str) => str.substring(1)),
-                    route,
-                });
-        }
-
-        for (const [method, capsules] of dict) {
-            const emended: string = method === "delete" ? "erase" : method;
-            for (const c of capsules) {
-                const empty: boolean = c.variables.length === 0;
-                c.route.name = empty
-                    ? emended
-                    : StringUtil.camel(
-                          `${emended}By/${c.variables.join("/and/")}`,
-                      );
-            }
-        }
-    };
-
-    export const write =
-        (components: ISwaggerComponents) =>
-        (controller: IMigrateController): string => {
-            const importer: ImportProgrammer = new ImportProgrammer(null);
-            const references: ISwaggerSchema.IReference[] = [];
-            const body: string = [
-                `@${importer.external({
-                    library: "@nestjs/common",
-                    instance: "Controller",
-                })}(${JSON.stringify(controller.path)})`,
-                `export class ${controller.name} {`,
-                controller.routes
-                    .map((r) =>
-                        RouteProgrammer.write(components)(references)(importer)(
-                            r,
-                        )
-                            .split("\n")
-                            .map((l) => `    ${l}`)
-                            .join("\n"),
-                    )
-                    .join("\n\n"),
-                `}`,
-            ].join("\n");
-            return [
-                ...importer.toScript(
-                    (ref) =>
-                        `${"../".repeat(
-                            StringUtil.splitWithNormalization(
-                                controller.location,
-                            ).length - 1,
-                        )}api/structures/${ref}`,
-                ),
-                ...(importer.empty() ? [] : [""]),
-                body,
-            ].join("\n");
-        };
-}
+import ts from "typescript";
+
+import { IMigrateController } from "../structures/IMigrateController";
+import { IMigrateRoute } from "../structures/IMigrateRoute";
+import { ISwagger } from "../structures/ISwagger";
+import { ISwaggerComponents } from "../structures/ISwaggerComponents";
+import { FilePrinter } from "../utils/FilePrinter";
+import { MapUtil } from "../utils/MapUtil";
+import { StringUtil } from "../utils/StringUtil";
+import { ImportProgrammer } from "./ImportProgrammer";
+import { RouteProgrammer } from "./RouteProgrammer";
+
+export namespace ControllerProgrammer {
+  /* -----------------------------------------------------------
+    ANALYZERS
+  ----------------------------------------------------------- */
+  export const analyze = (swagger: ISwagger): IMigrateController[] => {
+    const dict: Map<string, IMigrateRoute[]> = new Map();
+
+    // GATHER ROUTES
+    for (const [path, collection] of Object.entries(swagger.paths)) {
+      // PREPARE DIRECTORIES
+      const location: string = StringUtil.splitWithNormalization(path)
+        .filter((str) => str[0] !== "{" && str[0] !== ":")
+        .join("/");
+      for (const s of sequence(location)) MapUtil.take(dict)(s)(() => []);
+
+      // INSERT ROUTES TO THE LAST DIRECTORY
+      const routes: IMigrateRoute[] = MapUtil.take(dict)(location)(() => []);
+      for (const [method, value] of Object.entries(collection)) {
+        const r: IMigrateRoute | null = RouteProgrammer.analyze(swagger)({
+          path,
+          method,
+        })(value);
+        if (r !== null) routes.push(r);
+      }
+    }
+
+    // ABSORB STANDALONE ROUTES
+    const emended: Map<string, IMigrateRoute[]> = new Map(
+      [...dict.entries()].sort((a, b) => a[0].localeCompare(b[0])),
+    );
+    for (const [location, routes] of emended) {
+      if (routes.length !== 1) continue;
+      for (const s of sequence(location).slice(0, 1)) {
+        const parent = emended.get(s);
+        if (parent) {
+          parent.push(...routes);
+          emended.delete(location);
+          break;
+        }
+      }
+    }
+
+    // GENERATE CONTROLLERS
+    return [...emended.entries()]
+      .filter(([_l, routes]) => !!routes.length)
+      .map(([location, routes]) => {
+        const prefix: string = StringUtil.commonPrefix(
+          routes.map((r) => r.path),
+        );
+        for (const r of routes)
+          r.path = StringUtil.reJoinWithDecimalParameters(
+            r.path.replace(prefix, ""),
+          );
+        const controller: IMigrateController = {
+          name: StringUtil.pascal(location) + "Controller",
+          path: StringUtil.reJoinWithDecimalParameters(prefix),
+          location: "src/controllers/" + location,
+          routes,
+        };
+        if (controller.name === "Controller") controller.name = "__Controller";
+        naming(controller);
+        return controller;
+      });
+  };
+
+  const sequence = (location: string): string[] =>
+    StringUtil.splitWithNormalization(location)
+      .map((_str, i, entire) => entire.slice(0, i + 1).join("/"))
+      .slice(0, -1)
+      .reverse();
+
+  const naming = (controller: IMigrateController): void => {
+    interface IRouteCapsule {
+      variables: string[];
+      route: IMigrateRoute;
+    }
+    const dict: Map<string, IRouteCapsule[]> = new Map();
+    for (const route of controller.routes) {
+      const additional: string[] = StringUtil.splitWithNormalization(
+        route.path,
+      );
+      const statics: string[] = additional.filter((str) => str[0] !== ":");
+      if (statics.length) route.name = StringUtil.camel(statics.join("/"));
+      else
+        MapUtil.take(dict)(route.method)(() => []).push({
+          variables: additional
+            .filter((str) => str[0] === ":")
+            .map((str) => str.substring(1)),
+          route,
+        });
+    }
+
+    for (const [method, capsules] of dict) {
+      const emended: string = method === "delete" ? "erase" : method;
+      for (const c of capsules) {
+        const empty: boolean = c.variables.length === 0;
+        c.route.name = empty
+          ? emended
+          : StringUtil.camel(`${emended}By/${c.variables.join("/and/")}`);
+      }
+    }
+  };
+
+  /* -----------------------------------------------------------
+    WRITERS
+  ----------------------------------------------------------- */
+  export const write =
+    (components: ISwaggerComponents) =>
+    (controller: IMigrateController): ts.Statement[] => {
+      const importer: ImportProgrammer = new ImportProgrammer();
+      const $class = ts.factory.createClassDeclaration(
+        [
+          ts.factory.createDecorator(
+            ts.factory.createCallExpression(
+              ts.factory.createIdentifier(
+                importer.external({
+                  library: "@nestjs/common",
+                  instance: "Controller",
+                }),
+              ),
+              [],
+              [ts.factory.createStringLiteral(controller.path)],
+            ),
+          ),
+          ts.factory.createToken(ts.SyntaxKind.ExportKeyword),
+        ],
+        controller.name,
+        [],
+        [],
+        controller.routes.map(RouteProgrammer.write(components)(importer)),
+      );
+      return [
+        ...importer.toStatements(
+          (ref) =>
+            `${"../".repeat(
+              StringUtil.splitWithNormalization(controller.location).length - 1,
+            )}api/structures/${ref}`,
+        ),
+        ...(importer.empty() ? [] : [FilePrinter.enter()]),
+        $class,
+      ];
+    };
+}