dockyard2sail-py
Plantilla base para APIs REST en Python con FastAPI, listo para desarrollo local y despliegue en Railway u otros proveedores cloud.
Resumen del proyecto
dockyard2sail-py es una plantilla base para construir APIs REST en Python, con FastAPI, Poetry y Docker configurados de antemano para desarrollo local con hot-reload y despliegue directo a producción.
Incluye pruebas asíncronas con pytest y httpx, linting con Ruff, y endpoints de ejemplo (health check, saludo, documentación Swagger) listos para extender.
Características principales
- API REST con FastAPI y documentación Swagger automática
- Imágenes Docker separadas para desarrollo (hot-reload) y producción
- Pruebas asíncronas con pytest + httpx
- Linting y formato automático con Ruff
Stack
- Python3.14
- FastAPI0.141
- Jinja23.1
- Uvicorn0.53
- Poetry
- pytest9.1
- Ruff0.16
- mypy2.3
- Dockercompose
- GitHub Actions
- Railwaydeploy
Problema
Las plantillas de APIs REST en Python suelen omitir puertas de calidad reales, y la cobertura de pruebas y el lint se degradan con el tiempo.
Enfoque
Se construyó una plantilla FastAPI con arquitectura hexagonal pragmática, cobertura mínima de 90% forzada en CI y protección de rama en main que bloquea merges si fallan lint, pruebas, typecheck o el escaneo de Trivy.
Resultados
- 90%+ de cobertura de pruebas forzada en CI (pytest + httpx)
- Imagen de producción con digest pinning y usuario no-root
Cliente
Proyecto personal
Cronología
Mayo 2026
Rol
Desarrollador Backend
© 2026 Cuauhtémoc Bautista