@codiac.io/codiac-cli 1.2.172 → 1.2.173

package/lib/ops/workspace-versioner.js

@@ -0,0 +1,292 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SemanticVersioner = exports.WorkspaceVersioner = void 0;
+const tslib_1 = require("tslib");
+const codiac_common_1 = require("@codiac.io/codiac-common");
+const contracts_1 = require("@codiac.io/codiac-common/contracts");
+const inversify_1 = require("inversify");
+const cli_context_repo_1 = require("./data/cli-context-repo");
+const dx_constants_1 = require("./dx-constants");
+const semver = require("semver");
+/** Manages the semantic version number for image exports declared in the workspace (aka: the codiac.json).  */
+let WorkspaceVersioner = class WorkspaceVersioner {
+    constructor(logger, projCfgRepo
+    // @inject(SemanticVersioner) private versioner: SemanticVersioner
+    ) {
+        this.logger = logger;
+        this.projCfgRepo = projCfgRepo;
+        this.versioner = new SemanticVersioner(logger);
+    }
+    /** Increments the version number of the given image export by the given increment.
+     *  Retains existing version number if no increment is specified.
+     *  Sets to the default init version number if the imageExport doesnt yet have a version declared.
+     *  Writes changes to the project config (aka: codiac.json).
+     *  Throws if existing version is invalid.
+     *
+     * @param cfg Project config doc (aka: codiac.json deserialized)
+     */
+    incrementImageVersion(imageExport, cfg, increment) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            return new Promise((resolve, reject) => tslib_1.__awaiter(this, void 0, void 0, function* () {
+                try {
+                    if (!imageExport.version)
+                        imageExport.version = dx_constants_1.DxConstants.DEFAULT_INIT_IMAGE_VERSION; // TODO: Absorb this into this class
+                    let newVersion = this.versioner.incrementVersion(imageExport.version, increment);
+                    if (newVersion != imageExport.version) {
+                        imageExport.version = newVersion;
+                        if (!cfg.images)
+                            cfg.images = {};
+                        cfg.images[imageExport.name] = imageExport;
+                        yield this.projCfgRepo.updateProjectConfigFile(cfg);
+                    }
+                    resolve(imageExport);
+                }
+                catch (err) {
+                    reject(err);
+                }
+            }));
+        });
+    }
+    /** Increments the project code version number by the given increment.
+     *  Retains existing version number if no increment is specified.
+     *  Writes changes to the project config (aka: codiac.json).
+     *  Throws if existing version is invalid.
+     *
+     * @param cfg Project config doc (aka: codiac.json deserialized)
+     */
+    incrementCodeVersion(cfg, increment) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            return new Promise((resolve, reject) => tslib_1.__awaiter(this, void 0, void 0, function* () {
+                try {
+                    let newVersion = this.versioner.incrementVersion(cfg.codeVersion, increment);
+                    if (newVersion != cfg.codeVersion) {
+                        cfg.codeVersion = newVersion;
+                        yield this.projCfgRepo.updateProjectConfigFile(cfg);
+                    }
+                    resolve(cfg);
+                }
+                catch (err) {
+                    reject(err);
+                }
+            }));
+        });
+    }
+};
+WorkspaceVersioner = tslib_1.__decorate([
+    (0, inversify_1.injectable)(),
+    tslib_1.__param(0, (0, inversify_1.inject)(codiac_common_1.INTERFACES.IBetterLogger)),
+    tslib_1.__param(1, (0, inversify_1.inject)(cli_context_repo_1.ProjectContextRepo)),
+    tslib_1.__metadata("design:paramtypes", [Object, cli_context_repo_1.ProjectContextRepo
+        // @inject(SemanticVersioner) private versioner: SemanticVersioner
+    ])
+], WorkspaceVersioner);
+exports.WorkspaceVersioner = WorkspaceVersioner;
+let SemanticVersioner = class SemanticVersioner {
+    constructor(logger) {
+        this.logger = logger;
+    }
+    /** Increments the given semantic version nnumber by the given increment.
+     *  Returns existing version number if no increment is specified.
+     *  Throws if existing version is invalid.
+     */
+    incrementVersion(existing, increment) {
+        try {
+            let newVersion = existing;
+            if (increment) {
+                if (increment.fullName) {
+                    this.logger.notice(`Applying new version number ${increment.fullName}...`);
+                    newVersion = increment.fullName;
+                }
+                else if (increment.major) {
+                    this.logger.notice(`Incrementing ${"major"} version number...`);
+                    newVersion = semver.inc(existing, "major");
+                }
+                else if (increment.minor) {
+                    this.logger.notice(`Incrementing ${"minor"} version number...`);
+                    newVersion = semver.inc(existing, "minor");
+                }
+                else if (increment.patch) {
+                    this.logger.notice(`Incrementing ${"patch"} version number...`);
+                    newVersion = semver.inc(existing, "patch");
+                }
+                else if (increment.preId) {
+                    this.logger.notice(`Incrementing ${"prerelease"} id and number...`);
+                    newVersion = this.addPrereleaseId(existing, increment.preId);
+                    newVersion = semver.inc(newVersion, "prerelease");
+                }
+                else if (increment.prerelease) {
+                    this.logger.notice(`Incrementing ${"prerelease"} version number...`);
+                    newVersion = semver.inc(existing, "prerelease");
+                }
+                if (newVersion == null)
+                    throw new contracts_1.CodiacError(`Cannot increment; current version number [${existing}] is not a valid semantic version.`);
+            }
+            return newVersion;
+        }
+        catch (err) {
+            throw err;
+        }
+    }
+    /** Prefixes the prerelease version segment
+     * with the given prerelease identifier.
+     *
+     * using format:  `[major].[minor].[patch]-[id].[prereleaseNumber]`
+     *
+     * eg:  `1.2.3`  remains  `1.2.3`
+     * eg:  `1.2.3-4`  becomes  `1.2.3-thisBranch.4`
+     * eg:  `1.2.3-toro.4`  becomes  `1.2.3-thisBranch.4`   */
+    addPrereleaseId(version, prereleaseId) {
+        let output = version;
+        let parts = semver.parse(version);
+        // let ultimateId = /[^\w\d\.-]/g.exec(id); 
+        let ultimateId = prereleaseId.replace(/[^\w\d\.-]|_/g, "-");
+        // console.log(ultimateId);
+        if (parts) {
+            let pre = parts.prerelease; // semver.prerelease(version);
+            let newPre;
+            if (pre === null || pre.length == 0) {
+                // CASE 0) no prerelease at all.
+                newPre = [ultimateId];
+            }
+            else {
+                let newBuild = [...parts.build];
+                if (pre.length == 1) {
+                    if (typeof pre[0] === 'number') {
+                        // CASE 1) prerelease is a number
+                        output = `${ultimateId}.${pre[0]}`;
+                        newPre = [ultimateId, 0];
+                        newBuild = [];
+                    }
+                    else {
+                        // CASE 2) just a string body - no numeric suffix
+                        newPre = [ultimateId, 0];
+                        newBuild = [];
+                    }
+                }
+                else if (pre.length == 2) {
+                    // CASE 3) string body with numeric suffix
+                    if (pre[0] === ultimateId) {
+                        // CASE 3A) id already in prerelease
+                        newPre = [...pre]; // id is already in the prerelease; keep it as is.
+                    }
+                    else {
+                        // CASE 3B) given version has a diff prerelease id
+                        newPre = [ultimateId, 0];
+                        newBuild = [];
+                    }
+                }
+                else {
+                    // more than two segments in prerelease?  
+                    // Is this the case when a build number is attached?  eg:  [id].[number]+[build] 
+                    newPre = [...pre]; // not supporting this case yet...  
+                }
+            }
+            output = `${parts.major}.${parts.minor}.${parts.patch}`;
+            if (newPre.length > 0) {
+                output = output.concat("-", newPre.join("."));
+            }
+        }
+        return output;
+    }
+    /** Rewrites the entire semantic version with the given semantic version.
+     *
+     * @param version (required) Must be a valid semantic version (eg: `1.2.3` or `1.2.3-something` or `1.2.3-something.4`).
+     */
+    bump(change) {
+        try {
+            let newVersion = "";
+            return newVersion;
+        }
+        catch (err) {
+            throw err;
+        }
+    }
+    /** Rewrites the entire semantic version with the given semantic version.
+     *
+     * @param version (required) Must be a valid semantic version (eg: `1.2.3` or `1.2.3-something` or `1.2.3-something.4`).
+     */
+    set(version) {
+        return this.bump({ fullName: version });
+    }
+    /** Increments the major number of the semantic version for the current image definition.
+     *
+     * That is: the term `[major]` in the version format:
+     * ```
+     * [major].[minor].[patch]-[prereleaseName].[prereleaseNumber]
+     * ```
+     *
+     * eg:  `1.2.3` becomes `2.0.0`
+     *
+     * eg:  `1.2.3-my-branch.3` becomes `2.0.0`
+     */
+    major() {
+        return this.bump({ major: true });
+    }
+    /** Increments the minor number of the semantic version for the current image definition.
+     *
+     * That is: the term `[minor]` in the version format:
+     * ```
+     * [major].[minor].[patch]-[prereleaseName].[prereleaseNumber]
+     * ```
+     *
+     * eg:  `1.2.3` becomes `1.3.0`
+     *
+     * eg:  `1.2.3-my-branch.3` becomes `1.3.0`
+     */
+    minor(newValue) {
+        return this.bump({ minor: true });
+    }
+    /** Increments the patch number of the semantic version for the current image definition.
+     *
+     * That is: the term `[patch]` in the version format:
+     * ```
+     * [major].[minor].[patch]-[prereleaseName].[prereleaseNumber]
+     * ```
+     *
+     * eg:  `1.2.3` becomes `1.2.4`
+     *
+     * eg:  `1.2.3-my-branch.3` becomes `1.2.3`
+     *
+     * *(note: NOT 1.2.4 because prereleases lead up to a patch release, thus the term "cut a version")*
+     */
+    patch() {
+        return this.bump({ patch: true });
+    }
+    /** Increments the prerelease of the semantic version for the current image definition.
+     * Passing in an alphanumeric prerelease name
+     * will prefix the number and delimit with a period (.).
+     *
+     * That is: the `[prereleaseName]` and `[prereleaseNumber]` terms in the version format:
+     * ```
+     * [major].[minor].[patch]-[prereleaseName].[prereleaseNumber]
+     * ```
+     *
+     * eg: without providing a name...
+     *
+     * `1.2.3` becomes `1.2.4-0`
+     *
+     * `1.2.3-my-branch.3` becomes `1.2.3-my-branch.4`
+     *
+     * `1.2.3-my-branch` becomes `1.2.3-my-branch.0`
+     *
+     * eg: providing "workitem-pdq" as name...
+     *
+     * `1.2.3` becomes `1.2.4-workitem-pdq.0`
+     *
+     * `1.2.3-workitem-pdq.0` becomes `1.2.3-workitem-pdq.1`
+     *
+     * `1.2.3-my-branch.3` becomes `1.2.3-workitem-pdq.0`
+     *
+     * `1.2.3-my-branch` becomes `1.2.3-workitem-pdq.0`
+     */
+    prerelease(name) {
+        return this.bump({ prerelease: true, preId: name });
+    }
+};
+SemanticVersioner = tslib_1.__decorate([
+    (0, inversify_1.injectable)(),
+    tslib_1.__param(0, (0, inversify_1.inject)(codiac_common_1.INTERFACES.IBetterLogger)),
+    tslib_1.__metadata("design:paramtypes", [Object])
+], SemanticVersioner);
+exports.SemanticVersioner = SemanticVersioner;
+//# sourceMappingURL=workspace-versioner.js.map

package/lib/ops/workspace-versioner.js.map

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

package/oclif.manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.2.172",
+  "version": "1.2.173",
   "commands": {
     "branch": {
       "id": "branch",
@@ -150,6 +150,13 @@
           "description": "Increments the prerelease number (using Major.Minor.Patch-PreRelease).  NOTE:  Increments the Patch version number when appending.",
           "allowNo": false
         },
+        "preid": {
+          "name": "preid",
+          "type": "option",
+          "char": "i",
+          "description": "Sets the prereleaseId and resets the prerelease number (or increments it if the same preid is already set) (using Major.Minor.Patch-PreId.PreRelease).  NOTE:  Increments the Patch version number when appending.",
+          "multiple": false
+        },
         "clear": {
           "name": "clear",
           "type": "boolean",
@@ -3479,7 +3486,7 @@
           "name": "buildParams",
           "type": "option",
           "char": "b",
-          "description": "Additional freeform arguments to apply to the Docker build command.",
+          "description": "Additional freeform arguments to apply to the Docker build command (as: arg=val, eg: -b \"--size=12\" -b \"--color=blue\").",
           "required": false,
           "multiple": true
         }
@@ -3618,8 +3625,8 @@
       "pluginAlias": "@codiac.io/codiac-cli",
       "pluginType": "core",
       "aliases": [
-        "image:list",
-        "img:list"
+        "image:version:get",
+        "img:version:get"
       ],
       "flags": {
         "help": {
@@ -4856,6 +4863,75 @@
         "name"
       ]
     },
+    "images:version:bump": {
+      "id": "images:version:bump",
+      "description": "Output the local version a given image. useful for ci/cd automation.",
+      "strict": true,
+      "pluginName": "@codiac.io/codiac-cli",
+      "pluginAlias": "@codiac.io/codiac-cli",
+      "pluginType": "core",
+      "aliases": [
+        "image:version:bump",
+        "img:version:bump"
+      ],
+      "flags": {
+        "help": {
+          "name": "help",
+          "type": "boolean",
+          "char": "h",
+          "description": "Show CLI help.",
+          "allowNo": false
+        },
+        "version": {
+          "name": "version",
+          "type": "option",
+          "description": "Overwrites the full version for the build (using Major.Minor.Patch).",
+          "multiple": false
+        },
+        "major": {
+          "name": "major",
+          "type": "boolean",
+          "char": "M",
+          "description": "Increments the version by one Major version number (using Major.Minor.Patch).",
+          "allowNo": false
+        },
+        "minor": {
+          "name": "minor",
+          "type": "boolean",
+          "char": "m",
+          "description": "Increments the version by one Minor version number (using Major.Minor.Patch).",
+          "allowNo": false
+        },
+        "patch": {
+          "name": "patch",
+          "type": "boolean",
+          "char": "p",
+          "description": "Increments the version by one Patch version number (using Major.Minor.Patch).",
+          "allowNo": false
+        },
+        "prerelease": {
+          "name": "prerelease",
+          "type": "boolean",
+          "char": "r",
+          "description": "(default for this command) Increments the prerelease number (using Major.Minor.Patch-PreRelease).  NOTE:  Increments the Patch version number when appending.",
+          "allowNo": false
+        },
+        "preid": {
+          "name": "preid",
+          "type": "option",
+          "char": "i",
+          "description": "Sets the prereleaseId and resets the prerelease number (or increments it if the same preid is already set) (using Major.Minor.Patch-PreId.PreRelease).  NOTE:  Increments the Patch version number when appending.",
+          "multiple": false
+        }
+      },
+      "args": {
+        "name": {
+          "name": "name",
+          "description": "Image name (as it appears in the codiac.json)",
+          "required": true
+        }
+      }
+    },
     "noc:cluster:create": {
       "id": "noc:cluster:create",
       "description": "Provisions the physical cluster",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@codiac.io/codiac-cli",
   "description": "Local command line interface for registering and maintaining enterprise assets and pipelines",
-  "version": "1.2.172",
+  "version": "1.2.173",
   "author": "Codiac",
   "bin": {
     "codiac": "./bin/run",