@herodevs/cli 0.1.15 → 0.2.0

package/README.md

@@ -1,356 +1,42 @@
-# HeroDevs NES Developer Kit -- `@herodevs/cli`
+# HeroDevs CLI -- `@herodevs/cli`
 
-<!-- [![herodevs](https://img.shields.io/badge/cli-oclif-brightgreen.svg)](https://herodevs.com)
-[![CircleCI](https://circleci.com/gh/oclif/hello-world/tree/main.svg?style=shield)](https://circleci.com/gh/oclif/hello-world/tree/main)
-[![GitHub license](https://img.shields.io/github/license/oclif/hello-world)](https://github.com/oclif/hello-world/blob/main/LICENSE) -->
+## Installation
 
-<!-- toc -->
-* [HeroDevs NES Developer Kit -- `@herodevs/cli`](#herodevs-nes-developer-kit----herodevscli)
-* [Usage](#usage)
-* [Commands](#commands)
-<!-- tocstop -->
-
-# Usage
-
-<!-- usage -->
-```sh-session
-$ npm install -g @herodevs/cli
-$ @herodevs/cli COMMAND
-running command...
-$ @herodevs/cli (--version)
-@herodevs/cli/0.1.15 darwin-arm64 node-v18.17.1
-$ @herodevs/cli --help [COMMAND]
-USAGE
-  $ @herodevs/cli COMMAND
-...
-```
-<!-- usagestop -->
-
-# Commands
-
-<!-- commands -->
-* [`@herodevs/cli committer [GET-ALL]`](#herodevscli-committer-get-all)
-* [`@herodevs/cli committer:get-all [flags [-s][-e][-x]]`](#herodevscli-committerget-all-flags--s-e-x)
-* [`@herodevs/cli help [COMMANDS]`](#herodevscli-help-commands)
-* [`@herodevs/cli plugins`](#herodevscli-plugins)
-* [`@herodevs/cli plugins:install PLUGIN...`](#herodevscli-pluginsinstall-plugin)
-* [`@herodevs/cli plugins:inspect PLUGIN...`](#herodevscli-pluginsinspect-plugin)
-* [`@herodevs/cli plugins:install PLUGIN...`](#herodevscli-pluginsinstall-plugin-1)
-* [`@herodevs/cli plugins:link PLUGIN`](#herodevscli-pluginslink-plugin)
-* [`@herodevs/cli plugins:uninstall PLUGIN...`](#herodevscli-pluginsuninstall-plugin)
-* [`@herodevs/cli plugins:uninstall PLUGIN...`](#herodevscli-pluginsuninstall-plugin-1)
-* [`@herodevs/cli plugins:uninstall PLUGIN...`](#herodevscli-pluginsuninstall-plugin-2)
-* [`@herodevs/cli plugins update`](#herodevscli-plugins-update)
-
-## `@herodevs/cli committer [GET-ALL]`
-
-Gets committer info
-
-```
-USAGE
-  $ @herodevs/cli committer [GET-ALL] [--json] [--log-level debug|info|warn|error]
-
-GLOBAL FLAGS
-  --json                Format output as json.
-  --log-level=<option>  Specify level for logging.
-                        <options: debug|info|warn|error>
-
-DESCRIPTION
-  Gets committer info
-
-EXAMPLES
-  $ @herodevs/cli committer
-```
-
-_See code: [dist/commands/committer/index.ts](https://github.com/herodevs/cli/blob/v0.1.15/dist/commands/committer/index.ts)_
-
-## `@herodevs/cli committer:get-all [flags [-s][-e][-x]]`
-
-Get Committers Between Two Dates
-
-```
-USAGE
-  $ @herodevs/cli committer get-all [flags [-s][-e][-x]]
-
-FLAGS
-  -e, --endDate=<value>     [default: 2022-09-01] End Date (format: yyyy-MM-dd)
-  -s, --startDate=<value>   [default: 2023-09-01] Start Date (format: yyyy-MM-dd)
-  -x, --exclude=<value>...  Path Exclusions (eg -x="./src/bin" -x="./dist")
-
-GLOBAL FLAGS
-  --json                Format output as json.
-  --log-level=<option>  Specify level for logging.
-                        <options: debug|info|warn|error>
-
-EXAMPLES
-  $ @herodevs/cli committer get-all
-```
-
-_See code: [dist/commands/committer/get-all.ts](https://github.com/herodevs/cli/blob/v0.1.15/dist/commands/committer/get-all.ts)_
-
-## `@herodevs/cli help [COMMANDS]`
-
-Display help for @herodevs/cli.
-
-```
-USAGE
-  $ @herodevs/cli help [COMMANDS] [-n]
-
-ARGUMENTS
-  COMMANDS  Command to show help for.
-
-FLAGS
-  -n, --nested-commands  Include all nested commands in the output.
-
-DESCRIPTION
-  Display help for @herodevs/cli.
-```
-
-_See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/v5.2.16/src/commands/help.ts)_
-
-## `@herodevs/cli plugins`
-
-List installed plugins.
-
-```
-USAGE
-  $ @herodevs/cli plugins [--json] [--core]
-
-FLAGS
-  --core  Show core plugins.
-
-GLOBAL FLAGS
-  --json  Format output as json.
-
-DESCRIPTION
-  List installed plugins.
-
-EXAMPLES
-  $ @herodevs/cli plugins
-```
-
-_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v3.2.5/src/commands/plugins/index.ts)_
-
-## `@herodevs/cli plugins:install PLUGIN...`
-
-Installs a plugin into the CLI.
-
-```
-USAGE
-  $ @herodevs/cli plugins:install PLUGIN...
-
-ARGUMENTS
-  PLUGIN  Plugin to install.
-
-FLAGS
-  -f, --force    Run yarn install with force flag.
-  -h, --help     Show CLI help.
-  -v, --verbose
-
-DESCRIPTION
-  Installs a plugin into the CLI.
-  Can be installed from npm or a git url.
-
-  Installation of a user-installed plugin will override a core plugin.
-
-  e.g. If you have a core plugin that has a 'hello' command, installing a user-installed plugin with a 'hello' command
-  will override the core plugin implementation. This is useful if a user needs to update core plugin functionality in
-  the CLI without the need to patch and update the whole CLI.
-
-
-ALIASES
-  $ @herodevs/cli plugins add
-
-EXAMPLES
-  $ @herodevs/cli plugins:install myplugin 
-
-  $ @herodevs/cli plugins:install https://github.com/someuser/someplugin
-
-  $ @herodevs/cli plugins:install someuser/someplugin
-```
-
-## `@herodevs/cli plugins:inspect PLUGIN...`
-
-Displays installation properties of a plugin.
-
-```
-USAGE
-  $ @herodevs/cli plugins:inspect PLUGIN...
-
-ARGUMENTS
-  PLUGIN  [default: .] Plugin to inspect.
-
-FLAGS
-  -h, --help     Show CLI help.
-  -v, --verbose
-
-GLOBAL FLAGS
-  --json  Format output as json.
-
-DESCRIPTION
-  Displays installation properties of a plugin.
-
-EXAMPLES
-  $ @herodevs/cli plugins:inspect myplugin
 ```
-
-_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v3.2.5/src/commands/plugins/inspect.ts)_
-
-## `@herodevs/cli plugins:install PLUGIN...`
-
-Installs a plugin into the CLI.
-
-```
-USAGE
-  $ @herodevs/cli plugins:install PLUGIN...
-
-ARGUMENTS
-  PLUGIN  Plugin to install.
-
-FLAGS
-  -f, --force    Run yarn install with force flag.
-  -h, --help     Show CLI help.
-  -v, --verbose
-
-DESCRIPTION
-  Installs a plugin into the CLI.
-  Can be installed from npm or a git url.
-
-  Installation of a user-installed plugin will override a core plugin.
-
-  e.g. If you have a core plugin that has a 'hello' command, installing a user-installed plugin with a 'hello' command
-  will override the core plugin implementation. This is useful if a user needs to update core plugin functionality in
-  the CLI without the need to patch and update the whole CLI.
-
-
-ALIASES
-  $ @herodevs/cli plugins add
-
-EXAMPLES
-  $ @herodevs/cli plugins:install myplugin 
-
-  $ @herodevs/cli plugins:install https://github.com/someuser/someplugin
-
-  $ @herodevs/cli plugins:install someuser/someplugin
+npm install -g @herodevs/cli
 ```
 
-_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v3.2.5/src/commands/plugins/install.ts)_
+## Usage
 
-## `@herodevs/cli plugins:link PLUGIN`
-
-Links a plugin into the CLI for development.
+after global installation
 
 ```
-USAGE
-  $ @herodevs/cli plugins:link PLUGIN
-
-ARGUMENTS
-  PATH  [default: .] path to plugin
-
-FLAGS
-  -h, --help     Show CLI help.
-  -v, --verbose
-
-DESCRIPTION
-  Links a plugin into the CLI for development.
-  Installation of a linked plugin will override a user-installed or core plugin.
-
-  e.g. If you have a user-installed or core plugin that has a 'hello' command, installing a linked plugin with a 'hello'
-  command will override the user-installed or core plugin implementation. This is useful for development work.
-
-
-EXAMPLES
-  $ @herodevs/cli plugins:link myplugin
+@herodevs/cli ____
 ```
 
-_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v3.2.5/src/commands/plugins/link.ts)_
-
-## `@herodevs/cli plugins:uninstall PLUGIN...`
-
-Removes a plugin from the CLI.
+or
 
 ```
-USAGE
-  $ @herodevs/cli plugins:uninstall PLUGIN...
-
-ARGUMENTS
-  PLUGIN  plugin to uninstall
-
-FLAGS
-  -h, --help     Show CLI help.
-  -v, --verbose
-
-DESCRIPTION
-  Removes a plugin from the CLI.
-
-ALIASES
-  $ @herodevs/cli plugins unlink
-  $ @herodevs/cli plugins remove
+hd ____
 ```
 
-## `@herodevs/cli plugins:uninstall PLUGIN...`
-
-Removes a plugin from the CLI.
+without installation:
 
 ```
-USAGE
-  $ @herodevs/cli plugins:uninstall PLUGIN...
-
-ARGUMENTS
-  PLUGIN  plugin to uninstall
-
-FLAGS
-  -h, --help     Show CLI help.
-  -v, --verbose
-
-DESCRIPTION
-  Removes a plugin from the CLI.
-
-ALIASES
-  $ @herodevs/cli plugins unlink
-  $ @herodevs/cli plugins remove
+npx @herodevs/cli ____
 ```
 
-_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v3.2.5/src/commands/plugins/uninstall.ts)_
+## Commands
 
-## `@herodevs/cli plugins:uninstall PLUGIN...`
-
-Removes a plugin from the CLI.
+Get a list of committers within a git repository
 
 ```
-USAGE
-  $ @herodevs/cli plugins:uninstall PLUGIN...
-
-ARGUMENTS
-  PLUGIN  plugin to uninstall
-
-FLAGS
-  -h, --help     Show CLI help.
-  -v, --verbose
-
-DESCRIPTION
-  Removes a plugin from the CLI.
-
-ALIASES
-  $ @herodevs/cli plugins unlink
-  $ @herodevs/cli plugins remove
+hd report committers
 ```
 
-## `@herodevs/cli plugins update`
-
-Update installed plugins.
+Track a project's progress via lines of code
 
 ```
-USAGE
-  $ @herodevs/cli plugins update [-h] [-v]
-
-FLAGS
-  -h, --help     Show CLI help.
-  -v, --verbose
-
-DESCRIPTION
-  Update installed plugins.
+hd tracker init
+hd tracker run
 ```
-
-_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v3.2.5/src/commands/plugins/update.ts)_
-<!-- commandsstop -->

package/dist/commands/{committer/get-all.d.ts → report/committers.d.ts}

@@ -1,16 +1,16 @@
 import { BaseCommand, Flags as flagType } from '../../shared';
-export declare class CommitterGetAll extends BaseCommand<typeof CommitterGetAll> {
+export declare class ReportCommitters extends BaseCommand<typeof ReportCommitters> {
     static summary: string;
     static usage: string;
     static examples: string[];
     static flags: {
         startDate: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
         endDate: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
-        exclude: import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        exclude: import("@oclif/core/lib/interfaces").OptionFlag<string[], import("@oclif/core/lib/interfaces/parser").CustomOptions>;
     };
     private _parseDateFlags;
     private _parseGitLogEntries;
     private _collapseAndSortCommitterInfo;
     private _printOutput;
-    run(): Promise<flagType<typeof CommitterGetAll>>;
+    run(): Promise<flagType<typeof ReportCommitters>>;
 }

package/dist/commands/{committer/get-all.js → report/committers.js}

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CommitterGetAll = void 0;
+exports.ReportCommitters = void 0;
 const core_1 = require("@oclif/core");
 const shared_1 = require("../../shared");
 const date_fns_1 = require("date-fns");
@@ -9,17 +9,10 @@ const monthsToSubtract = 12;
 const dateFmt = 'yyyy-MM-dd';
 const defaultStartDate = (0, date_fns_1.format)(new Date(), dateFmt);
 const defaultEndDate = (0, date_fns_1.format)((0, date_fns_1.subMonths)(new Date(), monthsToSubtract), dateFmt);
-const gitOutputFormat = `"${[
-    '%h',
-    '%an',
-    '%ad'
-].join(gammaDelimiter)}"`;
-class CommitterGetAll extends shared_1.BaseCommand {
+const gitOutputFormat = `"${['%h', '%an', '%ad'].join(gammaDelimiter)}"`;
+class ReportCommitters extends shared_1.BaseCommand {
     _parseDateFlags(startDate, endDate) {
-        return [
-            (0, date_fns_1.parse)(endDate, dateFmt, new Date()),
-            (0, date_fns_1.parse)(startDate, dateFmt, new Date()),
-        ];
+        return [(0, date_fns_1.parse)(endDate, dateFmt, new Date()), (0, date_fns_1.parse)(startDate, dateFmt, new Date())];
     }
     _parseGitLogEntries(entries) {
         return entries.map((entry) => {
@@ -38,7 +31,9 @@ class CommitterGetAll extends shared_1.BaseCommand {
         Object.keys(hash).forEach((name) => {
             sortable.push({ name, commits: hash[name] });
         });
-        return sortable.sort((a, b) => { return b.commits.length - a.commits.length; });
+        return sortable.sort((a, b) => {
+            return b.commits.length - a.commits.length;
+        });
     }
     _printOutput(committers) {
         if (!Object.keys(committers).length) {
@@ -52,12 +47,12 @@ class CommitterGetAll extends shared_1.BaseCommand {
             });
             this.log('\n');
         });
-        this.log('--------------------------------------------------\n');
+        this.log('---------------------------------------------------\n');
     }
     async run() {
-        const { flags } = await this.parse(CommitterGetAll);
+        const { flags } = (await this.parse(ReportCommitters));
         const dates = this._parseDateFlags(flags.startDate, flags.endDate);
-        const ignores = (flags.exclude && flags.exclude.length) ? `-- . "!(${flags.exclude.join('|')})"` : '';
+        const ignores = flags.exclude && flags.exclude.length ? `-- . "!(${flags.exclude.join('|')})"` : '';
         const gitCommand = `git log --since "${dates[0]}" --until "${dates[1]}" --pretty=format:${gitOutputFormat} ${ignores}`;
         const result = await (0, shared_1.run)(gitCommand);
         const committers = this._collapseAndSortCommitterInfo(result.split('\n'));
@@ -65,26 +60,22 @@ class CommitterGetAll extends shared_1.BaseCommand {
         return Promise.resolve();
     }
 }
-exports.CommitterGetAll = CommitterGetAll;
-CommitterGetAll.summary = 'Get Committers Between Two Dates';
-CommitterGetAll.usage = '<%= command.id %> [flags [-s][-e][-x]]';
-CommitterGetAll.examples = [
-    [
-        '<%= config.bin %> <%= command.id %>',
-    ].join('\n')
-];
-CommitterGetAll.flags = {
+exports.ReportCommitters = ReportCommitters;
+ReportCommitters.summary = 'Get Committers Between Two Dates';
+ReportCommitters.usage = '<%= command.id %> [flags [-s][-e][-x]]';
+ReportCommitters.examples = [['<%= config.bin %> <%= command.id %>'].join('\n')];
+ReportCommitters.flags = {
     startDate: core_1.Flags.string({
         char: 's',
         summary: `Start Date (format: yyyy-MM-dd)`,
         required: false,
-        default: () => defaultStartDate
+        default: () => defaultStartDate,
     }),
     endDate: core_1.Flags.string({
         char: 'e',
         summary: `End Date (format: yyyy-MM-dd)`,
         required: false,
-        default: () => defaultEndDate
+        default: () => defaultEndDate,
     }),
     exclude: core_1.Flags.string({
         char: 'x',

package/dist/commands/tracker/init.d.ts

@@ -0,0 +1,8 @@
+import { Command } from '@oclif/core';
+export declare class TrackerInit extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {};
+    static args: {};
+    run(): Promise<void>;
+}

package/dist/commands/tracker/init.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TrackerInit = void 0;
+const core_1 = require("@oclif/core");
+const initialize_1 = require("../../shared/tracker/initialize");
+const util_1 = require("../../shared/tracker/util");
+class TrackerInit extends core_1.Command {
+    async run() {
+        (0, initialize_1.initialize)((0, util_1.getTheRootDirectory)(global.process.cwd()));
+    }
+}
+exports.TrackerInit = TrackerInit;
+TrackerInit.description = 'Initialize the tracker configuration';
+TrackerInit.examples = ['<%= config.bin %> <%= command.id %>'];
+TrackerInit.flags = {};
+TrackerInit.args = {};

package/dist/commands/tracker/run.d.ts

@@ -0,0 +1,13 @@
+import { Command } from '@oclif/core';
+import { ChartConfig } from '../../shared/tracker/models/chart-config';
+export declare class TrackerRun extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        root: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        config: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        chart: import("@oclif/core/lib/interfaces").OptionFlag<ChartConfig, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+    };
+    static args: {};
+    run(): Promise<void>;
+}

package/dist/commands/tracker/run.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TrackerRun = void 0;
+const core_1 = require("@oclif/core");
+const path_1 = require("path");
+const util_1 = require("../../shared/tracker/util");
+const process_config_1 = require("../../shared/tracker/process-config");
+const chart_config_1 = require("../../shared/tracker/models/chart-config");
+class TrackerRun extends core_1.Command {
+    async run() {
+        const { flags } = await this.parse(TrackerRun);
+        const localRootDir = (0, util_1.getTheRootDirectory)(global.process.cwd());
+        const rootDirectory = flags.root ? (0, path_1.resolve)(flags.root) : localRootDir;
+        const config = (0, util_1.readConfig)(localRootDir, flags.config);
+        const results = await (0, process_config_1.processConfig)(config, rootDirectory);
+        (0, util_1.saveResults)(localRootDir, config.outputDir, results);
+        const allData = (0, util_1.getData)(localRootDir, config.outputDir);
+        const parentDir = (0, path_1.resolve)(localRootDir, config.outputDir);
+        const chartConfig = new chart_config_1.ChartConfig(flags.chart);
+        try {
+            await (0, util_1.createDataVizIn)(chartConfig, parentDir, allData);
+        }
+        catch (error) {
+            console.log('Error creating visualization');
+        }
+    }
+}
+exports.TrackerRun = TrackerRun;
+TrackerRun.description = 'Run the tracker';
+TrackerRun.examples = ['<%= config.bin %> <%= command.id %>'];
+TrackerRun.flags = {
+    root: core_1.Flags.string({ char: 'r', description: 'root dir of the project' }),
+    config: core_1.Flags.string({ char: 'c', description: 'path to config file' }),
+    chart: core_1.Flags.custom({
+        description: 'chart configuration',
+    })(),
+};
+TrackerRun.args = {};

package/dist/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@herodevs/cli",
-  "version": "0.1.15",
-  "description": "HeroDevs NES Developer Kit",
+  "version": "0.2.0",
+  "description": "HeroDevs CLI",
   "author": "@herodevs",
   "bin": {
     "@herodevs/cli": "./bin/run",
@@ -19,14 +19,20 @@
     "package.json"
   ],
   "dependencies": {
-    "@badisi/latest-version": "^6.1.10",
     "@oclif/core": "^2",
     "@oclif/plugin-help": "^5",
     "@oclif/plugin-plugins": "^3.2.0",
-    "clear-npx-cache": "^1.0.1",
+    "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",
+    "get-json": "^1.0.1",
+    "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",
@@ -49,13 +55,15 @@
     "dirname": "@herodevs/cli",
     "commands": "./dist/commands",
     "plugins": [
-      "@oclif/plugin-help",
-      "@oclif/plugin-plugins"
+      "@oclif/plugin-help"
     ],
     "topicSeparator": " ",
     "topics": {
-      "committer": {
-        "description": "Committer actions"
+      "report": {
+        "description": "Run reports for the current project (commands: committers)"
+      },
+      "tracker": {
+        "description": "Track project progress based upon lines of code (commands: init, run)"
       }
     }
   },
@@ -69,7 +77,7 @@
     "build": "shx rm -rf dist && tsc -b && shx cp package.json dist/package.json",
     "lint": "eslint . --ext .ts --config .eslintrc",
     "postpack": "shx rm -f oclif.manifest.json",
-    "posttest": "npm run lint",
+    "posttestXXX": "npm run lint",
     "prepack": "npm run build && oclif manifest && oclif readme",
     "test": "mocha --forbid-only \"test/**/*.test.ts\"",
     "version": "oclif readme && git add README.md",
@@ -107,5 +115,11 @@
   "keywords": [
     "oclif"
   ],
-  "types": "dist/index.d.ts"
+  "types": "dist/index.d.ts",
+  "prettier": {
+    "singleQuote": true,
+    "trailingComma": "es5",
+    "bracketSpacing": true,
+    "printWidth": 100
+  }
 }

package/dist/shared/command/base-command.d.ts

@@ -9,7 +9,7 @@ declare enum LogLevel {
 export declare abstract class BaseCommand<T extends typeof Command> extends Command {
     static enableJsonFlag: boolean;
     static baseFlags: {
-        'log-level': import("@oclif/core/lib/interfaces").OptionFlag<LogLevel | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        'log-level': import("@oclif/core/lib/interfaces").OptionFlag<LogLevel, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
     };
     protected flags: flagType<T>;
     protected args: argType<T>;