Como você configura dependências e ambientes num projeto Python novo?

Declare tudo no pyproject.toml e gerencie o ambiente com uv, que cria o ambiente virtual, resolve dependências e escreve um lock file rapidamente. Mantenha as dependências diretas frouxas na tabela do projeto, versione o lock file para instalações reprodutíveis, e separe ferramentas de desenvolvimento em grupos de dependência para as imagens de produção não levarem pytest e ruff.

Tudo vive no pyproject.toml: as dependências, a configuração de ferramenta do ruff, do mypy e do pytest, os metadados de build. Eu uso uv para conduzir, porque ele cria a venv, resolve e instala rápido o suficiente para um ambiente de CI frio levar segundos em vez de minutos, e ele gerencia a versão do interpretador também, então ninguém fica brigando sobre qual Python está no path. As dependências diretas ganham restrições razoavelmente frouxas, aí o uv lock produz o conjunto resolvido exato e esse lock file é versionado. CI e Docker instalam a partir do lock congelado, então o que roda em produção é bit a bit o que eu testei. Ferramentas de desenvolvimento vão num grupo separado, o que deixa a imagem de runtime menor e significa que um linter comprometido não fica sentado no container de produção. No Docker eu copio o lock e o manifesto primeiro e instalo antes de copiar o código, para o cache de camadas funcionar de verdade. Migrar um projeto antigo de pip e arquivos de requirements levou talvez uma tarde e cortou vários minutos do nosso passo de setup no CI.