Busca en todas las páginas de la documentación
Los estándares de Python de toda la flota extienden PEP 8 con reglas de tipado, diseño de proyecto, manejo de errores y expectativas de revisión, aplicados por Ruff 0.9+, pyright en rutas modificadas y plantillas que copian los nuevos repositorios.
Tarjeta de referencia rápida - lista para copiar y pegar.
# pyproject.toml (línea base de la flota)
[tool.ruff]
line-length = 100
target-version = "py314"
select = ["E", "F", "I", "UP", "B", "ASYNC", "S"]
[tool.pyright]
pythonVersion = "3.14"
typeCheckingMode = "standard"src/<paquete>/
api/ # Solo HTTP
domain/ # sin importaciones de FastAPI/Django
infra/ # DB, colas, E/S externaCuándo recurrir a esto:
"""domain/orders.py - cumple con los estándares de la flota."""
from __future__ import annotations
from dataclasses import dataclass
from decimal import Decimal
@dataclass(frozen=True)
class OrderTotal:
subtotal: Decimal
tax: Decimal
@property
def grand_total(self) -> Decimal:
return self.subtotal + self.tax
def compute_total(subtotal: Decimal, tax_rate: Decimal) -> OrderTotal:
tax = (subtotal * tax_rate).quantize(Decimal("0.01"))
return OrderTotal(subtotal=subtotal, tax=tax)# api/routes/orders.py - límite delgado
from fastapi import APIRouter
from pydantic import BaseModel
from domain.orders import compute_total
router = APIRouter()
class TotalRequest(BaseModel):
subtotal: float
tax_rate: float
@router.post("/total")
def total(body: TotalRequest) -> dict[str, float]:
result = compute_total(body.subtotal, body.tax_rate)
return {"grand_total": float(result.grand_total)}Lo que esto demuestra:
Any requiere justificación con comentario.except desnudo.| Tema | Regla de la flota |
|---|---|
| Asíncrono | Sin E/S bloqueante en async def sin to_thread |
| SQL | Consultas parametrizadas; se prefiere ORM |
| Registro (Logging) | structlog JSON; sin f-string en el mensaje de registro |
| Pruebas | pytest; fixtures sobre estado global |
| Configuración | pydantic-settings; sin dispersión cruda de os.environ |
uv run ruff check .
uv run ruff format --check .
uv run pyright src/| Alternativa | Usar Cuando | No Usar Cuando |
|---|---|---|
| Solo Black (sin Ruff) | Legado | Flota nueva (Ruff reemplaza ambos) |
| mypy estricto en todo el repositorio | Greenfield pequeño | Monolito legado grande |
| Guía de estilo de Google verbatim | Necesita referencia externa | La flota tiene diseño personalizado |
| Sin estándares | Cierre inminente | Flota activa multi-escuadrón |
Línea base PEP 8; la flota añade reglas de diseño, tipado, asíncrono y seguridad.
Esta flota usa 100; elija una para toda la organización.
Permitir importaciones de Django en las capas apps/ y services/ según el ADR de la plantilla de Django.
Los notebooks no están en la ruta de producción; el código promovido debe pasar el mismo lint en los módulos.
Sí; módulos nuevos tipados; puerta de ruta modificada en CI.
El gremio de plataforma trimestralmente; RFC para cambios controvertidos.
Recomendado; CI es la fuente de verdad.
Excluir en ruff por archivo-ignorar; documentar rutas.
Estilo Google o NumPy, una opción; opcionalmente aplicado en código nuevo.
Versiones de Stack: Esta página fue escrita para Python 3.14.0 (estable 3.14, mantenimiento 3.13), FastAPI 0.115+, Django 5.2, Flask 3.1, Pydantic 2, PyTorch 2.6+, pandas 2.2+, Polars 1.x, ruff 0.9+, y uv 0.6+.
Revisado por Chris St. John·Última actualización: 16 jul 2026