¿Cómo montas las dependencias y los entornos en un proyecto Python nuevo?

Declara todo en pyproject.toml y gestiona el entorno con uv, que crea el entorno virtual, resuelve las dependencias y escribe un fichero de lock rápido. Mantén las dependencias directas con rangos amplios en la tabla del proyecto, versiona el fichero de lock para instalaciones reproducibles, y separa las herramientas de desarrollo en grupos de dependencias para que las imágenes de producción no lleven pytest ni ruff.

Todo vive en pyproject.toml: las dependencias, la configuración de ruff, mypy y pytest, y los metadatos de build. Uso uv para llevarlo, porque crea el venv, resuelve e instala lo bastante rápido como para que un entorno de CI en frío sean segundos y no minutos, y además gestiona la versión del intérprete, así que nadie discute sobre qué Python está en el path. Las dependencias directas llevan restricciones razonablemente amplias, luego uv lock produce el conjunto exacto resuelto y ese fichero de lock se versiona. CI y Docker instalan desde el lock congelado, así que lo que corre en producción es bit a bit lo que probé. Las herramientas de desarrollo van en un grupo aparte, lo que mantiene la imagen de ejecución más pequeña y hace que un linter comprometido no esté dentro del contenedor de producción. En Docker copio primero el lock y el manifiesto e instalo antes de copiar el código, para que la caché de capas funcione de verdad. Migrar un proyecto antiguo desde pip y ficheros requirements me llevó quizá una tarde y recortó varios minutos del paso de preparación de nuestro CI.