Pular para o conteúdo principal
Versão: Next

Filtragem

A filtragem permite restringir comandos a subconjuntos específicos de pacotes.

O pnpm suporta uma sintaxe de seletor rica para selecionar pacotes por nome ou por relação.

Os seletores podem ser especificados por meio do sinalizador --filter (ou -F):

pnpm --filter <package_selector> <command>

Coincidindo

--filter <nome_do_pacote>

Para selecionar um pacote exato apenas especifique o nome (@scope/pkg) ou use um padrão para selecionar um conjunto de pacotes (@scope/*).

Exemplos:

pnpm --filter "@babel/core" test
pnpm --filter "@babel/*" test
pnpm --filter "*core" test

Especificar o escopo do pacote é opcional, portanto --filter=core escolherá @babel/core se core não for encontrado. No entanto, se o espaço de trabalho tem vários pacotes com o mesmo nome (por exemplo, @babel/core e @types/core), então a filtragem sem escopo não escolherá nada.

--filter <nome_do_pacote>...

Para selecionar um pacote e suas dependências (diretas e não diretas), insira o nome do pacote seguido de reticências <nome_do_pacote>.... Por exemplo, o próximo comando executará testes de foo e todas as suas dependências:

pnpm --filter foo... test

Você pode usar um padrão para selecionar um conjunto de pacotes raiz:

pnpm --filter "@babel/preset-*..." test

--filter <nome_do_pacote>^...

Para selecionar APENAS as dependências de um pacote (diretas e não diretas), insira as reticências mencionadas precedidas por um acento circunflexo antes do nome. Por exemplo, o próximo comando executará testes para todas as dependências de foo:

pnpm --filter "foo^..." test

--filter ...<nome_do_pacote>

Para selecionar um pacote e suas dependências (diretas e não diretas), insira reticências seguido do nome do pacote: ...<nome_do_pacote>. Por exemplo, isso executará os testes de foo e de todos os pacotes dependentes dele:

pnpm --filter ...foo test

--filter "...^<nome_do_pacote>"

Para selecionar APENAS as dependências de um pacote (tanto diretas quanto não-diretas), insira reticências seguidas de um acento circunflexo antes do nome do pacote. Por exemplo, isso irá executar testes para todos os pacotes dependentes de foo:

pnpm --filter "...^foo" test

--filter ./<glob>, --filter {<glob>}

Um padrão glob relativo ao diretório de trabalho atual correspondendo aos projetos.

pnpm --filter "./packages/**" <cmd>

Inclui todos os projetos que estão sob o diretório especificado.

Ele pode ser usado com os operadores ellipsis e chevron para selecionar dependentes/dependências também:

pnpm --filter ...{<directory>} <cmd>
pnpm --filter {<directory>}... <cmd>
pnpm --filter ...{<directory>}... <cmd>

Também pode ser combinado com [<since>]. Por exemplo, para selecionar todos os projetos alterados dentro de um diretório:

pnpm --filter "{packages/**}[origin/master]" <cmd>
pnpm --filter "...{packages/**}[origin/master]" <cmd>
pnpm --filter "{packages/**}[origem/mestre]..." <cmd>
pnpm --filter "...{packages/**}[origin/master]..." <cmd>

Ou você pode selecionar todos os pacotes de um diretório com nomes que correspondam ao padrão fornecido:

pnpm --filter "@babel/*{components/**}" <cmd>
pnpm --filter "@babel/*{components/**}[origin/master]" <cmd>
pnpm --filter "...@babel/*{components/**}[origin/master]" <cmd>

--filter "[<desde>]"

Seleciona todos os pacotes alterados desde o commit/branch especificado. Pode ser sufixado ou prefixado com ... para incluir dependências/dependentes.

Por exemplo, o próximo comando executará testes em todos os pacotes alterados desde master e em quaisquer pacotes dependentes:

pnpm -- filter "... [origin/master]" teste

--fail-if-no-match

Added in: v8.13.1

Use this flag if you want the CLI to fail if no packages have matched the filters.

Excluindo

Qualquer um dos seletores de filtro pode funcionar como operadores de exclusão quando tiver um "!" à esquerda de. Em zsh (e possivelmente em outros shells), "!" deve ser escapado: \!.

Por exemplo, isso executará um comando em todos os projetos, exceto foo:

pnpm --filter=!foo <cmd>

E isso executará um comando em todos os projetos que não estiverem no diretório lib:

pnpm --filter=!./lib <cmd>

Multiplicidade

Quando os pacotes são filtrados, todo pacote que corresponde a pelo menos um dos seletores é obtido. Você pode usar quantos filtros quiser:

pnpm --filter ...foo --filter bar --filter baz... test

--filter-prod <filtering_pattern>

Atua da mesma forma --filter, mas omite devDependencies ao selecionar projetos de dependência do espaço de trabalho.

--test-pattern <glob>

test-pattern permite detectar se os arquivos modificados estão relacionados a testes. Se estiverem, os pacotes dependentes desses pacotes modificados não serão incluídos.

Esta opção é útil com o filtro "alterado desde". Por exemplo, o próximo comando executará testes em todos os pacotes alterados e, se as alterações estiverem no código-fonte do pacote, os testes também serão executados nos pacotes dependentes:

pnpm --filter="...[origin/master]" --test-pattern="test/*" test

--changed-files-ignore-pattern <glob>

Permite ignorar arquivos alterados por padrões glob ao filtrar projetos alterados desde o commit/branch especificado.

Exemplos de uso:

pnpm --filter="...[origin/master]" --changed-files-ignore-pattern="**/README.md" run build