@ohos-ports/nx 19.8.4-beta.0

package/src/command-line/run/run-one.js

@@ -0,0 +1,116 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runOne = runOne;
+const run_command_1 = require("../../tasks-runner/run-command");
+const command_line_utils_1 = require("../../utils/command-line-utils");
+const connect_to_nx_cloud_1 = require("../connect/connect-to-nx-cloud");
+const perf_hooks_1 = require("perf_hooks");
+const project_graph_1 = require("../../project-graph/project-graph");
+const workspace_root_1 = require("../../utils/workspace-root");
+const split_target_1 = require("../../utils/split-target");
+const output_1 = require("../../utils/output");
+const configuration_1 = require("../../config/configuration");
+const calculate_default_project_name_1 = require("../../config/calculate-default-project-name");
+const workspace_configuration_check_1 = require("../../utils/workspace-configuration-check");
+const graph_1 = require("../graph/graph");
+async function runOne(cwd, args, extraTargetDependencies = {}, extraOptions = {
+    excludeTaskDependencies: args.excludeTaskDependencies,
+    loadDotEnvFiles: process.env.NX_LOAD_DOT_ENV_FILES !== 'false',
+}) {
+    perf_hooks_1.performance.mark('code-loading:end');
+    perf_hooks_1.performance.measure('code-loading', 'init-local', 'code-loading:end');
+    (0, workspace_configuration_check_1.workspaceConfigurationCheck)();
+    const nxJson = (0, configuration_1.readNxJson)();
+    const projectGraph = await (0, project_graph_1.createProjectGraphAsync)();
+    const opts = parseRunOneOptions(cwd, args, projectGraph, nxJson);
+    const { nxArgs, overrides } = (0, command_line_utils_1.splitArgsIntoNxArgsAndOverrides)({
+        ...opts.parsedArgs,
+        configuration: opts.configuration,
+        targets: [opts.target],
+    }, 'run-one', { printWarnings: args.graph !== 'stdout' }, nxJson);
+    if (nxArgs.help) {
+        await (await Promise.resolve().then(() => require('./run'))).printTargetRunHelp(opts, workspace_root_1.workspaceRoot);
+        process.exit(0);
+    }
+    await (0, connect_to_nx_cloud_1.connectToNxCloudIfExplicitlyAsked)(nxArgs);
+    const { projects } = getProjects(projectGraph, opts.project);
+    if (nxArgs.graph) {
+        const projectNames = projects.map((t) => t.name);
+        const file = (0, command_line_utils_1.readGraphFileFromGraphArg)(nxArgs);
+        return await (0, graph_1.generateGraph)({
+            watch: true,
+            open: true,
+            view: 'tasks',
+            targets: nxArgs.targets,
+            projects: projectNames,
+            file,
+        }, projectNames);
+    }
+    else {
+        const status = await (0, run_command_1.runCommand)(projects, projectGraph, { nxJson }, nxArgs, overrides, opts.project, extraTargetDependencies, extraOptions);
+        process.exit(status);
+    }
+}
+function getProjects(projectGraph, project) {
+    if (!projectGraph.nodes[project]) {
+        output_1.output.error({
+            title: `Cannot find project '${project}'`,
+        });
+        process.exit(1);
+    }
+    let projects = [projectGraph.nodes[project]];
+    let projectsMap = {
+        [project]: projectGraph.nodes[project],
+    };
+    return { projects, projectsMap };
+}
+const targetAliases = {
+    b: 'build',
+    e: 'e2e',
+    l: 'lint',
+    s: 'serve',
+    t: 'test',
+};
+function parseRunOneOptions(cwd, parsedArgs, projectGraph, nxJson) {
+    const defaultProjectName = (0, calculate_default_project_name_1.calculateDefaultProjectName)(cwd, workspace_root_1.workspaceRoot, (0, project_graph_1.readProjectsConfigurationFromProjectGraph)(projectGraph), nxJson);
+    let project;
+    let target;
+    let configuration;
+    if (parsedArgs['project:target:configuration']?.indexOf(':') > -1) {
+        // run case
+        [project, target, configuration] = (0, split_target_1.splitTarget)(parsedArgs['project:target:configuration'], projectGraph);
+        // this is to account for "nx npmsript:dev"
+        if (project && !target && defaultProjectName) {
+            target = project;
+            project = defaultProjectName;
+        }
+    }
+    else {
+        target = parsedArgs.target ?? parsedArgs['project:target:configuration'];
+    }
+    if (parsedArgs.project) {
+        project = parsedArgs.project;
+    }
+    if (!project && defaultProjectName) {
+        project = defaultProjectName;
+    }
+    if (!project || !target) {
+        throw new Error(`Both project and target have to be specified`);
+    }
+    if (targetAliases[target]) {
+        target = targetAliases[target];
+    }
+    if (parsedArgs.configuration) {
+        configuration = parsedArgs.configuration;
+    }
+    else if (parsedArgs.prod) {
+        configuration = 'production';
+    }
+    const res = { project, target, configuration, parsedArgs };
+    delete parsedArgs['c'];
+    delete parsedArgs['project:target:configuration'];
+    delete parsedArgs['configuration'];
+    delete parsedArgs['prod'];
+    delete parsedArgs['project'];
+    return res;
+}

package/src/command-line/run/run.d.ts

@@ -0,0 +1,51 @@
+import { Schema } from '../../utils/params';
+import { ProjectsConfigurations } from '../../config/workspace-json-project-json';
+import { ExecutorContext } from '../../config/misc-interfaces';
+import { TaskGraph } from '../../config/task-graph';
+export interface Target {
+    project: string;
+    target: string;
+    configuration?: string;
+}
+export declare function printRunHelp(opts: {
+    project: string;
+    target: string;
+}, schema: Schema, plugin: {
+    plugin: string;
+    entity: string;
+}): void;
+export declare function validateProject(projects: ProjectsConfigurations, projectName: string): void;
+/**
+ * Loads and invokes executor.
+ *
+ * This is analogous to invoking executor from the terminal, with the exception
+ * that the params aren't parsed from the string, but instead provided parsed already.
+ *
+ * Apart from that, it works the same way:
+ *
+ * - it will load the workspace configuration
+ * - it will resolve the target
+ * - it will load the executor and the schema
+ * - it will load the options for the appropriate configuration
+ * - it will run the validations and will set the default
+ * - and, of course, it will invoke the executor
+ *
+ * Example:
+ *
+ * ```typescript
+ * for await (const s of await runExecutor({project: 'myproj', target: 'serve'}, {watch: true}, context)) {
+ *   // s.success
+ * }
+ * ```
+ *
+ * Note that the return value is a promise of an iterator, so you need to await before iterating over it.
+ */
+export declare function runExecutor<T extends {
+    success: boolean;
+}>(targetDescription: Target, overrides: {
+    [k: string]: any;
+}, context: ExecutorContext): Promise<AsyncIterableIterator<T>>;
+export declare function printTargetRunHelp(targetDescription: Target, root: string): Promise<number>;
+export declare function run(cwd: string, root: string, targetDescription: Target, overrides: {
+    [k: string]: any;
+}, isVerbose: boolean, taskGraph: TaskGraph): Promise<number>;

package/src/command-line/run/run.js

@@ -0,0 +1,179 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.printRunHelp = printRunHelp;
+exports.validateProject = validateProject;
+exports.runExecutor = runExecutor;
+exports.printTargetRunHelp = printTargetRunHelp;
+exports.run = run;
+const npm_run_path_1 = require("npm-run-path");
+const params_1 = require("../../utils/params");
+const handle_errors_1 = require("../../utils/handle-errors");
+const print_help_1 = require("../../utils/print-help");
+const path_1 = require("path");
+const serialize_overrides_into_command_line_1 = require("../../utils/serialize-overrides-into-command-line");
+const project_graph_1 = require("../../project-graph/project-graph");
+const configuration_1 = require("../../config/configuration");
+const async_iterator_1 = require("../../utils/async-iterator");
+const executor_utils_1 = require("./executor-utils");
+const pseudo_terminal_1 = require("../../tasks-runner/pseudo-terminal");
+const child_process_1 = require("child_process");
+function printRunHelp(opts, schema, plugin) {
+    (0, print_help_1.printHelp)(`run ${opts.project}:${opts.target}`, schema, {
+        mode: 'run',
+        ...plugin,
+    });
+}
+function validateProject(projects, projectName) {
+    const project = projects.projects[projectName];
+    if (!project) {
+        throw new Error(`Could not find project "${projectName}"`);
+    }
+}
+function isPromise(v) {
+    return typeof v?.then === 'function';
+}
+async function* promiseToIterator(v) {
+    yield await v;
+}
+async function iteratorToProcessStatusCode(i) {
+    const { success } = await (0, async_iterator_1.getLastValueFromAsyncIterableIterator)(i);
+    return success ? 0 : 1;
+}
+async function parseExecutorAndTarget({ project, target }, root, projectsConfigurations) {
+    const proj = projectsConfigurations.projects[project];
+    const targetConfig = proj.targets?.[target];
+    if (!targetConfig) {
+        throw new Error(`Cannot find target '${target}' for project '${project}'`);
+    }
+    const [nodeModule, executor] = targetConfig.executor.split(':');
+    const { schema, implementationFactory } = (0, executor_utils_1.getExecutorInformation)(nodeModule, executor, root, projectsConfigurations.projects);
+    return { executor, implementationFactory, nodeModule, schema, targetConfig };
+}
+async function printTargetRunHelpInternal({ project, target }, root, projectsConfigurations) {
+    const { executor, nodeModule, schema, targetConfig } = await parseExecutorAndTarget({ project, target }, root, projectsConfigurations);
+    printRunHelp({ project, target }, schema, {
+        plugin: nodeModule,
+        entity: executor,
+    });
+    if (nodeModule === 'nx' &&
+        executor === 'run-commands' &&
+        targetConfig.options.command) {
+        const command = targetConfig.options.command.split(' ')[0];
+        const helpCommand = `${command} --help`;
+        const localEnv = (0, npm_run_path_1.env)();
+        const env = {
+            ...process.env,
+            ...localEnv,
+        };
+        if (pseudo_terminal_1.PseudoTerminal.isSupported()) {
+            const terminal = (0, pseudo_terminal_1.getPseudoTerminal)();
+            await new Promise(() => {
+                const cp = terminal.runCommand(helpCommand, { jsEnv: env });
+                cp.onExit((code) => {
+                    process.exit(code);
+                });
+            });
+        }
+        else {
+            const cp = (0, child_process_1.exec)(helpCommand, {
+                env,
+                windowsHide: true,
+            });
+            cp.on('exit', (code) => {
+                process.exit(code);
+            });
+        }
+    }
+    else {
+        process.exit(0);
+    }
+}
+async function runExecutorInternal({ project, target, configuration }, overrides, root, cwd, projectsConfigurations, nxJsonConfiguration, projectGraph, taskGraph, isVerbose) {
+    validateProject(projectsConfigurations, project);
+    const { executor, implementationFactory, nodeModule, schema, targetConfig } = await parseExecutorAndTarget({ project, target, configuration }, root, projectsConfigurations);
+    configuration ??= targetConfig.defaultConfiguration;
+    const combinedOptions = (0, params_1.combineOptionsForExecutor)(overrides, configuration, targetConfig, schema, project, (0, path_1.relative)(root, cwd), isVerbose);
+    if ((0, executor_utils_1.getExecutorInformation)(nodeModule, executor, root, projectsConfigurations.projects).isNxExecutor) {
+        const implementation = implementationFactory();
+        const r = implementation(combinedOptions, {
+            root,
+            target: targetConfig,
+            projectsConfigurations,
+            nxJsonConfiguration,
+            workspace: { ...projectsConfigurations, ...nxJsonConfiguration },
+            projectName: project,
+            targetName: target,
+            configurationName: configuration,
+            projectGraph,
+            taskGraph,
+            cwd,
+            isVerbose,
+        });
+        if (isPromise(r)) {
+            return promiseToIterator(r);
+        }
+        else if ((0, async_iterator_1.isAsyncIterator)(r)) {
+            return r;
+        }
+        else {
+            throw new TypeError(`NX Executor "${targetConfig.executor}" should return either a Promise or an AsyncIterator`);
+        }
+    }
+    else {
+        require('../../adapter/compat');
+        const observable = await (await Promise.resolve().then(() => require('../../adapter/ngcli-adapter'))).scheduleTarget(root, {
+            project,
+            target,
+            configuration,
+            runOptions: combinedOptions,
+            projects: projectsConfigurations.projects,
+        }, isVerbose);
+        const { eachValueFrom } = await Promise.resolve().then(() => require('../../adapter/rxjs-for-await'));
+        return eachValueFrom(observable);
+    }
+}
+/**
+ * Loads and invokes executor.
+ *
+ * This is analogous to invoking executor from the terminal, with the exception
+ * that the params aren't parsed from the string, but instead provided parsed already.
+ *
+ * Apart from that, it works the same way:
+ *
+ * - it will load the workspace configuration
+ * - it will resolve the target
+ * - it will load the executor and the schema
+ * - it will load the options for the appropriate configuration
+ * - it will run the validations and will set the default
+ * - and, of course, it will invoke the executor
+ *
+ * Example:
+ *
+ * ```typescript
+ * for await (const s of await runExecutor({project: 'myproj', target: 'serve'}, {watch: true}, context)) {
+ *   // s.success
+ * }
+ * ```
+ *
+ * Note that the return value is a promise of an iterator, so you need to await before iterating over it.
+ */
+async function runExecutor(targetDescription, overrides, context) {
+    return await runExecutorInternal(targetDescription, {
+        ...overrides,
+        __overrides_unparsed__: (0, serialize_overrides_into_command_line_1.serializeOverridesIntoCommandLine)(overrides),
+    }, context.root, context.cwd, context.projectsConfigurations, context.nxJsonConfiguration, context.projectGraph, context.taskGraph, context.isVerbose);
+}
+function printTargetRunHelp(targetDescription, root) {
+    const projectGraph = (0, project_graph_1.readCachedProjectGraph)();
+    return (0, handle_errors_1.handleErrors)(false, async () => {
+        const projectsConfigurations = (0, project_graph_1.readProjectsConfigurationFromProjectGraph)(projectGraph);
+        await printTargetRunHelpInternal(targetDescription, root, projectsConfigurations);
+    });
+}
+function run(cwd, root, targetDescription, overrides, isVerbose, taskGraph) {
+    const projectGraph = (0, project_graph_1.readCachedProjectGraph)();
+    return (0, handle_errors_1.handleErrors)(isVerbose, async () => {
+        const projectsConfigurations = (0, project_graph_1.readProjectsConfigurationFromProjectGraph)(projectGraph);
+        return iteratorToProcessStatusCode(await runExecutorInternal(targetDescription, overrides, root, cwd, projectsConfigurations, (0, configuration_1.readNxJson)(), projectGraph, taskGraph, isVerbose));
+    });
+}

package/src/command-line/run-many/command-object.d.ts

@@ -0,0 +1,2 @@
+import { CommandModule } from 'yargs';
+export declare const yargsRunManyCommand: CommandModule;

package/src/command-line/run-many/command-object.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.yargsRunManyCommand = void 0;
+const documentation_1 = require("../yargs-utils/documentation");
+const shared_options_1 = require("../yargs-utils/shared-options");
+const handle_errors_1 = require("../../utils/handle-errors");
+exports.yargsRunManyCommand = {
+    command: 'run-many',
+    describe: 'Run target for multiple listed projects.',
+    builder: (yargs) => (0, documentation_1.linkToNxDevAndExamples)((0, shared_options_1.withRunManyOptions)((0, shared_options_1.withOutputStyleOption)((0, shared_options_1.withTargetAndConfigurationOption)((0, shared_options_1.withBatch)(yargs)))), 'run-many'),
+    handler: async (args) => {
+        const exitCode = await (0, handle_errors_1.handleErrors)(args.verbose ?? process.env.NX_VERBOSE_LOGGING === 'true', async () => {
+            await Promise.resolve().then(() => require('./run-many')).then((m) => m.runMany((0, shared_options_1.withOverrides)(args)));
+        });
+        process.exit(exitCode);
+    },
+};

package/src/command-line/run-many/run-many.d.ts

@@ -0,0 +1,10 @@
+import { NxArgs } from '../../utils/command-line-utils';
+import { ProjectGraph, ProjectGraphProjectNode } from '../../config/project-graph';
+import { TargetDependencyConfig } from '../../config/workspace-json-project-json';
+export declare function runMany(args: {
+    [k: string]: any;
+}, extraTargetDependencies?: Record<string, (TargetDependencyConfig | string)[]>, extraOptions?: {
+    excludeTaskDependencies: boolean;
+    loadDotEnvFiles: boolean;
+}): Promise<void>;
+export declare function projectsToRun(nxArgs: NxArgs, projectGraph: ProjectGraph): ProjectGraphProjectNode[];

package/src/command-line/run-many/run-many.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runMany = runMany;
+exports.projectsToRun = projectsToRun;
+const run_command_1 = require("../../tasks-runner/run-command");
+const command_line_utils_1 = require("../../utils/command-line-utils");
+const command_line_utils_2 = require("../../utils/command-line-utils");
+const project_graph_utils_1 = require("../../utils/project-graph-utils");
+const connect_to_nx_cloud_1 = require("../connect/connect-to-nx-cloud");
+const perf_hooks_1 = require("perf_hooks");
+const project_graph_1 = require("../../project-graph/project-graph");
+const configuration_1 = require("../../config/configuration");
+const output_1 = require("../../utils/output");
+const find_matching_projects_1 = require("../../utils/find-matching-projects");
+const workspace_configuration_check_1 = require("../../utils/workspace-configuration-check");
+const graph_1 = require("../graph/graph");
+async function runMany(args, extraTargetDependencies = {}, extraOptions = {
+    excludeTaskDependencies: args.excludeTaskDependencies,
+    loadDotEnvFiles: process.env.NX_LOAD_DOT_ENV_FILES !== 'false',
+}) {
+    perf_hooks_1.performance.mark('code-loading:end');
+    perf_hooks_1.performance.measure('code-loading', 'init-local', 'code-loading:end');
+    (0, workspace_configuration_check_1.workspaceConfigurationCheck)();
+    const nxJson = (0, configuration_1.readNxJson)();
+    const { nxArgs, overrides } = (0, command_line_utils_2.splitArgsIntoNxArgsAndOverrides)(args, 'run-many', { printWarnings: args.graph !== 'stdout' }, nxJson);
+    if (nxArgs.verbose) {
+        process.env.NX_VERBOSE_LOGGING = 'true';
+    }
+    await (0, connect_to_nx_cloud_1.connectToNxCloudIfExplicitlyAsked)(nxArgs);
+    const projectGraph = await (0, project_graph_1.createProjectGraphAsync)({ exitOnError: true });
+    const projects = projectsToRun(nxArgs, projectGraph);
+    if (nxArgs.graph) {
+        const file = (0, command_line_utils_1.readGraphFileFromGraphArg)(nxArgs);
+        const projectNames = projects.map((t) => t.name);
+        return await (0, graph_1.generateGraph)({
+            watch: true,
+            open: true,
+            view: 'tasks',
+            all: nxArgs.all,
+            targets: nxArgs.targets,
+            projects: projectNames,
+            file,
+        }, projectNames);
+    }
+    else {
+        const status = await (0, run_command_1.runCommand)(projects, projectGraph, { nxJson }, nxArgs, overrides, null, extraTargetDependencies, extraOptions);
+        process.exit(status);
+    }
+}
+function projectsToRun(nxArgs, projectGraph) {
+    const selectedProjects = {};
+    const validProjects = runnableForTarget(projectGraph.nodes, nxArgs.targets);
+    const invalidProjects = [];
+    // --all is default now, if --projects is provided, it'll override the --all
+    if (nxArgs.all && nxArgs.projects.length === 0) {
+        for (const projectName of validProjects) {
+            selectedProjects[projectName] = projectGraph.nodes[projectName];
+        }
+    }
+    else {
+        const matchingProjects = (0, find_matching_projects_1.findMatchingProjects)(nxArgs.projects, projectGraph.nodes);
+        for (const project of matchingProjects) {
+            if (!validProjects.has(project)) {
+                invalidProjects.push(project);
+            }
+            else {
+                selectedProjects[project] = projectGraph.nodes[project];
+            }
+        }
+        if (invalidProjects.length > 0) {
+            output_1.output.warn({
+                title: `The following projects do not have a configuration for any of the provided targets ("${nxArgs.targets.join(', ')}")`,
+                bodyLines: invalidProjects.map((name) => `- ${name}`),
+            });
+        }
+    }
+    const excludedProjects = (0, find_matching_projects_1.findMatchingProjects)(nxArgs.exclude, selectedProjects);
+    for (const excludedProject of excludedProjects) {
+        delete selectedProjects[excludedProject];
+    }
+    return Object.values(selectedProjects);
+}
+function runnableForTarget(projects, targets) {
+    const runnable = new Set();
+    for (let projectName in projects) {
+        const project = projects[projectName];
+        if (targets.find((target) => (0, project_graph_utils_1.projectHasTarget)(project, target))) {
+            runnable.add(projectName);
+        }
+    }
+    return runnable;
+}

package/src/command-line/show/command-object.d.ts

@@ -0,0 +1,26 @@
+import type { ProjectGraphProjectNode } from '../../config/project-graph';
+import { CommandModule } from 'yargs';
+export interface NxShowArgs {
+    json?: boolean;
+}
+export type ShowProjectsOptions = NxShowArgs & {
+    exclude?: string[];
+    files?: string;
+    uncommitted?: any;
+    untracked?: any;
+    base?: string;
+    head?: string;
+    affected?: boolean;
+    type?: ProjectGraphProjectNode['type'];
+    projects?: string[];
+    withTarget?: string[];
+    verbose?: boolean;
+    sep?: string;
+};
+export type ShowProjectOptions = NxShowArgs & {
+    projectName: string;
+    web?: boolean;
+    open?: boolean;
+    verbose?: boolean;
+};
+export declare const yargsShowCommand: CommandModule<Record<string, unknown>, NxShowArgs>;

package/src/command-line/show/command-object.js

@@ -0,0 +1,115 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.yargsShowCommand = void 0;
+const yargs_1 = require("yargs");
+const shared_options_1 = require("../yargs-utils/shared-options");
+const handle_errors_1 = require("../../utils/handle-errors");
+exports.yargsShowCommand = {
+    command: 'show',
+    describe: 'Show information about the workspace (e.g., list of projects).',
+    builder: (yargs) => yargs
+        .command(showProjectsCommand)
+        .command(showProjectCommand)
+        .demandCommand()
+        .option('json', {
+        type: 'boolean',
+        description: 'Output JSON.',
+    })
+        .example('$0 show projects', 'Show a list of all projects in the workspace')
+        .example('$0 show projects --with-target serve', 'Show a list of all projects in the workspace that have a "serve" target')
+        .example('$0 show project [projectName]', 'Shows the resolved configuration for [projectName]'),
+    handler: async (args) => {
+        (0, yargs_1.showHelp)();
+        process.exit(1);
+    },
+};
+const showProjectsCommand = {
+    command: 'projects',
+    describe: 'Show a list of projects in the workspace.',
+    builder: (yargs) => (0, shared_options_1.withVerbose)((0, shared_options_1.withAffectedOptions)(yargs))
+        .option('affected', {
+        type: 'boolean',
+        description: 'Show only affected projects.',
+    })
+        .option('projects', {
+        type: 'string',
+        alias: ['p'],
+        description: 'Show only projects that match a given pattern.',
+        coerce: shared_options_1.parseCSV,
+    })
+        .option('withTarget', {
+        type: 'string',
+        alias: ['t'],
+        description: 'Show only projects that have a specific target.',
+        coerce: shared_options_1.parseCSV,
+    })
+        .option('type', {
+        type: 'string',
+        description: 'Select only projects of the given type.',
+        choices: ['app', 'lib', 'e2e'],
+    })
+        .option('sep', {
+        type: 'string',
+        description: 'Outputs projects with the specified seperator.',
+    })
+        .implies('untracked', 'affected')
+        .implies('uncommitted', 'affected')
+        .implies('files', 'affected')
+        .implies('base', 'affected')
+        .implies('head', 'affected')
+        .conflicts('sep', 'json')
+        .conflicts('json', 'sep')
+        .example('$0 show projects --projects "apps/*"', 'Show all projects in the apps directory')
+        .example('$0 show projects --projects "shared-*"', 'Show all projects that start with "shared-"')
+        .example('$0 show projects --affected', 'Show affected projects in the workspace')
+        .example('$0 show projects --type app --affected', 'Show affected apps in the workspace')
+        .example('$0 show projects --affected --exclude=*-e2e', 'Show affected projects in the workspace, excluding end-to-end projects'),
+    handler: async (args) => {
+        const exitCode = await (0, handle_errors_1.handleErrors)(args.verbose, async () => {
+            const { showProjectsHandler } = await Promise.resolve().then(() => require('./projects'));
+            await showProjectsHandler(args);
+        });
+        process.exit(exitCode);
+    },
+};
+const showProjectCommand = {
+    command: 'project <projectName>',
+    describe: 'Shows resolved project configuration for a given project.',
+    builder: (yargs) => (0, shared_options_1.withVerbose)(yargs)
+        .positional('projectName', {
+        type: 'string',
+        alias: 'p',
+        description: 'Which project should be viewed?.',
+    })
+        .option('web', {
+        type: 'boolean',
+        description: 'Show project details in the browser. (default when interactive).',
+    })
+        .option('open', {
+        type: 'boolean',
+        description: 'Set to false to prevent the browser from opening when using --web.',
+        implies: 'web',
+    })
+        .check((argv) => {
+        // If TTY is enabled, default to web. Otherwise, default to JSON.
+        const alreadySpecified = argv.web !== undefined || argv.json !== undefined;
+        if (!alreadySpecified) {
+            if (process.stdout.isTTY) {
+                argv.web = true;
+            }
+            else {
+                argv.json = true;
+            }
+        }
+        return true;
+    })
+        .example('$0 show project my-app', 'View project information for my-app in JSON format')
+        .example('$0 show project my-app --web', 'View project information for my-app in the browser'),
+    handler: async (args) => {
+        const exitCode = await (0, handle_errors_1.handleErrors)(args.verbose, async () => {
+            const { showProjectHandler } = await Promise.resolve().then(() => require('./project'));
+            await showProjectHandler(args);
+        });
+        process.exit(exitCode);
+    },
+};

package/src/command-line/show/project.d.ts

@@ -0,0 +1,2 @@
+import { ShowProjectOptions } from './command-object';
+export declare function showProjectHandler(args: ShowProjectOptions): Promise<void>;