feat(core): filter affected projects by glob pattern on tags

docs/generated/cli/affected-apps.md

@@ -87,6 +87,12 @@ Default: `false`
 
 Rerun the tasks even when the results are available in the cache
 
+### tags
+
+Default: ``
+
+Filter affected projects by tags using glob patterns
+
 ### uncommitted
 
 Uncommitted changes

docs/generated/cli/affected-build.md

@@ -99,6 +99,12 @@ Default: `false`
 
 Rerun the tasks even when the results are available in the cache
 
+### tags
+
+Default: ``
+
+Filter affected projects by tags using glob patterns
+
 ### uncommitted
 
 Uncommitted changes

docs/generated/cli/affected-dep-graph.md

@@ -127,6 +127,12 @@ Default: `false`
 
 Rerun the tasks even when the results are available in the cache
 
+### tags
+
+Default: ``
+
+Filter affected projects by tags using glob patterns
+
 ### uncommitted
 
 Uncommitted changes

docs/generated/cli/affected-e2e.md

@@ -99,6 +99,12 @@ Default: `false`
 
 Rerun the tasks even when the results are available in the cache
 
+### tags
+
+Default: ``
+
+Filter affected projects by tags using glob patterns
+
 ### uncommitted
 
 Uncommitted changes

docs/generated/cli/affected-libs.md

@@ -87,6 +87,12 @@ Default: `false`
 
 Rerun the tasks even when the results are available in the cache
 
+### tags
+
+Default: ``
+
+Filter affected projects by tags using glob patterns
+
 ### uncommitted
 
 Uncommitted changes

docs/generated/cli/affected-lint.md

@@ -99,6 +99,12 @@ Default: `false`
 
 Rerun the tasks even when the results are available in the cache
 
+### tags
+
+Default: ``
+
+Filter affected projects by tags using glob patterns
+
 ### uncommitted
 
 Uncommitted changes

docs/generated/cli/affected-test.md

@@ -99,6 +99,12 @@ Default: `false`
 
 Rerun the tasks even when the results are available in the cache
 
+### tags
+
+Default: ``
+
+Filter affected projects by tags using glob patterns
+
 ### uncommitted
 
 Uncommitted changes

docs/generated/cli/affected.md

@@ -105,6 +105,12 @@ Default: `false`
 
 Rerun the tasks even when the results are available in the cache
 
+### tags
+
+Default: ``
+
+Filter affected projects by tags using glob patterns
+
 ### target
 
 Task to run for affected projects

docs/generated/cli/format-check.md

@@ -71,6 +71,12 @@ Default: `false`
 
 Rerun the tasks even when the results are available in the cache
 
+### tags
+
+Default: ``
+
+Filter affected projects by tags using glob patterns
+
 ### uncommitted
 
 Uncommitted changes

docs/generated/cli/format-write.md

@@ -71,6 +71,12 @@ Default: `false`
 
 Rerun the tasks even when the results are available in the cache
 
+### tags
+
+Default: ``
+
+Filter affected projects by tags using glob patterns
+
 ### uncommitted
 
 Uncommitted changes

docs/generated/cli/print-affected.md

@@ -99,6 +99,12 @@ Default: `false`
 
 Rerun the tasks even when the results are available in the cache
 
+### tags
+
+Default: ``
+
+Filter affected projects by tags using glob patterns
+
 ### uncommitted
 
 Uncommitted changes

nx-dev/nx-dev/public/documentation/generated/cli/affected-apps.md

@@ -87,6 +87,12 @@ Default: `false`
 
 Rerun the tasks even when the results are available in the cache
 
+### tags
+
+Default: ``
+
+Filter affected projects by tags using glob patterns
+
 ### uncommitted
 
 Uncommitted changes

nx-dev/nx-dev/public/documentation/generated/cli/affected-build.md

@@ -99,6 +99,12 @@ Default: `false`
 
 Rerun the tasks even when the results are available in the cache
 
+### tags
+
+Default: ``
+
+Filter affected projects by tags using glob patterns
+
 ### uncommitted
 
 Uncommitted changes

nx-dev/nx-dev/public/documentation/generated/cli/affected-dep-graph.md

@@ -127,6 +127,12 @@ Default: `false`
 
 Rerun the tasks even when the results are available in the cache
 
+### tags
+
+Default: ``
+
+Filter affected projects by tags using glob patterns
+
 ### uncommitted
 
 Uncommitted changes

nx-dev/nx-dev/public/documentation/generated/cli/affected-e2e.md

@@ -99,6 +99,12 @@ Default: `false`
 
 Rerun the tasks even when the results are available in the cache
 
+### tags
+
+Default: ``
+
+Filter affected projects by tags using glob patterns
+
 ### uncommitted
 
 Uncommitted changes

nx-dev/nx-dev/public/documentation/generated/cli/affected-libs.md

@@ -87,6 +87,12 @@ Default: `false`
 
 Rerun the tasks even when the results are available in the cache
 
+### tags
+
+Default: ``
+
+Filter affected projects by tags using glob patterns
+
 ### uncommitted
 
 Uncommitted changes

nx-dev/nx-dev/public/documentation/generated/cli/affected-lint.md

@@ -99,6 +99,12 @@ Default: `false`
 
 Rerun the tasks even when the results are available in the cache
 
+### tags
+
+Default: ``
+
+Filter affected projects by tags using glob patterns
+
 ### uncommitted
 
 Uncommitted changes

nx-dev/nx-dev/public/documentation/generated/cli/affected-test.md

@@ -99,6 +99,12 @@ Default: `false`
 
 Rerun the tasks even when the results are available in the cache
 
+### tags
+
+Default: ``
+
+Filter affected projects by tags using glob patterns
+
 ### uncommitted
 
 Uncommitted changes

nx-dev/nx-dev/public/documentation/generated/cli/affected.md

@@ -105,6 +105,12 @@ Default: `false`
 
 Rerun the tasks even when the results are available in the cache
 
+### tags
+
+Default: ``
+
+Filter affected projects by tags using glob patterns
+
 ### target
 
 Task to run for affected projects

nx-dev/nx-dev/public/documentation/generated/cli/format-check.md

@@ -71,6 +71,12 @@ Default: `false`
 
 Rerun the tasks even when the results are available in the cache
 
+### tags
+
+Default: ``
+
+Filter affected projects by tags using glob patterns
+
 ### uncommitted
 
 Uncommitted changes

nx-dev/nx-dev/public/documentation/generated/cli/format-write.md

@@ -71,6 +71,12 @@ Default: `false`
 
 Rerun the tasks even when the results are available in the cache
 
+### tags
+
+Default: ``
+
+Filter affected projects by tags using glob patterns
+
 ### uncommitted
 
 Uncommitted changes

nx-dev/nx-dev/public/documentation/generated/cli/print-affected.md

@@ -99,6 +99,12 @@ Default: `false`
 
 Rerun the tasks even when the results are available in the cache
 
+### tags
+
+Default: ``
+
+Filter affected projects by tags using glob patterns
+
 ### uncommitted
 
 Uncommitted changes

packages/workspace/src/command-line/affected.ts

@@ -22,6 +22,7 @@ import type { NxArgs, RawNxArgs } from './utils';
 import { splitArgsIntoNxArgsAndOverrides } from './utils';
 import { performance } from 'perf_hooks';
 import type { Environment } from '../core/shared-interfaces';
+import * as minimatch from 'minimatch';
 
 export async function affected(
   command: 'apps' | 'libs' | 'dep-graph' | 'print-affected' | 'affected',
@@ -40,7 +41,8 @@ export async function affected(
 
   const projectGraph = await createProjectGraphAsync();
   const projects = projectsToRun(nxArgs, projectGraph);
-  const projectsNotExcluded = applyExclude(projects, nxArgs);
+  const projectsMatchingTags = matchTags(projects, nxArgs);
+  const projectsNotExcluded = applyExclude(projectsMatchingTags, nxArgs);
   const env = readEnvironment();
   const filteredProjects = applyOnlyFailed(projectsNotExcluded, nxArgs, env);
 
@@ -132,6 +134,26 @@ export async function affected(
   }
 }
 
+function matchTags(projects: Record<string, ProjectGraphNode>, nxArgs: NxArgs) {
+  // We do not want to filter projects if there are no tags passed in to match on
+  if (!nxArgs.tags || nxArgs.tags.length === 0) {
+    return projects;
+  }
+
+  const tagGlobs = nxArgs.tags;
+
+  return Object.entries(projects)
+    .filter(([, project]) => {
+      const tags: string[] = project.data.tags;
+
+      /*
+       * Ensure that each tag passed in (in glob format) exists in the projects tag array
+       */
+      return tagGlobs.every((glob) => tags.some((tag) => minimatch(tag, glob)));
+    })
+    .reduce((prev, [key, project]) => ({ ...prev, [key]: project }), {});
+}
+
 function projectsToRun(nxArgs: NxArgs, projectGraph: ProjectGraph) {
   if (nxArgs.all) return projectGraph.nodes;
 

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

@@ -431,6 +431,12 @@ function withAffectedOptions(yargs: yargs.Argv): yargs.Argv {
     .option('verbose', {
       describe: 'Print additional error stack trace on failure',
     })
+    .option('tags', {
+      describe: 'Filter affected projects by tags using glob patterns',
+      default: [],
+      type: 'array',
+      coerce: parseCSV,
+    })
     .conflicts({
       files: ['uncommitted', 'untracked', 'base', 'head', 'all'],
       untracked: ['uncommitted', 'files', 'base', 'head', 'all'],