submodule-version 2.0.3 → 2.1.0

package/dist/src/sv.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SV = void 0;
+const PkgJSONManager_1 = require("./PkgJSONManager");
+const Graph_1 = require("./Graph");
+const runOptions_1 = require("./runOptions");
+const versionUtil_1 = require("./versionUtil");
+const git_1 = require("./git");
+class SV {
+    constructor(projectDir, modulesDir = 'addons') {
+        this.buildGraph = () => this.graph.build();
+        this.install = async (gitUrl, parentModule) => {
+            const { url, version, name } = git_1.git.parseUrl(gitUrl);
+            if (!name) {
+                throw new Error('NOT_A_GIT_URL');
+            }
+            const targetPkg = await this.pkgJSONManager.read(parentModule);
+            let installedPkg = await this.pkgJSONManager.read(name);
+            if (!installedPkg) {
+                await git_1.git.addSumbmodule(url);
+                installedPkg = this.pkgJSONManager.read(name);
+            }
+            const versions = await git_1.git.listVersions(name);
+            const latestVersion = versionUtil_1.versionUtil.latest(versions);
+            const requestedVersion = version || latestVersion;
+            if (!versions.includes(requestedVersion) && versions.length) {
+                throw new Error('REQUESTED_VERSION_NOT_EXISTS');
+            }
+            if (!targetPkg.sv) {
+                targetPkg.sv = {};
+            }
+            targetPkg.sv[url] = requestedVersion ? `^${requestedVersion}` : '*';
+            await this.pkgJSONManager.write(targetPkg, parentModule);
+            await this.graph.build();
+        };
+        this.update = async () => {
+            const graph = await this.graph.build();
+            if (!graph)
+                return;
+            await Promise.all(Object.entries(graph).map(async ([name, data]) => {
+                const { version, used } = data;
+                const latestVersion = versionUtil_1.versionUtil.latest(used);
+                if (latestVersion !== version) {
+                    await git_1.git.checkout(name, latestVersion);
+                }
+            }));
+        };
+        runOptions_1.RunOptions.cwd = projectDir;
+        runOptions_1.RunOptions.modulesDir = modulesDir;
+        this.pkgJSONManager = new PkgJSONManager_1.PkgJSONManager();
+        this.graph = new Graph_1.Graph(this.pkgJSONManager);
+    }
+}
+exports.SV = SV;
+//# sourceMappingURL=sv.js.map

package/dist/src/sv.js.map

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

package/dist/src/versionUtil.js.map

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

package/index-dev.ts

@@ -4,4 +4,4 @@ import chalk from 'chalk';
 import { log } from './src/log';
 
 log.message(chalk.bgRed.white.bold(' RUNNED IN DEV MODE '));
-import './src/submoduleVersion';
+import './src/runner';

package/index.ts

@@ -1,3 +1,3 @@
 #!/usr/bin/env node
 
-import './src/submoduleVersion';
+import './src/runner';

package/package.json

@@ -1,7 +1,9 @@
 {
   "name": "submodule-version",
   "description": "Git <S>ubmodule <V>ersioning tool",
-  "version": "2.0.3",
+  "version": "2.1.0",
+  "repository": "github:guljeny/submodule-version",
+  "main": "dist/src/index.js",
   "bin": {
     "sv": "dist/index.js",
     "sv-dev": "index-dev.ts"
@@ -9,10 +11,17 @@
   "scripts": {
     "prepare": "npm run build",
     "test": "npx jest",
-    "build": "npx tsc",
+    "build": "rm -rf ./dist && npx tsc",
     "lint": "npx eslint ./src"
   },
-  "author": "",
+  "author": "Yauheni Hul",
+  "keywords": [
+    "git",
+    "submodules",
+    "sv",
+    "version",
+    "version control"
+  ],
   "license": "ISC",
   "devDependencies": {
     "@types/jest": "^29.5.13",

package/src/Graph/Graph.ts

@@ -0,0 +1,121 @@
+import fs from 'fs';
+import path from 'path';
+import { PkgJSONManager } from '../PkgJSONManager';
+import { versionUtil } from '../versionUtil';
+import { git } from '../git';
+import { RunOptions } from '../runOptions';
+import { GraphError } from './GraphError';
+
+type TSV = Record<string, string>;
+
+interface ITreeEntry {
+  meta: {
+    version: string;
+    sv: TSV;
+  };
+  parents: Record<string, string>;
+}
+
+type TBaseTree = Record<string, ITreeEntry>;
+
+export interface IGraphEntry {
+  versions: string[];
+  parents: Record<string, string>;
+  used: string[];
+  version: string;
+}
+
+export class Graph {
+  constructor (private pkgJSONManager: PkgJSONManager) {}
+
+  public async build (): Promise<Record<string, IGraphEntry>> {
+    const baseJson = await this.pkgJSONManager.read();
+    const baseTree: TBaseTree = {};
+
+    if (!baseJson) {
+      throw new Error('NOT_A_NPM');
+    }
+
+    if (!baseJson.sv) {
+      /** There is no dependencies, graph is empty */
+      return {};
+    }
+
+    const recursiveBuilder = async (dependencies: TSV = {}, parent = '*') => {
+      await Promise.all(
+        Object.entries(dependencies).map(async ([url, version]) => {
+          const { name } = git.parseUrl(url);
+          const { cwd, modulesDir } = RunOptions;
+          const moduleDir = path.join(cwd, modulesDir, name);
+          const isInstalled = fs.existsSync(moduleDir);
+
+          if (version && !versionUtil.validate(version, true)) {
+            throw new GraphError('UNKNOWN_VERSION', { name, version, parent });
+          }
+
+          if (!isInstalled) {
+            await git.addSumbmodule(url);
+          }
+
+          const existEntry = baseTree[name] || null;
+
+          const mJson = existEntry
+            ? null
+            : await this.pkgJSONManager.read(name);
+
+          const meta = {
+            version: existEntry?.meta.version
+                      || mJson?.version
+                      || version
+                      || '*',
+            sv: existEntry?.meta.sv || mJson?.sv || {},
+          };
+
+          const parents = existEntry?.parents || {};
+
+          baseTree[name] = {
+            meta,
+            parents: { ...parents, [parent]: version },
+          };
+
+          await recursiveBuilder(meta.sv, name);
+        }),
+      );
+    };
+
+    await recursiveBuilder(baseJson.sv, baseJson.name);
+
+    const graph = await Promise.all(
+      Object.entries(baseTree).map(async ([name, data]) => {
+        const versions = await git.listVersions(name);
+        const { parents, meta } = data;
+
+        const used = Object.entries(parents).reduce((selective, [, v]) => (
+          versionUtil.pick(selective, v)
+        ), versions);
+
+        // No compatible version found and module has version tags
+        if (!used.length && versions.length) {
+          throw new GraphError('VERSION_CONFLICT', { parents, name });
+        }
+
+        if (!used.includes(meta.version)) {
+          const latest = versionUtil.latest(used);
+          if (latest) {
+            await git.checkout(name, latest);
+          }
+        }
+
+        return {
+          name,
+          data: { versions, parents, used, version: meta.version },
+        };
+      }),
+    );
+
+    return graph.reduce((acc, { name, data }) => ({
+      ...acc,
+      [name]: data,
+    }), {} as Record<string, IGraphEntry>);
+  }
+}

package/src/Graph/GraphError.ts

@@ -0,0 +1,12 @@
+type TDetails = {
+  name: string;
+  parents?: Record<string, string>;
+  version?: string;
+  parent?: string;
+}
+
+export class GraphError extends Error {
+  constructor (type: string, public details: TDetails) {
+    super(type);
+  }
+}

package/src/Graph/index.ts

@@ -0,0 +1,2 @@
+export { Graph } from './Graph';
+export { GraphError } from './GraphError';

package/src/PkgJSONManager.ts

@@ -0,0 +1,57 @@
+import fs from 'fs';
+import { promisify } from 'util';
+import path from 'path';
+import { RunOptions } from './runOptions';
+
+const existsAsync = promisify(fs.exists);
+const readFileAsync = promisify(fs.readFile);
+const writeFileAsync = promisify(fs.writeFile);
+const JSON_NAME = 'package.json';
+
+type TJSONPath = string | null;
+
+const getJsonPath = async (submoduleName?: string): Promise<TJSONPath> => {
+  const folder = submoduleName ? [RunOptions.modulesDir, submoduleName] : [];
+  const jsonPath = path.join(RunOptions.cwd, ...folder, JSON_NAME);
+  const isJsonExists = await existsAsync(jsonPath);
+  if (!isJsonExists) return null;
+
+  return jsonPath;
+};
+
+export class PkgJSONManager {
+  private cache: Map<string, any> = new Map();
+
+  /* Reads package.json in project folder or in submodule */
+  public read = async (submoduleName?: string) => {
+    const jsonPath = await getJsonPath(submoduleName);
+
+    if (!jsonPath) return null;
+
+    if (this.cache.has(jsonPath)) {
+      return this.cache.get(jsonPath);
+    }
+
+    const jsonString = await readFileAsync(jsonPath, 'utf-8');
+    const parsed = JSON.parse(jsonString);
+
+    this.cache.set(jsonPath, parsed);
+
+    return parsed;
+  };
+
+  /* Writes package.json in project folder or in submodule */
+  public write = async (data: Object, submoduleName?: string) => {
+    const jsonPath = await getJsonPath(submoduleName);
+
+    if (!jsonPath) return;
+
+    this.cache.set(jsonPath, data);
+
+    await writeFileAsync(jsonPath, JSON.stringify(data, null, 2));
+  };
+
+  public clearCache (): void {
+    this.cache.clear();
+  }
+}

package/src/git/git.ts

@@ -0,0 +1,64 @@
+import chalk from 'chalk';
+import { exec } from 'child_process';
+import { promisify } from 'util';
+import path from 'path';
+import { log } from '../log';
+import { parseGitUrl } from './parseGitUrl';
+import { versionUtil } from '../versionUtil';
+import { RunOptions } from '../runOptions';
+
+const execAsync = promisify(exec);
+
+export const git = {
+  parseUrl: parseGitUrl,
+
+  addSumbmodule: async (url: string): Promise<void> => {
+    const { name } = parseGitUrl(url);
+    const module = path.join(RunOptions.modulesDir, name);
+
+    // try {
+      await execAsync(
+        `git submodule add ${url} ${module}`,
+        { cwd: RunOptions.cwd },
+      );
+    // } catch {
+    //   log.error(url, 'Is not a git repo', RunOptions.cwd);
+    // }
+  },
+
+  checkout: async (name: string, version: string): Promise<void> => {
+    const module = path.join(RunOptions.modulesDir, name);
+    const styledName = chalk.green.bold(name);
+    const styledVer = chalk.green.bold(version);
+
+    try {
+      log.message('Checkout', styledName, 'to', styledVer);
+      await execAsync(
+        `git -C ${module} checkout ${version} -q`,
+        { cwd: RunOptions.cwd },
+      );
+    } catch {
+      log.error('Checkout failded');
+    }
+  },
+
+  listVersions: async (projectName: string): Promise<string[]> => {
+    const module = path.join(RunOptions.modulesDir, projectName);
+    const styledName = chalk.green.bold(projectName);
+    log.message('Fetching tag list for', styledName);
+    await execAsync(`git -C ${module} fetch --tags`, { cwd: RunOptions.cwd });
+
+    const res = await execAsync(
+      `git -C ${module} tag -l`,
+      { cwd: RunOptions.cwd },
+    );
+
+    const tagList = res.stdout.toString().split(/\r?\n/);
+
+    return tagList.filter(tag => {
+      if (!tag) return false;
+
+      return versionUtil.validate(tag);
+    });
+  },
+};

package/src/git/index.ts

@@ -0,0 +1 @@
+export { git } from './git';

package/src/{parseGitUrl.ts → git/parseGitUrl.ts}

@@ -1,4 +1,4 @@
-interface IParseResult {
+export interface IParseResult {
   name: string;
   url: string;
   version: string | null;

package/src/index.ts

@@ -0,0 +1 @@
+export { SV } from './sv';

package/src/runOptions.ts

@@ -0,0 +1,4 @@
+export class RunOptions {
+  public static cwd: string = '';
+  public static modulesDir: string = '';
+}

package/src/runner/handleErrors/handleBuildGraphError.ts

@@ -0,0 +1,49 @@
+import { GraphError } from '../../Graph';
+import { log } from '../../log';
+import chalk from 'chalk';
+
+export const handleBuildGraphError = (error: Error) => {
+  if (!(error instanceof GraphError)) return;
+
+  const { message: errorMessage, details } = error;
+
+  if (errorMessage === 'NOT_A_NPM') {
+    log.error('Not a npm project');
+  }
+
+  if (errorMessage === 'UNKNOWN_VERSION') {
+    const { name, version, parent } = details;
+    const stV = chalk.bgRed.bold.white(` ${version} `);
+    const stName = chalk.red.bold(name);
+    const stParent = chalk.green.bold(parent);
+
+    log.error('Unknown version', stV, 'for', stName, 'in', stParent);
+  }
+
+  if (errorMessage === 'VERSION_CONFLICT') {
+    const { parents, name } = details;
+
+    const longestVersion = Object.values(parents ?? {}).reduce((len, v) => (
+      v.length > len ? v.length : len
+    ), 0);
+
+    const formattedName = chalk.green.bold(name);
+    const baseMsg = `${chalk.red('Confilict')} for ${formattedName}:`;
+
+    const conflictMsg = Object.entries(parents ?? {})
+      .reduce((msg, [pName, v]) => {
+        const formatedV = chalk.bold.red(
+          String(v).padEnd(longestVersion, ' '),
+        );
+
+        return [
+          ...msg,
+          `  - Version ${formatedV} used in ${chalk.green.bold(pName)}`,
+        ];
+      }, [baseMsg]);
+
+    log.error(conflictMsg.join('\n'));
+  }
+
+  log.error(errorMessage);
+};

package/src/runner/handleErrors/handleErrors.ts

@@ -0,0 +1,9 @@
+import { handleBuildGraphError } from './handleBuildGraphError';
+import { handleInstallError } from './handleInstallError';
+
+export const handleErrors = async (error: Error, gitUrl: string) => {
+  await Promise.all([
+    handleBuildGraphError(error),
+    handleInstallError(error, gitUrl),
+  ]);
+};

package/src/runner/handleErrors/handleInstallError.ts

@@ -0,0 +1,26 @@
+import chalk from 'chalk';
+import { versionUtil } from "../../versionUtil";
+import { log } from '../../log';
+import { git } from '../../git';
+
+export const handleInstallError = async (error: Error, gitUrl: string) => {
+  const { message } = error;
+  const { url, version, name } = git.parseUrl(gitUrl);
+
+  if (message === 'NOT_A_GIT_URL') {
+    return log.error(chalk.red.bold(url), '- is not a git url!');
+  }
+
+  if (message === 'REQUESTED_VERSION_NOT_EXISTS') {
+    const versions = await git.listVersions(name);
+    const latestVersion = versionUtil.latest(versions);
+    const requestedVersion = version || latestVersion;
+    const styledName = `Package ${chalk.bold.green(name)}`;
+    const styledVer = chalk.bgRed.bold.white(` ${requestedVersion} `);
+    const errMsg = `does not contain version ${styledVer}.`;
+    const styledVList = chalk.bold.green(versions.join(', '));
+    const helpMsg = `Use one from [${styledVList}]`;
+
+    return log.error(styledName, errMsg, helpMsg);
+  }
+};

package/src/runner/handleErrors/index.ts

@@ -0,0 +1 @@
+export { handleErrors } from './handleErrors';

package/src/runner/index.ts

@@ -0,0 +1 @@
+import './runer';

package/src/runner/runer.ts

@@ -0,0 +1,76 @@
+import chalk from 'chalk';
+import yargs from 'yargs';
+import { SV } from '../sv';
+import { log } from '../log';
+import { handleErrors } from './handleErrors';
+
+const BASE_DIR = 'modules';
+
+const makeEvent = (event: (sv: SV, arg: any) => Promise<void>) => {
+  const sv = new SV(process.cwd(), BASE_DIR);
+
+  return async (arg: any) => {
+    const { url: gitUrl } = arg as {url: string};
+
+    try {
+      await event(sv, arg);
+    } catch (e) {
+      handleErrors(e as Error, gitUrl);
+    }
+  };
+};
+
+const install = makeEvent(async (sv, arg) => {
+  const { url: gitUrl, target } = arg as {url: string, target?: string};
+  await sv.install(gitUrl, target);
+});
+
+const update = makeEvent(async sv => {
+  await sv.update();
+});
+
+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!'),
+      );
+    }
+  });
+
+  log.message(chalk.green.bold('Everything is up to date!🔥'));
+});
+
+// eslint-disable-next-line @typescript-eslint/no-unused-expressions
+yargs.scriptName('sv')
+  .usage('$0 <cmd> [args]')
+  .command(
+    ['validate', '$0', 'v'],
+    'Validate and install modules',
+    () => {},
+    validate,
+  )
+  .command(
+    ['update', 'u'],
+    'Update git modules to actual versions',
+    () => {},
+    update,
+  )
+  .command(
+    ['install <url> [target]', 'i'],
+    'Install new submodule',
+    y => y.positional('url', {
+      type: 'string',
+      describe: 'Git submodule url',
+    }).positional('target', {
+      type: 'string',
+      describe: 'Target module name',
+    }),
+    install,
+  )
+  .help()
+  .argv;

package/src/sv.ts

@@ -0,0 +1,67 @@
+import { PkgJSONManager } from "./PkgJSONManager";
+import { Graph } from "./Graph";
+import { RunOptions } from "./runOptions";
+import { versionUtil } from "./versionUtil";
+import { git } from "./git";
+
+export class SV {
+  private pkgJSONManager: PkgJSONManager;
+  private graph: Graph;
+
+  constructor (
+    projectDir: string,
+    modulesDir: string = 'addons',
+  ) {
+    RunOptions.cwd = projectDir;
+    RunOptions.modulesDir = modulesDir;
+
+    this.pkgJSONManager = new PkgJSONManager();
+    this.graph = new Graph(this.pkgJSONManager);
+  }
+
+  public buildGraph = () => this.graph.build();
+
+  public install = async (gitUrl: string, parentModule?: string) => {
+    const { url, version, name } = git.parseUrl(gitUrl);
+
+    if (!name) {
+      throw new Error('NOT_A_GIT_URL');
+    }
+
+    const targetPkg = await this.pkgJSONManager.read(parentModule);
+    let installedPkg = await this.pkgJSONManager.read(name);
+
+    if (!installedPkg) {
+      await git.addSumbmodule(url);
+      installedPkg = this.pkgJSONManager.read(name);
+    }
+
+    const versions = await git.listVersions(name);
+    const latestVersion = versionUtil.latest(versions);
+    const requestedVersion = version || latestVersion;
+
+    if (!versions.includes(requestedVersion) && versions.length) {
+      throw new Error('REQUESTED_VERSION_NOT_EXISTS');
+    }
+
+    if (!targetPkg.sv) {
+      targetPkg.sv = {};
+    }
+
+    targetPkg.sv[url] = requestedVersion ? `^${requestedVersion}` : '*';
+    await this.pkgJSONManager.write(targetPkg, parentModule);
+    await this.graph.build();
+  };
+
+  public update = async () => {
+    const graph = await this.graph.build();
+    if (!graph) return;
+    await Promise.all(Object.entries(graph).map(async ([name, data]) => {
+      const { version, used } = data;
+      const latestVersion = versionUtil.latest(used);
+      if (latestVersion !== version) {
+        await git.checkout(name, latestVersion);
+      }
+    }));
+  };
+}

package/dist/src/__tests__/parseGitUrl.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"parseGitUrl.test.js","sourceRoot":"","sources":["../../../src/__tests__/parseGitUrl.test.ts"],"names":[],"mappings":";;AAAA,gDAA6C;AAE7C,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,iBAAiB,EAAE,GAAG,EAAE;QACzB,MAAM,GAAG,GAAG,8CAA8C,CAAC;QAE3D,MAAM,CAAC,IAAA,yBAAW,EAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC;YAC/B,GAAG,EAAE,8CAA8C;YACnD,OAAO,EAAE,SAAS;YAClB,IAAI,EAAE,aAAa;SACpB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,cAAc,EAAE,GAAG,EAAE;QACtB,MAAM,GAAG,GAAG,oDAAoD,CAAC;QAEjE,MAAM,CAAC,IAAA,yBAAW,EAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC;YAC/B,GAAG,EAAE,8CAA8C;YACnD,OAAO,EAAE,OAAO;YAChB,IAAI,EAAE,aAAa;SACpB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,cAAc,EAAE,GAAG,EAAE;QACtB,MAAM,GAAG,GAAG,aAAa,CAAC;QAE1B,MAAM,CAAC,IAAA,yBAAW,EAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC;YAC/B,GAAG,EAAE,aAAa;YAClB,OAAO,EAAE,IAAI;YACb,IAAI,EAAE,EAAE;SACT,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/buildGraph.d.ts

@@ -1,7 +0,0 @@
-export interface IGraphEntry {
-    versions: string[];
-    parents: Record<string, string>;
-    used: string[];
-    version: string;
-}
-export declare const buildGraph: () => Record<string, IGraphEntry> | void;