@travetto/cli 3.1.0-rc.2 → 3.1.0-rc.3

package/README.md

@@ -22,32 +22,35 @@ $ trv --help
 Usage:  [options] [command]
 
 Commands:
-  doc            Command line support for generating module docs.
-  doc:angular    Generate documentation into the angular webapp under related/travetto.github.io
-  doc:mapping    Generate module mapping for @travetto/doc
-  email:compile  CLI Entry point for running the email server
-  email:editor   The email editor compilation service and output serving
-  exec           Repo execution
-  lint           Command line support for linting
-  lint:register  Writes the lint configuration file
-  list           Allows for listing of modules
-  model:export   Exports model schemas
-  model:install  Installing models
-  openapi:client CLI for generating the cli client
-  openapi:spec   CLI for outputting the open api spec to a local file
-  pack           Standard pack support
-  pack:docker    Standard docker support for pack
-  pack:lambda    Standard lambda support for pack
-  pack:zip       Standard zip support for pack
-  repo:publish   Publish all pending modules
-  repo:version   Version all changed dependencies
-  run:double     Doubles a number
-  run:rest       Run a rest server as an application
-  scaffold       Command to run scaffolding
-  service        Allows for running services
-  test           Launch test framework and execute tests
-  test:watch     Invoke the test watcher
-  version-sync   Enforces all packages to write out their versions and dependencies
+  doc               Command line support for generating module docs.
+  doc:angular       Generate documentation into the angular webapp under related/travetto.github.io
+  doc:mapping       Generate module mapping for @travetto/doc
+  email:compile     CLI Entry point for running the email server
+  email:editor      The email editor compilation service and output serving
+  exec              Repo execution
+  lint              Command line support for linting
+  lint:register     Writes the lint configuration file
+  list              Allows for listing of modules
+  model:export      Exports model schemas
+  model:install     Installing models
+  openapi:client    CLI for generating the cli client
+  openapi:spec      CLI for outputting the open api spec to a local file
+  pack              Standard pack support
+  pack:docker       Standard docker support for pack
+  pack:lambda       Standard lambda support for pack
+  pack:zip          Standard zip support for pack
+  repo:exec         Repo execution
+  repo:list         Allows for listing of modules
+  repo:publish      Publish all pending modules
+  repo:version      Version all changed dependencies
+  repo:version-sync Enforces all packages to write out their versions and dependencies
+  run:double        Doubles a number
+  run:rest          Run a rest server as an application
+  scaffold          Command to run scaffolding
+  service           Allows for running services
+  test              Launch test framework and execute tests
+  test:watch        Invoke the test watcher
+  version-sync      Enforces all packages to write out their versions and dependencies
 ```
 
 This listing is from the [Travetto](https://travetto.dev) monorepo, and represents the majority of tools that can be invoked from the command line. 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@travetto/cli",
-  "version": "3.1.0-rc.2",
+  "version": "3.1.0-rc.3",
   "description": "CLI infrastructure for Travetto framework",
   "keywords": [
     "cli",
@@ -24,9 +24,8 @@
     "directory": "module/cli"
   },
   "dependencies": {
-    "@travetto/schema": "^3.1.0-rc.2",
-    "@travetto/terminal": "^3.1.0-rc.0",
-    "@travetto/worker": "^3.1.0-rc.0"
+    "@travetto/schema": "^3.1.0-rc.3",
+    "@travetto/terminal": "^3.1.0-rc.0"
   },
   "travetto": {
     "displayName": "Command Line Interface"

package/src/decorators.ts

@@ -39,7 +39,7 @@ export function CliCommand(cfg: { fields?: ExtraFields[], runTarget?: boolean, h
         if (addEnv) { defineGlobalEnv({ envName: cmd.env }); }
         if (addProfile) { defineGlobalEnv({ profiles: cmd.profile }); }
         if (addEnv || addProfile) { ConsoleManager.setDebugFromEnv(); }
-        if (addModule && cmd.module && cmd.module !== RootIndex.mainModule.name) { // Mono-repo support
+        if (addModule && cmd.module && cmd.module !== RootIndex.mainModuleName) { // Mono-repo support
           RootIndex.reinitForModule(cmd.module); // Reinit with specified module
         }
       }

package/src/module.ts

@@ -1,32 +1,11 @@
-import { ColorDefineUtil, NAMED_COLORS, Terminal, GlobalTerminal, TermLinePosition } from '@travetto/terminal';
-import { Env, ExecutionOptions, ExecutionResult, ExecutionState, TypedObject } from '@travetto/base';
-import { IndexedModule, PackageUtil, RootIndex } from '@travetto/manifest';
-import { IterableWorkSet, WorkPool, type Worker } from '@travetto/worker';
+import { IndexedModule, RootIndex } from '@travetto/manifest';
 
 import { CliScmUtil } from './scm';
 import { CliValidationError } from './types';
 import { CliUtil } from './util';
 
-type ModuleRunConfig<T = ExecutionResult> = {
-  progressMessage?: (mod: IndexedModule | undefined) => string;
-  filter?: (mod: IndexedModule) => boolean | Promise<boolean>;
-  transformResult?: (mod: IndexedModule, result: ExecutionResult) => T;
-  workerCount?: number;
-  progressPosition?: TermLinePosition;
-  prefixOutput?: boolean;
-  showStdout?: boolean;
-  showStderr?: boolean;
-};
-
 type ModuleGraphEntry = { children: Set<string>, name: string, active: Set<string>, parents?: string[] };
 
-const COLORS = TypedObject.keys(NAMED_COLORS)
-  .map(k => [k, ColorDefineUtil.defineColor(k).hsl] as const)
-  .filter(([, [, s, l]]) => l > .5 && l < .8 && s > .8)
-  .map(([k]) => GlobalTerminal.colorer(k));
-
-const colorize = (val: string, idx: number): string => COLORS[idx % COLORS.length](val);
-
 const modError = (message: string): CliValidationError => ({ source: 'flag', message: `module: ${message}` });
 
 /**
@@ -34,45 +13,6 @@ const modError = (message: string): CliValidationError => ({ source: 'flag', mes
  */
 export class CliModuleUtil {
 
-  /**
-   * Generate execution options for running on modules
-   */
-  static #buildExecutionOptions<T = ExecutionState>(
-    mod: IndexedModule,
-    config: ModuleRunConfig<T>,
-    prefixes: Record<string, string>,
-    stdoutTerm: Terminal,
-    stderrTerm: Terminal
-  ): ExecutionOptions {
-    const folder = mod.sourceFolder;
-    const opts: ExecutionOptions = {
-      stdio: ['ignore', 'pipe', 'pipe', 'ignore'],
-      outputMode: 'text',
-      catchAsResult: true,
-      cwd: folder,
-      env: { TRV_MANIFEST: '', TRV_MODULE: mod.name },
-    };
-
-    if (config.showStdout) {
-      opts.onStdOutLine = (line: string): unknown => stdoutTerm.writeLines(`${prefixes[folder] ?? ''}${line}`);
-    }
-    if (config.showStderr) {
-      opts.onStdErrorLine = (line: string): unknown => stderrTerm.writeLines(`${prefixes[folder] ?? ''}${line}`);
-    }
-    return opts;
-  }
-
-  /**
-   * Build equal sized prefix labels for outputting
-   * @param mods
-   * @returns
-   */
-  static #buildPrefixes(mods: IndexedModule[]): Record<string, string> {
-    const folders = mods.map(x => x.sourceFolder);
-    const maxWidth = Math.max(...folders.map(x => x.length));
-    return Object.fromEntries(folders.map((x, i) => [x, colorize(x.padStart(maxWidth, ' ').padEnd(maxWidth + 1), i)]));
-  }
-
   /**
    * Find modules that changed, and the dependent modules
    * @param hash
@@ -115,86 +55,6 @@ export class CliModuleUtil {
     ).filter(x => x.sourcePath !== RootIndex.manifest.workspacePath);
   }
 
-  /**
-   * Synchronize all workspace modules to have the correct versions from the current packages
-   */
-  static async synchronizeModuleVersions(): Promise<Record<string, string>> {
-    const versions = {};
-    await PackageUtil.syncVersions((await this.findModules('all')).map(x => x.sourcePath), versions);
-    return versions;
-  }
-
-  /**
-   * Run on all modules
-   */
-  static async execOnModules<T = ExecutionResult>(
-    mode: 'all' | 'changed',
-    operation: (mod: IndexedModule, options: ExecutionOptions) => ExecutionState,
-    config: ModuleRunConfig<T> = {}
-  ): Promise<Map<IndexedModule, T>> {
-
-    config.showStdout = config.showStdout ?? (Env.isSet('DEBUG') && !Env.isFalse('DEBUG'));
-    config.showStderr = config.showStderr ?? true;
-
-    const workerCount = config.workerCount ?? WorkPool.DEFAULT_SIZE;
-
-    const mods = await CliModuleUtil.findModules(mode);
-    const results = new Map<IndexedModule, T>();
-    const processes = new Map<IndexedModule, ExecutionState>();
-
-    const prefixes = config.prefixOutput !== false ? this.#buildPrefixes(mods) : {};
-    const stdoutTerm = await Terminal.for({ output: process.stdout });
-    const stderrTerm = await Terminal.for({ output: process.stderr });
-
-    let id = 1;
-    const pool = new WorkPool(async () => {
-      const worker: Worker<IndexedModule> & { mod?: IndexedModule } = {
-        id: id += 1,
-        mod: undefined,
-        active: false,
-        async destroy() {
-          this.active = false;
-          processes.get(this.mod!)?.process.kill('SIGKILL');
-        },
-        async execute(mod: IndexedModule) {
-          try {
-            this.mod = mod;
-            this.active = true;
-
-            if (await config.filter?.(mod) === false) {
-              this.active = false;
-            } else {
-              const opts = CliModuleUtil.#buildExecutionOptions(mod, config, prefixes, stdoutTerm, stderrTerm);
-
-              const result = await operation(mod, opts).result;
-
-              // eslint-disable-next-line @typescript-eslint/consistent-type-assertions
-              const output = (config.transformResult ? config.transformResult(mod, result) : result) as T;
-              results.set(mod, output);
-            }
-          } finally {
-            this.active = false;
-            delete this.mod;
-          }
-        },
-      };
-      return worker;
-    }, { max: workerCount, min: workerCount });
-
-    const work = pool.iterateProcess(new IterableWorkSet(mods));
-
-    if (config.progressMessage) {
-      const cfg = { position: config.progressPosition ?? 'bottom' } as const;
-      await stdoutTerm.trackProgress(work, ev => ({ ...ev, text: config.progressMessage!(ev.value) }), cfg);
-    } else {
-      for await (const _ of work) {
-        // Ensure its all consumed
-      }
-    }
-
-    return results;
-  }
-
   /**
    * Get module dependency graph, fully collapsed
    */

package/src/util.ts

@@ -12,7 +12,7 @@ export class CliUtil {
    * Get a simplified version of a module name
    * @returns
    */
-  static getSimpleModuleName(name = RootIndex.mainPackage.name): string {
+  static getSimpleModuleName(name = RootIndex.mainModuleName): string {
     return name.replace(/[\/]/, '_').replace(/@/, '');
   }
 }

package/support/cli.exec.ts

@@ -1,55 +0,0 @@
-import { CliCommand, CliCommandShape, CliModuleUtil } from '@travetto/cli';
-import { WorkPool } from '@travetto/worker';
-import { RootIndex } from '@travetto/manifest';
-import { ExecUtil, GlobalEnvConfig } from '@travetto/base';
-import { Max, Min } from '@travetto/schema';
-
-/**
- * Repo execution
- */
-@CliCommand()
-export class RepoExecCommand implements CliCommandShape {
-
-  #unknownArgs?: string[];
-
-  /** Only changed modules */
-  changed = true;
-
-  /** Number of concurrent workers */
-  @Min(1) @Max(WorkPool.MAX_SIZE)
-  workers = WorkPool.DEFAULT_SIZE;
-
-  /** Prefix output by folder */
-  prefixOutput = true;
-
-  /** Show stdout */
-  showStdout = true;
-
-  isActive(): boolean {
-    return !!RootIndex.manifest.monoRepo;
-  }
-
-  envInit(): GlobalEnvConfig {
-    return { debug: false };
-  }
-
-  finalize(unknownArgs?: string[] | undefined): void | Promise<void> {
-    this.#unknownArgs = unknownArgs;
-  }
-
-  async main(cmd: string, args: string[]): Promise<void> {
-    const finalArgs = [...args, ...this.#unknownArgs ?? []];
-
-    await CliModuleUtil.execOnModules(
-      this.changed ? 'changed' : 'all',
-      // eslint-disable-next-line @typescript-eslint/consistent-type-assertions
-      (mod, opts) => ExecUtil.spawn(cmd, finalArgs, opts),
-      {
-        progressMessage: mod => `Running '${cmd} ${finalArgs.join(' ')}' [%idx/%total] ${mod?.sourceFolder ?? ''}`,
-        showStdout: this.showStdout,
-        prefixOutput: this.prefixOutput,
-        workerCount: this.workers,
-      }
-    );
-  }
-}

package/support/cli.list.ts

@@ -1,51 +0,0 @@
-import { CliCommandShape, CliCommand, CliModuleUtil } from '@travetto/cli';
-import { RootIndex } from '@travetto/manifest';
-
-const write = (line: string): Promise<void> => new Promise(r => process.stdout.write(`${line}\n`, () => r()));
-
-/**
- * Allows for listing of modules
- */
-@CliCommand()
-export class ListModuleCommand implements CliCommandShape {
-
-  /** Only show changed modules */
-  changed = false;
-
-  /** Output format */
-  format: 'graph' | 'json' | 'list' = 'list';
-
-  isActive(): boolean {
-    return !!RootIndex.manifest.monoRepo;
-  }
-
-  async main(): Promise<void> {
-
-    const mods = await CliModuleUtil.findModules(this.changed ? 'changed' : 'all');
-    switch (this.format) {
-      case 'list': {
-        for (const mod of mods.map(x => x.sourceFolder).sort()) {
-          await write(mod);
-        }
-        break;
-      }
-      case 'json': {
-        const outputMap = CliModuleUtil.getDependencyGraph(mods);
-        await write(JSON.stringify(Object.entries(outputMap).map(([name, children]) => ({ name, children, local: RootIndex.getModule(name)?.local })), null, 2));
-        break;
-      }
-      case 'graph': {
-        await write('digraph g {');
-        for (const el of mods) {
-          for (const dep of el.parents) {
-            if (dep !== RootIndex.mainPackage.name) {
-              await write(`  "${dep}" -> "${el.name}";`);
-            }
-          }
-        }
-        await write('}');
-        break;
-      }
-    }
-  }
-}

package/support/cli.version-sync.ts

@@ -1,16 +0,0 @@
-import { CliCommandShape, CliCommand, CliModuleUtil } from '@travetto/cli';
-import { RootIndex } from '@travetto/manifest';
-
-/**
- * Enforces all packages to write out their versions and dependencies
- */
-@CliCommand()
-export class VersionSyncCommand implements CliCommandShape {
-  isActive(): boolean {
-    return !!RootIndex.manifest.monoRepo;
-  }
-
-  async main(): Promise<void> {
-    await CliModuleUtil.synchronizeModuleVersions();
-  }
-}