abhijanfastapi 1.0.0__tar.gz

abhijanfastapi-1.0.0/PKG-INFO

@@ -0,0 +1,75 @@
+Metadata-Version: 2.5
+Name: abhijanfastapi
+Version: 1.0.0
+Summary: Abhijan FastAPI scaffolding package with `abhijan init` and `abhijan alembic` CLI.
+Project-URL: Homepage, https://github.com/Kilo-Org/kilocode
+Project-URL: Issues, https://github.com/Kilo-Org/kilocode/issues
+Author: Abhijan
+License: MIT
+Keywords: alembic,cli,fastapi,scaffolding
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Code Generators
+Requires-Python: >=3.10
+Requires-Dist: rich>=13
+Requires-Dist: typer>=0.12
+Description-Content-Type: text/markdown
+
+# abhijanfastapi
+
+Scaffolding CLI for Abhijan FastAPI projects.
+
+Provides the `abhijan` command with two subcommands:
+
+- `abhijan init` — creates `main.py`, `config.py`, `database.py`
+- `abhijan alembic` — creates `alembic/env.py` with the async migration config
+
+## Install
+
+```bash
+pip install abhijanfastapi
+```
+
+## Usage
+
+```bash
+# scaffold a new project in the current directory
+abhijan init
+
+# scaffold into a specific directory
+abhijan init -d ./my-app
+
+# (re)create alembic/env.py
+abhijan alembic
+
+# overwrite existing files without prompting
+abhijan init -f
+```
+
+After scaffolding, run your app with:
+
+```bash
+uvicorn main:app --reload
+```
+
+And run migrations with:
+
+```bash
+alembic revision --autogenerate -m "initial"
+alembic upgrade head
+```
+
+## Requirements
+
+- Python >= 3.10
+
+## License
+
+MIT

abhijanfastapi-1.0.0/README.md

@@ -0,0 +1,51 @@
+# abhijanfastapi
+
+Scaffolding CLI for Abhijan FastAPI projects.
+
+Provides the `abhijan` command with two subcommands:
+
+- `abhijan init` — creates `main.py`, `config.py`, `database.py`
+- `abhijan alembic` — creates `alembic/env.py` with the async migration config
+
+## Install
+
+```bash
+pip install abhijanfastapi
+```
+
+## Usage
+
+```bash
+# scaffold a new project in the current directory
+abhijan init
+
+# scaffold into a specific directory
+abhijan init -d ./my-app
+
+# (re)create alembic/env.py
+abhijan alembic
+
+# overwrite existing files without prompting
+abhijan init -f
+```
+
+After scaffolding, run your app with:
+
+```bash
+uvicorn main:app --reload
+```
+
+And run migrations with:
+
+```bash
+alembic revision --autogenerate -m "initial"
+alembic upgrade head
+```
+
+## Requirements
+
+- Python >= 3.10
+
+## License
+
+MIT

abhijanfastapi-1.0.0/fastapipkg/__init__.py

@@ -0,0 +1,3 @@
+"""Abhijan FastAPI package - scaffolding utilities."""
+
+__version__ = "1.0.0"

abhijanfastapi-1.0.0/fastapipkg/cli.py

@@ -0,0 +1,118 @@
+"""CLI entry point: `abhijan init` and `abhijan alembic` scaffolding commands."""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+import typer
+from rich.console import Console
+from rich.prompt import Confirm
+
+app = typer.Typer(name="abhijan", help="Abhijan FastAPI scaffolding CLI")
+console = Console()
+
+_TEMPLATES_DIR = Path(__file__).resolve().parent / "templates"
+
+# Map template file -> destination filename
+_TEMPLATES = {
+    "main.py.template": "main.py",
+    "config.py.template": "config.py",
+    "database.py.template": "database.py",
+    "alembic/env.py.template": "alembic/env.py",
+}
+
+
+def _write_template(
+    src_name: str,
+    dest_name: str,
+    directory: Path,
+    force: bool,
+) -> bool:
+    """Write a template file to the destination, prompting on conflicts."""
+    src = _TEMPLATES_DIR / src_name
+    dest = directory / dest_name
+    content = src.read_text()
+
+    if dest.exists() and not force:
+        if not Confirm.ask(
+            f"[yellow]{dest_name}[/yellow] already exists. Overwrite?",
+            default=False,
+        ):
+            console.print(f"  [dim]- skipped {dest_name}[/dim]")
+            return False
+
+    dest.parent.mkdir(parents=True, exist_ok=True)
+    dest.write_text(content)
+    console.print(f"  [green]+[/green] {dest_name}")
+    return True
+
+
+@app.callback(invoke_without_command=True)
+def _root(ctx: typer.Context) -> None:
+    if ctx.invoked_subcommand is None:
+        console.print(
+            "[bold green]abhijan[/bold green] - Abhijan FastAPI scaffolding tool.\n"
+            "Run [cyan]abhijan init[/cyan] to scaffold a new project, or "
+            "[cyan]abhijan alembic[/cyan] to (re)create alembic/env.py."
+        )
+
+
+@app.command()
+def init(
+    directory: Path = typer.Option(
+        Path("."),
+        "--directory",
+        "-d",
+        help="Target directory to scaffold into (default: current directory).",
+    ),
+    force: bool = typer.Option(
+        False,
+        "--force",
+        "-f",
+        help="Overwrite existing files without prompting.",
+    ),
+) -> None:
+    """Scaffold a new Abhijan FastAPI project."""
+    directory = directory.resolve()
+    directory.mkdir(parents=True, exist_ok=True)
+
+    console.print(f"[bold]Scaffolding Abhijan FastAPI project in[/bold] {directory}")
+
+    for src_name, dest_name in _TEMPLATES.items():
+        if dest_name.startswith("alembic/"):
+            continue
+        _write_template(src_name, dest_name, directory, force)
+
+    console.print("\n[bold green]Done.[/bold green] Run your app with:")
+    console.print("  [cyan]uvicorn main:app --reload[/cyan]")
+
+
+@app.command()
+def alembic(
+    directory: Path = typer.Option(
+        Path("."),
+        "--directory",
+        "-d",
+        help="Target directory (default: current directory).",
+    ),
+    force: bool = typer.Option(
+        False,
+        "--force",
+        "-f",
+        help="Overwrite existing alembic/env.py without prompting.",
+    ),
+) -> None:
+    """(Re)create alembic/env.py with the Abhijan async migration config."""
+    directory = directory.resolve()
+    directory.mkdir(parents=True, exist_ok=True)
+
+    console.print(f"[bold]Writing alembic/env.py in[/bold] {directory}")
+    _write_template("alembic/env.py.template", "alembic/env.py", directory, force)
+
+    console.print("\n[bold green]Done.[/bold green] Then run:")
+    console.print("  [cyan]alembic revision --autogenerate -m 'initial'[/cyan]")
+    console.print("  [cyan]alembic upgrade head[/cyan]")
+
+
+if __name__ == "__main__":
+    app()

abhijanfastapi-1.0.0/fastapipkg/templates/alembic/env.py.template

@@ -0,0 +1,68 @@
+from __future__ import annotations
+
+import asyncio
+from logging.config import fileConfig
+
+from sqlalchemy import pool
+from sqlalchemy.engine import Connection
+from sqlalchemy.ext.asyncio import async_engine_from_config
+
+from alembic import context
+
+from config import settings
+from database import Base
+from models import Todo  # noqa: F401 - required for autogenerate
+
+config = context.config
+
+if config.config_file_name is not None:
+    fileConfig(config.config_file_name)
+
+target_metadata = Base.metadata
+
+config.set_main_option("sqlalchemy.url", settings.database_url)
+
+
+def run_migrations_offline() -> None:
+    """Run migrations in 'offline' mode."""
+    url = config.get_main_option("sqlalchemy.url")
+    context.configure(
+        url=url,
+        target_metadata=target_metadata,
+        literal_binds=True,
+        dialect_opts={"paramstyle": "named"},
+    )
+
+    with context.begin_transaction():
+        context.run_migrations()
+
+
+def do_run_migrations(connection: Connection) -> None:
+    context.configure(
+        connection=connection,
+        target_metadata=target_metadata,
+        compare_type=True,
+    )
+
+    with context.begin_transaction():
+        context.run_migrations()
+
+
+async def run_migrations_online() -> None:
+    """Run migrations in 'online' mode."""
+    connectable = async_engine_from_config(
+        config.get_section(config.config_ini_section, {}),
+        prefix="sqlalchemy.",
+        poolclass=pool.NullPool,
+    )
+
+    async with connectable.connect() as connection:
+        await connection.run_sync(do_run_migrations)
+
+    await connectable.dispose()
+
+
+if context.is_offline_mode():
+    run_migrations_offline()
+else:
+    asyncio.run(run_migrations_online())

abhijanfastapi-1.0.0/fastapipkg/templates/config.py.template

@@ -0,0 +1,11 @@
+from pydantic_settings import BaseSettings, SettingsConfigDict
+
+
+class Settings(BaseSettings):
+    database_url: str = "postgresql+asyncpg://user:pass@localhost:5432/abhijanfastapi"
+    debug: bool = False
+
+    model_config = SettingsConfigDict(env_file=".env", env_prefix="")
+
+
+settings = Settings()

abhijanfastapi-1.0.0/fastapipkg/templates/database.py.template

@@ -0,0 +1,38 @@
+from sqlalchemy.ext.asyncio import AsyncSession, create_async_engine
+from sqlalchemy.orm import DeclarativeBase, sessionmaker
+
+from config import settings
+
+engine = create_async_engine(
+    settings.database_url,
+    echo=settings.debug,
+    future=True,
+)
+
+AsyncSessionLocal = sessionmaker(
+    bind=engine,
+    class_=AsyncSession,
+    expire_on_commit=False,
+    autoflush=False,
+)
+
+
+class Base(DeclarativeBase):
+    pass
+
+
+async def get_db() -> AsyncSession:
+    async with AsyncSessionLocal() as session:
+        try:
+            yield session
+            await session.commit()
+        except Exception:
+            await session.rollback()
+            raise
+        finally:
+            await session.close()
+
+
+async def init_db() -> None:
+    async with engine.begin() as conn:
+        await conn.run_sync(Base.metadata.create_all)

abhijanfastapi-1.0.0/fastapipkg/templates/main.py.template

@@ -0,0 +1,36 @@
+from fastapi import FastAPI
+from fastapi.middleware.cors import CORSMiddleware
+
+from database import init_db
+
+app = FastAPI(title="Abhijan FastAPI", version="1.0.0")
+
+origins = [
+    "http://localhost:3000",
+    "http://localhost:5173",
+    "http://127.0.0.1:3000",
+    "http://127.0.0.1:5173",
+]
+
+app.add_middleware(
+    CORSMiddleware,
+    allow_origins=origins,
+    allow_credentials=True,
+    allow_methods=["*"],
+    allow_headers=["*"],
+)
+
+
+@app.get("/")
+def read_root():
+    return {"message": "Hello from Abhijan FastAPI"}
+
+
+@app.get("/health")
+def health_check():
+    return {"status": "ok"}
+
+
+@app.on_event("startup")
+async def on_startup() -> None:
+    await init_db()

abhijanfastapi-1.0.0/pyproject.toml

@@ -0,0 +1,40 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "abhijanfastapi"
+version = "1.0.0"
+description = "Abhijan FastAPI scaffolding package with `abhijan init` and `abhijan alembic` CLI."
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [{ name = "Abhijan" }]
+keywords = ["fastapi", "scaffolding", "alembic", "cli"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Code Generators",
+]
+dependencies = [
+    "typer>=0.12",
+    "rich>=13",
+]
+
+[project.scripts]
+abhijan = "fastapipkg.cli:app"
+
+[project.urls]
+Homepage = "https://github.com/Kilo-Org/kilocode"
+Issues = "https://github.com/Kilo-Org/kilocode/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["fastapipkg"]
+dev-mode-dirs = ["."]