Фильтрация
Фильтрация позволяет ограничить команды определенными подмножествами пакетов.
pnpm поддерживает расширенный синтаксис селектора для выбора пакетов по имени или по отношению.
Селекторы могут быть указаны с помощью флага --filter (или -F):
pnpm --filter <package_selector> <command>
Соответствие
--filter <селектор пакета>
Чтобы выбрать конкретный пакет, просто укажите его имя (@scope/pkg) или используйте шаблон для выбора набора пакетов (@scope/*).
Примеры:
pnpm --filter "@babel/core" test
pnpm --filter "@babel/*" test
pnpm --filter "*core" test
Указание области действия пакета не является обязательным, поэтому --filter=core выберет @babel/core, если core не найден. Однако, если в рабочей области есть несколько пакетов с одинаковыми именами (например, @babel/core и @types/core), фильтрация без области ничего не выберет.
--filter <селектор пакета>...
Чтобы выбрать пакет и его зависимости (прямые и непрямые), добавьте к имени пакета многоточие: <package_name>.... Например, следующая команда запустит тесты foo и всех его зависимостей:
pnpm --filter foo... test
Вы можете использовать шаблон для выбора набора корневых пакетов:
pnpm --filter "@babel/preset-*..." test
--filter <селектор пакета>^...
Чтобы выбрать ТОЛЬКО зависимости пакета (как прямые, так и непрямые), добавьте к имени вышеупомянутое многоточие, которому предшествует шеврон. Например, следующая команда запустит тесты foo и всех его зависимостей:
pnpm --filter "foo^..." test
--filter ...<селектор пакета>
Чтобы выбрать пакет и его зависимые пакеты (прямые и непрямые), добавьте к имени пакета префикс с многоточием: ...<package_name>. Например, это запустит тесты foo всех зависимых от него пакетов:
pnpm --filter ...foo test
--filter "...^<селектор пакета>"
Чтобы выбрать ТОЛЬКО зависимые пакеты (прямые и непрямые), добавьте к имени пакета префикс с многоточием, за которым следует шеврон. Например, это запустит тесты для всех пакетов, зависящих от foo:
pnpm --filter "...^foo" test
--filter ./<glob>, --filter {<glob>}
Шаблон glob относительно текущего рабочего каталога, соответствующего проектам.
pnpm --filter "./packages/**" <cmd>
Включает все проекты, находящиеся в указанном каталоге.
Его также можно использовать с операторами многоточия и шеврона для выбора зависимых/зависимостей:
pnpm --filter ...{<directory>} <cmd>
pnpm --filter {<directory>}... <cmd>
pnpm --filter ...{<directory>}... <cmd>
Его также можно комбинировать с [<since>]. Например, чтобы выбрать все измененные проекты внутри каталога:
pnpm --filter "{packages/**}[origin/master]" <cmd>
pnpm --filter "...{packages/**}[origin/master]" <cmd>
pnpm --filter "{packages/**}[origin/master]..." <cmd>
pnpm --filter "...{packages/**}[origin/master]..." <cmd>
Или вы можете выбрать все пакеты из каталога с именами, соответствующими заданному шаблону:
pnpm --filter "@babel/*{components/**}" <cmd>
pnpm --filter "@babel/*{components/**}[origin/master]" <cmd>
pnpm --filter "...@babel/*{components/**}[origin/master]" <cmd>
--filter "[<since>]"
Выбирает все измененные пакеты с момента указанного commit/branch. Может иметь суффикс или префикс ... для включения зависимостей/зависимых.
Например, следующая команда запустит тесты во всех измененных пакетах, начиная с master и во всех зависимых пакетах:
pnpm --filter "...[origin/master]" test
Исключения
Любой из селекторов фильтра может работать как оператор исключения, если перед ним стоит "!". В zsh (и, возможно, в других оболочках) "!" следует экранировать: \!.
Например, это будет выполнять команду во всех проектах, за исключением foo:
pnpm --filter=!foo <cmd>
И это запустит команду во всех проектах, которые не находятся в папке lib:
pnpm --filter=!./lib <cmd>
Множественность
Когда пакеты фильтруются, берется каждый пакет, который соответствует хотя бы одному из селекторов. Вы можете использовать столько фильтров, сколько хотите:
pnpm --filter ...foo --filter bar --filter baz... test
--filter-prod <filtering_pattern>
Действует так же, как --filter, но пропускает devDependencies при выборе проектов зависимостей из рабочей области.
--test-pattern <glob>
test-pattern позволяет определить, относятся ли измененные файлы к тестам. Если они есть, то зависимые пакеты таких измененных пакетов не включаются.
Этот параметр полезен с фильтром «изменилось с» (дата, время). Например, следующая команда запустит тесты во всех измененных пакетах, а если изменения находятся в исходном коде пакета, тесты будут запущены и в зависимых пакетах:
pnpm --filter="...[origin/master]" --test-pattern="test/*" test
--changed-files-ignore-pattern <glob>
Позволяет игнорировать измененные файлы по шаблонам glob при фильтрации измененных проектов, начиная с указанного commit/branch.
Пример использования:
pnpm --filter="...[origin/master]" --changed-files-ignore-pattern="**/README.md" run build