Metadata-Version: 2.4
Name: calypso-api
Version: 0.1.1
Summary: Calypso API Library and CLI for scaffolding FastAPI projects
Author-email: Juan Maniglia <juan.maniglia@example.com>
License: MIT
Classifier: Framework :: FastAPI
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.12
Requires-Dist: aiosqlite>=0.22.1
Requires-Dist: asyncpg>=0.31.0
Requires-Dist: bcrypt>=5.0.0
Requires-Dist: fastapi>=0.128.0
Requires-Dist: python-dotenv>=1.2.1
Requires-Dist: python-jose[cryptography]>=3.5.0
Requires-Dist: python-multipart>=0.0.22
Requires-Dist: slowapi>=0.1.9
Requires-Dist: sqlalchemy>=2.0.46
Requires-Dist: sqlmodel>=0.0.32
Requires-Dist: typer>=0.21.1
Requires-Dist: uvicorn>=0.40.0
Description-Content-Type: text/markdown

# Calypso API

Librería y CLI para crear estructuras de proyectos robustos y escalables con FastAPI, SQLAlchemy (Async) y PostgreSQL.

## Instalación

Puedes instalar `calypso-api` directamente desde PyPI usando `pip` o `uv`:

```bash
uv add calypso-api
# O con pip
pip install calypso-api
```

## Uso

Una vez instalado, tendrás acceso al comando `calypso` en tu terminal.

### Crear un nuevo proyecto

Para generar un nuevo proyecto con toda la estructura lista:

```bash
calypso init mi_nuevo_proyecto "Mi Nuevo Proyecto" --host 0.0.0.0 --port 8000 --docker
```

Esto creará una carpeta `mi_nuevo_proyecto` con:
- Estructura modular (Controllers, Models, Routes, etc.)
- Configuración de Docker y Docker Compose.
- Autenticación JWT configurada.
- Documentación automática lista.

### Comandos disponibles

```bash
# Inicializar un proyecto
calypso init <directorio> <nombre_proyecto>

# Ver ayuda
calypso --help
```

## Estructura Generada

El proyecto generado tendrá la siguiente estructura:

- `auth/`: Lógica de autenticación.
- `controllers/`: Controladores de la lógica de negocio.
- `core/`: Configuración global.
- `database/`: Configuración de base de datos.
- `routes/`: Definición de endpoints.
- `models/`: Modelos de base de datos.
- `schemas/`: Schemas Pydantic.
- `helpers/`: Utilidades generales.
- `services/`: Lógica de negocio compleja.
- `docker-compose.yml`: Orquestación de contenedores.
