Usando TestPyPI¶
Test PyPI é uma instância separada do Python Package Index (PyPI) que permite que você experimente as ferramentas de distribuição e o processo sem se preocupar em afetar o índice real. O TestPyPI está hospedado em test.pypi.org
Registrando sua conta¶
Como o TestPyPI tem um banco de dados separado do PyPI real, você precisará de uma conta de usuário separada especificamente para o TestPyPI. Vá para https://test.pypi.org/account/register/ para registrar sua conta.
Nota
O banco de dados do TestPyPI pode ser apagado periodicamente, portanto, não é incomum que contas de usuário sejam excluídas.
Usando TestPyPI com Twine¶
Você pode enviar suas distribuições para TestPyPI usando twine especificando o sinalizador --repository:
twine upload --repository testpypi dist/*
Você pode ver se o seu pacote foi enviado com sucesso navegando para a URL https://test.pypi.org/project/<projetoexemplo> onde projetoexemplo é o nome do seu projeto que você enviou. O seu projeto pode demorar um ou dois minutos para aparecer no site.
Usando TestPyPI com pip¶
Você pode dizer ao pip para baixar pacotes do TestPyPI, em vez do PyPI, especificando o sinalizador --index-url:
python3 -m pip install --index-url https://test.pypi.org/simple/ your-package
py -m pip install --index-url https://test.pypi.org/simple/ your-package
Se você quiser permitir que pip também baixe outros pacotes do PyPI, você pode especificar --extra-index-url para apontar para PyPI. Isso é útil quando o pacote que você está testando tem dependências:
python3 -m pip install --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple/ your-package
py -m pip install --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple/ your-package
Configurando TestPyPI no .pypirc¶
Se você quiser evitar de ter que inserir seu nome de usuário, pode configurar o TestPyPI em seu $HOME/.pypirc:
[testpypi]
username = <your TestPyPI username>
Para mais detalhes, veja a especificação do .pypirc.