PyPortable Installer

Uma ferramenta CLI e biblioteca Python para baixar, configurar e gerenciar instalações do Python Portable (Embeddable) automaticamente. Ideal para criar ambientes Python isolados para distribuição, sem instalação administrativa.

Funcionalidades

• Versões sempre atualizadas — a lista de versões é lida em tempo real do feed oficial do python.org (com cache local), nada de lista fixa no código.
• Multi-arquitetura — builds amd64 (64 bits), win32 (32 bits) e arm64, com detecção automática da sua máquina.
• Download inteligente — barra de progresso, retry automático, cache dos instaladores e verificação de checksum quando o python.org publica um.
• Fallback de releases source-only — quando uma versão só tem código-fonte (sem binário para Windows), o PyPortable cai automaticamente para o patch mais novo que realmente possui build.
• Pip pronto para uso — instala pip, setuptools e wheel, e já configura o ._pth e o site-packages.
• Scripts de ativação — gera activate.ps1 e activate.bat junto da instalação.
• Diagnóstico e limpeza — doctor, uninstall e clean integrados.
• CLI moderna — Typer + Rich, com cores, tabelas e ajuda navegável.

Instalação

pip install pyportable

Desenvolvimento

git clone https://github.com/DaavidSiilva/PyPortable
cd PyPortable
pip install -e ".[dev]"
pytest

Uso

Listar versões disponíveis

pyportable list              # versões estáveis
pyportable list --all        # inclui alpha/beta/rc
pyportable list --check      # confirma no python.org quais builds existem
pyportable list --json       # saída para scripts

Instalar

pyportable install latest              # instala na pasta .python
pyportable install 3.12                # série mais recente disponível
pyportable install 3.12.10             # versão exata
pyportable install 3.12 --arch 32      # força 32 bits
pyportable install 3.12 --dir .venv    # pasta customizada
pyportable install 3.12 --dry-run      # mostra o plano sem baixar
pyportable install 3.12 --force        # substitui instalação existente

Atalho: pyportable 3.12 é equivalente a pyportable install 3.12.

Gerenciar

pyportable doctor                 # checa a instalação atual
pyportable uninstall --yes        # remove a instalação
pyportable clean --yes            # limpa o cache de downloads
pyportable version                # versão do PyPortable

Ativar o ambiente

Depois de instalar, use os scripts gerados:

# PowerShell
.\.python\activate.ps1

:: CMD
.python\activate.bat

Uso como biblioteca

from pyportable import install, doctor, uninstall

result = install("3.12", arch="64", dest=".python")
print(result.python_exe)   # .python\python.exe

report = doctor(".python")
if not report.ok:
    print(report.issues)

uninstall(".python")

Opções da CLI

Use pyportable <comando> --help para ver todas as flags.

Estrutura do Projeto

• pyportable/
  • cli.py — interface de linha de comando (Typer + Rich).
  • releases.py — descoberta e resolução de versões no python.org.
  • downloader.py — download com progresso, retry e checksum.
  • installer.py — instalação, desinstalação e diagnóstico.
  • config.py — constantes e caminhos.
  • _console.py — tema e helpers de saída.
• tests/ — suíte de testes com pytest.

Publicação

O caminho recomendado é Trusted Publishing (OIDC), sem tokens armazenados: crie uma tag (vX.Y.Z) e o workflow .github/workflows/publish.yml cuida do resto.

Para publicar manualmente com o Twine:

python -m build
twine upload dist/*          # usa TWINE_USERNAME / TWINE_PASSWORD do ambiente

TWINE_USERNAME costuma ser __token__ e TWINE_PASSWORD, o API token do PyPI.

Licença

MIT