nx/docs/generated/cli/affected-libs.md
2022-10-28 10:54:05 -04:00

2.1 KiB

title description
affected:libs - CLI command Print libraries affected by changes

affected:libs

**Deprecated:** Use `nx print-affected --type=lib ...` instead. This command will be removed in v15.

Print libraries affected by changes

Usage

nx affected:libs

Install nx globally to invoke the command directly using nx, or use npx nx, yarn nx, or pnpm nx.

Examples

Print the names of all the libs affected by changing the index.ts file:

 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

Type: `boolean`

All projects
### base

Type: `string`

Base of the current branch (usually main)
### configuration

Type: `string`

This is the configuration to use when performing tasks on projects
### exclude

Type: `array`

Default: `[]`

Exclude certain projects from being processed
### files

Type: `array`

Change the way Nx is calculating the affected command by providing directly changed files, list of files delimited by commas
### head

Type: `string`

Latest commit of the current branch (usually HEAD)
### help

Type: `boolean`

Show help
### nx-bail

Type: `boolean`

Default: `false`

Stop command execution after the first failed task
### nx-ignore-cycles

Type: `boolean`

Default: `false`

Ignore cycles in the task graph
### plain

Produces a plain output for affected:apps and affected:libs
### runner

Type: `string`

This is the name of the tasks runner configured in nx.json
### skip-nx-cache

Type: `boolean`

Default: `false`

Rerun the tasks even when the results are available in the cache
### uncommitted

Type: `boolean`

Uncommitted changes
### untracked

Type: `boolean`

Untracked changes
### verbose

Type: `boolean`

Default: `false`

Prints additional information about the commands (e.g., stack traces)
### version

Type: `boolean`

Show version number