PKGCTL-VERSION-SETUP(1)   PKGCTL-VERSION-SETUP(1)

pkgctl-version-setup - Detecta e configura automaticamente uma configuração básica do nvchecker

pkgctl version setup [OPÇÕES] [PKGBASE...]

Este subcomando automatiza a criação de um arquivo de configuração básico nvchecker(1) analisando o array de fontes especificada no arquivo PKGBUILD(1) de um pacote. Este comando detecta de forma inteligente várias plataformas e APIs (por exemplo, GitHub, GitLab, PyPI) usadas pelas fontes do pacote e gera uma configuração .nvchecker.toml correspondente com base em sua melhor estimativa.

Isso é particularmente útil para inicializar as configurações do nvchecker(1) para um pacote sem criar manualmente o arquivo .nvchecker.toml. Ele simplifica o processo de configuração de verificações de versão, especialmente ao fazer a transição de um monitoramento de pacote de uma plataforma de fontes para outra ou ao iniciar verificações de versão para um novo pacote.

Se nenhum PKGBASE for especificado, o comando usará por padrão o diretório de trabalho atual.

Para obter uma lista de fontes suportadas e seus formatos de URL esperados, consulte a seção de fontes.

-f, --force

Sobrescreve a configuração existente do nvchecker(1)

--prefer-platform-api

Prefere a API GitHub/GitLab específica da plataforma em vez do Git para casos complexos

--url URL

Deriva o alvo de verificação do URL fornecido em vez das entradas do array de fontes

--no-check

Não executa pkgctl-version-check(1) após a configuração

--no-upstream

Define uma configuração em branco para pacotes sem fontes upstream, como metapacotes. Isso deve ser usado apenas em casos sem upstream. Entre em contato com a equipe de desenvolvimento para obter orientação sobre fontes upstream difíceis de configurar.

-h, --help

Mostra um texto de ajuda.

Aqui estão as plataformas e fontes atualmente suportadas, juntamente com exemplos de formatos de URL que permitem sua detecção automática como tipos de fontes específicos:

Git

• https://github.com/example/project
• https://gitlab.com/example/group/project
•git://git.foobar.org/example
•git+https://git.foobar.org/example

GitHub

• https://github.com/example/project
• https://github.com/example/project/archive/v1.0/project-v1.0.tar.gz

GitLab

• https://gitlab.com/example/group/project
• https://gitlab.archlinux.org/archlinux/devtools.git
• https://gitlab.archlinux.org/archlinux/devtools/-/releases/v1.1.0/downloads/devtools-v1.1.0.tar.gz

Hackage

• https://hackage.haskell.org/package/xmonad
• https://hackage.haskell.org/package/xmonad-0.18.0/xmonad-0.18.0.tar.gz
• https://hackage.haskell.org/packages/archive/xmonad/0.18.0/xmonad-0.18.0.tar.gz

NPM

• https://registry.npmjs.org/node-gyp/-/node-gyp-10.0.1.tgz
• https://www.npmjs.com/package/node-gyp

PyPI

• https://pypi.io/packages/source/p/pyflakes
• https://pypi.org/packages/source/b/bleach
• https://files.pythonhosted.org/packages/source/p/pyflakes
• https://pypi.org/project/SQLAlchemy/

RubyGems

• https://rubygems.org/downloads/diff-lcs-1.5.1.gem
• https://rubygems.org/gems/diff-lcs

CPAN

• https://search.cpan.org/CPAN/authors/id/C/CO/COSIMO/Locale-PO-0.27.tar.gz
• https://cpan.metacpan.org/authors/id/C/CO/COSIMO/Locale-PO-0.27.tar.gz

crates.io

• https://static.crates.io/crates/shotgun/shotgun-1.0.crate
• https://crates.io/api/v1/crates/shotgun/1.0/download
• https://crates.io/crates/git-smash

pkgctl version setup

Detecta fontes do diretório atual’s PKGBUILD(1) e configura um .nvchecker.toml básico.

pkgctl version setup --url https://github.com/example/project

Gera um .nvchecker.toml para o PKGBUILD(1) atual, mas substitui a URL de fontes pelo projeto GitHub especificado.

pkgctl-version(1) pkgctl-version-check(1) nvchecker(1) PKGBUILD(5)

https://gitlab.archlinux.org/archlinux/devtools

Por favor, relate bugs e solicitações de recursos no rastreador de problemas. Por favor, faça o seu melhor para fornecer um caso de teste reproduzível para bugs.

A tradução para português brasileiro desta página man foi criada por Rafael Fontenelle <rafaelff@gnome.org>

Esta tradução é uma documentação livre; leia a Licença Pública Geral GNU Versão 3 ou posterior para as condições de direitos autorais. Nenhuma responsabilidade é aceita.

Se você encontrar algum erro na tradução desta página de manual, envie um e-mail para a lista de discussão de tradutores.

27 janeiro 2026