UNPKG

nx

Version:

The core Nx plugin contains the core functionality of Nx like the project graph, nx commands and task orchestration.

195 lines (194 loc) • 7.88 kB
"use strict"; Object.defineProperty(exports, "__esModule", { value: true }); exports.initLocal = initLocal; exports.rewriteTargetsAndProjects = rewriteTargetsAndProjects; const perf_hooks_1 = require("perf_hooks"); const nx_commands_1 = require("../src/command-line/nx-commands"); const strip_indents_1 = require("../src/utils/strip-indents"); const client_1 = require("../src/daemon/client/client"); const enquirer_1 = require("enquirer"); const output_1 = require("../src/utils/output"); /** * Nx is being run inside a workspace. * * @param workspace Relevant local workspace properties */ async function initLocal(workspace) { process.env.NX_CLI_SET = 'true'; try { // In case Nx Cloud forcibly exits while the TUI is running, ensure the terminal is restored etc. process.on('exit', (...args) => { if (typeof globalThis.tuiOnProcessExit === 'function') { globalThis.tuiOnProcessExit(...args); } }); perf_hooks_1.performance.mark('init-local'); if (workspace.type !== 'nx' && shouldDelegateToAngularCLI()) { console.warn((0, strip_indents_1.stripIndents) `Using Nx to run Angular CLI commands is deprecated and will be removed in a future version. To run Angular CLI commands, use \`ng\`.`); handleAngularCLIFallbacks(workspace); return; } // Ensure NxConsole is installed if the user has it configured. try { await ensureNxConsoleInstalledViaDaemon(); } catch { } const command = process.argv[2]; if (command === 'run' || command === 'g' || command === 'generate') { nx_commands_1.commandsObject.parse(process.argv.slice(2)); } else if (isKnownCommand(command)) { const newArgs = rewriteTargetsAndProjects(process.argv); const help = newArgs.indexOf('--help'); const split = newArgs.indexOf('--'); if (help > -1 && (split === -1 || split > help)) { nx_commands_1.commandsObject.showHelp(); } else { nx_commands_1.commandsObject.parse(newArgs); } } else { nx_commands_1.commandsObject.parse(process.argv.slice(2)); } } catch (e) { console.error(e.message); process.exit(1); } } function rewriteTargetsAndProjects(args) { const newArgs = [args[2]]; let i = 3; while (i < args.length) { if (args[i] === '--') { return [...newArgs, ...args.slice(i)]; } else if (args[i] === '-p' || args[i] === '--projects' || args[i] === '--exclude' || args[i] === '--files' || args[i] === '-t' || args[i] === '--target' || args[i] === '--targets') { newArgs.push(args[i]); i++; const items = []; while (i < args.length && !args[i].startsWith('-')) { items.push(args[i]); i++; } newArgs.push(items.join(',')); } else { newArgs.push(args[i]); ++i; } } return newArgs; } function isKnownCommand(command) { const commands = [ ...Object.keys(nx_commands_1.commandsObject .getInternalMethods() .getCommandInstance() .getCommandHandlers()), 'g', 'dep-graph', 'affected:dep-graph', 'format', 'workspace-schematic', 'connect-to-nx-cloud', 'clear-cache', 'help', ]; return !command || command.startsWith('-') || commands.indexOf(command) > -1; } function shouldDelegateToAngularCLI() { const command = process.argv[2]; const commands = [ 'analytics', 'cache', 'completion', 'config', 'doc', 'update', ]; return commands.indexOf(command) > -1; } async function ensureNxConsoleInstalledViaDaemon() { // Only proceed if daemon is available if (!client_1.daemonClient.enabled()) { return; } // Get status from daemon const status = await client_1.daemonClient.getNxConsoleStatus(); // If we should prompt the user if (status.shouldPrompt && process.stdout.isTTY) { output_1.output.log({ title: "Install Nx's official editor extension to:", bodyLines: [ '- Enable your AI assistant to do more by understanding your workspace', '- Add IntelliSense for Nx configuration files', '- Explore your workspace visually', ], }); try { const { shouldInstallNxConsole } = await (0, enquirer_1.prompt)({ type: 'confirm', name: 'shouldInstallNxConsole', message: 'Install Nx Console? (you can uninstall anytime)', initial: true, }); // Set preference and install if user said yes const result = await client_1.daemonClient.setNxConsolePreferenceAndInstall(shouldInstallNxConsole); if (result.installed) { output_1.output.log({ title: 'Successfully installed Nx Console!' }); } } catch (error) { // User cancelled or error occurred, save preference as false await client_1.daemonClient.setNxConsolePreferenceAndInstall(false); } } } function handleAngularCLIFallbacks(workspace) { if (process.argv[2] === 'update' && process.env.FORCE_NG_UPDATE != 'true') { console.log(`Nx provides a much improved version of "ng update". It runs the same migrations, but allows you to:`); console.log(`- rerun the same migration multiple times`); console.log(`- reorder migrations, skip migrations`); console.log(`- fix migrations that "almost work"`); console.log(`- commit a partially migrated state`); console.log(`- change versions of packages to match organizational requirements`); console.log(`And, in general, it is lot more reliable for non-trivial workspaces. Read more at: https://nx.dev/getting-started/nx-and-angular#ng-update-and-nx-migrate`); console.log(`Run "nx migrate latest" to update to the latest version of Nx.`); console.log(`Running "ng update" can still be useful in some dev workflows, so we aren't planning to remove it.`); console.log(`If you need to use it, run "FORCE_NG_UPDATE=true ng update".`); } else if (process.argv[2] === 'completion') { if (!process.argv[3]) { console.log(`"ng completion" is not natively supported by Nx. Instead, you could try an Nx Editor Plugin for a visual tool to run Nx commands. If you're using VSCode, you can use the Nx Console plugin, or if you're using WebStorm, you could use one of the available community plugins. For more information, see https://nx.dev/getting-started/editor-setup`); } } else if (process.argv[2] === 'cache') { console.log(`"ng cache" is not natively supported by Nx. To clear the cache, you can delete the ".angular/cache" directory (or the directory configured by "cli.cache.path" in the "nx.json" file). To update the cache configuration, you can directly update the relevant options in your "nx.json" file (https://angular.dev/reference/configs/workspace-config#cache-options).`); } else { try { // nx-ignore-next-line const cli = require.resolve('@angular/cli/lib/init.js', { paths: [workspace.dir], }); require(cli); } catch (e) { console.error(`Could not find '@angular/cli/lib/init.js' module in this workspace.`, e); process.exit(1); } } }