python-runtime

Python Runtime

Skill para configurar y mantener toolchains Python modernos: Ruff (linting + formatting), pytest, type hints con mypy, gestión de dependencias, virtual environments y estándares de proyecto.

Principios fundamentales

• Python 3.12+ como runtime mínimo.
• Ruff como linter y formatter unificado (reemplaza flake8, isort, black, pyflakes).
• pytest como test runner con plugins (pytest-cov, pytest-asyncio, hypothesis).
• Type hints obligatorios en funciones públicas. mypy o pyright para validación estática.
• Virtual environments siempre. Nunca instalar dependencias globalmente.

Estructura de proyecto recomendada

proyecto/
├── src/
│   └── mi_paquete/
│       ├── __init__.py
│       ├── handlers/
│       ├── services/
│       ├── repositories/
│       ├── models/
│       └── utils/
├── tests/
│   ├── unit/
│   ├── integration/
│   └── conftest.py
├── pyproject.toml
├── requirements.txt
├── requirements-dev.txt
└── README.md

pyproject.toml recomendado

[project]
name = "mi-proyecto"
version = "0.1.0"
requires-python = ">=3.12"
dependencies = [
    "aws-lambda-powertools[all]>=2.0.0",
    "pydantic>=2.0.0",
    "boto3>=1.34.0",
]

[project.optional-dependencies]
dev = [
    "ruff>=0.4.0",
    "mypy>=1.10.0",
    "pytest>=8.0.0",
    "pytest-cov>=5.0.0",
    "pytest-asyncio>=0.23.0",
    "hypothesis>=6.100.0",
    "boto3-stubs[dynamodb,s3,sqs]",
    "moto[dynamodb,s3,sqs]>=5.0.0",
]

[tool.ruff]
target-version = "py312"
line-length = 120

[tool.ruff.lint]
select = [
    "E",    # pycodestyle errors
    "W",    # pycodestyle warnings
    "F",    # pyflakes
    "I",    # isort
    "N",    # pep8-naming
    "UP",   # pyupgrade
    "B",    # flake8-bugbear
    "SIM",  # flake8-simplify
    "TCH",  # flake8-type-checking
    "RUF",  # ruff-specific rules
]
ignore = ["E501"]  # line length handled by formatter

[tool.ruff.lint.isort]
known-first-party = ["mi_paquete"]

[tool.mypy]
python_version = "3.12"
strict = true
warn_return_any = true
warn_unused_configs = true
disallow_untyped_defs = true

[tool.pytest.ini_options]
testpaths = ["tests"]
addopts = "-v --tb=short --strict-markers"
markers = [
    "unit: Unit tests",
    "integration: Integration tests",
    "slow: Slow tests",
]