nx/docs/react/cli/affected-libs.md
Craigory Coppola 8435bdfb6f
feat(core): shift from 'master' to 'main' as default branch and base (#7111)
* chore(core): fix some broken tests

* docs(core): update docs to represent master -> main

* chore(core): review changes

Co-authored-by: Jason Jean <jasonjean1993@gmail.com>

* chore(core): add migration script for backwards-compat w/ main default.

Co-authored-by: Jason Jean <jasonjean1993@gmail.com>
2021-10-08 16:48:02 -04:00

100 lines
1.6 KiB
Markdown

# affected:libs
Print libraries affected by changes
## Usage
```bash
nx affected:libs
```
[Install `nx` globally]({{framework}}/getting-started/nx-setup#install-nx) to invoke the command directly using `nx`, or use `npx nx`, `yarn nx`, or `pnpx nx`.
### Examples
Print the names of all the libs affected by changing the index.ts file:
```bash
nx affected:libs --files=libs/mylib/src/index.ts
```
Print the names of all the libs affected by the changes between main and HEAD (e.g., PR):
```bash
nx affected:libs --base=main --head=HEAD
```
Print the names of all the libs affected by the last commit on main:
```bash
nx affected:libs --base=main~1 --head=main
```
## Options
### all
All projects
### base
Base of the current branch (usually main)
### configuration
This is the configuration to use when performing tasks on projects
### exclude
Default: ``
Exclude certain projects from being processed
### files
Change the way Nx is calculating the affected command by providing directly changed files, list of files delimited by commas
### head
Latest commit of the current branch (usually HEAD)
### help
Show help
### only-failed
Default: `false`
Isolate projects which previously failed
### plain
Produces a plain output for affected:apps and affected:libs
### runner
This is the name of the tasks runner configured in nx.json
### skip-nx-cache
Default: `false`
Rerun the tasks even when the results are available in the cache
### uncommitted
Uncommitted changes
### untracked
Untracked changes
### verbose
Print additional error stack trace on failure
### version
Show version number