calypso-api 0.1.0__tar.gz

calypso_api-0.1.0/.python-version

@@ -0,0 +1 @@
+3.12

calypso_api-0.1.0/Dockerfile

@@ -0,0 +1,13 @@
+
+FROM python:3.11-slim
+
+WORKDIR /app
+
+RUN apt-get update && apt-get install -y --no-install-recommends     build-essential     libpq-dev     && rm -rf /var/lib/apt/lists/*
+
+COPY requirements.txt .
+RUN pip install --no-cache-dir -r requirements.txt
+
+COPY . .
+
+CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8000"]

calypso_api-0.1.0/PKG-INFO

@@ -0,0 +1,81 @@
+Metadata-Version: 2.4
+Name: calypso-api
+Version: 0.1.0
+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.

calypso_api-0.1.0/README.md

@@ -0,0 +1,56 @@
+# 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.

calypso_api-0.1.0/docker-compose.yml

@@ -0,0 +1,27 @@
+
+services:
+  api:
+    build: .
+    ports:
+      - "8000:8000"
+    environment:
+      - POSTGRES_SERVER=db
+      - POSTGRES_USER=postgres
+      - POSTGRES_PASSWORD=postgres
+      - POSTGRES_DB=app
+    depends_on:
+      - db
+
+  db:
+    image: postgres:15-alpine
+    environment:
+      - POSTGRES_USER=postgres
+      - POSTGRES_PASSWORD=postgres
+      - POSTGRES_DB=app
+    volumes:
+      - postgres_data:/var/lib/postgresql/data
+    ports:
+      - "5432:5432"
+
+volumes:
+  postgres_data:

calypso_api-0.1.0/main.py

@@ -0,0 +1,102 @@
+from fastapi import FastAPI, Request, HTTPException
+from fastapi.staticfiles import StaticFiles
+from starlette.middleware.cors import CORSMiddleware 
+from starlette.middleware.gzip import GZipMiddleware
+from fastapi.responses import JSONResponse, FileResponse
+from slowapi import _rate_limit_exceeded_handler
+from slowapi.errors import RateLimitExceeded
+from dependencies.limitador import limiter
+from database.db_service import create_db_and_tables
+from core import config
+from contextlib import asynccontextmanager
+from database.db import session_manager
+from core.exceptions import exception_handler, http_exception_handler
+from utils.logger import configure_logger
+from fastapi.openapi.docs import get_swagger_ui_html, get_redoc_html
+
+# Routers
+from auth.auth_routes import router as security_router
+from routes.example_router import router as example_router
+
+description = f"""
+# {config.PROJECT_NAME}
+
+*{config.PROJECT_DESCRIPTION}*
+"""
+
+logger = configure_logger(name=__name__)
+
+@asynccontextmanager
+async def lifespan(app: FastAPI):
+    """
+    Función que maneja los eventos de inicio y cierre de la aplicación.
+    """
+    if config.crear_usuarios_y_tablas:
+        await create_db_and_tables()
+    
+        from utils.defaultUser import create_defaultAdmin_user
+        from database.db_service import get_session_context
+        async for session in get_session_context():
+            await create_defaultAdmin_user(db=session)
+            break
+        
+    yield
+    
+    if session_manager._engine is not None:
+        await session_manager.close()
+        logger.info("Conexión a la base de datos cerrada.")
+
+app = FastAPI(
+    title=config.PROJECT_NAME,
+    description=description,
+    version=config.VERSION,
+    debug=config.DEBUG,
+    lifespan=lifespan,
+    docs_url=None,
+    redoc_url=None,
+)
+
+# Middlewares
+app.add_middleware(
+    CORSMiddleware,
+    allow_origins=[config.origenes_permitidos],
+    allow_credentials=True,
+    allow_methods=["*"],
+    allow_headers=["*"],
+)
+app.add_middleware(GZipMiddleware, minimum_size=1000)
+app.state.limiter = limiter
+app.add_exception_handler(RateLimitExceeded, _rate_limit_exceeded_handler)
+app.add_exception_handler(Exception, exception_handler)
+app.add_exception_handler(HTTPException, http_exception_handler)
+
+# Static files
+app.mount("/static", StaticFiles(directory="static"), name="static")
+
+@app.get("/favicon.ico", include_in_schema=False)
+async def favicon():
+    return FileResponse("static/img/favicon.ico")
+
+@app.get("/", include_in_schema=False)
+async def root():
+    return {"mensaje": f"Bienvenido a {config.PROJECT_NAME}. Para más información, visita /docs o /redoc."}
+
+@app.get("/docs", include_in_schema=False)
+async def custom_swagger_ui_html():
+    return get_swagger_ui_html(
+        openapi_url=app.openapi_url,
+        title=app.title + " - Swagger UI",
+        swagger_favicon_url="/static/img/favicon.ico"
+    )
+    
+@app.get("/redoc", include_in_schema=False)
+async def custom_redoc_html():
+    return get_redoc_html(
+        openapi_url=app.openapi_url,
+        title=app.title + " - ReDoc",
+        redoc_favicon_url="/static/img/favicon.ico"
+    )
+
+# Include Routers
+app.include_router(security_router)
+app.include_router(example_router)

calypso_api-0.1.0/pyproject.toml

@@ -0,0 +1,42 @@
+[project]
+name = "calypso-api"
+version = "0.1.0"
+description = "Calypso API Library and CLI for scaffolding FastAPI projects"
+readme = "README.md"
+requires-python = ">=3.12"
+authors = [
+  {name = "Juan Maniglia", email = "juan.maniglia@example.com"}
+]
+license = {text = "MIT"}
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Framework :: FastAPI",
+]
+dependencies = [
+    "aiosqlite>=0.22.1",
+    "asyncpg>=0.31.0",
+    "bcrypt>=5.0.0",
+    "fastapi>=0.128.0",
+    "python-dotenv>=1.2.1",
+    "python-jose[cryptography]>=3.5.0",
+    "python-multipart>=0.0.22",
+    "slowapi>=0.1.9",
+    "sqlalchemy>=2.0.46",
+    "sqlmodel>=0.0.32",
+    "typer>=0.21.1",
+    "uvicorn>=0.40.0",
+]
+
+[project.scripts]
+calypso = "calypso_api.cli:app"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[dependency-groups]
+dev = [
+    "ipython>=9.10.0",
+]

calypso_api-0.1.0/requirements.txt

@@ -0,0 +1,12 @@
+
+fastapi
+uvicorn
+sqlalchemy
+asyncpg
+python-jose[cryptography]
+passlib[bcrypt]
+slowapi
+pandas
+pyarrow
+pydantic
+python-multipart

calypso_api-0.1.0/src/calypso_api/__main__.py

@@ -0,0 +1,4 @@
+from calypso_api.cli import app
+
+if __name__ == "__main__":
+    app()

calypso_api-0.1.0/src/calypso_api/cli.py

@@ -0,0 +1,44 @@
+
+import typer
+import uvicorn
+from calypso_api.core import config
+from pathlib import Path
+from calypso_api.scaffold import generate
+
+app = typer.Typer()
+
+@app.command()
+def run(
+    host: str = "127.0.0.1",
+    port: int = 8000,
+    reload: bool = True
+):
+    uvicorn.run(
+        "calypso_api.main:app",
+        host=host,
+        port=port,
+        reload=reload,
+        log_level="info" if config.DEBUG else "warning"
+    )
+
+@app.command()
+def shell():
+    import IPython
+    from calypso_api.database.db import engine
+    
+    typer.echo("Opening shell...")
+    IPython.embed(header="API Template Shell", colors="neutral")
+
+@app.command()
+def init(
+    destino: Path = typer.Argument(..., file_okay=False, dir_okay=True, readable=True, writable=True, help="Directorio destino"),
+    nombre: str = typer.Argument(..., help="Nombre del proyecto"),
+    host: str = typer.Option("127.0.0.1", help="Host para la aplicación"),
+    port: int = typer.Option(8000, help="Puerto para la aplicación"),
+    docker: bool = typer.Option(True, help="Incluir configuración de Docker")
+):
+    generate(destino, nombre, host, port, docker)
+    typer.echo(f"Estructura creada en {destino}")
+
+if __name__ == "__main__":
+    app()

calypso_api-0.1.0/src/calypso_api/core/config.py

@@ -0,0 +1,23 @@
+
+import os
+from typing import List
+from dotenv import load_dotenv
+
+load_dotenv()
+
+# Configuración de la API
+API_KEY = os.environ.get('API_KEY', 'default_api_key')
+SECRET_KEY = os.environ.get('SECRET_KEY', 'default_secret_key')
+ALGORITHM = os.environ.get('ALGORITHM', 'HS256')
+ACCESS_TOKEN_EXPIRE_MINUTES = 60 * 4
+PROJECT_NAME: str = "API Template"
+PROJECT_DESCRIPTION: str = "Template para nuevas APIs con FastAPI y Typer"
+VERSION: str = "0.1.0"
+API_PREFIX: str = "/api"
+DEBUG: bool = os.environ.get('DEBUG', 'False').lower() == 'true'
+
+# Base de datos
+DATABASE_URL = os.environ.get('DATABASE_URL', "sqlite+aiosqlite:///./test.db")
+
+# CORS
+ORIGINS: List[str] = ["*"]

calypso_api-0.1.0/src/calypso_api/database/db.py

@@ -0,0 +1,24 @@
+
+from sqlalchemy.ext.asyncio import create_async_engine, async_sessionmaker, AsyncSession
+from sqlmodel import SQLModel
+from calypso_api.core import config
+from typing import AsyncGenerator
+
+engine = create_async_engine(config.DATABASE_URL, echo=config.DEBUG, future=True)
+
+async_session_factory = async_sessionmaker(
+    bind=engine,
+    class_=AsyncSession,
+    expire_on_commit=False,
+    autocommit=False,
+    autoflush=False,
+)
+
+async def get_db() -> AsyncGenerator[AsyncSession, None]:
+    async with async_session_factory() as session:
+        yield session
+
+async def init_db():
+    async with engine.begin() as conn:
+        # await conn.run_sync(SQLModel.metadata.drop_all)
+        await conn.run_sync(SQLModel.metadata.create_all)

calypso_api-0.1.0/src/calypso_api/main.py

@@ -0,0 +1,38 @@
+
+from fastapi import FastAPI
+from fastapi.middleware.cors import CORSMiddleware
+from contextlib import asynccontextmanager
+from calypso_api.core import config
+from calypso_api.database.db import init_db
+from calypso_api.routes import health
+
+@asynccontextmanager
+async def lifespan(app: FastAPI):
+    # Startup
+    await init_db()
+    yield
+    # Shutdown
+
+app = FastAPI(
+    title=config.PROJECT_NAME,
+    description=config.PROJECT_DESCRIPTION,
+    version=config.VERSION,
+    lifespan=lifespan,
+    docs_url=f"{config.API_PREFIX}/docs",
+    redoc_url=f"{config.API_PREFIX}/redoc",
+    openapi_url=f"{config.API_PREFIX}/openapi.json",
+)
+
+app.add_middleware(
+    CORSMiddleware,
+    allow_origins=config.ORIGINS,
+    allow_credentials=True,
+    allow_methods=["*"],
+    allow_headers=["*"],
+)
+
+app.include_router(health.router, prefix=config.API_PREFIX)
+
+@app.get("/")
+async def root():
+    return {"message": f"Welcome to {config.PROJECT_NAME}"}

calypso_api-0.1.0/src/calypso_api/routes/health.py

@@ -0,0 +1,8 @@
+
+from fastapi import APIRouter
+
+router = APIRouter(tags=["Health"])
+
+@router.get("/health")
+async def health_check():
+    return {"status": "ok", "message": "Service is healthy"}