dockyard2sail-py
Template base para APIs REST en Python con FastAPI, listo para desarrollo local y despliegue en Railway u otros proveedores cloud.
Project Overview
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.
Key Features
- 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
Technologies Used
Problema
Los templates de APIs REST en Python suelen omitir gates de calidad reales, dejando que la cobertura de tests y el lint se degraden con el tiempo.
Enfoque
Se construyó un template 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, tests, typecheck o el scan de Trivy.
Resultados
- 90%+ de cobertura de tests forzada en CI (pytest + httpx)
- Imagen de producción con digest pinning y usuario no-root
Project Details
Client
Personal Project
Timeline
Mayo 2026
Role
Desarrollador Backend
© 2026 Cuauhtémoc Bautista