submodule-version 2.4.1 → 3.0.0

package/dist/src/versionUtil/versionUtil.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"versionUtil.js","sourceRoot":"","sources":["../../../src/versionUtil/versionUtil.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "submodule-version",
   "description": "Git <S>ubmodule <V>ersioning tool",
-  "version": "2.4.1",
+  "version": "3.0.0",
   "repository": "github:guljeny/submodule-version",
   "main": "dist/src/index.js",
   "bin": {
@@ -11,7 +11,7 @@
   "scripts": {
     "prepare": "npm run build",
     "test": "npx jest",
-    "build": "rm -rf ./dist && npx tsc",
+    "build": "rm -rf ./dist && npx tsc && chmod +x dist/runner/index.js",
     "lint": "npx eslint ./src"
   },
   "author": "Yauheni Hul",
@@ -25,6 +25,7 @@
   "license": "ISC",
   "devDependencies": {
     "@types/jest": "^29.5.13",
+    "@types/semver": "^7.5.8",
     "eslint": "9.9.1",
     "eslint-config-soft": "^1.0.5",
     "ts-jest": "^29.2.5",
@@ -33,6 +34,7 @@
   "dependencies": {
     "chalk": "^4.1.2",
     "jest": "^29.7.0",
+    "semver": "^7.6.3",
     "typescript": "^5.6.2",
     "yargs": "^17.7.2"
   }

package/runner/handleErrors/handleErrors.ts

@@ -1,13 +1,6 @@
-import { handleBuildGraphError } from './handleBuildGraphError';
-import { handleInstallError } from './handleInstallError';
-import { handleGitError } from './handleGitError';
+import { printError } from '../../src';
 import { log } from '../log';
 
-export const handleErrors = async (error: Error, gitUrl: string) => {
-  await Promise.all([
-    handleBuildGraphError(error),
-    handleInstallError(error, gitUrl),
-    handleGitError(error),
-  ]);
-  log.error('unhandled error', error.message);
+export const handleErrors = async (error: Error) => {
+  log.error(printError(error));
 };

package/runner/runner.ts

@@ -1,37 +1,106 @@
 import chalk from 'chalk';
 import yargs from 'yargs';
-import { SV } from '../src';
+import { SV, SVError } from '../src';
 import { log } from './log';
 import { handleErrors } from './handleErrors';
 
-const BASE_DIR = 'modules';
+/* 'A.B.C' → { name: 'C', parent: 'B' } (parent — непосредственный родитель) */
+const splitPath = (modulePath: string): { name: string, parent?: string } => {
+  const parts = modulePath.split('.');
+  const name = parts.pop() as string;
 
-const makeEvent = (event: (sv: SV, arg: any) => Promise<void>) => {
-  const sv = new SV(process.cwd(), BASE_DIR);
+  return { name, parent: parts.pop() };
+};
 
-  return async (arg: any) => {
-    const { url: gitUrl } = arg as {url: string};
+const makeEvent = (
+  event: (sv: SV, arg: any) => Promise<void>,
+  { skipInit = false } = {},
+) => async (arg: any) => {
+  const sv = new SV(process.cwd(), arg.modulesDir);
 
-    try {
-      await event(sv, arg);
-    } catch (e) {
-      handleErrors(e as Error, gitUrl);
+  try {
+    /* publish умеет работать с ещё не git/npm-инициализированным проектом */
+    if (!skipInit) {
+      await sv.init();
     }
-  };
+
+    await event(sv, arg);
+  } catch (e) {
+    handleErrors(e as Error);
+  }
 };
 
-const install = makeEvent(async (sv, arg) => {
-  const { url: gitUrl, target } = arg as {url: string, target?: string};
-  await sv.install(gitUrl, target);
+const put = makeEvent(async (sv, arg) => {
+  const { url: gitUrl, target, ver } = arg as {
+    url: string,
+    target?: string,
+    ver?: string,
+  };
+
+  await sv.put(gitUrl, ver || target, ver ? target : undefined);
 });
 
-const update = makeEvent(async sv => {
-  await sv.update();
+const update = makeEvent(async (sv, arg) => {
+  const { path: modulePath } = arg as { path?: string };
+
+  if (!modulePath) {
+    /* init внутри makeEvent уже пересобрал модули на максимально разрешённые */
+    log.message(chalk.green.bold('Modules are up to date!'));
+
+    return;
+  }
+
+  const { name, parent } = splitPath(modulePath);
+  const entry = sv.getResolution()[name];
+
+  if (!entry) throw new SVError('ADDON_NOT_FOUND', { name });
+
+  await sv.put(entry.url, '*', parent);
 });
 
-const remove = makeEvent(async (sv, arg) => {
-  const { name } = arg as {name: string};
-  await sv.remove(name);
+const del = makeEvent(async (sv, arg) => {
+  const { path: modulePath } = arg as {path: string};
+  const { name, parent } = splitPath(modulePath);
+
+  await sv.delete(name, parent);
+});
+
+const listVersions = makeEvent(async (sv, arg) => {
+  const { name, installed } = arg as { name?: string, installed?: boolean };
+
+  if (installed) {
+    const resolution = sv.getResolution();
+
+    if (name && !resolution[name]) {
+      throw new SVError('ADDON_NOT_FOUND', { name });
+    }
+
+    const names = name ? [name] : Object.keys(resolution);
+
+    await Promise.all(names.map(async moduleName => {
+      const version = await sv.currentVersion(moduleName);
+
+      log.message(
+        chalk.bold(moduleName),
+        version || chalk.red('no version tag'),
+      );
+    }));
+
+    return;
+  }
+
+  const versions = sv.listVersions(name);
+
+  if (name) {
+    log.message(chalk.bold(name), (versions as string[]).join(', '));
+
+    return;
+  }
+
+  Object.entries(versions as Record<string, string[]>)
+    .forEach(([moduleName, moduleVersions]) => {
+      log.message(chalk.bold(moduleName), moduleVersions.join(', '));
+    });
 });
 
 const publish = makeEvent(async (sv, arg) => {
@@ -50,59 +119,72 @@ const publish = makeEvent(async (sv, arg) => {
     chalk.green.bold('version'),
     chalk.bgGreen.black(` ${version} `),
   );
-});
+}, { skipInit: true });
 
 const validate = makeEvent(async sv => {
-  const result = await sv.buildGraph();
-
-  Object.entries(result).forEach(([name, entry]) => {
-    if (!entry.used.includes(entry.version) && entry.versions.length === 0) {
-      log.message(
-        chalk.yellow('⚠️  WARN: Module'),
-        chalk.bgYellow.black(` ${name} `),
-        chalk.yellow('does not contain any version tag!'),
-      );
-    }
-  });
+  sv.getResolution();
 
   log.message(chalk.green.bold('Everything is up to date!🔥'));
 });
 
-// eslint-disable-next-line @typescript-eslint/no-unused-expressions
 export const s = yargs.scriptName('sv')
-  .usage('$0 <cmd> [args]')
+  .usage('$0 [cmd] [args]')
+  .option('modules-dir', {
+    type: 'string',
+    describe: 'Directory where submodules live'
+      + ' (stored in package.json as sv-dir)',
+  })
   .command(
-    ['validate', '$0', 'v'],
+    ['$0'],
     'Validate and install modules',
     () => {},
     validate,
   )
   .command(
-    ['update', 'u'],
-    'Update git modules to actual versions',
-    () => {},
+    ['update [path]', 'u'],
+    'Update modules to the latest allowed versions',
+    y => y.positional('path', {
+      type: 'string',
+      describe: 'Module path (A.B.C), all modules when omitted',
+    }),
     update,
   )
   .command(
-    ['install <url> [target]', 'i'],
-    'Install new submodule',
+    ['put <url> [target]', 'install', 'i'],
+    'Install a submodule or change its version',
     y => y.positional('url', {
       type: 'string',
-      describe: 'Git submodule url',
+      describe: 'Git submodule url or installed module name',
     }).positional('target', {
       type: 'string',
-      describe: 'Target module name',
+      describe: 'Parent module name',
+    }).option('ver', {
+      type: 'string',
+      alias: 'v',
+      describe: 'Version to install',
+    }),
+    put,
+  )
+  .command(
+    ['delete <path>', 'remove', 'r'],
+    'Delete submodule by path',
+    y => y.positional('path', {
+      type: 'string',
+      describe: 'Submodule path (A.B.C)',
     }),
-    install,
+    del,
   )
   .command(
-    ['remove <name>', 'r'],
-    'Remove submodule by name',
+    ['list-versions [name]', 'ls'],
+    'List available versions of all modules or one',
     y => y.positional('name', {
       type: 'string',
-      describe: 'Submodule name',
+      describe: 'Module name',
+    }).option('installed', {
+      type: 'boolean',
+      describe: 'Show installed versions instead of available',
     }),
-    remove,
+    listVersions,
   )
   .command(
     ['publish [module]', 'p'],