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

NOME
       pkgctl-version-setup - Detecta e configura automaticamente uma
       configuracao basica do nvchecker

SINOPSE
       pkgctl version setup [OPCOES] [PKGBASE...]

DESCRICAO
       Este subcomando automatiza a criacao de um arquivo de configuracao
       basico nvchecker(1) analisando o array de fontes especificada no
       arquivo PKGBUILD(1) de um pacote. Este comando detecta de forma
       inteligente varias plataformas e APIs (por exemplo, GitHub, GitLab,
       PyPI) usadas pelas fontes do pacote e gera uma configuracao
       .nvchecker.toml correspondente com base em sua melhor estimativa.

       Isso e particularmente util para inicializar as configuracoes do
       nvchecker(1) para um pacote sem criar manualmente o arquivo
       .nvchecker.toml. Ele simplifica o processo de configuracao de
       verificacoes de versao, especialmente ao fazer a transicao de um
       monitoramento de pacote de uma plataforma de fontes para outra ou ao
       iniciar verificacoes de versao para um novo pacote.

       Se nenhum PKGBASE for especificado, o comando usara por padrao o
       diretorio de trabalho atual.

       Para obter uma lista de fontes suportadas e seus formatos de URL
       esperados, consulte a secao de fontes.

OPCOES
       -f, --force
           Sobrescreve a configuracao existente do nvchecker(1)

       --prefer-platform-api
           Prefere a API GitHub/GitLab especifica da plataforma em vez do Git
           para casos complexos

       --url URL
           Deriva o alvo de verificacao do URL fornecido em vez das entradas
           do array de fontes

       --no-check
           Nao executa pkgctl-version-check(1) apos a configuracao

       --no-upstream
           Define uma configuracao 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
           orientacao sobre fontes upstream dificeis de configurar.

       -h, --help
           Mostra um texto de ajuda.

FONTES
       Aqui estao as plataformas e fontes atualmente suportadas, juntamente
       com exemplos de formatos de URL que permitem sua deteccao automatica
       como tipos de fontes especificos:

       Git

           o    <https://github.com/example/project>

           o    <https://gitlab.com/example/group/project>

           o   git://git.foobar.org/example

           o   git+https://git.foobar.org/example

       GitHub

           o    <https://github.com/example/project>

           o
               <https://github.com/example/project/archive/v1.0/project-v1.0.tar.gz>

       GitLab

           o    <https://gitlab.com/example/group/project>

           o    <https://gitlab.archlinux.org/archlinux/devtools.git>

           o
               <https://gitlab.archlinux.org/archlinux/devtools/-/releases/v1.1.0/downloads/devtools-v1.1.0.tar.gz>

       Hackage

           o    <https://hackage.haskell.org/package/xmonad>

           o
               <https://hackage.haskell.org/package/xmonad-0.18.0/xmonad-0.18.0.tar.gz>

           o
               <https://hackage.haskell.org/packages/archive/xmonad/0.18.0/xmonad-0.18.0.tar.gz>

       NPM

           o    <https://registry.npmjs.org/node-gyp/-/node-gyp-10.0.1.tgz>

           o    <https://www.npmjs.com/package/node-gyp>

       PyPI

           o    <https://pypi.io/packages/source/p/pyflakes>

           o    <https://pypi.org/packages/source/b/bleach>

           o    <https://files.pythonhosted.org/packages/source/p/pyflakes>

           o    <https://pypi.org/project/SQLAlchemy/>

       RubyGems

           o    <https://rubygems.org/downloads/diff-lcs-1.5.1.gem>

           o    <https://rubygems.org/gems/diff-lcs>

       CPAN

           o
               <https://search.cpan.org/CPAN/authors/id/C/CO/COSIMO/Locale-PO-0.27.tar.gz>

           o
               <https://cpan.metacpan.org/authors/id/C/CO/COSIMO/Locale-PO-0.27.tar.gz>

       crates.io

           o    <https://static.crates.io/crates/shotgun/shotgun-1.0.crate>

           o    <https://crates.io/api/v1/crates/shotgun/1.0/download>

           o    <https://crates.io/crates/git-smash>

EXEMPLOS
       pkgctl version setup
           Detecta fontes do diretorio atual's PKGBUILD(1) e configura um
           .nvchecker.toml basico.

       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.

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

SITE
         <https://gitlab.archlinux.org/archlinux/devtools>

       Por favor, relate bugs e solicitacoes de recursos no rastreador de
       problemas. Por favor, faca o seu melhor para fornecer um caso de teste
       reproduzivel para bugs.

TRADUCAO
       A traducao para portugues brasileiro desta pagina man foi criada por
       Rafael Fontenelle <rafaelff@gnome.org>

       Esta traducao e uma documentacao livre; leia a Licenca Publica Geral
       GNU Versao 3 <https://www.gnu.org/licenses/gpl-3.0.html> ou posterior
       para as condicoes de direitos autorais.  Nenhuma responsabilidade e
       aceita.

       Se voce encontrar algum erro na traducao desta pagina de manual, envie
       um e-mail para a lista de discussao de tradutores
       <debian-l10n-portuguese@lists.debian.org>.

                                27 janeiro 2026        PKGCTL-VERSION-SETUP(1)