Merge pull request npm#16 from herodevs/tracker

Implement HeroDevs tracker logic in this CLI

Author: jeremymwells

package-lock.json

@@ -23,9 +23,16 @@
     "@oclif/core": "^2",
     "@oclif/plugin-help": "^5",
     "@oclif/plugin-plugins": "^3.2.0",
+    "chart.js": "^3.9.1",
+    "chart.js-image": "^6.1.3",
+    "chartjs-node-canvas": "^4.1.6",
+    "chartjs-plugin-autocolors": "^0.2.2",
+    "chartjs-plugin-datalabels": "^2.2.0",
     "date-fns": "^2.30.0",
+    "git-last-commit": "^1.0.1",
     "module-alias": "^2.2.3",
-    "shelljs": "^0.8.5"
+    "shelljs": "^0.8.5",
+    "sloc": "^0.2.1"
   },
   "devDependencies": {
     "@oclif/test": "^2.4.4",
@@ -55,6 +62,9 @@
     "topics": {
       "committer": {
         "description": "Committer actions"
+      },
+      "tracker": {
+        "description": "Track project progress"
       }
     }
   },
@@ -106,5 +116,11 @@
   "keywords": [
     "oclif"
   ],
-  "types": "dist/index.d.ts"
+  "types": "dist/index.d.ts",
+  "prettier": {
+    "singleQuote": true,
+    "trailingComma": "es5",
+    "bracketSpacing": true,
+    "printWidth": 100
+  }
 }

package.json

@@ -0,0 +1,19 @@
+import { Args, Command, Flags } from '@oclif/core';
+import { TrackerInit } from './init';
+import { BaseCommand } from '../../shared';
+import { TrackerRun } from './run';
+
+export default class Tracker extends Command {
+  static description = 'Tracker info';
+
+  static examples = [`$ @herodevs/cli tracker`];
+
+  static flags = {};
+
+  static args = {
+    init: TrackerInit.args,
+    run: TrackerRun.args,
+  } as any;
+
+  async run(): Promise<void> {}
+}

src/commands/tracker/index.ts

@@ -0,0 +1,17 @@
+import { Args, Command, Flags } from '@oclif/core';
+import { initialize } from '../../shared/tracker/initialize';
+import { getTheRootDirectory } from '../../shared/tracker/util';
+
+export class TrackerInit extends Command {
+  static description = 'Initialize the tracker configuration';
+
+  static examples = ['<%= config.bin %> <%= command.id %>'];
+
+  static flags = {};
+
+  static args = {};
+
+  public async run(): Promise<void> {
+    initialize(getTheRootDirectory(global.process.cwd()));
+  }
+}

src/commands/tracker/init.ts

@@ -0,0 +1,48 @@
+import { Args, Command, Flags } from '@oclif/core';
+import { resolve } from 'path';
+import {
+  createDataVizIn,
+  getData,
+  getTheRootDirectory,
+  readConfig,
+  saveResults,
+} from '../../shared/tracker/util';
+import { processConfig } from '../../shared/tracker/process-config';
+import { ChartConfig } from '../../shared/tracker/models/chart-config';
+
+export class TrackerRun extends Command {
+  static description = 'Run the tracker';
+
+  static examples = ['<%= config.bin %> <%= command.id %>'];
+
+  static flags = {
+    root: Flags.string({ char: 'r', description: 'root dir of the project' }),
+    config: Flags.string({ char: 'c', description: 'path to config file' }),
+    chart: Flags.custom<ChartConfig>({
+      description: 'chart configuration',
+    })(),
+  };
+
+  static args = {};
+
+  public async run(): Promise<void> {
+    const { flags } = await this.parse(TrackerRun);
+
+    const localRootDir = getTheRootDirectory(global.process.cwd());
+
+    const rootDirectory = flags.root ? resolve(flags.root) : localRootDir;
+    const config = readConfig(localRootDir, flags.config);
+
+    const results = await processConfig(config, rootDirectory);
+
+    saveResults(localRootDir, config.outputDir, results);
+
+    const allData = getData(localRootDir, config.outputDir);
+
+    const parentDir = resolve(localRootDir, config.outputDir);
+
+    const chartConfig = new ChartConfig(flags.chart);
+
+    await createDataVizIn(chartConfig, parentDir, allData);
+  }
+}

src/commands/tracker/run.ts

@@ -0,0 +1,20 @@
+import { Config } from './models/config';
+
+const defaultConfig: Config = {
+  categories: {
+    legacy: {
+      fileTypes: ['js', 'ts', 'html', 'css', 'scss', 'less'],
+      includes: ['./legacy'],
+      jsTsPairs: 'js',
+    },
+    modern: {
+      fileTypes: ['ts', 'html', 'css', 'scss', 'less'],
+      includes: ['./modern'],
+      jsTsPairs: 'ts',
+    },
+  },
+  ignorePatterns: ['node_modules'],
+  outputDir: 'hd-tracker',
+};
+
+export default defaultConfig;

src/shared/tracker/default-config.ts

@@ -0,0 +1,13 @@
+import { join } from "path";
+import { existsSync, writeFileSync, mkdirSync } from "fs";
+
+import defaultConfig from "./default-config";
+
+export function initialize(rootDir: string): void {
+  const output = JSON.stringify(defaultConfig, null, 2);
+  const dir = join(rootDir, "hd-tracker");
+  if (!existsSync(dir)) {
+    mkdirSync(dir);
+  }
+  writeFileSync(join(dir, "config.json"), output);
+}

src/shared/tracker/initialize.ts

@@ -0,0 +1,5 @@
+import { TotalResult } from './total-result';
+
+export interface AggregateResult extends TotalResult {
+  fileType: string;
+}

src/shared/tracker/models/aggregate-result.ts

@@ -0,0 +1,8 @@
+import { AggregateResult } from './aggregate-result';
+import { TotalResult } from './total-result';
+
+export interface CategoryResult {
+  name: string;
+  totals: TotalResult;
+  fileTypes: AggregateResult[];
+}

src/shared/tracker/models/category-result.ts

@@ -0,0 +1,10 @@
+export interface Category extends CategoryDefinition {
+  name: string;
+}
+
+export interface CategoryDefinition {
+  fileTypes: string[];
+  includes: string[];
+  excludes?: string[];
+  jsTsPairs?: 'js' | 'ts' | 'ignore';
+}