Skip to content

Commit

Permalink
Merge branch 'master' into feat/nx-ignore-cycles-variable
Browse files Browse the repository at this point in the history
  • Loading branch information
timfisher committed Aug 18, 2023
2 parents b565cb5 + 195c5bf commit b8e886e
Show file tree
Hide file tree
Showing 24 changed files with 385 additions and 76 deletions.
6 changes: 0 additions & 6 deletions docs/generated/cli/affected.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,12 +29,6 @@ Run tests in parallel:
nx affected -t test --parallel=5
```

Run the test target for all projects:

```shell
nx affected -t test --all
```

Run lint, test, and build targets for affected projects. Requires Nx v15.4+:

```shell
Expand Down
4 changes: 2 additions & 2 deletions docs/generated/cli/run-many.md
Original file line number Diff line number Diff line change
Expand Up @@ -68,7 +68,7 @@ Test all projects with a `type:feature` or `type:ui` tag:
Run lint, test, and build targets for all projects. Requires Nx v15.4+:

```shell
nx run-many --targets=lint,test,build --all
nx run-many --targets=lint,test,build
```

## Options
Expand All @@ -79,7 +79,7 @@ Type: `boolean`

Default: `true`

[deprecated] Run the target on all projects in the workspace
[deprecated] `run-many` runs all targets on all projects in the workspace if no projects are provided. This option is no longer required.

### configuration

Expand Down
24 changes: 24 additions & 0 deletions docs/generated/manifests/menus.json
Original file line number Diff line number Diff line change
Expand Up @@ -2117,6 +2117,14 @@
"children": [],
"disableCollapsible": false
},
{
"name": "Reduce Repetitive Configuration",
"path": "/recipes/tips-n-tricks/reduce-repetitive-configuration",
"id": "reduce-repetitive-configuration",
"isExternal": false,
"children": [],
"disableCollapsible": false
},
{
"name": "Run Root-Level NPM Scripts with Nx",
"path": "/recipes/tips-n-tricks/root-level-scripts",
Expand Down Expand Up @@ -3173,6 +3181,14 @@
"children": [],
"disableCollapsible": false
},
{
"name": "Reduce Repetitive Configuration",
"path": "/recipes/tips-n-tricks/reduce-repetitive-configuration",
"id": "reduce-repetitive-configuration",
"isExternal": false,
"children": [],
"disableCollapsible": false
},
{
"name": "Run Root-Level NPM Scripts with Nx",
"path": "/recipes/tips-n-tricks/root-level-scripts",
Expand Down Expand Up @@ -3312,6 +3328,14 @@
"children": [],
"disableCollapsible": false
},
{
"name": "Reduce Repetitive Configuration",
"path": "/recipes/tips-n-tricks/reduce-repetitive-configuration",
"id": "reduce-repetitive-configuration",
"isExternal": false,
"children": [],
"disableCollapsible": false
},
{
"name": "Run Root-Level NPM Scripts with Nx",
"path": "/recipes/tips-n-tricks/root-level-scripts",
Expand Down
34 changes: 32 additions & 2 deletions docs/generated/manifests/nx.json
Original file line number Diff line number Diff line change
Expand Up @@ -1235,7 +1235,7 @@
"itemList": [],
"isExternal": false,
"path": "/concepts/types-of-configuration",
"tags": [""]
"tags": []
},
{
"id": "how-caching-works",
Expand Down Expand Up @@ -1546,7 +1546,7 @@
"itemList": [],
"isExternal": false,
"path": "/concepts/types-of-configuration",
"tags": [""]
"tags": []
},
"/concepts/how-caching-works": {
"id": "how-caching-works",
Expand Down Expand Up @@ -2639,6 +2639,16 @@
"path": "/recipes/tips-n-tricks/identify-dependencies-between-folders",
"tags": []
},
{
"id": "reduce-repetitive-configuration",
"name": "Reduce Repetitive Configuration",
"description": "",
"file": "shared/recipes/reduce-repetitive-configuration",
"itemList": [],
"isExternal": false,
"path": "/recipes/tips-n-tricks/reduce-repetitive-configuration",
"tags": []
},
{
"id": "root-level-scripts",
"name": "Run Root-Level NPM Scripts with Nx",
Expand Down Expand Up @@ -3957,6 +3967,16 @@
"path": "/recipes/tips-n-tricks/identify-dependencies-between-folders",
"tags": []
},
{
"id": "reduce-repetitive-configuration",
"name": "Reduce Repetitive Configuration",
"description": "",
"file": "shared/recipes/reduce-repetitive-configuration",
"itemList": [],
"isExternal": false,
"path": "/recipes/tips-n-tricks/reduce-repetitive-configuration",
"tags": []
},
{
"id": "root-level-scripts",
"name": "Run Root-Level NPM Scripts with Nx",
Expand Down Expand Up @@ -4132,6 +4152,16 @@
"path": "/recipes/tips-n-tricks/identify-dependencies-between-folders",
"tags": []
},
"/recipes/tips-n-tricks/reduce-repetitive-configuration": {
"id": "reduce-repetitive-configuration",
"name": "Reduce Repetitive Configuration",
"description": "",
"file": "shared/recipes/reduce-repetitive-configuration",
"itemList": [],
"isExternal": false,
"path": "/recipes/tips-n-tricks/reduce-repetitive-configuration",
"tags": []
},
"/recipes/tips-n-tricks/root-level-scripts": {
"id": "root-level-scripts",
"name": "Run Root-Level NPM Scripts with Nx",
Expand Down
9 changes: 0 additions & 9 deletions docs/generated/manifests/tags.json
Original file line number Diff line number Diff line change
Expand Up @@ -632,15 +632,6 @@
"path": "/recipes/tips-n-tricks/standalone-to-integrated"
}
],
"": [
{
"description": "",
"file": "shared/concepts/types-of-configuration",
"id": "types-of-configuration",
"name": "Types of Configuration",
"path": "/concepts/types-of-configuration"
}
],
"create-your-own-plugin": [
{
"description": "",
Expand Down
6 changes: 0 additions & 6 deletions docs/generated/packages/nx/documents/affected.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,12 +29,6 @@ Run tests in parallel:
nx affected -t test --parallel=5
```

Run the test target for all projects:

```shell
nx affected -t test --all
```

Run lint, test, and build targets for affected projects. Requires Nx v15.4+:

```shell
Expand Down
4 changes: 2 additions & 2 deletions docs/generated/packages/nx/documents/run-many.md
Original file line number Diff line number Diff line change
Expand Up @@ -68,7 +68,7 @@ Test all projects with a `type:feature` or `type:ui` tag:
Run lint, test, and build targets for all projects. Requires Nx v15.4+:

```shell
nx run-many --targets=lint,test,build --all
nx run-many --targets=lint,test,build
```

## Options
Expand All @@ -79,7 +79,7 @@ Type: `boolean`

Default: `true`

[deprecated] Run the target on all projects in the workspace
[deprecated] `run-many` runs all targets on all projects in the workspace if no projects are provided. This option is no longer required.

### configuration

Expand Down
8 changes: 7 additions & 1 deletion docs/map.json
Original file line number Diff line number Diff line change
Expand Up @@ -365,7 +365,7 @@
},
{
"name": "Types of Configuration",
"tags": [""],
"tags": [],
"id": "types-of-configuration",
"file": "shared/concepts/types-of-configuration"
},
Expand Down Expand Up @@ -874,6 +874,12 @@
"tags": [],
"file": "shared/recipes/identify-dependencies-between-folders"
},
{
"name": "Reduce Repetitive Configuration",
"id": "reduce-repetitive-configuration",
"tags": [],
"file": "shared/recipes/reduce-repetitive-configuration"
},
{
"name": "Run Root-Level NPM Scripts with Nx",
"id": "root-level-scripts",
Expand Down
2 changes: 1 addition & 1 deletion docs/nx-cloud/reference/config.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ Only operations listed in `cacheableOperations` can be cached using Nx Cloud and
By default, Nx Cloud requests will time out after 10 seconds. `NX_CLOUD_NO_TIMEOUTS` disables the timeout.

```shell
NX_CLOUD_NO_TIMEOUTS=true nx run-many -t build --all
NX_CLOUD_NO_TIMEOUTS=true nx run-many -t build
```

## Logging
Expand Down
2 changes: 1 addition & 1 deletion docs/shared/concepts/types-of-configuration.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ For example, Jest has a global `/jest.config.ts` file and a project-specific `/a
In a repository with many different projects and many different tools, there will be a lot of tooling configuration. Nx helps reduce the complexity of managing that configuration in two ways:

1. Abstracting away common tooling configuration settings so that if your project is using the tool in the most common way, you won't need to worry about configuration at all. The default settings for any Nx plugin executor are intended to work without modification for most projects in the community.
2. Allowing you to provide `targetDefaults` so that the most common settings for projects in your repo can all be defined in one place. Then, only projects that are exceptions need to overwrite those settings. With the judicious application of this method, larger repositories can actually have less lines of configuration after adding Nx than before.
2. Allowing you to [provide `targetDefaults`](/recipes/tips-n-tricks/reduce-repetitive-configuration) so that the most common settings for projects in your repo can all be defined in one place. Then, only projects that are exceptions need to overwrite those settings. With the judicious application of this method, larger repositories can actually have less lines of configuration after adding Nx than before.

## Determining the Value of a Configuration Property

Expand Down
2 changes: 1 addition & 1 deletion docs/shared/mental-model.md
Original file line number Diff line number Diff line change
Expand Up @@ -122,7 +122,7 @@ When you run `nx run-many -t test -p app1 lib`, you are telling Nx to do the sam
tasks `app1:test`
and `lib:test`.

When you run `nx run-many -t test --all`, you are telling Nx to do this for all the projects.
When you run `nx run-many -t test`, you are telling Nx to do this for all the projects.

As your workspace grows, retesting all projects becomes too slow. To address this Nx implements code change analysis to
get the min set of projects that need to be retested. How does it work?
Expand Down

0 comments on commit b8e886e

Please sign in to comment.