cleanup(nx-plugin): migrate e2e executor to nx devkit (#6212)

docs/angular/api-nx-plugin/executors/e2e.md

@@ -1,6 +1,6 @@
 # e2e
 
-Creates and runs an e2e for a Nx Plugin
+Creates and runs the e2e tests for an Nx Plugin.
 
 Properties can be configured in angular.json when defining the executor, or when invoking it.
 
@@ -10,16 +10,18 @@ Properties can be configured in angular.json when defining the executor, or when
 
 Type: `string`
 
-Jest config file
+Jest config file.
 
 ### target
 
 Type: `string`
 
-the target Nx Plugin project and build
+The build target for the Nx Plugin project.
 
 ### ~~tsSpecConfig~~
 
 Type: `string`
 
-**Deprecated:** Spec tsconfig file
+**Deprecated:** Use the `tsconfig` property for `ts-jest` in the e2e project `jest.config.js` file. It will be removed in the next major release.
+
+The tsconfig file for specs.

docs/node/api-nx-plugin/executors/e2e.md

@@ -1,6 +1,6 @@
 # e2e
 
-Creates and runs an e2e for a Nx Plugin
+Creates and runs the e2e tests for an Nx Plugin.
 
 Properties can be configured in workspace.json when defining the executor, or when invoking it.
 Read more about how to use executors and the CLI here: https://nx.dev/node/getting-started/nx-cli#running-tasks.
@@ -11,16 +11,18 @@ Read more about how to use executors and the CLI here: https://nx.dev/node/getti
 
 Type: `string`
 
-Jest config file
+Jest config file.
 
 ### target
 
 Type: `string`
 
-the target Nx Plugin project and build
+The build target for the Nx Plugin project.
 
 ### ~~tsSpecConfig~~
 
 Type: `string`
 
-**Deprecated:** Spec tsconfig file
+**Deprecated:** Use the `tsconfig` property for `ts-jest` in the e2e project `jest.config.js` file. It will be removed in the next major release.
+
+The tsconfig file for specs.

docs/react/api-nx-plugin/executors/e2e.md

@@ -1,6 +1,6 @@
 # e2e
 
-Creates and runs an e2e for a Nx Plugin
+Creates and runs the e2e tests for an Nx Plugin.
 
 Properties can be configured in workspace.json when defining the executor, or when invoking it.
 Read more about how to use executors and the CLI here: https://nx.dev/react/getting-started/nx-cli#running-tasks.
@@ -11,16 +11,18 @@ Read more about how to use executors and the CLI here: https://nx.dev/react/gett
 
 Type: `string`
 
-Jest config file
+Jest config file.
 
 ### target
 
 Type: `string`
 
-the target Nx Plugin project and build
+The build target for the Nx Plugin project.
 
 ### ~~tsSpecConfig~~
 
 Type: `string`
 
-**Deprecated:** Spec tsconfig file
+**Deprecated:** Use the `tsconfig` property for `ts-jest` in the e2e project `jest.config.js` file. It will be removed in the next major release.
+
+The tsconfig file for specs.

packages/nx-plugin/.eslintrc.json

@@ -14,6 +14,19 @@
     {
       "files": ["*.js", "*.jsx"],
       "rules": {}
+    },
+    {
+      "files": ["**/*.ts"],
+      "excludedFiles": ["./src/migrations/**"],
+      "rules": {
+        "no-restricted-imports": [
+          "error",
+          "@angular-devkit/architect",
+          "@angular-devkit/core",
+          "@angular-devkit/schematics",
+          "@nrwl/workspace"
+        ]
+      }
     }
   ]
 }

packages/nx-plugin/builders.json

@@ -1,9 +0,0 @@
-{
-  "builders": {
-    "e2e": {
-      "implementation": "./src/executors/e2e/e2e.impl",
-      "schema": "./src/executors/e2e/schema.json",
-      "description": "Creates and runs an e2e for a Nx Plugin"
-    }
-  }
-}

packages/nx-plugin/executors.json

@@ -0,0 +1,16 @@
+{
+  "builders": {
+    "e2e": {
+      "implementation": "./src/executors/e2e/e2e.impl#nxPluginE2EBuilder",
+      "schema": "./src/executors/e2e/schema.json",
+      "description": "Creates and runs the e2e tests for an Nx Plugin."
+    }
+  },
+  "executors": {
+    "e2e": {
+      "implementation": "./src/executors/e2e/e2e.impl",
+      "schema": "./src/executors/e2e/schema.json",
+      "description": "Creates and runs the e2e tests for an Nx Plugin."
+    }
+  }
+}

packages/nx-plugin/package.json

@@ -20,15 +20,12 @@
   },
   "homepage": "https://nx.dev",
   "schematics": "./collection.json",
-  "builders": "./builders.json",
+  "builders": "./executors.json",
   "ng-update": {
     "requirements": {},
     "migrations": "./migrations.json"
   },
   "dependencies": {
-    "@angular-devkit/architect": "^0.1200.0",
-    "@angular-devkit/core": "^12.0.0",
-    "@angular-devkit/schematics": "^12.0.0",
     "@nrwl/devkit": "*",
     "@nrwl/jest": "*",
     "@nrwl/linter": "*",

packages/nx-plugin/src/executors/e2e/e2e.impl.ts

@@ -1,38 +1,67 @@
+import type { ExecutorContext } from '@nrwl/devkit';
 import {
-  BuilderContext,
+  convertNxExecutor,
-  createBuilder,
+  logger,
-  scheduleTargetAndForget,
+  parseTargetString,
-  targetFromTargetString,
+  readTargetOptions,
-} from '@angular-devkit/architect';
+  runExecutor,
-import { from } from 'rxjs';
+} from '@nrwl/devkit';
-import { concatMap, switchMap } from 'rxjs/operators';
+import { jestExecutor } from '@nrwl/jest/src/executors/jest/jest.impl';
-import { Schema } from './schema';
+import type { NxPluginE2EExecutorOptions } from './schema';
 
 try {
   require('dotenv').config();
   // eslint-disable-next-line no-empty
 } catch (e) {}
 
-export type NxPluginE2EBuilderOptions = Schema;
+export async function* nxPluginE2EExecutor(
-
+  options: NxPluginE2EExecutorOptions,
-function buildTarget(context: BuilderContext, target: string) {
+  context: ExecutorContext
-  return scheduleTargetAndForget(context, targetFromTargetString(target));
+): AsyncGenerator<{ success: boolean }> {
+  let success: boolean;
+  for await (const _ of runBuildTarget(options.target, context)) {
+    try {
+      success = await runTests(options.jestConfig, context);
+    } catch (e) {
+      logger.error(e.message);
+      success = false;
+    }
   }
 
-export function runNxPluginE2EBuilder(
+  return { success };
-  options: NxPluginE2EBuilderOptions,
+}
-  context: BuilderContext
+
-) {
+async function* runBuildTarget(
-  return buildTarget(context, options.target).pipe(
+  buildTarget: string,
-    switchMap(() => {
+  context: ExecutorContext
-      return from(
+): AsyncGenerator<boolean> {
-        context.scheduleBuilder('@nrwl/jest:jest', {
+  const { project, target, configuration } = parseTargetString(buildTarget);
-          jestConfig: options.jestConfig,
+  const buildTargetOptions = readTargetOptions(
-          watch: false,
+    { project, target, configuration },
-        })
+    context
-      ).pipe(concatMap((run) => run.output));
-    })
   );
+  const targetSupportsWatch = Object.keys(buildTargetOptions).includes('watch');
+
+  for await (const output of await runExecutor<{ success: boolean }>(
+    { project, target, configuration },
+    targetSupportsWatch ? { watch: false } : {},
+    context
+  )) {
+    if (!output.success)
+      throw new Error('Could not compile application files.');
+    yield output.success;
+  }
 }
 
-export default createBuilder(runNxPluginE2EBuilder);
+async function runTests(
+  jestConfig: string,
+  context: ExecutorContext
+): Promise<boolean> {
+  const { success } = await jestExecutor({ jestConfig, watch: false }, context);
+
+  return success;
+}
+
+export default nxPluginE2EExecutor;
+
+export const nxPluginE2EBuilder = convertNxExecutor(nxPluginE2EExecutor);

packages/nx-plugin/src/executors/e2e/schema.d.ts

@@ -1,6 +1,4 @@
-import { JsonObject } from '@angular-devkit/core';
+export interface NxPluginE2EExecutorOptions {
-
-export interface Schema extends JsonObject {
   target: string;
   jestConfig: string;
 }

packages/nx-plugin/src/executors/e2e/schema.json

@@ -1,21 +1,23 @@
 {
   "title": "Nx Plugin Playground Target",
   "description": "Creates a playground for a Nx Plugin",
+  "cli": "nx",
   "type": "object",
   "properties": {
     "target": {
-      "type": "string",
+      "description": "The build target for the Nx Plugin project.",
-      "description": "the target Nx Plugin project and build"
+      "type": "string"
     },
     "jestConfig": {
       "type": "string",
-      "description": "Jest config file"
+      "description": "Jest config file."
     },
     "tsSpecConfig": {
       "type": "string",
-      "description": "Spec tsconfig file",
+      "description": "The tsconfig file for specs.",
-      "x-deprecated": true
+      "x-deprecated": "Use the `tsconfig` property for `ts-jest` in the e2e project `jest.config.js` file. It will be removed in the next major release."
     }
   },
+  "additionalProperties": false,
   "required": ["target", "jestConfig"]
 }

packages/nx-plugin/src/generators/e2e-project/e2e.spec.ts

@@ -99,11 +99,7 @@ describe('NxPlugin e2e-project Generator', () => {
     expect(project.targets.e2e).toBeTruthy();
     expect(project.targets.e2e).toMatchObject({
       executor: '@nrwl/nx-plugin:e2e',
-      options: expect.objectContaining({
+      options: expect.objectContaining({ target: 'my-plugin:build' }),
-        target: 'my-plugin:build',
-        npmPackageName: '@proj/my-plugin',
-        pluginOutputPath: 'dist/libs/my-plugin',
-      }),
     });
   });
 

packages/nx-plugin/src/generators/e2e-project/e2e.ts

@@ -66,11 +66,7 @@ function updateWorkspaceConfiguration(host: Tree, options: NormalizedSchema) {
       targets: {
         e2e: {
           executor: '@nrwl/nx-plugin:e2e',
-          options: {
+          options: { target: `${options.pluginName}:build` },
-            target: `${options.pluginName}:build`,
-            npmPackageName: options.npmPackageName,
-            pluginOutputPath: options.pluginOutputPath,
-          },
         },
       },
       tags: [],

tsconfig.base.json

@@ -30,6 +30,7 @@
       "@nrwl/express": ["./packages/express"],
       "@nrwl/gatsby": ["./packages/gatsby"],
       "@nrwl/jest": ["./packages/jest"],
+      "@nrwl/jest/*": ["./packages/jest/*"],
       "@nrwl/linter": ["./packages/linter"],
       "@nrwl/nest": ["./packages/nest"],
       "@nrwl/next": ["./packages/next"],