projen 0.0.0

package/lib/cli/synth.d.ts

@@ -0,0 +1,19 @@
+import { TaskRuntime } from '../task-runtime';
+export interface SynthOptions {
+    /**
+     * Execute post synthesis commands.
+     * @default true
+     */
+    readonly post?: boolean;
+    /**
+     * Start watching .projenrc.js and re-synth when changed.
+     * @default false
+     */
+    readonly watch?: boolean;
+    /**
+     * The name of the .projenrc.js file  to use instead of the default.
+     * @default ".projenrc.js"
+     */
+    readonly rcfile?: string;
+}
+export declare function synth(runtime: TaskRuntime, options: SynthOptions): Promise<void>;

package/lib/cli/synth.js

@@ -0,0 +1,104 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.synth = void 0;
+const child_process_1 = require("child_process");
+const os = require("os");
+const path = require("path");
+const fs = require("fs-extra");
+const common_1 = require("../common");
+const logging = require("../logging");
+const project_1 = require("../project");
+const projenModule = path.dirname(require.resolve('../../package.json'));
+async function synth(runtime, options) {
+    var _a;
+    const workdir = runtime.workdir;
+    const rcfile = path.resolve(workdir, (_a = options.rcfile) !== null && _a !== void 0 ? _a : common_1.PROJEN_RC); // TODO: support non javascript projenrc (e.g. java projects)
+    // if --rc points to .projenrc.js, then behave as if it wasn't specified.
+    if (rcfile === path.resolve(workdir, common_1.PROJEN_RC)) {
+        delete options.rcfile;
+    }
+    // if there are no tasks, we assume this is not a projen project (modern
+    // projects must at least have the "default" task).
+    if (runtime.tasks.length === 0 && !fs.existsSync(rcfile)) {
+        logging.error('Unable to find projen project. Use "projen new" to create a new project.');
+        process.exit(1);
+    }
+    // run synth once
+    const success = await trySynth();
+    if (options.watch) {
+        // if we are in watch mode, start the watch loop
+        watchLoop();
+    }
+    else if (!success) {
+        // make sure exit code is non-zero if we are not in watch mode
+        process.exit(1);
+    }
+    async function trySynth() {
+        // determine if post synthesis tasks should be executed (e.g. "yarn install").
+        process.env.PROJEN_DISABLE_POST = (!options.post).toString();
+        try {
+            const defaultTask = runtime.tasks.find(t => t.name === project_1.Project.DEFAULT_TASK);
+            // if "--rc" is specified, ignore the default task
+            if (defaultTask) {
+                if (!options.rcfile) {
+                    runtime.runTask(defaultTask.name);
+                    return true;
+                }
+                else {
+                    logging.warn('Default task skipped. Trying legacy synthesis since --rc is specified');
+                }
+            }
+            // for backwards compatibility, if there is a .projenrc.js file, default to "node .projenrc.js"
+            if (tryLegacySynth()) {
+                return true;
+            }
+            throw new Error('Unable to find a task named "default"');
+        }
+        catch (e) {
+            logging.error(`Synthesis failed: ${e.message}`);
+            return false;
+        }
+    }
+    function watchLoop() {
+        logging.info(`Watching for changes in ${workdir}...`);
+        const watch = fs.watch(workdir, { recursive: true });
+        watch.on('change', event => {
+            // we only care about "change" events
+            if (event !== 'change') {
+                return;
+            }
+            process.stdout.write('\x1Bc'); // clear screen
+            watch.close();
+            trySynth()
+                .then(() => watchLoop())
+                .catch(() => watchLoop());
+        });
+    }
+    function tryLegacySynth() {
+        const rcdir = path.dirname(rcfile);
+        if (!fs.existsSync(rcfile)) {
+            return false;
+        }
+        // if node_modules/projen is not a directory or does not exist, create a
+        // temporary symlink to the projen that we are currently running in order to
+        // allow .projenrc.js to `require()` it.
+        const nodeModules = path.resolve(rcdir, 'node_modules');
+        const projenModulePath = path.resolve(nodeModules, 'projen');
+        if (!fs.existsSync(path.join(projenModulePath, 'package.json')) || !fs.statSync(projenModulePath).isDirectory()) {
+            fs.removeSync(projenModulePath);
+            fs.mkdirpSync(nodeModules);
+            fs.symlinkSync(projenModule, projenModulePath, (os.platform() === 'win32') ? 'junction' : null);
+        }
+        const ret = child_process_1.spawnSync(process.execPath, [rcfile], { stdio: ['inherit', 'inherit', 'pipe'] });
+        if (ret.error) {
+            throw new Error(`Synthesis failed: ${ret.error}`);
+        }
+        else if (ret.status !== 0) {
+            logging.error(ret.stderr.toString());
+            throw new Error(`Synthesis failed: calling "${process.execPath} ${rcfile}" exited with status=${ret.status}`);
+        }
+        return true;
+    }
+}
+exports.synth = synth;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic3ludGguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvY2xpL3N5bnRoLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQUFBLGlEQUEwQztBQUMxQyx5QkFBeUI7QUFDekIsNkJBQTZCO0FBQzdCLCtCQUErQjtBQUMvQixzQ0FBc0M7QUFDdEMsc0NBQXNDO0FBQ3RDLHdDQUFxQztBQUdyQyxNQUFNLFlBQVksR0FBRyxJQUFJLENBQUMsT0FBTyxDQUFDLE9BQU8sQ0FBQyxPQUFPLENBQUMsb0JBQW9CLENBQUMsQ0FBQyxDQUFDO0FBc0JsRSxLQUFLLFVBQVUsS0FBSyxDQUFDLE9BQW9CLEVBQUUsT0FBcUI7O0lBQ3JFLE1BQU0sT0FBTyxHQUFHLE9BQU8sQ0FBQyxPQUFPLENBQUM7SUFDaEMsTUFBTSxNQUFNLEdBQUcsSUFBSSxDQUFDLE9BQU8sQ0FBQyxPQUFPLFFBQUUsT0FBTyxDQUFDLE1BQU0sbUNBQUksa0JBQVMsQ0FBQyxDQUFDLENBQUMsNkRBQTZEO0lBRWhJLHlFQUF5RTtJQUN6RSxJQUFJLE1BQU0sS0FBSyxJQUFJLENBQUMsT0FBTyxDQUFDLE9BQU8sRUFBRSxrQkFBUyxDQUFDLEVBQUU7UUFDL0MsT0FBUSxPQUFlLENBQUMsTUFBTSxDQUFDO0tBQ2hDO0lBRUQsd0VBQXdFO0lBQ3hFLG1EQUFtRDtJQUNuRCxJQUFJLE9BQU8sQ0FBQyxLQUFLLENBQUMsTUFBTSxLQUFLLENBQUMsSUFBSSxDQUFDLEVBQUUsQ0FBQyxVQUFVLENBQUMsTUFBTSxDQUFDLEVBQUU7UUFDeEQsT0FBTyxDQUFDLEtBQUssQ0FBQywwRUFBMEUsQ0FBQyxDQUFDO1FBQzFGLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FBQyxDQUFDLENBQUM7S0FDakI7SUFFRCxpQkFBaUI7SUFDakIsTUFBTSxPQUFPLEdBQUcsTUFBTSxRQUFRLEVBQUUsQ0FBQztJQUVqQyxJQUFJLE9BQU8sQ0FBQyxLQUFLLEVBQUU7UUFDakIsZ0RBQWdEO1FBQ2hELFNBQVMs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QUNoQyxFQUFFLENBQUMsVUFBVSxDQUFDLFdBQVcsQ0FBQyxDQUFDO1lBQzNCLEVBQUUsQ0FBQyxXQUFXLENBQUMsWUFBWSxFQUFFLGdCQUFnQixFQUFFLENBQUMsRUFBRSxDQUFDLFFBQVEsRUFBRSxLQUFLLE9BQU8sQ0FBQyxDQUFDLENBQUMsQ0FBQyxVQUFVLENBQUMsQ0FBQyxDQUFDLElBQUksQ0FBQyxDQUFDO1NBQ2pHO1FBRUQsTUFBTSxHQUFHLEdBQUcseUJBQVMsQ0FBQyxPQUFPLENBQUMsUUFBUSxFQUFFLENBQUMsTUFBTSxDQUFDLEVBQUUsRUFBRSxLQUFLLEVBQUUsQ0FBQyxTQUFTLEVBQUUsU0FBUyxFQUFFLE1BQU0sQ0FBQyxFQUFFLENBQUMsQ0FBQztRQUM3RixJQUFJLEdBQUcsQ0FBQyxLQUFLLEVBQUU7WUFDYixNQUFNLElBQUksS0FBSyxDQUFDLHFCQUFxQixHQUFHLENBQUMsS0FBSyxFQUFFLENBQUMsQ0FBQztTQUNuRDthQUFNLElBQUksR0FBRyxDQUFDLE1BQU0sS0FBSyxDQUFDLEVBQUU7WUFDM0IsT0FBTyxDQUFDLEtBQUssQ0FBQyxHQUFHLENBQUMsTUFBTSxDQUFDLFFBQVEsRUFBRSxDQUFDLENBQUM7WUFDckMsTUFBTSxJQUFJLEtBQUssQ0FBQyw4QkFBOEIsT0FBTyxDQUFDLFFBQVEsSUFBSSxNQUFNLHdCQUF3QixHQUFHLENBQUMsTUFBTSxFQUFFLENBQUMsQ0FBQztTQUMvRztRQUVELE9BQU8sSUFBSSxDQUFDO0lBQ2QsQ0FBQztBQUNILENBQUM7QUFwR0Qsc0JBb0dDIiwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IHsgc3Bhd25TeW5jIH0gZnJvbSAnY2hpbGRfcHJvY2Vzcyc7XG5pbXBvcnQgKiBhcyBvcyBmcm9tICdvcyc7XG5pbXBvcnQgKiBhcyBwYXRoIGZyb20gJ3BhdGgnO1xuaW1wb3J0ICogYXMgZnMgZnJvbSAnZnMtZXh0cmEnO1xuaW1wb3J0IHsgUFJPSkVOX1JDIH0gZnJvbSAnLi4vY29tbW9uJztcbmltcG9ydCAqIGFzIGxvZ2dpbmcgZnJvbSAnLi4vbG9nZ2luZyc7XG5pbXBvcnQgeyBQcm9qZWN0IH0gZnJvbSAnLi4vcHJvamVjdCc7XG5pbXBvcnQgeyBUYXNrUnVudGltZSB9IGZyb20gJy4uL3Rhc2stcnVudGltZSc7XG5cbmNvbnN0IHByb2plbk1vZHVsZSA9IHBhdGguZGlybmFtZShyZXF1aXJlLnJlc29sdmUoJy4uLy4uL3BhY2thZ2UuanNvbicpKTtcblxuZXhwb3J0IGludGVyZmFjZSBTeW50aE9wdGlvbnMge1xuICAvKipcbiAgICogRXhlY3V0ZSBwb3N0IHN5bnRoZXNpcyBjb21tYW5kcy5cbiAgICogQGRlZmF1bHQgdHJ1ZVxuICAgKi9cbiAgcmVhZG9ubHkgcG9zdD86IGJvb2xlYW47XG5cbiAgLyoqXG4gICAqIFN0YXJ0IHdhdGNoaW5nIC5wcm9qZW5yYy5qcyBhbmQgcmUtc3ludGggd2hlbiBjaGFuZ2VkLlxuICAgKiBAZGVmYXVsdCBmYWxzZVxuICAgKi9cbiAgcmVhZG9ubHkgd2F0Y2g/OiBib29sZWFuO1xuXG4gIC8qKlxuICAgKiBUaGUgbmFtZSBvZiB0aGUgLnByb2plbnJjLmpzIGZpbGUgIHRvIHVzZSBpbnN0ZWFkIG9mIHRoZSBkZWZhdWx0LlxuICAgKiBAZGVmYXVsdCBcIi5wcm9qZW5yYy5qc1wiXG4gICAqL1xuICByZWFkb25seSByY2ZpbGU/OiBzdHJpbmc7XG59XG5cbmV4cG9ydCBhc3luYyBmdW5jdGlvbiBzeW50aChydW50aW1lOiBUYXNrUnVudGltZSwgb3B0aW9uczogU3ludGhPcHRpb25zKSB7XG4gIGNvbnN0IHdvcmtkaXIgPSBydW50aW1lLndvcmtkaXI7XG4gIGNvbnN0IHJjZmlsZSA9IHBhdGgucmVzb2x2ZSh3b3JrZGlyLCBvcHRpb25zLnJjZmlsZSA/PyBQUk9KRU5fUkMpOyAvLyBUT0RPOiBzdXBwb3J0IG5vbiBqYXZhc2NyaXB0IHByb2plbnJjIChlLmcuIGphdmEgcHJvamVjdHMpXG5cbiAgLy8gaWYgLS1yYyBwb2ludHMgdG8gLnByb2plbnJjLmpzLCB0aGVuIGJlaGF2ZSBhcyBpZiBpdCB3YXNuJ3Qgc3BlY2lmaWVkLlxuICBpZiAocmNmaWxlID09PSBwYXRoLnJlc29sdmUod29ya2RpciwgUFJPSkVOX1JDKSkge1xuICAgIGRlbGV0ZSAob3B0aW9ucyBhcyBhbnkpLnJjZmlsZTtcbiAgfVxuXG4gIC8vIGlmIHRoZXJlIGFyZSBubyB0YXNrcywgd2UgYXNzdW1lIHRoaXMgaXMgbm90IGEgcHJvamVuIHByb2plY3QgKG1vZGVyblxuICAvLyBwcm9qZWN0cyBtdXN0IGF0IGxlYXN0IGhhdmUgdGhlIFwiZGVmYXVsdFwiIHRhc2spLlxuICBpZiAocnVudGltZS50YXNrcy5sZW5ndGggPT09IDAgJiYgIWZzLmV4aXN0c1N5bmMocmNmaWxlKSkge1xuICAgIGxvZ2dpbmcuZXJyb3IoJ1VuYWJsZSB0byBmaW5kIHByb2plbiBwcm9qZWN0LiBVc2UgXCJwcm9qZW4gbmV3XCIgdG8gY3JlYXRlIGEgbmV3IHByb2plY3QuJyk7XG4gICAgcHJvY2Vzcy5leGl0KDEpO1xuICB9XG5cbiAgLy8gcnVuIHN5bnRoIG9uY2VcbiAgY29uc3Qgc3VjY2VzcyA9IGF3YWl0IHRyeVN5bnRoKCk7XG5cbiAgaWYgKG9wdGlvbnMud2F0Y2gpIHtcbiAgICAvLyBpZiB3ZSBhcmUgaW4gd2F0Y2ggbW9kZSwgc3RhcnQgdGhlIHdhdGNoIGxvb3BcbiAgICB3YXRjaExvb3AoKTtcbiAgfSBlbHNlIGlmICghc3VjY2Vzcykge1xuICAgIC8vIG1ha2Ugc3VyZSBleGl0IGNvZGUgaXMgbm9uLXplcm8gaWYgd2UgYXJlIG5vdCBpbiB3YXRjaCBtb2RlXG4gICAgcHJvY2Vzcy5leGl0KDEpO1xuICB9XG5cbiAgYXN5bmMgZnVuY3Rpb24gdHJ5U3ludGgoKSB7XG4gICAgLy8gZGV0ZXJtaW5lIGlmIHBvc3Qgc3ludGhlc2lzIHRhc2tzIHNob3VsZCBiZSBleGVjdXRlZCAoZS5nLiBcInlhcm4gaW5zdGFsbFwiKS5cbiAgICBwcm9jZXNzLmVudi5QUk9KRU5fRElTQUJMRV9QT1NUID0gKCFvcHRpb25zLnBvc3QpLnRvU3RyaW5nKCk7XG4gICAgdHJ5IHtcbiAgICAgIGNvbnN0IGRlZmF1bHRUYXNrID0gcnVudGltZS50YXNrcy5maW5kKHQgPT4gdC5uYW1lID09PSBQcm9qZWN0LkRFRkFVTFRfVEFTSyk7XG5cbiAgICAgIC8vIGlmIFwiLS1yY1wiIGlzIHNwZWNpZmllZCwgaWdub3JlIHRoZSBkZWZhdWx0IHRhc2tcbiAgICAgIGlmIChkZWZhdWx0VGFzaykge1xuICAgICAgICBpZiAoIW9wdGlvbnMucmNmaWxlKSB7XG4gICAgICAgICAgcnVudGltZS5ydW5UYXNrKGRlZmF1bHRUYXNrLm5hbWUpO1xuICAgICAgICAgIHJldHVybiB0cnVlO1xuICAgICAgICB9IGVsc2Uge1xuICAgICAgICAgIGxvZ2dpbmcud2FybignRGVmYXVsdCB0YXNrIHNraXBwZWQuIFRyeWluZyBsZWdhY3kgc3ludGhlc2lzIHNpbmNlIC0tcmMgaXMgc3BlY2lmaWVkJyk7XG4gICAgICAgIH1cbiAgICAgIH1cblxuICAgICAgLy8gZm9yIGJhY2t3YXJkcyBjb21wYXRpYmlsaXR5LCBpZiB0aGVyZSBpcyBhIC5wcm9qZW5yYy5qcyBmaWxlLCBkZWZhdWx0IHRvIFwibm9kZSAucHJvamVucmMuanNcIlxuICAgICAgaWYgKHRyeUxlZ2FjeVN5bnRoKCkpIHtcbiAgICAgICAgcmV0dXJuIHRydWU7XG4gICAgICB9XG5cbiAgICAgIHRocm93IG5ldyBFcnJvcignVW5hYmxlIHRvIGZpbmQgYSB0YXNrIG5hbWVkIFwiZGVmYXVsdFwiJyk7XG4gICAgfSBjYXRjaCAoZSkge1xuICAgICAgbG9nZ2luZy5lcnJvcihgU3ludGhlc2lzIGZhaWxlZDogJHsoZSBhcyBhbnkpLm1lc3NhZ2V9YCk7XG4gICAgICByZXR1cm4gZmFsc2U7XG4gICAgfVxuICB9XG5cbiAgZnVuY3Rpb24gd2F0Y2hMb29wKCkge1xuICAgIGxvZ2dpbmcuaW5mbyhgV2F0Y2hpbmcgZm9yIGNoYW5nZXMgaW4gJHt3b3JrZGlyfS4uLmApO1xuICAgIGNvbnN0IHdhdGNoID0gZnMud2F0Y2god29ya2RpciwgeyByZWN1cnNpdmU6IHRydWUgfSk7XG4gICAgd2F0Y2gub24oJ2NoYW5nZScsIGV2ZW50ID0+IHtcbiAgICAgIC8vIHdlIG9ubHkgY2FyZSBhYm91dCBcImNoYW5nZVwiIGV2ZW50c1xuICAgICAgaWYgKGV2ZW50ICE9PSAnY2hhbmdlJykge1xuICAgICAgICByZXR1cm47XG4gICAgICB9XG5cbiAgICAgIHByb2Nlc3Muc3Rkb3V0LndyaXRlKCdcXHgxQmMnKTsgLy8gY2xlYXIgc2NyZWVuXG4gICAgICB3YXRjaC5jbG9zZSgpO1xuICAgICAgdHJ5U3ludGgoKVxuICAgICAgICAudGhlbigoKSA9PiB3YXRjaExvb3AoKSlcbiAgICAgICAgLmNhdGNoKCgpID0+IHdhdGNoTG9vcCgpKTtcbiAgICB9KTtcbiAgfVxuXG4gIGZ1bmN0aW9uIHRyeUxlZ2FjeVN5bnRoKCkge1xuICAgIGNvbnN0IHJjZGlyID0gcGF0aC5kaXJuYW1lKHJjZmlsZSk7XG5cbiAgICBpZiAoIWZzLmV4aXN0c1N5bmMocmNmaWxlKSkge1xuICAgICAgcmV0dXJuIGZhbHNlO1xuICAgIH1cblxuICAgIC8vIGlmIG5vZGVfbW9kdWxlcy9wcm9qZW4gaXMgbm90IGEgZGlyZWN0b3J5IG9yIGRvZXMgbm90IGV4aXN0LCBjcmVhdGUgYVxuICAgIC8vIHRlbXBvcmFyeSBzeW1saW5rIHRvIHRoZSBwcm9qZW4gdGhhdCB3ZSBhcmUgY3VycmVudGx5IHJ1bm5pbmcgaW4gb3JkZXIgdG9cbiAgICAvLyBhbGxvdyAucHJvamVucmMuanMgdG8gYHJlcXVpcmUoKWAgaXQuXG4gICAgY29uc3Qgbm9kZU1vZHVsZXMgPSBwYXRoLnJlc29sdmUocmNkaXIsICdub2RlX21vZHVsZXMnKTtcbiAgICBjb25zdCBwcm9qZW5Nb2R1bGVQYXRoID0gcGF0aC5yZXNvbHZlKG5vZGVNb2R1bGVzLCAncHJvamVuJyk7XG4gICAgaWYgKCFmcy5leGlzdHNTeW5jKHBhdGguam9pbihwcm9qZW5Nb2R1bGVQYXRoLCAncGFja2FnZS5qc29uJykpIHx8ICFmcy5zdGF0U3luYyhwcm9qZW5Nb2R1bGVQYXRoKS5pc0RpcmVjdG9yeSgpKSB7XG4gICAgICBmcy5yZW1vdmVTeW5jKHByb2plbk1vZHVsZVBhdGgpO1xuICAgICAgZnMubWtkaXJwU3luYyhub2RlTW9kdWxlcyk7XG4gICAgICBmcy5zeW1saW5rU3luYyhwcm9qZW5Nb2R1bGUsIHByb2plbk1vZHVsZVBhdGgsIChvcy5wbGF0Zm9ybSgpID09PSAnd2luMzInKSA/ICdqdW5jdGlvbicgOiBudWxsKTtcbiAgICB9XG5cbiAgICBjb25zdCByZXQgPSBzcGF3blN5bmMocHJvY2Vzcy5leGVjUGF0aCwgW3JjZmlsZV0sIHsgc3RkaW86IFsnaW5oZXJpdCcsICdpbmhlcml0JywgJ3BpcGUnXSB9KTtcbiAgICBpZiAocmV0LmVycm9yKSB7XG4gICAgICB0aHJvdyBuZXcgRXJyb3IoYFN5bnRoZXNpcyBmYWlsZWQ6ICR7cmV0LmVycm9yfWApO1xuICAgIH0gZWxzZSBpZiAocmV0LnN0YXR1cyAhPT0gMCkge1xuICAgICAgbG9nZ2luZy5lcnJvcihyZXQuc3RkZXJyLnRvU3RyaW5nKCkpO1xuICAgICAgdGhyb3cgbmV3IEVycm9yKGBTeW50aGVzaXMgZmFpbGVkOiBjYWxsaW5nIFwiJHtwcm9jZXNzLmV4ZWNQYXRofSAke3JjZmlsZX1cIiBleGl0ZWQgd2l0aCBzdGF0dXM9JHtyZXQuc3RhdHVzfWApO1xuICAgIH1cblxuICAgIHJldHVybiB0cnVlO1xuICB9XG59XG5cbiJdfQ==

package/lib/cli/tasks.d.ts

@@ -0,0 +1,7 @@
+import * as yargs from 'yargs';
+import { TaskRuntime } from '../task-runtime';
+/**
+ * Reads .projen/tasks.json and adds CLI commands for all tasks.
+ * @param ya yargs
+ */
+export declare function discoverTaskCommands(runtime: TaskRuntime, ya: yargs.Argv): void;

package/lib/cli/tasks.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.discoverTaskCommands = void 0;
+const chalk = require("chalk");
+const logging = require("../logging");
+/**
+ * Reads .projen/tasks.json and adds CLI commands for all tasks.
+ * @param ya yargs
+ */
+function discoverTaskCommands(runtime, ya) {
+    var _a, _b;
+    const tasks = (_a = runtime.manifest.tasks) !== null && _a !== void 0 ? _a : {};
+    for (const task of Object.values(tasks)) {
+        ya.command(task.name, (_b = task.description) !== null && _b !== void 0 ? _b : '', taskCommandHandler(task.name));
+    }
+    function taskCommandHandler(taskName) {
+        return (args) => {
+            args.option('inspect', { alias: 'i', desc: 'show all steps in this task' });
+            const argv = args.argv;
+            if (argv.inspect) {
+                return inspectTask(taskName);
+            }
+            else {
+                try {
+                    runtime.runTask(taskName);
+                }
+                catch (e) {
+                    logging.error(e.message);
+                    process.exit(1);
+                }
+            }
+        };
+    }
+    function inspectTask(name, indent = 0) {
+        var _a, _b;
+        const writeln = (s) => console.log(' '.repeat(indent) + s);
+        const task = runtime.tryFindTask(name);
+        if (!task) {
+            throw new Error(`${name}: unable to resolve subtask with name "${name}"`);
+        }
+        if (task.description) {
+            writeln(`${chalk.underline('description')}: ${task.description}`);
+        }
+        for (const [k, v] of Object.entries((_a = task.env) !== null && _a !== void 0 ? _a : {})) {
+            writeln(`${chalk.underline('env')}: ${k}=${v}`);
+        }
+        for (const step of (_b = task.steps) !== null && _b !== void 0 ? _b : []) {
+            if (step.spawn) {
+                writeln(`- ${chalk.bold(step.spawn)}`);
+                inspectTask(step.spawn, indent + 2);
+            }
+            else if (step.exec) {
+                writeln(`- exec: ${step.exec}`);
+            }
+            else if (step.builtin) {
+                writeln(`- builtin: ${step.builtin}`);
+            }
+        }
+    }
+}
+exports.discoverTaskCommands = discoverTaskCommands;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidGFza3MuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvY2xpL3Rhc2tzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQUFBLCtCQUErQjtBQUUvQixzQ0FBc0M7QUFHdEM7OztHQUdHO0FBQ0gsU0FBZ0Isb0JBQW9CLENBQUMsT0FBb0IsRUFBRSxFQUFjOztJQUN2RSxNQUFNLEtBQUssU0FBRyxPQUFPLENBQUMsUUFBUSxDQUFDLEtBQUssbUNBQUksRUFBRSxDQUFDO0lBQzNDLEtBQUssTUFBTSxJQUFJLElBQUksTUFBTSxDQUFDLE1BQU0sQ0FBQyxLQUFLLENBQUMsRUFBRTtRQUN2QyxFQUFFLENBQUMsT0FBTyxDQUFDLElBQUksQ0FBQyxJQUFJLFFBQUUsSUFBSSxDQUFDLFdBQVcsbUNBQUksRUFBRSxFQUFFLGtCQUFrQixDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsQ0FBQyxDQUFDO0tBQzlFO0lBRUQsU0FBUyxrQkFBa0IsQ0FBQyxRQUFnQjtRQUMxQyxPQUFPLENBQUMsSUFBZ0IsRUFBRSxFQUFFO1lBQzFCLElBQUksQ0FBQyxNQUFNLENBQUMsU0FBUyxFQUFFLEVBQUUsS0FBSyxFQUFFLEdBQUcsRUFBRSxJQUFJLEVBQUUsNkJBQTZCLEVBQUUsQ0FBQyxDQUFDO1lBRTVFLE1BQU0sSUFBSSxHQUFHLElBQUksQ0FBQyxJQUFJLENBQUM7WUFFdkIsSUFBSSxJQUFJLENBQUMsT0FBTyxFQUFFO2dCQUNoQixPQUFPLFdBQVcsQ0FBQyxRQUFRLENBQUMsQ0FBQzthQUM5QjtpQkFBTTtnQkFDTCxJQUFJO29CQUNGLE9BQU8sQ0FBQyxPQUFPLENBQUMsUUFBUSxDQUFDLENBQUM7aUJBQzNCO2dCQUFDLE9BQU8sQ0FBQyxFQUFFO29CQUNWLE9BQU8sQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDLE9BQU8sQ0FBQyxDQUFDO29CQUN6QixPQUFPLENBQUMsSUFBSSxDQUFDLENBQUMsQ0FBQyxDQUFDO2lCQUNqQjthQUNGO1FBQ0gsQ0FBQyxDQUFDO0lBQ0osQ0FBQztJQUVELFNBQVMsV0FBVyxDQUFDLElBQVksRUFBRSxNQUFNLEdBQUcsQ0FBQzs7UUFDM0MsTUFBTSxPQUFPLEdBQUcsQ0FBQyxDQUFTLEVBQUUsRUFBRSxDQUFDLE9BQU8sQ0FBQyxHQUFHLENBQUMsR0FBRyxDQUFDLE1BQU0sQ0FBQyxNQUFNLENBQUMsR0FBRyxDQUFDLENBQUMsQ0FBQztRQUVuRSxNQUFNLElBQUksR0FBRyxPQUFPLENBQUMsV0FBVyxDQUFDLElBQUksQ0FBQyxDQUFDO1FBQ3ZDLElBQUksQ0FBQyxJQUFJLEVBQUU7WUFDVCxNQUFNLElBQUksS0FBSyxDQUFDLEdBQUcsSUFBSSwwQ0FBMEMsSUFBSSxHQUFHLENBQUMsQ0FBQztTQUMzRTtRQUVELElBQUksSUFBSSxDQUFDLFdBQVcsRUFBRTtZQUNwQixPQUFPLENBQUMsR0FBRyxLQUFLLENBQUMsU0FBUyxDQUFDLGFBQWEsQ0FBQyxLQUFLLElBQUksQ0FBQyxXQUFXLEVBQUUsQ0FBQyxDQUFDO1NBQ25FO1FBRUQsS0FBSyxNQUFNLENBQUMsQ0FBQyxFQUFFLENBQUMsQ0FBQyxJQUFJLE1BQU0sQ0FBQyxPQUFPLE9BQUMsSUFBSSxDQUFDLEdBQUcsbUNBQUksRUFBRSxDQUFDLEVBQUU7WUFDbkQsT0FBTyxDQUFDLEdBQUcsS0FBSyxDQUFDLFNBQVMsQ0FBQyxLQUFLLENBQUMsS0FBSyxDQUFDLElBQUksQ0FBQyxFQUFFLENBQUMsQ0FBQztTQUNqRDtRQUVELEtBQUssTUFBTSxJQUFJLFVBQUksSUFBSSxDQUFDLEtBQUssbUNBQUksRUFBRSxFQUFFO1lBQ25DLElBQUksSUFBSSxDQUFDLEtBQUssRUFBRTtnQkFDZCxPQUFPLENBQUMsS0FBSyxLQUFLLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxLQUFLLENBQUMsRUFBRSxDQUFDLENBQUM7Z0JBQ3ZDLFdBQVcsQ0FBQyxJQUFJLENBQUMsS0FBSyxFQUFFLE1BQU0sR0FBRyxDQUFDLENBQUMsQ0FBQzthQUNyQztpQkFBTSxJQUFJLElBQUksQ0FBQyxJQUFJLEVBQUU7Z0JBQ3BCLE9BQU8sQ0FBQyxXQUFXLElBQUksQ0FBQyxJQUFJLEVBQUUsQ0FBQyxDQUFDO2FBQ2pDO2lCQUFNLElBQUksSUFBSSxDQUFDLE9BQU8sRUFBRTtnQkFDdkIsT0FBTyxDQUFDLGNBQWMsSUFBSSxDQUFDLE9BQU8sRUFBRSxDQUFDLENBQUM7YUFDdkM7U0FDRjtJQUNILENBQUM7QUFDSCxDQUFDO0FBcERELG9EQW9EQyIsInNvdXJjZXNDb250ZW50IjpbImltcG9ydCAqIGFzIGNoYWxrIGZyb20gJ2NoYWxrJztcbmltcG9ydCAqIGFzIHlhcmdzIGZyb20gJ3lhcmdzJztcbmltcG9ydCAqIGFzIGxvZ2dpbmcgZnJvbSAnLi4vbG9nZ2luZyc7XG5pbXBvcnQgeyBUYXNrUnVudGltZSB9IGZyb20gJy4uL3Rhc2stcnVudGltZSc7XG5cbi8qKlxuICogUmVhZHMgLnByb2plbi90YXNrcy5qc29uIGFuZCBhZGRzIENMSSBjb21tYW5kcyBmb3IgYWxsIHRhc2tzLlxuICogQHBhcmFtIHlhIHlhcmdzXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBkaXNjb3ZlclRhc2tDb21tYW5kcyhydW50aW1lOiBUYXNrUnVudGltZSwgeWE6IHlhcmdzLkFyZ3YpIHtcbiAgY29uc3QgdGFza3MgPSBydW50aW1lLm1hbmlmZXN0LnRhc2tzID8/IHt9O1xuICBmb3IgKGNvbnN0IHRhc2sgb2YgT2JqZWN0LnZhbHVlcyh0YXNrcykpIHtcbiAgICB5YS5jb21tYW5kKHRhc2submFtZSwgdGFzay5kZXNjcmlwdGlvbiA/PyAnJywgdGFza0NvbW1hbmRIYW5kbGVyKHRhc2submFtZSkpO1xuICB9XG5cbiAgZnVuY3Rpb24gdGFza0NvbW1hbmRIYW5kbGVyKHRhc2tOYW1lOiBzdHJpbmcpIHtcbiAgICByZXR1cm4gKGFyZ3M6IHlhcmdzLkFyZ3YpID0+IHtcbiAgICAgIGFyZ3Mub3B0aW9uKCdpbnNwZWN0JywgeyBhbGlhczogJ2knLCBkZXNjOiAnc2hvdyBhbGwgc3RlcHMgaW4gdGhpcyB0YXNrJyB9KTtcblxuICAgICAgY29uc3QgYXJndiA9IGFyZ3MuYXJndjtcblxuICAgICAgaWYgKGFyZ3YuaW5zcGVjdCkge1xuICAgICAgICByZXR1cm4gaW5zcGVjdFRhc2sodGFza05hbWUpO1xuICAgICAgfSBlbHNlIHtcbiAgICAgICAgdHJ5IHtcbiAgICAgICAgICBydW50aW1lLnJ1blRhc2sodGFza05hbWUpO1xuICAgICAgICB9IGNhdGNoIChlKSB7XG4gICAgICAgICAgbG9nZ2luZy5lcnJvcihlLm1lc3NhZ2UpO1xuICAgICAgICAgIHByb2Nlc3MuZXhpdCgxKTtcbiAgICAgICAgfVxuICAgICAgfVxuICAgIH07XG4gIH1cblxuICBmdW5jdGlvbiBpbnNwZWN0VGFzayhuYW1lOiBzdHJpbmcsIGluZGVudCA9IDApIHtcbiAgICBjb25zdCB3cml0ZWxuID0gKHM6IHN0cmluZykgPT4gY29uc29sZS5sb2coJyAnLnJlcGVhdChpbmRlbnQpICsgcyk7XG5cbiAgICBjb25zdCB0YXNrID0gcnVudGltZS50cnlGaW5kVGFzayhuYW1lKTtcbiAgICBpZiAoIXRhc2spIHtcbiAgICAgIHRocm93IG5ldyBFcnJvcihgJHtuYW1lfTogdW5hYmxlIHRvIHJlc29sdmUgc3VidGFzayB3aXRoIG5hbWUgXCIke25hbWV9XCJgKTtcbiAgICB9XG5cbiAgICBpZiAodGFzay5kZXNjcmlwdGlvbikge1xuICAgICAgd3JpdGVsbihgJHtjaGFsay51bmRlcmxpbmUoJ2Rlc2NyaXB0aW9uJyl9OiAke3Rhc2suZGVzY3JpcHRpb259YCk7XG4gICAgfVxuXG4gICAgZm9yIChjb25zdCBbaywgdl0gb2YgT2JqZWN0LmVudHJpZXModGFzay5lbnYgPz8ge30pKSB7XG4gICAgICB3cml0ZWxuKGAke2NoYWxrLnVuZGVybGluZSgnZW52Jyl9OiAke2t9PSR7dn1gKTtcbiAgICB9XG5cbiAgICBmb3IgKGNvbnN0IHN0ZXAgb2YgdGFzay5zdGVwcyA/PyBbXSkge1xuICAgICAgaWYgKHN0ZXAuc3Bhd24pIHtcbiAgICAgICAgd3JpdGVsbihgLSAke2NoYWxrLmJvbGQoc3RlcC5zcGF3bil9YCk7XG4gICAgICAgIGluc3BlY3RUYXNrKHN0ZXAuc3Bhd24sIGluZGVudCArIDIpO1xuICAgICAgfSBlbHNlIGlmIChzdGVwLmV4ZWMpIHtcbiAgICAgICAgd3JpdGVsbihgLSBleGVjOiAke3N0ZXAuZXhlY31gKTtcbiAgICAgIH0gZWxzZSBpZiAoc3RlcC5idWlsdGluKSB7XG4gICAgICAgIHdyaXRlbG4oYC0gYnVpbHRpbjogJHtzdGVwLmJ1aWx0aW59YCk7XG4gICAgICB9XG4gICAgfVxuICB9XG59Il19

package/lib/cli/util.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Installs the npm module (through `npm install`) to node_modules under `projectDir`.
+ * @param spec The npm package spec (e.g. `foo@^1.2` or `foo@/var/folders/8k/qcw0ls5pv_ph0000gn/T/projen-RYurCw/pkg.tgz`)
+ * @returns The installed package name (e.g. `@foo/bar`)
+ */
+export declare function installPackage(baseDir: string, spec: string): string;
+/**
+ * Render a command to install an npm package.
+ *
+ * Engine checks are ignorred at this point so that the module can be installed
+ * regardless of the environment. This was needed to unblock the upgrade of the
+ * minimum node version of projen, but also okay generally because engine checks
+ * will be performed later and for all eternety.
+ *
+ * @param dir Base directory
+ * @param module The module to install (e.g. foo@^1.2)
+ * @returns The string that includes the install command ("npm install ...")
+ */
+export declare function renderInstallCommand(dir: string, module: string): string;

package/lib/cli/util.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderInstallCommand = exports.installPackage = void 0;
+const path = require("path");
+const fs = require("fs-extra");
+const logging = require("../logging");
+const util_1 = require("../util");
+/**
+ * Installs the npm module (through `npm install`) to node_modules under `projectDir`.
+ * @param spec The npm package spec (e.g. `foo@^1.2` or `foo@/var/folders/8k/qcw0ls5pv_ph0000gn/T/projen-RYurCw/pkg.tgz`)
+ * @returns The installed package name (e.g. `@foo/bar`)
+ */
+function installPackage(baseDir, spec) {
+    const packageJsonPath = path.join(baseDir, 'package.json');
+    const packageJsonExisted = fs.existsSync(packageJsonPath);
+    if (!packageJsonExisted) {
+        // Make sure we have a package.json to read from later
+        util_1.exec('npm init --yes', { cwd: baseDir });
+    }
+    logging.info(`installing external module ${spec}...`);
+    util_1.exec(renderInstallCommand(baseDir, spec), { cwd: baseDir });
+    // Get the true installed package name
+    const packageJson = fs.readJsonSync(packageJsonPath);
+    const packageName = Object.keys(packageJson.devDependencies).find(name => name !== 'projen');
+    if (!packageName) {
+        throw new Error(`Unable to resolve package name from spec ${spec}`);
+    }
+    // if package.json did not exist before calling `npm install`, we should remove it
+    // so we can start off clean.
+    if (!packageJsonExisted) {
+        fs.removeSync(packageJsonPath);
+    }
+    return packageName;
+}
+exports.installPackage = installPackage;
+/**
+ * Render a command to install an npm package.
+ *
+ * Engine checks are ignorred at this point so that the module can be installed
+ * regardless of the environment. This was needed to unblock the upgrade of the
+ * minimum node version of projen, but also okay generally because engine checks
+ * will be performed later and for all eternety.
+ *
+ * @param dir Base directory
+ * @param module The module to install (e.g. foo@^1.2)
+ * @returns The string that includes the install command ("npm install ...")
+ */
+function renderInstallCommand(dir, module) {
+    return `npm install --save-dev -f --no-package-lock --prefix=${dir} ${module}`;
+}
+exports.renderInstallCommand = renderInstallCommand;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidXRpbC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9jbGkvdXRpbC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFBQSw2QkFBNkI7QUFDN0IsK0JBQStCO0FBQy9CLHNDQUFzQztBQUN0QyxrQ0FBK0I7QUFFL0I7Ozs7R0FJRztBQUNILFNBQWdCLGNBQWMsQ0FBQyxPQUFlLEVBQUUsSUFBWTtJQUMxRCxNQUFNLGVBQWUsR0FBRyxJQUFJLENBQUMsSUFBSSxDQUFDLE9BQU8sRUFBRSxjQUFjLENBQUMsQ0FBQztJQUMzRCxNQUFNLGtCQUFrQixHQUFHLEVBQUUsQ0FBQyxVQUFVLENBQUMsZUFBZSxDQUFDLENBQUM7SUFFMUQsSUFBSSxDQUFDLGtCQUFrQixFQUFFO1FBQ3ZCLHNEQUFzRDtRQUN0RCxXQUFJLENBQUMsZ0JBQWdCLEVBQUUsRUFBRSxHQUFHLEVBQUUsT0FBTyxFQUFFLENBQUMsQ0FBQztLQUMxQztJQUVELE9BQU8sQ0FBQyxJQUFJLENBQUMsOEJBQThCLElBQUksS0FBSyxDQUFDLENBQUM7SUFDdEQsV0FBSSxDQUFDLG9CQUFvQixDQUFDLE9BQU8sRUFBRSxJQUFJLENBQUMsRUFBRSxFQUFFLEdBQUcsRUFBRSxPQUFPLEVBQUUsQ0FBQyxDQUFDO0lBRTVELHNDQUFzQztJQUN0QyxNQUFNLFdBQVcsR0FBRyxFQUFFLENBQUMsWUFBWSxDQUFDLGVBQWUsQ0FBQyxDQUFDO0lBQ3JELE1BQU0sV0FBVyxHQUFHLE1BQU0sQ0FBQyxJQUFJLENBQUMsV0FBVyxDQUFDLGVBQWUsQ0FBQyxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsRUFBRSxDQUFDLElBQUksS0FBSyxRQUFRLENBQUMsQ0FBQztJQUU3RixJQUFJLENBQUMsV0FBVyxFQUFFO1FBQ2hCLE1BQU0sSUFBSSxLQUFLLENBQUMsNENBQTRDLElBQUksRUFBRSxDQUFDLENBQUM7S0FDckU7SUFFRCxrRkFBa0Y7SUFDbEYsNkJBQTZCO0lBQzdCLElBQUksQ0FBQyxrQkFBa0IsRUFBRTtRQUN2QixFQUFFLENBQUMsVUFBVSxDQUFDLGVBQWUsQ0FBQyxDQUFDO0tBQ2hDO0lBRUQsT0FBTyxXQUFXLENBQUM7QUFDckIsQ0FBQztBQTNCRCx3Q0EyQkM7QUFFRDs7Ozs7Ozs7Ozs7R0FXRztBQUNILFNBQWdCLG9CQUFvQixDQUFDLEdBQVcsRUFBRSxNQUFjO0lBQzlELE9BQU8sd0RBQXdELEdBQUcsSUFBSSxNQUFNLEVBQUUsQ0FBQztBQUNqRixDQUFDO0FBRkQsb0RBRUMiLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgKiBhcyBwYXRoIGZyb20gJ3BhdGgnO1xuaW1wb3J0ICogYXMgZnMgZnJvbSAnZnMtZXh0cmEnO1xuaW1wb3J0ICogYXMgbG9nZ2luZyBmcm9tICcuLi9sb2dnaW5nJztcbmltcG9ydCB7IGV4ZWMgfSBmcm9tICcuLi91dGlsJztcblxuLyoqXG4gKiBJbnN0YWxscyB0aGUgbnBtIG1vZHVsZSAodGhyb3VnaCBgbnBtIGluc3RhbGxgKSB0byBub2RlX21vZHVsZXMgdW5kZXIgYHByb2plY3REaXJgLlxuICogQHBhcmFtIHNwZWMgVGhlIG5wbSBwYWNrYWdlIHNwZWMgKGUuZy4gYGZvb0BeMS4yYCBvciBgZm9vQC92YXIvZm9sZGVycy84ay9xY3cwbHM1cHZfcGgwMDAwZ24vVC9wcm9qZW4tUll1ckN3L3BrZy50Z3pgKVxuICogQHJldHVybnMgVGhlIGluc3RhbGxlZCBwYWNrYWdlIG5hbWUgKGUuZy4gYEBmb28vYmFyYClcbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGluc3RhbGxQYWNrYWdlKGJhc2VEaXI6IHN0cmluZywgc3BlYzogc3RyaW5nKTogc3RyaW5nIHtcbiAgY29uc3QgcGFja2FnZUpzb25QYXRoID0gcGF0aC5qb2luKGJhc2VEaXIsICdwYWNrYWdlLmpzb24nKTtcbiAgY29uc3QgcGFja2FnZUpzb25FeGlzdGVkID0gZnMuZXhpc3RzU3luYyhwYWNrYWdlSnNvblBhdGgpO1xuXG4gIGlmICghcGFja2FnZUpzb25FeGlzdGVkKSB7XG4gICAgLy8gTWFrZSBzdXJlIHdlIGhhdmUgYSBwYWNrYWdlLmpzb24gdG8gcmVhZCBmcm9tIGxhdGVyXG4gICAgZXhlYygnbnBtIGluaXQgLS15ZXMnLCB7IGN3ZDogYmFzZURpciB9KTtcbiAgfVxuXG4gIGxvZ2dpbmcuaW5mbyhgaW5zdGFsbGluZyBleHRlcm5hbCBtb2R1bGUgJHtzcGVjfS4uLmApO1xuICBleGVjKHJlbmRlckluc3RhbGxDb21tYW5kKGJhc2VEaXIsIHNwZWMpLCB7IGN3ZDogYmFzZURpciB9KTtcblxuICAvLyBHZXQgdGhlIHRydWUgaW5zdGFsbGVkIHBhY2thZ2UgbmFtZVxuICBjb25zdCBwYWNrYWdlSnNvbiA9IGZzLnJlYWRKc29uU3luYyhwYWNrYWdlSnNvblBhdGgpO1xuICBjb25zdCBwYWNrYWdlTmFtZSA9IE9iamVjdC5rZXlzKHBhY2thZ2VKc29uLmRldkRlcGVuZGVuY2llcykuZmluZChuYW1lID0+IG5hbWUgIT09ICdwcm9qZW4nKTtcblxuICBpZiAoIXBhY2thZ2VOYW1lKSB7XG4gICAgdGhyb3cgbmV3IEVycm9yKGBVbmFibGUgdG8gcmVzb2x2ZSBwYWNrYWdlIG5hbWUgZnJvbSBzcGVjICR7c3BlY31gKTtcbiAgfVxuXG4gIC8vIGlmIHBhY2thZ2UuanNvbiBkaWQgbm90IGV4aXN0IGJlZm9yZSBjYWxsaW5nIGBucG0gaW5zdGFsbGAsIHdlIHNob3VsZCByZW1vdmUgaXRcbiAgLy8gc28gd2UgY2FuIHN0YXJ0IG9mZiBjbGVhbi5cbiAgaWYgKCFwYWNrYWdlSnNvbkV4aXN0ZWQpIHtcbiAgICBmcy5yZW1vdmVTeW5jKHBhY2thZ2VKc29uUGF0aCk7XG4gIH1cblxuICByZXR1cm4gcGFja2FnZU5hbWU7XG59XG5cbi8qKlxuICogUmVuZGVyIGEgY29tbWFuZCB0byBpbnN0YWxsIGFuIG5wbSBwYWNrYWdlLlxuICpcbiAqIEVuZ2luZSBjaGVja3MgYXJlIGlnbm9ycmVkIGF0IHRoaXMgcG9pbnQgc28gdGhhdCB0aGUgbW9kdWxlIGNhbiBiZSBpbnN0YWxsZWRcbiAqIHJlZ2FyZGxlc3Mgb2YgdGhlIGVudmlyb25tZW50LiBUaGlzIHdhcyBuZWVkZWQgdG8gdW5ibG9jayB0aGUgdXBncmFkZSBvZiB0aGVcbiAqIG1pbmltdW0gbm9kZSB2ZXJzaW9uIG9mIHByb2plbiwgYnV0IGFsc28gb2theSBnZW5lcmFsbHkgYmVjYXVzZSBlbmdpbmUgY2hlY2tzXG4gKiB3aWxsIGJlIHBlcmZvcm1lZCBsYXRlciBhbmQgZm9yIGFsbCBldGVybmV0eS5cbiAqXG4gKiBAcGFyYW0gZGlyIEJhc2UgZGlyZWN0b3J5XG4gKiBAcGFyYW0gbW9kdWxlIFRoZSBtb2R1bGUgdG8gaW5zdGFsbCAoZS5nLiBmb29AXjEuMilcbiAqIEByZXR1cm5zIFRoZSBzdHJpbmcgdGhhdCBpbmNsdWRlcyB0aGUgaW5zdGFsbCBjb21tYW5kIChcIm5wbSBpbnN0YWxsIC4uLlwiKVxuICovXG5leHBvcnQgZnVuY3Rpb24gcmVuZGVySW5zdGFsbENvbW1hbmQoZGlyOiBzdHJpbmcsIG1vZHVsZTogc3RyaW5nKTogc3RyaW5nIHtcbiAgcmV0dXJuIGBucG0gaW5zdGFsbCAtLXNhdmUtZGV2IC1mIC0tbm8tcGFja2FnZS1sb2NrIC0tcHJlZml4PSR7ZGlyfSAke21vZHVsZX1gO1xufVxuIl19

package/lib/clobber.d.ts

@@ -0,0 +1,5 @@
+import { Component } from './component';
+import { Project } from './project';
+export declare class Clobber extends Component {
+    constructor(project: Project);
+}

package/lib/clobber.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Clobber = void 0;
+const component_1 = require("./component");
+class Clobber extends component_1.Component {
+    constructor(project) {
+        super(project);
+        const task = this.project.addTask('clobber', {
+            description: 'hard resets to HEAD of origin and cleans the local repo',
+            condition: 'git diff --exit-code > /dev/null',
+            env: {
+                BRANCH: '$(git branch --show-current)',
+            },
+        });
+        task.exec('git checkout -b scratch', { name: 'save current HEAD in "scratch" branch' });
+        task.exec('git checkout $BRANCH');
+        task.exec('git fetch origin', { name: 'fetch latest changes from origin' });
+        task.exec('git reset --hard origin/$BRANCH', { name: 'hard reset to origin commit' });
+        task.exec('git clean -fdx', { name: 'clean all untracked files' });
+        task.say('ready to rock! (unpushed commits are under the "scratch" branch)');
+    }
+}
+exports.Clobber = Clobber;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xvYmJlci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9jbG9iYmVyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQUFBLDJDQUF3QztBQUd4QyxNQUFhLE9BQVEsU0FBUSxxQkFBUztJQUNwQyxZQUFZLE9BQWdCO1FBQzFCLEtBQUssQ0FBQyxPQUFPLENBQUMsQ0FBQztRQUVmLE1BQU0sSUFBSSxHQUFHLElBQUksQ0FBQyxPQUFPLENBQUMsT0FBTyxDQUFDLFNBQVMsRUFBRTtZQUMzQyxXQUFXLEVBQUUseURBQXlEO1lBQ3RFLFNBQVMsRUFBRSxrQ0FBa0M7WUFDN0MsR0FBRyxFQUFFO2dCQUNILE1BQU0sRUFBRSw4QkFBOEI7YUFDdkM7U0FDRixDQUFDLENBQUM7UUFFSCxJQUFJLENBQUMsSUFBSSxDQUFDLHlCQUF5QixFQUFFLEVBQUUsSUFBSSxFQUFFLHVDQUF1QyxFQUFFLENBQUMsQ0FBQztRQUN4RixJQUFJLENBQUMsSUFBSSxDQUFDLHNCQUFzQixDQUFDLENBQUM7UUFDbEMsSUFBSSxDQUFDLElBQUksQ0FBQyxrQkFBa0IsRUFBRSxFQUFFLElBQUksRUFBRSxrQ0FBa0MsRUFBRSxDQUFDLENBQUM7UUFDNUUsSUFBSSxDQUFDLElBQUksQ0FBQyxpQ0FBaUMsRUFBRSxFQUFFLElBQUksRUFBRSw2QkFBNkIsRUFBRSxDQUFDLENBQUM7UUFDdEYsSUFBSSxDQUFDLElBQUksQ0FBQyxnQkFBZ0IsRUFBRSxFQUFFLElBQUksRUFBRSwyQkFBMkIsRUFBRSxDQUFDLENBQUM7UUFDbkUsSUFBSSxDQUFDLEdBQUcsQ0FBQyxrRUFBa0UsQ0FBQyxDQUFDO0lBQy9FLENBQUM7Q0FDRjtBQW5CRCwwQkFtQkMiLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgeyBDb21wb25lbnQgfSBmcm9tICcuL2NvbXBvbmVudCc7XG5pbXBvcnQgeyBQcm9qZWN0IH0gZnJvbSAnLi9wcm9qZWN0JztcblxuZXhwb3J0IGNsYXNzIENsb2JiZXIgZXh0ZW5kcyBDb21wb25lbnQge1xuICBjb25zdHJ1Y3Rvcihwcm9qZWN0OiBQcm9qZWN0KSB7XG4gICAgc3VwZXIocHJvamVjdCk7XG5cbiAgICBjb25zdCB0YXNrID0gdGhpcy5wcm9qZWN0LmFkZFRhc2soJ2Nsb2JiZXInLCB7XG4gICAgICBkZXNjcmlwdGlvbjogJ2hhcmQgcmVzZXRzIHRvIEhFQUQgb2Ygb3JpZ2luIGFuZCBjbGVhbnMgdGhlIGxvY2FsIHJlcG8nLFxuICAgICAgY29uZGl0aW9uOiAnZ2l0IGRpZmYgLS1leGl0LWNvZGUgPiAvZGV2L251bGwnLFxuICAgICAgZW52OiB7XG4gICAgICAgIEJSQU5DSDogJyQoZ2l0IGJyYW5jaCAtLXNob3ctY3VycmVudCknLFxuICAgICAgfSxcbiAgICB9KTtcblxuICAgIHRhc2suZXhlYygnZ2l0IGNoZWNrb3V0IC1iIHNjcmF0Y2gnLCB7IG5hbWU6ICdzYXZlIGN1cnJlbnQgSEVBRCBpbiBcInNjcmF0Y2hcIiBicmFuY2gnIH0pO1xuICAgIHRhc2suZXhlYygnZ2l0IGNoZWNrb3V0ICRCUkFOQ0gnKTtcbiAgICB0YXNrLmV4ZWMoJ2dpdCBmZXRjaCBvcmlnaW4nLCB7IG5hbWU6ICdmZXRjaCBsYXRlc3QgY2hhbmdlcyBmcm9tIG9yaWdpbicgfSk7XG4gICAgdGFzay5leGVjKCdnaXQgcmVzZXQgLS1oYXJkIG9yaWdpbi8kQlJBTkNIJywgeyBuYW1lOiAnaGFyZCByZXNldCB0byBvcmlnaW4gY29tbWl0JyB9KTtcbiAgICB0YXNrLmV4ZWMoJ2dpdCBjbGVhbiAtZmR4JywgeyBuYW1lOiAnY2xlYW4gYWxsIHVudHJhY2tlZCBmaWxlcycgfSk7XG4gICAgdGFzay5zYXkoJ3JlYWR5IHRvIHJvY2shICh1bnB1c2hlZCBjb21taXRzIGFyZSB1bmRlciB0aGUgXCJzY3JhdGNoXCIgYnJhbmNoKScpO1xuICB9XG59Il19

package/lib/common.d.ts

@@ -0,0 +1,5 @@
+export declare const PROJEN_RC = ".projenrc.js";
+export declare const PROJEN_DIR = ".projen";
+export declare const PROJEN_MARKER: string;
+export declare const IS_TEST_RUN: boolean;
+export declare const PROJEN_VERSION: any;

package/lib/common.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PROJEN_VERSION = exports.IS_TEST_RUN = exports.PROJEN_MARKER = exports.PROJEN_DIR = exports.PROJEN_RC = void 0;
+exports.PROJEN_RC = '.projenrc.js';
+exports.PROJEN_DIR = '.projen';
+exports.PROJEN_MARKER = '~~ Generated by ' + 'projen'; // we split into two so /this/ file does not match the marker
+exports.IS_TEST_RUN = (process.env.NODE_ENV === 'test');
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+const packageVersion = require('../package.json').version;
+// if we are running with a test, report a fake stable version
+exports.PROJEN_VERSION = exports.IS_TEST_RUN
+    ? '99.99.99'
+    : packageVersion;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29tbW9uLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL2NvbW1vbi50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFBYSxRQUFBLFNBQVMsR0FBRyxjQUFjLENBQUM7QUFDM0IsUUFBQSxVQUFVLEdBQUcsU0FBUyxDQUFDO0FBQ3ZCLFFBQUEsYUFBYSxHQUFHLGtCQUFrQixHQUFHLFFBQVEsQ0FBQyxDQUFDLDZEQUE2RDtBQUU1RyxRQUFBLFdBQVcsR0FBRyxDQUFDLE9BQU8sQ0FBQyxHQUFHLENBQUMsUUFBUSxLQUFLLE1BQU0sQ0FBQyxDQUFDO0FBRTdELGlFQUFpRTtBQUNqRSxNQUFNLGNBQWMsR0FBRyxPQUFPLENBQUMsaUJBQWlCLENBQUMsQ0FBQyxPQUFPLENBQUM7QUFFMUQsOERBQThEO0FBQ2pELFFBQUEsY0FBYyxHQUFHLG1CQUFXO0lBQ3ZDLENBQUMsQ0FBQyxVQUFVO0lBQ1osQ0FBQyxDQUFDLGNBQWMsQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbImV4cG9ydCBjb25zdCBQUk9KRU5fUkMgPSAnLnByb2plbnJjLmpzJztcbmV4cG9ydCBjb25zdCBQUk9KRU5fRElSID0gJy5wcm9qZW4nO1xuZXhwb3J0IGNvbnN0IFBST0pFTl9NQVJLRVIgPSAnfn4gR2VuZXJhdGVkIGJ5ICcgKyAncHJvamVuJzsgLy8gd2Ugc3BsaXQgaW50byB0d28gc28gL3RoaXMvIGZpbGUgZG9lcyBub3QgbWF0Y2ggdGhlIG1hcmtlclxuXG5leHBvcnQgY29uc3QgSVNfVEVTVF9SVU4gPSAocHJvY2Vzcy5lbnYuTk9ERV9FTlYgPT09ICd0ZXN0Jyk7XG5cbi8vIGVzbGludC1kaXNhYmxlLW5leHQtbGluZSBAdHlwZXNjcmlwdC1lc2xpbnQvbm8tcmVxdWlyZS1pbXBvcnRzXG5jb25zdCBwYWNrYWdlVmVyc2lvbiA9IHJlcXVpcmUoJy4uL3BhY2thZ2UuanNvbicpLnZlcnNpb247XG5cbi8vIGlmIHdlIGFyZSBydW5uaW5nIHdpdGggYSB0ZXN0LCByZXBvcnQgYSBmYWtlIHN0YWJsZSB2ZXJzaW9uXG5leHBvcnQgY29uc3QgUFJPSkVOX1ZFUlNJT04gPSBJU19URVNUX1JVTlxuICA/ICc5OS45OS45OSdcbiAgOiBwYWNrYWdlVmVyc2lvbjtcbiJdfQ==

package/lib/component.d.ts

@@ -0,0 +1,33 @@
+import { Project } from './project';
+/**
+ * (experimental) Represents a project component.
+ *
+ * @experimental
+ */
+export declare class Component {
+    readonly project: Project;
+    /**
+     * @experimental
+     */
+    constructor(project: Project);
+    /**
+     * (experimental) Called before synthesis.
+     *
+     * @experimental
+     */
+    preSynthesize(): void;
+    /**
+     * (experimental) Synthesizes files to the project output directory.
+     *
+     * @experimental
+     */
+    synthesize(): void;
+    /**
+     * (experimental) Called after synthesis.
+     *
+     * Order is *not* guaranteed.
+     *
+     * @experimental
+     */
+    postSynthesize(): void;
+}

package/lib/component.js

@@ -0,0 +1,43 @@
+"use strict";
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Component = void 0;
+const JSII_RTTI_SYMBOL_1 = Symbol.for("jsii.rtti");
+/**
+ * (experimental) Represents a project component.
+ *
+ * @experimental
+ */
+class Component {
+    /**
+     * @experimental
+     */
+    constructor(project) {
+        this.project = project;
+        project._addComponent(this);
+    }
+    /**
+     * (experimental) Called before synthesis.
+     *
+     * @experimental
+     */
+    preSynthesize() { }
+    /**
+     * (experimental) Synthesizes files to the project output directory.
+     *
+     * @experimental
+     */
+    synthesize() { }
+    /**
+     * (experimental) Called after synthesis.
+     *
+     * Order is *not* guaranteed.
+     *
+     * @experimental
+     */
+    postSynthesize() { }
+}
+exports.Component = Component;
+_a = JSII_RTTI_SYMBOL_1;
+Component[_a] = { fqn: "projen.Component", version: "0.46.8" };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29tcG9uZW50LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL2NvbXBvbmVudC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7Ozs7Ozs7O0FBR0EsTUFBYSxTQUFTOzs7O0lBQ3BCLFlBQTRCLE9BQWdCO1FBQWhCLFlBQU8sR0FBUCxPQUFPLENBQVM7UUFDMUMsT0FBTyxDQUFDLGFBQWEsQ0FBQyxJQUFJLENBQUMsQ0FBQztJQUM5QixDQUFDOzs7Ozs7SUFHTSxhQUFhLEtBQUssQ0FBQzs7Ozs7O0lBR25CLFVBQVUsS0FBSSxDQUFDOzs7Ozs7OztJQUdmLGNBQWMsS0FBSSxDQUFDOztBQVo1Qiw4QkFhQyIsInNvdXJjZXNDb250ZW50IjpbImltcG9ydCB7IFByb2plY3QgfSBmcm9tICcuL3Byb2plY3QnO1xuXG4gICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICBcbmV4cG9ydCBjbGFzcyBDb21wb25lbnQge1xuICBjb25zdHJ1Y3RvcihwdWJsaWMgcmVhZG9ubHkgcHJvamVjdDogUHJvamVjdCkge1xuICAgIHByb2plY3QuX2FkZENvbXBvbmVudCh0aGlzKTtcbiAgfVxuXG4gICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIFxuICBwdWJsaWMgcHJlU3ludGhlc2l6ZSgpIHsgfVxuXG4gICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgXG4gIHB1YmxpYyBzeW50aGVzaXplKCkge31cblxuICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIFxuICBwdWJsaWMgcG9zdFN5bnRoZXNpemUoKSB7fVxufSJdfQ==

package/lib/dependencies.d.ts

@@ -0,0 +1,187 @@
+import { Component } from './component';
+import { Project } from './project';
+/**
+ * (experimental) The `Dependencies` component is responsible to track the list of dependencies a project has, and then used by project types as the model for rendering project-specific dependency manifests such as the dependencies section `package.json` files.
+ *
+ * To add a dependency you can use a project-type specific API such as
+ * `nodeProject.addDeps()` or use the generic API of `project.deps`:
+ *
+ * @experimental
+ */
+export declare class Dependencies extends Component {
+    /**
+     * (experimental) The project-relative path of the deps manifest file.
+     *
+     * @experimental
+     */
+    static readonly MANIFEST_FILE: string;
+    /**
+     * (experimental) Returns the coordinates of a dependency spec.
+     *
+     * Given `foo@^3.4.0` returns `{ name: "foo", version: "^3.4.0" }`.
+     * Given `bar@npm:@bar/legacy` returns `{ name: "bar", version: "npm:@bar/legacy" }`.
+     *
+     * @experimental
+     */
+    static parseDependency(spec: string): DependencyCoordinates;
+    private readonly _deps;
+    /**
+     * (experimental) Adds a dependencies component to the project.
+     *
+     * @param project The parent project.
+     * @experimental
+     */
+    constructor(project: Project);
+    /**
+     * (experimental) A copy of all dependencies recorded for this project.
+     *
+     * The list is sorted by type->name->version
+     *
+     * @experimental
+     */
+    get all(): Dependency[];
+    /**
+     * (experimental) Returns a dependency by name.
+     *
+     * Fails if there is no dependency defined by that name or if `type` is not
+     * provided and there is more then one dependency type for this dependency.
+     *
+     * @param name The name of the dependency.
+     * @param type The dependency type.
+     * @returns a copy (cannot be modified)
+     * @experimental
+     */
+    getDependency(name: string, type?: DependencyType): Dependency;
+    /**
+     * (experimental) Returns a dependency by name.
+     *
+     * Returns `undefined` if there is no dependency defined by that name or if
+     * `type` is not provided and there is more then one dependency type for this
+     * dependency.
+     *
+     * @param name The name of the dependency.
+     * @param type The dependency type.
+     * @returns a copy (cannot be modified) or undefined if there is no match
+     * @experimental
+     */
+    tryGetDependency(name: string, type?: DependencyType): Dependency | undefined;
+    /**
+     * (experimental) Adds a dependency to this project.
+     *
+     * @param spec The dependency spec in the format `MODULE[@VERSION]` where `MODULE` is the package-manager-specific module name and `VERSION` is an optional semantic version requirement (e.g. `^3.4.0`).
+     * @param type The type of the dependency.
+     * @experimental
+     */
+    addDependency(spec: string, type: DependencyType, metadata?: {
+        [key: string]: any;
+    }): Dependency;
+    /**
+     * (experimental) Removes a dependency.
+     *
+     * @param name The name of the module to remove (without the version).
+     * @param type The dependency type.
+     * @experimental
+     */
+    removeDependency(name: string, type?: DependencyType): void;
+    private tryGetDependencyIndex;
+    private toJson;
+}
+/**
+ * @experimental
+ */
+export interface DepsManifest {
+    /**
+     * (experimental) All dependencies of this module.
+     *
+     * @experimental
+     */
+    readonly dependencies: Dependency[];
+}
+/**
+ * (experimental) Coordinates of the dependency (name and version).
+ *
+ * @experimental
+ */
+export interface DependencyCoordinates {
+    /**
+     * (experimental) The package manager name of the dependency (e.g. `leftpad` for npm).
+     *
+     * NOTE: For package managers that use complex coordinates (like Maven), we
+     * will codify it into a string somehow.
+     *
+     * @experimental
+     */
+    readonly name: string;
+    /**
+     * (experimental) Semantic version version requirement.
+     *
+     * @default - requirement is managed by the package manager (e.g. npm/yarn).
+     * @experimental
+     */
+    readonly version?: string;
+}
+/**
+ * (experimental) Represents a project dependency.
+ *
+ * @experimental
+ */
+export interface Dependency extends DependencyCoordinates {
+    /**
+     * (experimental) Which type of dependency this is (runtime, build-time, etc).
+     *
+     * @experimental
+     */
+    readonly type: DependencyType;
+    /**
+     * (experimental) Additional JSON metadata associated with the dependency (package manager specific).
+     *
+     * @default {}
+     * @experimental
+     */
+    readonly metadata?: {
+        [key: string]: any;
+    };
+}
+/**
+ * (experimental) Type of dependency.
+ *
+ * @experimental
+ */
+export declare enum DependencyType {
+    /**
+     * (experimental) The dependency is required for the program/library during runtime.
+     *
+     * @experimental
+     */
+    RUNTIME = "runtime",
+    /**
+     * (experimental) The dependency is required at runtime but expected to be installed by the consumer.
+     *
+     * @experimental
+     */
+    PEER = "peer",
+    /**
+     * (experimental) The dependency is bundled and shipped with the module, so consumers are not required to install it.
+     *
+     * @experimental
+     */
+    BUNDLED = "bundled",
+    /**
+     * (experimental) The dependency is required to run the `build` task.
+     *
+     * @experimental
+     */
+    BUILD = "build",
+    /**
+     * (experimental) The dependency is required to run the `test` task.
+     *
+     * @experimental
+     */
+    TEST = "test",
+    /**
+     * (experimental) The dependency is required for development (e.g. IDE plugins).
+     *
+     * @experimental
+     */
+    DEVENV = "devenv"
+}