Checklist de Configuração de Ambiente

Configuração de Python 3.14, uv, editor e ferramentas - de clone a testes bem-sucedidos em minutos no macOS ou Linux.

Como Usar Este Checklist

• Complete em ordem em uma máquina nova ou em um clone de repositório novo.
• Marque cada caixa antes de passar para as etapas específicas do aplicativo.
• Se uma etapa falhar, pare e corrija - não pule as etapas de lockfile ou venv.
• Cole as versões exatas de pyproject.toml ao relatar problemas de configuração.

Runtime Principal

1. Instalar uv 0.6+: curl -LsSf https://astral.sh/uv/install.sh | sh ou gerenciador de pacotes conforme a política da organização.
2. Instalar Python 3.14: uv python install 3.14 se não estiver instalado globalmente.
3. Clonar repositório: Chave SSH configurada; git clone git@github.com:acme/service.git.
4. Entrar no projeto: cd service - confirme a presença de pyproject.toml e uv.lock.
5. Sincronizar dependências: uv sync --all-extras (ou --extra dev conforme o README).

Ferramentas de Qualidade

6. Executar linter: uv run ruff check . - zero erros no main limpo.
7. Verificar formatação: uv run ruff format --check . ou formatar uma vez.
8. Executar testes: uv run pytest -q - suíte completa ou subconjunto do README para a primeira passagem.
9. Verificação de tipos (se configurado): uv run mypy src/ ou uv run pyright.
10. Instalar pre-commit: uv run pre-commit install e depois pre-commit run --all-files.

Configuração do Aplicativo

11. Copiar template de env: cp .env.example .env - preencha os valores locais do 1Password/documento de cofre.
12. Nunca commitar .env: Confirme se está listado em .gitignore.
13. Banco de dados (se necessário): Docker compose docker compose up -d db ou Postgres local documentado.
14. Migrações: uv run alembic upgrade head ou migrate do Django conforme o projeto.
15. Iniciar servidor de desenvolvimento: uv run uvicorn app.main:app --reload - curl /health.

Editor e Git

16. Interpretador Python do Editor: Aponte para .venv/bin/python criado pelo uv.
17. Extensão Ruff: Formatar ao salvar alinhado com o pyproject.toml de comprimento de linha.
18. Identidade Git: user.name e user.email definidos (Configuração do Git).
19. GitHub CLI (opcional): gh auth login para fluxo de trabalho de PR.
20. PATH do Shell: ~/.local/bin para ferramentas pipx (httpie, copier).

Portão de Verificação

21. Repetir CI localmente: Mesmos comandos do .github/workflows/pr.yml (ruff, pytest, mypy).
22. HTTP Smoke Test: curl -sf http://localhost:8000/health retorna 200.
23. Sanidade de Importação: uv run python -c "import app" sem ImportError.
24. Documentar bloqueadores: Abrir um issue ou thread no Slack com a saída exata do erro se alguma etapa falhar.
25. Assinar com um colega: Captura de tela ou colar o resumo do terminal no ticket de onboarding.

FAQs

Relacionados

• uv - A Ferramenta Rápida - profundidade do uv
• Checklist de Onboarding de Desenvolvedores - rampa completa
• Python no Shell - uso do shell
• Gerenciando Versões Python - política de versão

Versões da Stack: Esta página foi escrita para Python 3.14.0 (3.14 estável, 3.13 de manutenção), FastAPI 0.115+, Django 5.2, Flask 3.1, Pydantic 2, PyTorch 2.6+, pandas 2.2+, Polars 1.x, ruff 0.9+ e uv 0.6+.