@vlandoss/run-run 0.0.11 → 0.0.12

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vlandoss/run-run",
-  "version": "0.0.11",
+  "version": "0.0.12",
   "description": "The CLI toolbox to fullstack common scripts in Variable Land",
   "homepage": "https://github.com/variableland/dx/tree/main/packages/run-run#readme",
   "bugs": {
@@ -31,6 +31,7 @@
     "commander": "13.1.0",
     "glob": "^11.0.2",
     "is-ci": "4.1.0",
+    "memoize": "^10.2.0",
     "rimraf": "6.0.1",
     "typescript": "5.8.2",
     "@vlandoss/clibuddy": "0.0.5",

package/src/program/__tests__/__snapshots__/snapshots.test.ts.snap

@@ -1,6 +1,6 @@
 // Bun Snapshot v1, https://goo.gl/fbAQLP
 
-exports[`should match command: "help" 1`] = `
+exports[`should match all root commands: root-command-help 1`] = `
 "🦊 R U N - R U N: The CLI toolbox to fullstack common scripts in Variable Land 👊
 
 Usage: rr|run-run [options] <command...>
@@ -16,6 +16,8 @@ Commands:
   tsc|typecheck                check if TypeScript code is well typed 🎨
   clean [options]              delete dirty folders or files such as
                                node_modules, etc 🗑️
+  pkgs|packages [options]      list unique affected packages from list of files
+                               📦
   help [command]               display help for command
 
 Acknowledgment:
@@ -27,7 +29,7 @@ Acknowledgment:
 "
 `;
 
-exports[`should match command: "--help" 1`] = `
+exports[`should match all root commands: root-command---help 1`] = `
 "🦊 R U N - R U N: The CLI toolbox to fullstack common scripts in Variable Land 👊
 
 Usage: rr|run-run [options] <command...>
@@ -43,6 +45,8 @@ Commands:
   tsc|typecheck                check if TypeScript code is well typed 🎨
   clean [options]              delete dirty folders or files such as
                                node_modules, etc 🗑️
+  pkgs|packages [options]      list unique affected packages from list of files
+                               📦
   help [command]               display help for command
 
 Acknowledgment:
@@ -54,17 +58,17 @@ Acknowledgment:
 "
 `;
 
-exports[`should match command: "--version" 1`] = `
+exports[`should match all root commands: root-command---version 1`] = `
 "0.0.0-test
 "
 `;
 
-exports[`should match command: "-v" 1`] = `
+exports[`should match all root commands: root-command--v 1`] = `
 "0.0.0-test
 "
 `;
 
-exports[`should match help message for command "run" 1`] = `
+exports[`should match help messages for all commands: help-command-run 1`] = `
 "Usage: rr run [options] <cmds...>
 
 Arguments:
@@ -75,7 +79,7 @@ Options:
 "
 `;
 
-exports[`should match help message for command "check" 1`] = `
+exports[`should match help messages for all commands: help-command-check 1`] = `
 "Usage: rr check|test:static [options]
 
 check format and lint issues 🔍
@@ -89,7 +93,7 @@ Under the hood, this command uses the biome CLI to check the code.
 "
 `;
 
-exports[`should match help message for command "lint" 1`] = `
+exports[`should match help messages for all commands: help-command-lint 1`] = `
 "Usage: rr lint [options]
 
 lint the code 🧹
@@ -103,7 +107,7 @@ Under the hood, this command uses the biome CLI to lint the code.
 "
 `;
 
-exports[`should match help message for command "fmt" 1`] = `
+exports[`should match help messages for all commands: help-command-fmt 1`] = `
 "Usage: rr fmt|format [options]
 
 format the code 🎨
@@ -117,7 +121,7 @@ Under the hood, this command uses the biome CLI to format the code.
 "
 `;
 
-exports[`should match help message for command "tsc" 1`] = `
+exports[`should match help messages for all commands: help-command-tsc 1`] = `
 "Usage: rr tsc|typecheck [options]
 
 check if TypeScript code is well typed 🎨
@@ -129,7 +133,7 @@ Under the hood, this command uses the TypeScript CLI to check the code.
 "
 `;
 
-exports[`should match help message for command "clean" 1`] = `
+exports[`should match help messages for all commands: help-command-clean 1`] = `
 "Usage: rr clean [options]
 
 delete dirty folders or files such as node_modules, etc 🗑️
@@ -143,7 +147,19 @@ Under the hood, this command uses the rimraf.js to delete dirty folders or files
 "
 `;
 
-exports[`should match help message for command "tools" 1`] = `
+exports[`should match help messages for all commands: help-command-pkgs 1`] = `
+"Usage: rr pkgs|packages [options]
+
+list unique affected packages from list of files 📦
+
+Options:
+  --files <files...>  list of files to check
+  --decorator [type]  type of decorator to use (choices: "turbo")
+  -h, --help          display help for command
+"
+`;
+
+exports[`should match help messages for all commands: help-command-tools 1`] = `
 "Usage: rr tools [options] [command]
 
 expose the internal tools 🛠️

package/src/program/__tests__/snapshots.test.ts

@@ -1,5 +1,5 @@
 import { afterEach, expect, test } from "bun:test";
-import { createTestProgram, execCli, mocked } from "test/helpers";
+import { createTestProgram, execCli, mocked } from "#test/helpers";
 
 const { program, ctx } = await createTestProgram();
 const $ = ctx.shell.$;
@@ -10,20 +10,29 @@ afterEach(() => {
   mocked($).mockClear();
 });
 
-for (const cmd of rootCommands) {
-  test(`should match command: "${cmd}"`, async () => {
-    const { stdout } = await execCli(cmd);
-
-    expect(stdout).toMatchSnapshot();
-  });
-}
-
-for (const command of program.commands) {
-  const cmd = command.name();
-
-  test(`should match help message for command "${cmd}"`, async () => {
-    const { stdout } = await execCli(`${cmd} --help`);
+test("should match all root commands", async () => {
+  const results = await Promise.all(
+    rootCommands.map(async (cmd) => {
+      const { stdout } = await execCli(cmd);
+      return { cmd, output: stdout };
+    }),
+  );
+
+  for (const { cmd, output } of results) {
+    expect(output).toMatchSnapshot(`root-command-${cmd}`);
+  }
+});
 
-    expect(stdout).toMatchSnapshot();
-  });
-}
+test("should match help messages for all commands", async () => {
+  const results = await Promise.all(
+    program.commands.map(async (command) => {
+      const cmd = command.name();
+      const { stdout } = await execCli(`${cmd} --help`);
+      return { cmd, output: stdout };
+    }),
+  );
+
+  for (const { cmd, output } of results) {
+    expect(output).toMatchSnapshot(`help-command-${cmd}`);
+  }
+});

package/src/program/commands/check.ts

@@ -1,7 +1,7 @@
 import { createCommand } from "commander";
 import isCI from "is-ci";
-import { BiomeService } from "~/services/biome";
-import type { Context } from "~/services/ctx";
+import { BiomeService } from "#/services/biome";
+import type { Context } from "#/services/ctx";
 
 export function createCheckCommand(ctx: Context) {
   return createCommand("check")

package/src/program/commands/clean.ts

@@ -2,7 +2,7 @@ import { cwd } from "@vlandoss/clibuddy";
 import { createCommand } from "commander";
 import { type GlobOptions, glob } from "glob";
 import { rimraf } from "rimraf";
-import { logger } from "~/services/logger";
+import { logger } from "#/services/logger";
 
 type Options = {
   onlyDist: boolean;

package/src/program/commands/format.ts

@@ -1,6 +1,6 @@
 import { createCommand } from "commander";
-import { BiomeService } from "~/services/biome";
-import type { Context } from "~/services/ctx";
+import { BiomeService } from "#/services/biome";
+import type { Context } from "#/services/ctx";
 
 export function createFormatCommand(ctx: Context) {
   return createCommand("fmt")

package/src/program/commands/lint.ts

@@ -1,6 +1,6 @@
 import { createCommand } from "commander";
-import { BiomeService } from "~/services/biome";
-import type { Context } from "~/services/ctx";
+import { BiomeService } from "#/services/biome";
+import type { Context } from "#/services/ctx";
 
 export function createLintCommand(ctx: Context) {
   return createCommand("lint")

package/src/program/commands/pkgs.ts

@@ -0,0 +1,75 @@
+import path from "node:path";
+import { type Command, createCommand, Option } from "commander";
+import memoize from "memoize";
+import type { Context } from "#/services/ctx";
+import { logger } from "#/services/logger";
+
+// Currently only "turbo" is supported, but this can be extended in the future
+const decorators = ["turbo"] as const;
+
+type Options = {
+  files: string[];
+  decorator?: (typeof decorators)[number];
+};
+
+export function createPkgsCommand(ctx: Context) {
+  return createCommand("pkgs")
+    .alias("packages")
+    .description("list unique affected packages from list of files 📦")
+    .addOption(new Option("--files <files...>", "list of files to check"))
+    .addOption(new Option("--decorator [type]", "type of decorator to use").choices(decorators))
+    .action(async function pkgsAction({ files, decorator }: Options, cmd: Command) {
+      const { appPkg } = ctx;
+
+      if (!appPkg.isMonorepo()) {
+        const cmdName = cmd.parent?.args[0] ?? cmd.args[0] ?? cmd.name();
+        logger.error(`The \`${cmdName}\` command can only be run in a monorepo.`);
+        return process.exit(1);
+      }
+
+      const projects = await appPkg.getWorkspaceProjects();
+
+      const getRelativeRootDir = memoize((rootDir: string) => {
+        const appDir = appPkg.dirPath;
+
+        if (!path.isAbsolute(rootDir)) {
+          return rootDir;
+        }
+
+        return path.relative(appDir, rootDir);
+      });
+
+      function getPackageForFile(filePath: string) {
+        for (const project of projects) {
+          const relativeRootDir = getRelativeRootDir(project.rootDir);
+
+          if (filePath.startsWith(relativeRootDir)) {
+            return project;
+          }
+        }
+
+        return null;
+      }
+
+      const uniquePkgsNames = new Set<string>();
+
+      files.forEach((file) => {
+        const pkg = getPackageForFile(file);
+        if (pkg?.manifest.name) {
+          uniquePkgsNames.add(pkg.manifest.name);
+        }
+      });
+
+      if (!uniquePkgsNames.size) {
+        return;
+      }
+
+      const pkgsNames = Array.from(uniquePkgsNames);
+
+      if (decorator === "turbo") {
+        console.log(...pkgsNames.map((name) => `--filter=...${name}`));
+      } else {
+        console.log(...pkgsNames);
+      }
+    });
+}

package/src/program/commands/run.ts

@@ -1,5 +1,5 @@
 import { createCommand } from "commander";
-import type { Context } from "~/services/ctx";
+import type { Context } from "#/services/ctx";
 
 export function createRunCommand(ctx: Context) {
   const program = createCommand("run")

package/src/program/commands/tools.ts

@@ -1,6 +1,6 @@
 import { createCommand } from "commander";
-import { BiomeService } from "~/services/biome";
-import type { Context } from "~/services/ctx";
+import { BiomeService } from "#/services/biome";
+import type { Context } from "#/services/ctx";
 
 function createToolCommand(toolBin: string) {
   // biome-ignore format: I prefer multi-line here

package/src/program/commands/typecheck.ts

@@ -1,7 +1,7 @@
 import type { Project } from "@vlandoss/clibuddy";
 import { createCommand } from "commander";
-import type { Context } from "~/services/ctx";
-import { logger } from "~/services/logger";
+import type { Context } from "#/services/ctx";
+import { logger } from "#/services/logger";
 
 export function createTypecheckCommand(ctx: Context) {
   return createCommand("tsc")

package/src/program/index.ts

@@ -1,10 +1,11 @@
 import { getVersion } from "@vlandoss/clibuddy";
 import { createCommand } from "commander";
-import { createContext } from "~/services/ctx";
+import { createContext } from "#/services/ctx";
 import { createCheckCommand } from "./commands/check";
 import { createCleanCommand } from "./commands/clean";
 import { createFormatCommand } from "./commands/format";
 import { createLintCommand } from "./commands/lint";
+import { createPkgsCommand } from "./commands/pkgs";
 import { createRunCommand } from "./commands/run";
 import { createToolsCommand } from "./commands/tools";
 import { createTypecheckCommand } from "./commands/typecheck";
@@ -31,6 +32,7 @@ export async function createProgram(options: Options) {
     .addCommand(createFormatCommand(ctx))
     .addCommand(createTypecheckCommand(ctx))
     .addCommand(createCleanCommand())
+    .addCommand(createPkgsCommand(ctx))
     .addCommand(createToolsCommand(ctx), {
       hidden: true,
     });

package/src/services/biome.ts

@@ -1,5 +1,5 @@
 import type { ShellService } from "@vlandoss/clibuddy";
-import { gracefullBinDir } from "~/utils/gracefullBinDir";
+import { gracefullBinDir } from "#/utils/gracefullBinDir";
 import type { ToolService } from "./models";
 
 export class BiomeService implements ToolService {

package/src/utils/gracefullBinDir.ts

@@ -1,6 +1,6 @@
 import fs from "node:fs";
 import path from "node:path";
-import { logger } from "~/services/logger";
+import { logger } from "#/services/logger";
 
 export function gracefullBinDir(binPathResolver: () => string) {
   try {

package/tsconfig.json

@@ -3,8 +3,8 @@
   "compilerOptions": {
     "baseUrl": ".",
     "paths": {
-      "~/*": ["./src/*"],
-      "test/*": ["./test/*"],
+      "#/*": ["./src/*"],
+      "#test/*": ["./test/*"],
       "@vlandoss/*": ["../../packages/*/src"]
     }
   }