fastapi-mike 0.0.0__py3-none-any.whl

fastapi_mike-0.0.0.dist-info/METADATA

@@ -0,0 +1,141 @@
+Metadata-Version: 2.4
+Name: fastapi-mike
+Version: 0.0.0
+Summary: FastAPI Enterprise Scaffolder by MIKECARDONA076
+Author-email: Mike Cardona <mikecardona076@gmail.com.com>
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.0.0
+Requires-Dist: sqlalchemy>=2.0.0
+Requires-Dist: alembic>=1.10.0
+Requires-Dist: requests>=2.28.0
+Dynamic: license-file
+
+# 🚀 FastMike – FastAPI Enterprise Scaffolder
+
+**FastMike** es una herramienta de línea de comandos (**CLI**) de alto rendimiento diseñada para **automatizar la creación de proyectos FastAPI** siguiendo estándares **empresariales** y principios de **Clean Architecture**.
+
+Desarrollado y mantenido por **MIKECARDONA076**.
+
+---
+
+## ✨ Características Principales
+
+- **Estructura Profesional**  
+  Genera automáticamente un layout modular:
+  - `api`
+  - `core`
+  - `crud`
+  - `models`
+  - `schemas`
+  - `services`
+
+- **Alembic Ready**  
+  Configuración automática de migraciones de base de datos con **detección de modelos**.
+
+- **Suite TESTMIKE**  
+  Incluye **5 pruebas rápidas de humo** para validar:
+  - Base de Datos
+  - CORS
+  - Seguridad
+  - Integridad de Modelos
+  - Respaldo de archivos
+
+- **Docker Support**  
+  Genera:
+  - `Dockerfile`
+  - `docker-compose.yml`  
+  Listo para despliegues rápidos.
+
+- **Seguridad Integrada**  
+  Configuración base de:
+  - Middlewares de CORS
+  - Utilidades de hashing y criptografía
+
+---
+
+## 🛠️ Instalación
+
+Instala el paquete de forma global o dentro de un entorno virtual:
+
+```bash
+pip install fastmike
+````
+
+---
+
+## 🚀 Uso Rápido
+
+Para desplegar la estructura base de tu nueva API:
+
+```bash
+fastmike init --name mi-proyecto-pro
+```
+
+---
+
+## 🆘 ¿El comando `fastmike` no se reconoce?
+
+Si el comando no está disponible por variables de entorno (`PATH`), usa el modo módulo de Python:
+
+```bash
+python -m fastmike init --name mi-proyecto-pro
+```
+
+Este método es **infalible**.
+
+---
+
+## 📁 Estructura Generada
+
+Al ejecutar el comando, se creará el siguiente árbol de directorios:
+
+```text
+nombre-de-tu-proyecto/
+├── app/
+│   ├── api/v1/          # Endpoints versionados
+│   ├── core/            # Configuración y Seguridad
+│   ├── crud/            # Lógica atómica de DB
+│   ├── models/          # Modelos SQLAlchemy
+│   ├── schemas/         # DTOs de Pydantic
+│   ├── services/        # Lógica de negocio compleja
+│   └── main.py          # Punto de entrada
+├── TESTMIKE/            # Suite de validación rápida
+├── alembic/             # Migraciones de DB
+├── .env                 # Variables de entorno
+├── Dockerfile           # Configuración Docker
+└── requirements.txt     # Dependencias base
+```
+
+---
+
+## 🧪 Validando tu Proyecto (TESTMIKE)
+
+Una vez creada la estructura, entra a la carpeta del proyecto y ejecuta los tests de validación rápida:
+
+```bash
+# Validar conexión a Base de Datos
+python TESTMIKE/db_check.py
+
+# Validar integridad de modelos
+python TESTMIKE/model_integrity.py
+```
+
+Estos tests confirman que el proyecto está **correctamente configurado antes de desarrollar**.
+
+---
+
+## 🤝 Contribuciones y Soporte
+
+Si encuentras errores o tienes sugerencias:
+
+1. Haz un **Fork** del proyecto
+2. Crea una rama para tu mejora:
+
+   ```bash
+   git checkout -b feature/Mejora
+   ```
+3. Envía un **Pull Request**
+
+

fastapi_mike-0.0.0.dist-info/RECORD

@@ -0,0 +1,11 @@
+fastapi_mike-0.0.0.dist-info/licenses/LICENSE,sha256=wioVC01h0BZaoURb49RXMpk8f309BxHdvq-ibdgf_1s,502
+fastmike/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+fastmike/__main__.py,sha256=fcOdMNlBtIL1PMXJGw3LIL0T6WHguQ5yP5V7xs1rSHU,121
+fastmike/cli.py,sha256=RLsWX3-ZikEqc5apbMeWXBT2m9YZ9L1ux1_nUpyzcmM,3358
+fastmike/templates.py,sha256=JLuvdSTXmYZw7T9gTW5Sie-nGZ8GgdnSBl3JhM4D3bE,1231
+fastmike/utils.py,sha256=MPA0uMFMNWiKoNTYoIG_eWBrM3k4MJRmIZitfmFDGFg,1117
+fastapi_mike-0.0.0.dist-info/METADATA,sha256=SJ3AjSaTghjxws0gBBvDrzw1RNiTjmNLB1QDVdbd7qw,3554
+fastapi_mike-0.0.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+fastapi_mike-0.0.0.dist-info/entry_points.txt,sha256=PQhW7CNBRYcGSOBFdnOUY8A1lbsggX8Lzmxep19SBPo,51
+fastapi_mike-0.0.0.dist-info/top_level.txt,sha256=4IZpMJzbvfpIPmSBvjD6S0KG4eL7DqQ74NVJBDO9bjo,9
+fastapi_mike-0.0.0.dist-info/RECORD,,

fastapi_mike-0.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

fastapi_mike-0.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+fastapi-mike = fastmike.cli:main

fastapi_mike-0.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,22 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "fastmike"
+version = "0.1.0"
+authors = [
+  { name="Mike Cardona", email="mikcardona076@gmail.com" },
+]
+description = "FastAPI Enterprise Scaffolder by MIKECARDONA076"
+readme = "README.md"
+requires-python = ">=3.8"
+dependencies = [
+    "click>=8.0.0",
+    "sqlalchemy>=2.0.0",
+    "alembic>=1.10.0",
+    "requests>=2.28.0",
+]
+
+[project.scripts]
+fastmike = "fastmike.cli:main"

fastapi_mike-0.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+fastmike

fastmike/__main__.py

@@ -0,0 +1,5 @@
+from fastmike.cli import main
+
+if __name__ == "__main__":
+    # Permite ejecutar con: python -m fastmike
+    main()

fastmike/cli.py

@@ -0,0 +1,94 @@
+import click
+import os
+import pathlib
+import subprocess
+from .utils import print_banner, get_db_url
+from .templates import (
+    get_main_py, 
+    get_db_base, 
+    get_api_router, 
+    get_testmike_files,
+    get_alembic_env_py
+)
+
+@click.group()
+def main():
+    """CLI Profesional de fastapi-mike por MIKECARDONA076"""
+    pass
+
+@main.command()
+@click.option('--name', default='fastapi-mike-api', help='Nombre del proyecto')
+def init(name):
+    """Inicializa la estructura perfecta de FastAPI"""
+    print_banner()
+    click.secho(f"🚀 Creando proyecto: {name}...", fg="yellow")
+    # Lógica de creación de carpetas y archivos...
+    click.secho("✅ ¡Listo! Proyecto configurado.", fg="green", bold=True)
+
+
+@main.command()
+@click.option('--name', default='fastapi-project', help='Nombre del proyecto')
+def init(name):
+    """Inicializa un nuevo proyecto con la estructura profesional de Mike."""
+    print_banner()
+    
+    # 1. Crear Estructura de Carpetas
+    folders = [
+        "app/api/v1/endpoints", "app/core", "app/crud", "app/db",
+        "app/models", "app/schemas", "app/services", "app/admin",
+        "tests/api", "tests/crud", "TESTMIKE"
+    ]
+    
+    click.echo("📁 Creando estructura de directorios...")
+    for folder in folders:
+        path = pathlib.Path(folder)
+        path.mkdir(parents=True, exist_ok=True)
+        (path / "__init__.py").touch()
+    
+    # 2. Obtener URL de DB y Generar Archivos Base
+    db_url = get_db_url()
+    
+    click.echo("📝 Generando archivos base...")
+    with open("app/main.py", "w", encoding="utf-8") as f: 
+        f.write(get_main_py(name))
+    
+    with open("app/db/base_class.py", "w", encoding="utf-8") as f: 
+        f.write(get_db_base())
+        
+    with open("app/api/v1/api.py", "w", encoding="utf-8") as f: 
+        f.write(get_api_router())
+
+    # 3. Generar Suite TESTMIKE
+    click.echo("🧪 Generando suite de pruebas rápidas TESTMIKE...")
+    tests = get_testmike_files(db_url)
+    for filename, content in tests.items():
+        with open(f"TESTMIKE/{filename}", "w", encoding="utf-8") as f:
+            f.write(content)
+
+    # 4. Configurar Alembic
+    click.echo("⚙️ Configurando Alembic...")
+    try:
+        if not os.path.exists("alembic.ini"):
+            subprocess.run(["alembic", "init", "alembic"], capture_output=True)
+            
+        # Modificar alembic.ini
+        with open("alembic.ini", "r") as f: lines = f.readlines()
+        with open("alembic.ini", "w") as f:
+            for line in lines:
+                if line.startswith("sqlalchemy.url"):
+                    f.write(f"sqlalchemy.url = {db_url}\n")
+                else: f.write(line)
+        
+        # Sobreescribir env.py para auto-detección
+        with open("alembic/env.py", "w", encoding="utf-8") as f:
+            f.write(get_alembic_env_py())
+            
+    except Exception as e:
+        click.secho(f"⚠️ Error configurando Alembic: {e}", fg="yellow")
+
+    # 5. Extras (Docker & .env)
+    with open(".env", "w") as f:
+        f.write(f"PROJECT_NAME={name}\nDATABASE_URL={db_url}\n")
+    
+    click.secho(f"\n🚀 Proyecto '{name}' listo para despegar!", fg='green', bold=True)
+    click.echo("Usa 'pip install -r requirements.txt' y luego 'uvicorn app.main:app --reload'")

fastmike/templates.py

@@ -0,0 +1,41 @@
+def get_main_py(project_name):
+    return f"""from fastapi import FastAPI
+from app.api.v1.api import api_router
+
+app = FastAPI(title="{project_name}")
+app.include_router(api_router, prefix="/api/v1")
+
+@app.get("/")
+def read_root():
+    return {{"message": "Welcome to {project_name}", "mike": "cardona076"}}
+"""
+
+def get_api_router():
+    return "from fastapi import APIRouter\napi_router = APIRouter()"
+
+def get_db_base():
+    return """from sqlalchemy.ext.declarative import as_declarative, declared_attr
+from typing import Any
+
+@as_declarative()
+class Base:
+    id: Any
+    __name__: str
+    @declared_attr
+    def __tablename__(cls) -> str:
+        return cls.__name__.lower()
+"""
+
+def get_testmike_files(db_url):
+    return {
+        "db_check.py": f"import sqlalchemy; print('Checking {db_url}')",
+        "security_auth.py": "import secrets; print(f'Token: {secrets.token_urlsafe(32)}')",
+        # ... (puedes añadir los otros 3 aquí siguiendo el mismo formato)
+    }
+
+def get_alembic_env_py():
+    return """# Contenido de env.py para detección automática de modelos
+from app.db.base_class import Base
+target_metadata = Base.metadata
+# ... (resto de la lógica de alembic)
+"""

fastmike/utils.py

@@ -0,0 +1,25 @@
+import click
+
+def print_banner():
+    banner = r"""
+  __  __ _____ _  cache _____   _____            _____  _____   ____  _   _ 
+ |  \/  |_   _| |/ /  | ____| |  ___|/\   / \  / ____|/ ____| / __ \| \ | |
+ | \  / | | | | ' /   |  _|   | |_  /  \ /   \| (___ | |     | |  | |  \| |
+ | |\/| | | | |  <    | |___  |  _|/ /\ \\ / / \___ \| |     | |  | | . ` |
+ | |  | |_| |_| . \   | |____ | | / ____ \/ /  ____) | |____ | |__| | |\  |
+ |_|  |_|_____|_|\_\  |______||_|/_/    \_\/  |_____/ \_____| \____/|_| \_|
+                                                                           
+                         DEVELOPED BY: MIKECARDONA076
+    """
+    click.secho(banner, fg="cyan")
+
+def get_db_url():
+    click.echo("\nConfiguración de Base de Datos:")
+    db_type = click.prompt(
+        "Elige DB (1: SQLite, 2: Postgres, 3: MySQL)", 
+        type=click.Choice(['1', '2', '3']), 
+        default='1'
+    )
+    if db_type == '1': return "sqlite:///./sql_app.db"
+    if db_type == '2': return "postgresql://user:pass@localhost:5432/db"
+    return "mysql+pymysql://user:pass@localhost:3306/db"