Filtering
Added in: v2.13.0
Filtering allows to restrict commands to subsets of packages.
pnpm supports a rich selector syntax for picking packages by name or by relation.
Selectors may be specified via the --filter
flag:
pnpm <command> --filter <package_selector>
An article that compares Lerna's filtering to pnpm's: https://medium.com/pnpm/pnpm-vs-lerna-filtering-in-a-multi-package-repository-1f68bc644d6a
--filter <package_name>
Added in: v2.13.0
To select an exact package, just specify its name (@babel/core
) or use a pattern
to select a set of packages (@babel/*
).
Usage examples:
pnpm test --filter @babel/core
pnpm test --filter @babel/*
pnpm test --filter *core
--filter <package_name>...
Added in: v2.13.0
To select a package and its dependencies (direct and non-direct), suffix the package name with 3 dots: <package_name>...
.
For instance, the next command will run installation in all dependencies of foo
and in foo
:
pnpm install --filter foo...
You may use a pattern to select a set of "root" packages:
pnpm install --filter @babel/preset-*...
--filter ...<package_name>
Added in: 2.14.0
To select a package and its dependent packages (direct and non-direct), prefix the package name with 3 dots: ...<package_name>
.
For instance, the next command will run installation in all dependents of foo
and in foo
:
pnpm install --filter ...foo
When packages in the workspace are filtered, every package is taken that matches at least one of the selectors. You can use as many filters as you want:
pnpm install --filter ...foo --filter bar --filter qar...
--filter ./<directory>
Added in: v2.15.0