pnpm publish
Publica um pacote no registry do npm.
pnpm [-r] publish [<tarball|folder>] [--tag <tag>]
[--access <public|restricted>] [options]
Ao publicar um pacote dentro de um workspace , o arquivo LICENSE da raiz do workspace é compactado com o pacote (a menos que o pacote tenha uma licença própria).
Você pode substituir alguns campos antes de publicar, usando o campo publishConfig em package.json
. Você também pode usar o publishConfig.directory
para personalizar o subdiretório publicado (geralmente usando ferramentas de compilação de terceiros).
Ao executar este comando recursivamente (pnpm -r publish
), o pnpm publicará todos os pacotes que possuem versões ainda não publicadas no registry.
Opções
--recursive, -r
Publica todos os pacotes do workspace.
--json
Mostra informações no formato JSON.
--tag <tag>
Publica o pacote com a determinada tag. Por padrão, o pnpm publish
atualiza a latest
tag.
Por exemplo:
# dentro do diretório do pacote foo
pnpm publish --tag next
# em um projeto onde você deseja usar a próxima versão de foo
pnpm add foo@next
--access <public|restricted>
Informa ao registro se o pacote publicado deve ser público ou restrito.
--no-git-checks
Não verifique se a branch atual é a branch de publicação, limpa e atualizada com o remote.
--publish-branch
- Padrão: master e main
- Tipos: String
A branch principal do repositório que é usada para publicar as últimas mudanças.
--force
Tente publicar os pacotes mesmo se as suas versões já forem encontradas no registro.
--report-summary
Salve a lista de pacotes publicados em pnpm-publish-summary.json
. Útil quando alguma outra ferramenta é usada para reportar a lista de pacotes publicados.
Um exemplo de um arquivo pnpm-publish-summary.json
:
{
"publishedPackages": [
{
"name": "foo",
"version": "1.0.0"
},
{
"name": "bar",
"version": "2.0.0"
}
}
]
--dry-run
Realize todo o processo de publicação, mas sem realmente publicar no registro.
--otp
Ao publicar pacotes que requerem autenticação de dois fatores, esta opção pode especificar uma senha de uso único.
--filter <package_selector>
Configuração
Você também pode definir opções de git-checks
e publish-branch
no arquivo .npmrc
.
Por exemplo:
git-checks=false
publish-branch=production
Scripts de Life Cycle
prepublishOnly
prepublish
prepack
prepare
postpack
publish
postpublish