trailofbits/modern-python

¿Qué hace modern-python?

Configura proyectos de Python con herramientas modernas (uv, ruff, ty). Úsalo al crear proyectos, escribir scripts independientes o migrar desde pip/Poetry/mypy/black.

¿Qué ofrece?

• uv: Gestión de dependencias y entornos virtuales ultrarrápida. Reemplaza pip, venv y Poetry.
• ruff: Linting y formateo de código extremadamente rápido, compatible con reglas de flake8, isort y black.
• ty: Ejecutor de tareas simple y moderno, similar a make o invoke, pero para Python puro.

¿Cuándo usarlo?

• Nuevos proyectos: Configura un proyecto desde cero con las herramientas modernas preinstaladas y configuradas.
• Scripts independientes: Crea scripts con entornos aislados de forma rápida y limpia.
• Migraciones: Actualiza proyectos que usan pip, Poetry, mypy o black a este stack moderno.

Plataformas compatibles

• Claude Code
• Cursor
• Codex
• Entornos locales y CI/CD

Cómo funciona

1. El skill instala uv, ruff y ty en el entorno del proyecto (usando pip o uv según disponibilidad).
2. Genera los archivos de configuración (pyproject.toml, ruff.toml, etc.) con valores por defecto modernos y sensibles.
3. Si es una migración, detecta configuraciones existentes y las convierte automáticamente.
4. Provee comandos de ejemplo para tareas comunes: formateo, linting, ejecución de pruebas.

Ejemplo de uso

# Inicializar un nuevo proyecto
$ uv init mi-proyecto

# Configurar con modern-python (dentro del proyecto)
# (el skill aplica automáticamente la configuración)

# Formatear código
$ ruff format .

# Ejecutar linting
$ ruff check .

# Ejecutar tarea definida en ty
$ ty run

Configuración generada

uv se configura para usar ruff como formateador y linter por defecto. ty se configura con tareas básicas como format, lint, test. ruff se configura con reglas recomendadas (equivalente a flake8-bugbear, isort, black).