Merge pull request #38 from Himenon/feat/add-native-dot-engine

feat: add `--engine` which use native graphviz engine

Author: Himenon

.gitignore

@@ -11,3 +11,20 @@ private_npm_cache
 buildcache/
 bin/*.js
 .npmrc
+
+### packages/cli
+
+packages/cli/lib
+packages/cli/coverage
+packages/cli/node_modules
+packages/cli/package-lock.json
+packages/cli/.env*
+packages/cli/*.log
+packages/cli/private_npm_cache
+packages/cli/data/
+packages/cli/dist/
+packages/cli/output
+
+### packages/view
+
+packages/view/dist

.prettierignore

@@ -4,6 +4,23 @@
 
 docs
 
+### packages/cli
+
+packages/cli/lib
+packages/cli/coverage
+packages/cli/node_modules
+packages/cli/package-lock.json
+packages/cli/.env*
+packages/cli/*.log
+packages/cli/private_npm_cache
+packages/cli/data/
+packages/cli/dist/
+packages/cli/output
+
+### packages/view
+
+packages/view/dist
+
 ### Node ###
 # Logs
 logs

packages/cli/.gitignore

@@ -8,7 +8,7 @@ code-dependency --source ./src
 
 ## Option
 
-**-s --source** (required)
+### -s --source\*\* (required)
 
 Source directory path
 
@@ -17,7 +17,7 @@ code-dependency --source ./src
 code-dependency --source /home/app/src
 ```
 
-**-p --port**
+### -p --port
 
 Server port number (default 3000).
 
@@ -26,15 +26,15 @@ code-dependency --source ./src --p 4000
 code-dependency --source ./src --port 4000
 ```
 
-**--ts-config**
+### --ts-config
 
 `tsconfig.json` path. [see](https://github.com/sverweij/dependency-cruiser/blob/develop/doc/cli.md#--ts-config-use-a-typescript-configuration-file-project)
 
 ```bash
 code-dependency --source ./src --ts-config ./tsconfig.json
 ```
 
-**--webpack-config**
+### --webpack-config
 
 `webpack.config.js` path. (JavaScript only) [see](https://github.com/sverweij/dependency-cruiser/blob/develop/doc/cli.md#--webpack-config-use-the-resolution-options-of-a-webpack-configuration)
 
@@ -43,23 +43,23 @@ code-dependency --source ./src --webpack-config webpack.config.js
 code-dependency --source ./src --webpack-config your.config.js
 ```
 
-**--exclude**
+### --exclude
 
 cruise ignore pattern (default: "node_modules"). [see](https://github.com/sverweij/dependency-cruiser/blob/develop/doc/cli.md#--exclude-exclude-dependencies-from-being-cruised)
 
 ```bash
 code-dependency --source ./src --exclude node_modules
 ```
 
-**--export-static**
+### --export-static
 
 generate static site.
 
 ```bash
 code-dependency --source ./src --exclude node_modules --export-static ./docs
 ```
 
-**--public-path**
+### --public-path
 
 ```bash
 code-dependency --source ./src --exclude node_modules --export-static ./docs --public-path /docs
@@ -79,7 +79,17 @@ Directory Structure
     └── src           // `--source` target : Browser entrypoint -> /project/src/index.html
 ```
 
-**--dry-run** (experimental)
+### --engine
+
+Use native graphviz engine. (https://www.graphviz.org/)
+
+Option: `dot` (recommended)
+
+```bash
+code-dependency --source ./src --exclude node_modules --export-static ./docs --public-path /docs --engine dot
+```
+
+### --dry-run (experimental)
 
 if failed generate static file and retry generate static file only unfinished path.
 

packages/cli/.prettierignore

@@ -36,6 +36,7 @@
     "export:static": "node ./bin/code-dependency.js --source ./src --exclude node_modules --export-static ./output --public-path http://localhost:5000/output",
     "generate:docs": "node ./bin/code-dependency.js --source ./src --exclude node_modules --export-static ../../docs --public-path https://himenon.github.io/code-dependency/",
     "server": "nodemon ./bin/code-dependency.js --source ./src --exclude node_modules",
+    "server2": "nodemon ./bin/code-dependency.js --source ./src --engine dot --exclude node_modules",
     "start": "run-p develop server",
     "test": "jest -c jest.config.json && yarn export:static",
     "test:ci": "jest -c jest.config.json --no-cache --ci && yarn export:static",
@@ -60,6 +61,7 @@
     "recursive-readdir": "^2.2.2",
     "resolve-pkg": "^2.0.0",
     "rimraf": "^3.0.1",
+    "tempfile": "^3.0.0",
     "tsconfig": "^7.0.0",
     "urljoin": "^0.1.5"
   },
@@ -71,7 +73,8 @@
     "@types/pretty": "^2.0.0",
     "@types/react": "^16.9.19",
     "@types/react-dom": "^16.9.5",
-    "@types/rimraf": "^2.0.3"
+    "@types/rimraf": "^2.0.3",
+    "@types/tempfile": "^3.0.0"
   },
   "publishConfig": {
     "access": "public"

packages/cli/README.md

@@ -22,7 +22,7 @@ export const create = ({ context = process.cwd(), source }: Params) => {
     original: source,
     binRelativePath: path.relative(__dirname, source),
     rootDir: path.dirname(absolutePath),
-    rootAbsolutePath: absolutePath,
+    absoluteRootPath: absolutePath,
   };
 };
 

packages/cli/package.json

@@ -1,5 +1,5 @@
 import commander from "commander";
-import { SourcePathInvalidError } from "../exceptions";
+import { SourcePathInvalidError, CliArgumentError } from "../exceptions";
 import * as PathFactory from "./PathFactory";
 
 const isInvalidPath = require("is-invalid-path");
@@ -13,6 +13,7 @@ interface CLIArguments {
   exportStatic?: PathFactory.Type;
   publicPath?: string;
   dryRun: boolean;
+  engine?: "dot";
 }
 
 export const validateCliArguments = (args: commander.Command): CLIArguments => {
@@ -22,6 +23,12 @@ export const validateCliArguments = (args: commander.Command): CLIArguments => {
   if (args["tsConfig"] && isInvalidPath(args["source"])) {
     throw new SourcePathInvalidError("`--source` arguments does not selected.");
   }
+  if ("exportStatic" in args && typeof args["exportStatic"] !== "string") {
+    throw new CliArgumentError("`--export-static` require 1 string argument.");
+  }
+  if ("publicPath" in args && typeof args["publicPath"] !== "string") {
+    throw new CliArgumentError("`--public-path` require 1 string argument.");
+  }
   return {
     source: PathFactory.create({ source: args["source"] }),
     port: args["port"],
@@ -31,6 +38,7 @@ export const validateCliArguments = (args: commander.Command): CLIArguments => {
     exportStatic: args["exportStatic"] && PathFactory.create({ source: args["exportStatic"] }),
     publicPath: args["publicPath"],
     dryRun: !!args["dryRun"],
+    engine: args["engine"] === "dot" ? "dot" : undefined,
   };
 };
 
@@ -45,6 +53,7 @@ export const executeCommandLine = (): CLIArguments => {
     .option("--export-static [static directory]", "static file hosting directory")
     .option("--public-path [host public path]", "the base path for all the assets")
     .option("--dry-run", "only use --export-static option")
+    .option("--engine <dot>", "already local installed graphviz. <https://www.graphviz.org/>")
     .parse(process.argv);
   return validateCliArguments(commander);
 };

packages/cli/src/cli/PathFactory.ts

@@ -2,6 +2,7 @@ import * as path from "path";
 import { FilePathObject } from "@code-dependency/view";
 
 export interface Type {
+  rendererType: "client" | "server";
   server: {
     port: number;
   };
@@ -11,8 +12,16 @@ export interface Type {
   filePathList: FilePathObject[];
 }
 
-export const create = (port: number, absoluteRootPath: string, filePathList: FilePathObject[]): Type => {
+export interface Params {
+  rendererType: "client" | "server";
+  port: number;
+  absoluteRootPath: string;
+  filePathList: FilePathObject[];
+}
+
+export const create = ({ rendererType, port, absoluteRootPath, filePathList }: Params): Type => {
   return {
+    rendererType,
     server: {
       port,
     },

packages/cli/src/cli/index.ts

@@ -1,4 +1,7 @@
 export const routes = {
+  index: {
+    path: "/",
+  },
   project: {
     path: "/project",
   },