feat(misc): expose nx init command flags (#16287)

e2e/nx-init/src/nx-init-angular.test.ts

@@ -30,7 +30,9 @@ describe('nx init (Angular CLI)', () => {
 
   it('should successfully convert an Angular CLI workspace to an Nx standalone workspace', () => {
     const output = runCommand(
-      `${pmc.runUninstalledPackage} nx@${getPublishedVersion()} init -y`
+      `${
+        pmc.runUninstalledPackage
+      } nx@${getPublishedVersion()} init --no-interactive`
     );
 
     expect(output).toContain('🎉 Done!');
@@ -64,7 +66,7 @@ describe('nx init (Angular CLI)', () => {
     const output = runCommand(
       `${
         pmc.runUninstalledPackage
-      } nx@${getPublishedVersion()} init -y --integrated`
+      } nx@${getPublishedVersion()} init --integrated --no-interactive`
     );
 
     expect(output).toContain('🎉 Done!');

e2e/nx-init/src/nx-init-monorepo.test.ts

@@ -40,7 +40,7 @@ describe('nx init (Monorepo)', () => {
     const output = runCommand(
       `${
         pmc.runUninstalledPackage
-      } nx@${getPublishedVersion()} init -y --cacheable=build`
+      } nx@${getPublishedVersion()} init --cacheable=build --no-interactive`
     );
 
     expect(output).toContain('🎉 Done!');

e2e/nx-init/src/nx-init-nest.test.ts

@@ -34,7 +34,7 @@ describe('nx init (for NestCLI)', () => {
     const output = execSync(
       `${
         pmc.runUninstalledPackage
-      } nx@${getPublishedVersion()} init -y --cacheable=format`,
+      } nx@${getPublishedVersion()} init --cacheable=format --no-interactive`,
       {
         cwd: projectRoot,
         encoding: 'utf-8',

e2e/nx-init/src/nx-init-npm-repo.test.ts

@@ -32,7 +32,7 @@ describe('nx init (NPM repo)', () => {
     const output = runCommand(
       `${
         pmc.runUninstalledPackage
-      } nx@${getPublishedVersion()} init -y --cacheable=echo`
+      } nx@${getPublishedVersion()} init --cacheable=echo --no-interactive`
     );
     console.log(output);
     expect(output).toContain('Enabled computation caching');
@@ -61,7 +61,7 @@ describe('nx init (NPM repo)', () => {
     runCommand(
       `${
         pmc.runUninstalledPackage
-      } nx@${getPublishedVersion()} init -y --cacheable=compound`
+      } nx@${getPublishedVersion()} init --cacheable=compound --no-interactive`
     );
 
     const output = runCommand('npm run compound TEST');

packages/nx/src/command-line/init.ts

@@ -14,7 +14,13 @@ import { directoryExists, readJsonFile } from '../utils/fileutils';
 import { PackageJson } from '../utils/package-json';
 
 export interface InitArgs {
+  addE2e: boolean;
+  force: boolean;
   integrated: boolean;
+  interactive: boolean;
+  vite: boolean;
+  nxCloud?: boolean;
+  cacheable?: string[];
 }
 
 export async function initHandler(options: InitArgs) {
@@ -40,15 +46,15 @@ export async function initHandler(options: InitArgs) {
   } else if (existsSync('package.json')) {
     const packageJson: PackageJson = readJsonFile('package.json');
     if (existsSync('angular.json')) {
-      await addNxToAngularCliRepo(options.integrated);
+      await addNxToAngularCliRepo(options);
     } else if (isCRA(packageJson)) {
-      await addNxToCraRepo(options.integrated);
+      await addNxToCraRepo(options);
     } else if (isNestCLI(packageJson)) {
-      await addNxToNest(packageJson);
+      await addNxToNest(options, packageJson);
     } else if (isMonorepo(packageJson)) {
-      await addNxToMonorepo();
+      await addNxToMonorepo(options);
     } else {
-      await addNxToNpmRepo();
+      await addNxToNpmRepo(options);
     }
   } else {
     const useDotNxFolder = await prompt<{ useDotNxFolder: string }>([

packages/nx/src/command-line/nx-commands.ts

@@ -2,14 +2,12 @@ import * as chalk from 'chalk';
 import { execSync } from 'child_process';
 import * as path from 'path';
 import * as yargs from 'yargs';
-import { nxVersion } from '../utils/versions';
-import { examples } from './examples';
-import { workspaceRoot } from '../utils/workspace-root';
-import { getPackageManagerCommand } from '../utils/package-manager';
+import { runNxSync } from '../utils/child-process';
 import { writeJsonFile } from '../utils/fileutils';
+import { getPackageManagerCommand } from '../utils/package-manager';
+import { workspaceRoot } from '../utils/workspace-root';
+import { examples } from './examples';
 import { WatchArguments } from './watch';
-import { runNxSync } from '../utils/child-process';
-import { stripIndents } from '../utils/strip-indents';
 
 // Ensure that the output takes up the available width of the terminal.
 yargs.wrap(yargs.terminalWidth());
@@ -305,7 +303,7 @@ export const commandsObject = yargs
     command: 'init',
     describe:
       'Adds Nx to any type of workspace. It installs nx, creates an nx.json configuration file and optionally sets up distributed caching. For more info, check https://nx.dev/recipes/adopting-nx.',
-    builder: (yargs) => withIntegratedOption(yargs),
+    builder: (yargs) => withInitOptions(yargs),
     handler: async (args: any) => {
       await (await import('./init')).initHandler(args);
       process.exit(0);
@@ -1122,14 +1120,54 @@ function withListOptions(yargs) {
   });
 }
 
-function withIntegratedOption(yargs) {
-  return yargs.option('integrated', {
-    type: 'boolean',
-    description:
-      'Migrate to an Nx integrated layout workspace. Only for CRA and Angular projects.',
-    // TODO(leo): keep it hidden until feature is released
-    hidden: true,
-  });
+function withInitOptions(yargs: yargs.Argv) {
+  // TODO(leo): make them visible in docs/help once the feature is released in Nx 16
+  return yargs
+    .options('nxCloud', {
+      type: 'boolean',
+      description: 'Set up distributed caching with Nx Cloud.',
+      hidden: true,
+    })
+    .option('interactive', {
+      describe: 'When false disables interactive input prompts for options.',
+      type: 'boolean',
+      default: true,
+      hidden: true,
+    })
+    .option('integrated', {
+      type: 'boolean',
+      description:
+        'Migrate to an Nx integrated layout workspace. Only for Angular CLI workspaces and CRA projects.',
+      default: false,
+      hidden: true,
+    })
+    .option('addE2e', {
+      describe:
+        'Set up Cypress E2E tests in integrated workspaces. Only for CRA projects.',
+      type: 'boolean',
+      default: false,
+      hidden: true,
+    })
+    .option('force', {
+      describe:
+        'Force the migration to continue and ignore custom webpack setup or uncommitted changes. Only for CRA projects.',
+      type: 'boolean',
+      default: false,
+      hidden: true,
+    })
+    .options('vite', {
+      type: 'boolean',
+      description: 'Use Vite as the bundler. Only for CRA projects.',
+      default: true,
+      hidden: true,
+    })
+    .options('cacheable', {
+      type: 'string',
+      description:
+        'Comma-separated list of cacheable operations. Only used for internal testing.',
+      coerce: parseCSV,
+      hidden: true,
+    });
 }
 
 function runMigration() {

packages/nx/src/nx-init/add-nx-to-monorepo.ts

@@ -2,7 +2,7 @@ import { prompt } from 'enquirer';
 import { readdirSync, readFileSync, statSync } from 'fs';
 import ignore from 'ignore';
 import { join, relative } from 'path';
-import * as yargsParser from 'yargs-parser';
+import { InitArgs } from '../command-line/init';
 import { readJsonFile } from '../utils/fileutils';
 import { output } from '../utils/output';
 import { getPackageManagerCommand } from '../utils/package-manager';
@@ -15,15 +15,9 @@ import {
   runInstall,
 } from './utils';
 
-const parsedArgs = yargsParser(process.argv, {
-  boolean: ['yes'],
-  string: ['cacheable'], // only used for testing
-  alias: {
-    yes: ['y'],
-  },
-});
+type Options = Pick<InitArgs, 'nxCloud' | 'interactive' | 'cacheable'>;
 
-export async function addNxToMonorepo() {
+export async function addNxToMonorepo(options: Options) {
   const repoRoot = process.cwd();
 
   output.log({ title: '🐳 Nx initialization' });
@@ -36,7 +30,7 @@ export async function addNxToMonorepo() {
   let scriptOutputs = {} as { [script: string]: string };
   let useNxCloud: boolean;
 
-  if (parsedArgs.yes !== true && scripts.length > 0) {
+  if (options.interactive && scripts.length > 0) {
     output.log({
       title:
         '🧑‍🔧 Please answer the following questions about the scripts found in your workspace in order to generate task runner configuration',
@@ -78,13 +72,13 @@ export async function addNxToMonorepo() {
       )[scriptName];
     }
 
-    useNxCloud = await askAboutNxCloud();
+    useNxCloud = options.nxCloud ?? (await askAboutNxCloud());
   } else {
     targetDefaults = [];
-    cacheableOperations = parsedArgs.cacheable
-      ? parsedArgs.cacheable.split(',')
-      : [];
-    useNxCloud = false;
+    cacheableOperations = options.cacheable ?? [];
+    useNxCloud =
+      options.nxCloud ??
+      (options.interactive ? await askAboutNxCloud() : false);
   }
 
   createNxJsonFile(

packages/nx/src/nx-init/add-nx-to-nest.ts

@@ -1,10 +1,13 @@
-import { unlinkSync, writeFileSync } from 'fs-extra';
-import * as yargsParser from 'yargs-parser';
 import * as enquirer from 'enquirer';
+import { unlinkSync, writeFileSync } from 'fs-extra';
 import { join } from 'path';
+import { InitArgs } from '../command-line/init';
+import { NrwlJsPluginConfig, NxJsonConfiguration } from '../config/nx-json';
+import { ProjectConfiguration } from '../config/workspace-json-project-json';
+import { fileExists, readJsonFile, writeJsonFile } from '../utils/fileutils';
 import { output } from '../utils/output';
 import { PackageJson } from '../utils/package-json';
-import { fileExists, readJsonFile, writeJsonFile } from '../utils/fileutils';
+import { getPackageManagerCommand } from '../utils/package-manager';
 import {
   addDepsToPackageJson,
   askAboutNxCloud,
@@ -14,20 +17,11 @@ import {
   printFinalMessage,
   runInstall,
 } from './utils';
-import { getPackageManagerCommand } from '../utils/package-manager';
-import { ProjectConfiguration } from '../config/workspace-json-project-json';
-import { NrwlJsPluginConfig, NxJsonConfiguration } from '../config/nx-json';
 
+type Options = Pick<InitArgs, 'nxCloud' | 'interactive' | 'cacheable'>;
 type NestCLIConfiguration = any;
-const parsedArgs = yargsParser(process.argv, {
-  boolean: ['yes'],
-  string: ['cacheable'], // only used for testing
-  alias: {
-    yes: ['y'],
-  },
-});
-
-export async function addNxToNest(packageJson: PackageJson) {
+
+export async function addNxToNest(options: Options, packageJson: PackageJson) {
   const repoRoot = process.cwd();
 
   output.log({ title: '🐳 Nx initialization' });
@@ -69,7 +63,7 @@ export async function addNxToNest(packageJson: PackageJson) {
   let scriptOutputs = {};
   let useNxCloud: boolean;
 
-  if (parsedArgs.yes !== true) {
+  if (options.interactive) {
     output.log({
       title:
         '🧑‍🔧 Please answer the following questions about the scripts found in your package.json in order to generate task runner configuration',
@@ -98,12 +92,10 @@ export async function addNxToNest(packageJson: PackageJson) {
       )[scriptName];
     }
 
-    useNxCloud = await askAboutNxCloud();
+    useNxCloud = options.nxCloud ?? (await askAboutNxCloud());
   } else {
-    cacheableOperations = parsedArgs.cacheable
-      ? parsedArgs.cacheable.split(',')
-      : [];
-    useNxCloud = false;
+    cacheableOperations = options.cacheable ?? [];
+    useNxCloud = options.nxCloud ?? false;
   }
 
   createNxJsonFile(

packages/nx/src/nx-init/add-nx-to-npm-repo.ts

@@ -1,5 +1,5 @@
 import * as enquirer from 'enquirer';
-import * as yargsParser from 'yargs-parser';
+import { InitArgs } from '../command-line/init';
 import { readJsonFile } from '../utils/fileutils';
 import { output } from '../utils/output';
 import { getPackageManagerCommand } from '../utils/package-manager';
@@ -13,15 +13,9 @@ import {
   runInstall,
 } from './utils';
 
-const parsedArgs = yargsParser(process.argv, {
-  boolean: ['yes'],
-  string: ['cacheable'], // only used for testing
-  alias: {
-    yes: ['y'],
-  },
-});
+type Options = Pick<InitArgs, 'nxCloud' | 'interactive' | 'cacheable'>;
 
-export async function addNxToNpmRepo() {
+export async function addNxToNpmRepo(options: Options) {
   const repoRoot = process.cwd();
 
   output.log({ title: '🐳 Nx initialization' });
@@ -35,7 +29,7 @@ export async function addNxToNpmRepo() {
     (s) => !s.startsWith('pre') && !s.startsWith('post')
   );
 
-  if (parsedArgs.yes !== true) {
+  if (options.interactive) {
     output.log({
       title:
         '🧑‍🔧 Please answer the following questions about the scripts found in your package.json in order to generate task runner configuration',
@@ -66,12 +60,10 @@ export async function addNxToNpmRepo() {
       )[scriptName];
     }
 
-    useNxCloud = await askAboutNxCloud();
+    useNxCloud = options.nxCloud ?? (await askAboutNxCloud());
   } else {
-    cacheableOperations = parsedArgs.cacheable
-      ? parsedArgs.cacheable.split(',')
-      : [];
-    useNxCloud = false;
+    cacheableOperations = options.cacheable ?? [];
+    useNxCloud = options.nxCloud ?? false;
   }
 
   createNxJsonFile(repoRoot, [], cacheableOperations, {});