fastapi-basekit 0.2.1__tar.gz → 0.3.0__tar.gz

fastapi_basekit-0.3.0/PKG-INFO

@@ -0,0 +1,130 @@
+Metadata-Version: 2.1
+Name: fastapi-basekit
+Version: 0.3.0
+Summary: Utilities and base classes for FastAPI async projects (Beanie, SQLAlchemy or SQLModel)
+Author-email: Jerson Moreno <jerson.ml820@hotmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/mundobien2025/fastapi-basekit
+Project-URL: Repository, https://github.com/mundobien2025/fastapi-basekit
+Project-URL: Issues, https://github.com/mundobien2025/fastapi-basekit/issues
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Programming Language :: Python :: 3
+Classifier: Framework :: FastAPI
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: fastapi>=0.116.1
+Requires-Dist: pydantic<3,>=2.11.7
+Requires-Dist: fastapi-restful[all]>=0.6.0
+Requires-Dist: pyjwt>=2.10.1
+Provides-Extra: beanie
+Requires-Dist: beanie>=1.24.0; extra == "beanie"
+Requires-Dist: motor>=3.3.0; extra == "beanie"
+Provides-Extra: sqlalchemy
+Requires-Dist: SQLAlchemy[asyncio]>=2.0.0; extra == "sqlalchemy"
+Requires-Dist: psycopg2>=2.9.0; extra == "sqlalchemy"
+Provides-Extra: sqlmodel
+Requires-Dist: sqlmodel>=0.0.37; extra == "sqlmodel"
+Provides-Extra: init
+Requires-Dist: cookiecutter>=2.5.0; extra == "init"
+Provides-Extra: docs
+Requires-Dist: mkdocs>=1.6.0; extra == "docs"
+Requires-Dist: mkdocs-material>=9.5.0; extra == "docs"
+Requires-Dist: mkdocstrings[python]>=0.27.0; extra == "docs"
+Requires-Dist: pymdown-extensions>=10.10; extra == "docs"
+Requires-Dist: mike>=2.1.0; extra == "docs"
+Provides-Extra: all
+Requires-Dist: beanie>=1.24.0; extra == "all"
+Requires-Dist: motor>=3.3.0; extra == "all"
+Requires-Dist: SQLAlchemy[asyncio]>=2.0.0; extra == "all"
+Requires-Dist: psycopg2>=2.9.0; extra == "all"
+Requires-Dist: sqlmodel>=0.0.37; extra == "all"
+Requires-Dist: cookiecutter>=2.5.0; extra == "all"
+Requires-Dist: mkdocs>=1.6.0; extra == "all"
+Requires-Dist: mkdocs-material>=9.5.0; extra == "all"
+Requires-Dist: mkdocstrings[python]>=0.27.0; extra == "all"
+
+<div align="center">
+
+# FastAPI BaseKit
+
+**Toolkit base para construir APIs FastAPI rápido — sin reinventar repos, services y controllers.**
+
+[![PyPI](https://img.shields.io/pypi/v/fastapi-basekit?style=flat-square&color=teal)](https://pypi.org/project/fastapi-basekit/)
+![Python](https://img.shields.io/badge/python-3.11+-blue?style=flat-square&logo=python)
+![FastAPI](https://img.shields.io/badge/FastAPI-005571?style=flat-square&logo=fastapi)
+![SQLAlchemy](https://img.shields.io/badge/SQLAlchemy-2.0-red?style=flat-square)
+![Beanie](https://img.shields.io/badge/MongoDB-Beanie-47A248?style=flat-square&logo=mongodb)
+![License](https://img.shields.io/badge/license-MIT-green?style=flat-square)
+
+[**Docs**](https://mundobien2025.github.io/fastapi-basekit) · [**PyPI**](https://pypi.org/project/fastapi-basekit/) · [**Issues**](https://github.com/mundobien2025/fastapi-basekit/issues) · [**Changelog**](./CHANGELOG.md)
+
+</div>
+
+---
+
+## Quickstart
+
+```bash
+pip install fastapi-basekit[init]
+basekit init                                    # cookiecutter prompts
+cd <project_slug>
+cp .env.example .env
+make up-d
+make migrate-create && make migrate-up
+make seed
+```
+
+Abre http://localhost:8000/docs. Login con `admin@example.com` / `ChangeMe2026!`.
+
+## ¿Qué incluye?
+
+- **Repository / Service / Controller** base async para SQLAlchemy 2.0, SQLModel y Beanie
+- **Paginación, filtrado, búsqueda, ordenamiento** vía query string out-of-the-box
+- **JWT middleware** + `BasePermission` classes + soft-delete
+- **`basekit init`** — scaffolder cookiecutter (multi-ORM, multi-DB, redis, s3, license)
+- **Plugin Claude Code** — la skill `fastapi-basekit-crud` enseña el patrón a Claude
+
+## Documentación
+
+📚 **[mundobien2025.github.io/fastapi-basekit](https://mundobien2025.github.io/fastapi-basekit)**
+
+| Sección | Contenido |
+|---|---|
+| [Primeros pasos](https://mundobien2025.github.io/fastapi-basekit/getting-started/installation) | Instalación, `basekit init`, primer CRUD |
+| [Guía de usuario](https://mundobien2025.github.io/fastapi-basekit/user-guide/controllers) | Controllers, services, repositories, paginación, filtros |
+| [Avanzado](https://mundobien2025.github.io/fastapi-basekit/advanced/permissions) | Permisos, soft-delete, logging, performance |
+| [Referencia API](https://mundobien2025.github.io/fastapi-basekit/api-reference/base-controller) | Docstrings de `BaseController`, `BaseService`, `BaseRepository`, `Schemas` |
+| [Ejemplos](https://mundobien2025.github.io/fastapi-basekit/examples/basic-crud) | CRUD básico, filtros complejos, relaciones, auth |
+
+## Como plugin de Claude Code
+
+```bash
+/plugin marketplace add https://github.com/mundobien2025/fastapi-basekit
+/plugin install fastapi-basekit
+/plugin list
+```
+
+Luego pide: *"Crea el recurso `Invoice` con CRUD completo"* — Claude usa la skill automáticamente.
+
+## Instalación por ORM
+
+```bash
+pip install fastapi-basekit[sqlalchemy]   # Postgres / MySQL / SQLite
+pip install fastapi-basekit[beanie]       # MongoDB
+pip install fastapi-basekit[sqlmodel]
+pip install fastapi-basekit[init]         # solo scaffolder
+pip install fastapi-basekit[all]          # todo
+```
+
+## Contribuir
+
+PRs bienvenidos. Setup local en [docs/contributing](https://mundobien2025.github.io/fastapi-basekit/contributing).
+
+Mantenedores: [`RELEASING.md`](./RELEASING.md) tiene release flow, CI/CD, mike y troubleshooting.
+
+## Licencia
+
+[MIT](./LICENSE) — © Jerson Moreno

fastapi_basekit-0.3.0/README.md

@@ -0,0 +1,82 @@
+<div align="center">
+
+# FastAPI BaseKit
+
+**Toolkit base para construir APIs FastAPI rápido — sin reinventar repos, services y controllers.**
+
+[![PyPI](https://img.shields.io/pypi/v/fastapi-basekit?style=flat-square&color=teal)](https://pypi.org/project/fastapi-basekit/)
+![Python](https://img.shields.io/badge/python-3.11+-blue?style=flat-square&logo=python)
+![FastAPI](https://img.shields.io/badge/FastAPI-005571?style=flat-square&logo=fastapi)
+![SQLAlchemy](https://img.shields.io/badge/SQLAlchemy-2.0-red?style=flat-square)
+![Beanie](https://img.shields.io/badge/MongoDB-Beanie-47A248?style=flat-square&logo=mongodb)
+![License](https://img.shields.io/badge/license-MIT-green?style=flat-square)
+
+[**Docs**](https://mundobien2025.github.io/fastapi-basekit) · [**PyPI**](https://pypi.org/project/fastapi-basekit/) · [**Issues**](https://github.com/mundobien2025/fastapi-basekit/issues) · [**Changelog**](./CHANGELOG.md)
+
+</div>
+
+---
+
+## Quickstart
+
+```bash
+pip install fastapi-basekit[init]
+basekit init                                    # cookiecutter prompts
+cd <project_slug>
+cp .env.example .env
+make up-d
+make migrate-create && make migrate-up
+make seed
+```
+
+Abre http://localhost:8000/docs. Login con `admin@example.com` / `ChangeMe2026!`.
+
+## ¿Qué incluye?
+
+- **Repository / Service / Controller** base async para SQLAlchemy 2.0, SQLModel y Beanie
+- **Paginación, filtrado, búsqueda, ordenamiento** vía query string out-of-the-box
+- **JWT middleware** + `BasePermission` classes + soft-delete
+- **`basekit init`** — scaffolder cookiecutter (multi-ORM, multi-DB, redis, s3, license)
+- **Plugin Claude Code** — la skill `fastapi-basekit-crud` enseña el patrón a Claude
+
+## Documentación
+
+📚 **[mundobien2025.github.io/fastapi-basekit](https://mundobien2025.github.io/fastapi-basekit)**
+
+| Sección | Contenido |
+|---|---|
+| [Primeros pasos](https://mundobien2025.github.io/fastapi-basekit/getting-started/installation) | Instalación, `basekit init`, primer CRUD |
+| [Guía de usuario](https://mundobien2025.github.io/fastapi-basekit/user-guide/controllers) | Controllers, services, repositories, paginación, filtros |
+| [Avanzado](https://mundobien2025.github.io/fastapi-basekit/advanced/permissions) | Permisos, soft-delete, logging, performance |
+| [Referencia API](https://mundobien2025.github.io/fastapi-basekit/api-reference/base-controller) | Docstrings de `BaseController`, `BaseService`, `BaseRepository`, `Schemas` |
+| [Ejemplos](https://mundobien2025.github.io/fastapi-basekit/examples/basic-crud) | CRUD básico, filtros complejos, relaciones, auth |
+
+## Como plugin de Claude Code
+
+```bash
+/plugin marketplace add https://github.com/mundobien2025/fastapi-basekit
+/plugin install fastapi-basekit
+/plugin list
+```
+
+Luego pide: *"Crea el recurso `Invoice` con CRUD completo"* — Claude usa la skill automáticamente.
+
+## Instalación por ORM
+
+```bash
+pip install fastapi-basekit[sqlalchemy]   # Postgres / MySQL / SQLite
+pip install fastapi-basekit[beanie]       # MongoDB
+pip install fastapi-basekit[sqlmodel]
+pip install fastapi-basekit[init]         # solo scaffolder
+pip install fastapi-basekit[all]          # todo
+```
+
+## Contribuir
+
+PRs bienvenidos. Setup local en [docs/contributing](https://mundobien2025.github.io/fastapi-basekit/contributing).
+
+Mantenedores: [`RELEASING.md`](./RELEASING.md) tiene release flow, CI/CD, mike y troubleshooting.
+
+## Licencia
+
+[MIT](./LICENSE) — © Jerson Moreno

fastapi_basekit-0.3.0/fastapi_basekit/cli/__init__.py

@@ -0,0 +1,5 @@
+"""basekit CLI — entry point for `basekit init`."""
+
+from fastapi_basekit.cli.main import main
+
+__all__ = ["main"]

fastapi_basekit-0.3.0/fastapi_basekit/cli/main.py

@@ -0,0 +1,112 @@
+"""basekit CLI entry point.
+
+Usage:
+    basekit init                # interactive cookiecutter prompts
+    basekit init --no-input     # use defaults (good for CI / testing)
+    basekit init -o /path       # output dir
+    basekit init --extra-context key=value
+    basekit version
+"""
+
+from __future__ import annotations
+
+import argparse
+import sys
+from importlib import metadata
+from pathlib import Path
+from typing import Sequence
+
+
+def _template_dir() -> Path:
+    return Path(__file__).resolve().parent.parent / "templates" / "project"
+
+
+def _cmd_init(args: argparse.Namespace) -> int:
+    try:
+        from cookiecutter.main import cookiecutter
+    except ImportError:
+        print(
+            "Error: cookiecutter not installed. Install with:\n"
+            "    pip install fastapi-basekit[init]\n"
+            "or  pip install cookiecutter",
+            file=sys.stderr,
+        )
+        return 1
+
+    extra_context: dict[str, str] = {}
+    for kv in args.extra_context or []:
+        if "=" not in kv:
+            print(f"Bad --extra-context value (expected key=value): {kv}", file=sys.stderr)
+            return 2
+        k, v = kv.split("=", 1)
+        extra_context[k.strip()] = v.strip()
+
+    try:
+        cookiecutter(
+            template=str(_template_dir()),
+            no_input=args.no_input,
+            output_dir=args.output_dir,
+            extra_context=extra_context,
+            overwrite_if_exists=args.overwrite,
+        )
+    except Exception as exc:  # pragma: no cover - cookiecutter raises various
+        print(f"basekit init failed: {exc}", file=sys.stderr)
+        return 3
+    return 0
+
+
+def _cmd_version(_: argparse.Namespace) -> int:
+    try:
+        v = metadata.version("fastapi-basekit")
+    except metadata.PackageNotFoundError:  # pragma: no cover
+        v = "unknown"
+    print(f"fastapi-basekit {v}")
+    return 0
+
+
+def build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(
+        prog="basekit",
+        description="fastapi-basekit project scaffolder.",
+    )
+    sub = parser.add_subparsers(dest="cmd", required=True)
+
+    init = sub.add_parser("init", help="Scaffold a new project from the basekit template.")
+    init.add_argument(
+        "-o",
+        "--output-dir",
+        default=".",
+        help="Where to write the new project (default: current directory).",
+    )
+    init.add_argument(
+        "--no-input",
+        action="store_true",
+        help="Skip interactive prompts; use cookiecutter.json defaults.",
+    )
+    init.add_argument(
+        "--overwrite",
+        action="store_true",
+        help="Overwrite the output directory if it already exists.",
+    )
+    init.add_argument(
+        "--extra-context",
+        action="append",
+        metavar="KEY=VALUE",
+        help="Override one cookiecutter variable; repeatable.",
+    )
+    init.set_defaults(func=_cmd_init)
+
+    version = sub.add_parser("version", help="Print the installed version.")
+    version.set_defaults(func=_cmd_version)
+
+    return parser
+
+
+def main(argv: Sequence[str] | None = None) -> int:
+    parser = build_parser()
+    args = parser.parse_args(argv)
+    return args.func(args)
+
+
+if __name__ == "__main__":  # pragma: no cover
+    raise SystemExit(main())

fastapi_basekit-0.3.0/fastapi_basekit/templates/project/cookiecutter.json

@@ -0,0 +1,19 @@
+{
+    "project_name": "My FastAPI Service",
+    "project_slug": "{{ cookiecutter.project_name.lower()|replace(' ', '_')|replace('-', '_') }}",
+    "package_name": "{{ cookiecutter.project_slug }}",
+    "description": "Backend API built with fastapi-basekit",
+    "author_name": "Your Name",
+    "author_email": "you@example.com",
+    "python_version": "3.12",
+    "orm": ["sqlalchemy", "beanie"],
+    "database": ["postgres", "mariadb", "sqlite", "mongodb"],
+    "server": ["uvicorn", "gunicorn"],
+    "cache": ["none", "redis"],
+    "background_tasks": ["none", "arq"],
+    "bucket": ["none", "s3"],
+    "include_alembic": ["yes", "no"],
+    "license": ["MIT", "Apache-2.0", "GPL-3.0", "Proprietary"],
+    "include_docker": ["yes", "no"],
+    "_extensions": ["jinja2.ext.do"]
+}

fastapi_basekit-0.3.0/fastapi_basekit/templates/project/hooks/post_gen_project.py

@@ -0,0 +1,51 @@
+"""Cleanup files that aren't needed for the chosen options."""
+
+import os
+import shutil
+from pathlib import Path
+
+ORM = "{{ cookiecutter.orm }}"
+DB = "{{ cookiecutter.database }}"
+INCLUDE_ALEMBIC = "{{ cookiecutter.include_alembic }}" == "yes"
+INCLUDE_DOCKER = "{{ cookiecutter.include_docker }}" == "yes"
+CACHE = "{{ cookiecutter.cache }}"
+BUCKET = "{{ cookiecutter.bucket }}"
+
+PROJECT_DIR = Path(os.getcwd())
+
+
+def rm(path: str) -> None:
+    p = PROJECT_DIR / path
+    if p.is_dir():
+        shutil.rmtree(p, ignore_errors=True)
+    elif p.exists():
+        p.unlink()
+
+
+# 1. Beanie projects don't use alembic
+if ORM == "beanie" or not INCLUDE_ALEMBIC:
+    rm("alembic")
+    rm("alembic.ini")
+
+# 2. Docker is opt-out
+if not INCLUDE_DOCKER:
+    rm("docker-compose.yml")
+    rm("Dockerfile")
+
+# 3. Print next steps
+print(
+    f"\n✓ Project scaffolded at {PROJECT_DIR}\n"
+    f"  ORM      : {ORM}\n"
+    f"  Database : {DB}\n"
+    f"  Cache    : {CACHE}\n"
+    f"  Bucket   : {BUCKET}\n"
+    f"  Alembic  : {'yes' if INCLUDE_ALEMBIC and ORM != 'beanie' else 'no'}\n"
+    f"  Docker   : {'yes' if INCLUDE_DOCKER else 'no'}\n"
+    f"\nNext steps:\n"
+    f"  cd {PROJECT_DIR.name}\n"
+    f"  cp .env.example .env       # edit values\n"
+    + ("  make up                    # start containers\n" if INCLUDE_DOCKER else "  pip install -r requirements.txt\n  uvicorn app.main:app --reload\n")
+    + (f"  make migrate-create        # generate baseline alembic\n  make migrate-up\n" if ORM != 'beanie' and INCLUDE_ALEMBIC else "")
+    + f"  make seed                  # seed admin user\n"
+    f"\nVisit http://localhost:8000/docs\n"
+)

fastapi_basekit-0.3.0/fastapi_basekit/templates/project/hooks/pre_gen_project.py

@@ -0,0 +1,32 @@
+"""Validate cookiecutter inputs before scaffolding."""
+
+import re
+import sys
+
+slug = "{{ cookiecutter.project_slug }}"
+orm = "{{ cookiecutter.orm }}"
+db = "{{ cookiecutter.database }}"
+
+# 1. Slug must be a valid Python identifier
+if not re.match(r"^[a-z][a-z0-9_]*$", slug):
+    print(
+        f"ERROR: project_slug '{slug}' is invalid. "
+        "Must start with a lowercase letter and contain only [a-z0-9_].",
+        file=sys.stderr,
+    )
+    sys.exit(1)
+
+# 2. ORM ↔ database compatibility
+if orm == "beanie" and db != "mongodb":
+    print(
+        f"ERROR: orm=beanie requires database=mongodb (got '{db}').",
+        file=sys.stderr,
+    )
+    sys.exit(1)
+
+if orm in ("sqlalchemy", "sqlmodel") and db == "mongodb":
+    print(
+        f"ERROR: orm={orm} requires a SQL database (postgres/mariadb/sqlite), got '{db}'.",
+        file=sys.stderr,
+    )
+    sys.exit(1)

fastapi_basekit-0.3.0/fastapi_basekit/templates/project/{{cookiecutter.project_slug}}/.env.example

@@ -0,0 +1,40 @@
+PROJECT_NAME={{ cookiecutter.project_name }}
+VERSION=0.1.0
+DEBUG=true
+ENVIRONMENT=local
+
+SECRET_KEY=change-me-in-production
+JWT_SECRET=change-me-in-production
+JWT_ALGORITHM=HS256
+JWT_EXPIRE_SECONDS=3600
+ACCESS_TOKEN_EXPIRE_MINUTES=60
+REFRESH_TOKEN_EXPIRE_DAYS=7
+
+{% if cookiecutter.orm == "beanie" -%}
+DATABASE_URL=mongodb://root:secret@db:27017
+DATABASE_NAME={{ cookiecutter.package_name }}
+{%- elif cookiecutter.database == "postgres" -%}
+DATABASE_URL=postgresql+asyncpg://{{ cookiecutter.package_name }}:secret@db:5432/{{ cookiecutter.package_name }}
+{%- elif cookiecutter.database == "mariadb" -%}
+DATABASE_URL=mysql+aiomysql://{{ cookiecutter.package_name }}:secret@db:3306/{{ cookiecutter.package_name }}
+{%- elif cookiecutter.database == "sqlite" -%}
+DATABASE_URL=sqlite+aiosqlite:///./{{ cookiecutter.package_name }}.db
+{%- endif %}
+
+{% if cookiecutter.cache == "redis" -%}
+REDIS_HOST=redis
+REDIS_PORT=6379
+REDIS_DB=0
+REDIS_PASSWORD=
+{%- endif %}
+
+{% if cookiecutter.bucket == "s3" -%}
+AWS_ACCESS_KEY_ID=
+AWS_SECRET_ACCESS_KEY=
+AWS_REGION_NAME=us-east-1
+AWS_S3_BUCKET_NAME=
+{%- endif %}
+
+ADMIN_EMAIL=admin@example.com
+ADMIN_PASSWORD=ChangeMe2026!
+ADMIN_NAME=Platform Admin

fastapi_basekit-0.3.0/fastapi_basekit/templates/project/{{cookiecutter.project_slug}}/.gitignore

@@ -0,0 +1,12 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+.venv/
+venv/
+.env
+.coverage
+htmlcov/
+.pytest_cache/
+.mypy_cache/
+*.sqlite3
+uploads/

fastapi_basekit-0.3.0/fastapi_basekit/templates/project/{{cookiecutter.project_slug}}/Dockerfile

@@ -0,0 +1,18 @@
+FROM python:{{ cookiecutter.python_version }}-slim
+
+WORKDIR /app
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    build-essential \
+    && rm -rf /var/lib/apt/lists/*
+
+COPY requirements.txt .
+RUN pip install --no-cache-dir -r requirements.txt
+
+COPY . .
+
+{% if cookiecutter.server == "gunicorn" -%}
+CMD ["gunicorn", "app.main:app", "-k", "uvicorn.workers.UvicornWorker", "-b", "0.0.0.0:8000", "--workers", "4"]
+{%- else -%}
+CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "8000"]
+{%- endif %}

fastapi_basekit-0.3.0/fastapi_basekit/templates/project/{{cookiecutter.project_slug}}/LICENSE

@@ -0,0 +1,61 @@
+{% if cookiecutter.license == "MIT" -%}
+MIT License
+
+Copyright (c) {{ cookiecutter.author_name }}
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+{%- elif cookiecutter.license == "Apache-2.0" -%}
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   Copyright {{ cookiecutter.author_name }}
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+
+   Full license text: https://www.apache.org/licenses/LICENSE-2.0.txt
+{%- elif cookiecutter.license == "GPL-3.0" -%}
+                    GNU GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+ Copyright (C) {{ cookiecutter.author_name }}
+
+ This program is free software: you can redistribute it and/or modify
+ it under the terms of the GNU General Public License as published by
+ the Free Software Foundation, either version 3 of the License, or
+ (at your option) any later version.
+
+ Full license text: https://www.gnu.org/licenses/gpl-3.0.txt
+{%- elif cookiecutter.license == "Proprietary" -%}
+Copyright (c) {{ cookiecutter.author_name }}
+
+All rights reserved. Unauthorized copying, distribution, modification, or use
+of this software, in whole or in part, is strictly prohibited without prior
+written permission from the copyright holder.
+{%- endif %}

fastapi_basekit-0.3.0/fastapi_basekit/templates/project/{{cookiecutter.project_slug}}/Makefile

@@ -0,0 +1,46 @@
+DOCKER_COMPOSE = docker compose -p {{ cookiecutter.package_name }}
+
+.PHONY: help format lint up up-d down logs ps {% if cookiecutter.orm != "beanie" and cookiecutter.include_alembic == "yes" %}migrate-create migrate-up migrate-down{% endif %} seed test
+
+help:
+	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | sort | awk 'BEGIN {FS = ":.*?## "}; {printf "  \033[36m%-20s\033[0m %s\n", $$1, $$2}'
+
+format: ## black + isort
+	black --line-length 100 --exclude "alembic|venv" .
+	isort --skip alembic --skip venv .
+
+lint: ## flake8
+	flake8 --exclude alembic,venv --max-line-length 100 app
+
+up: ## Start containers (build + tail)
+	$(DOCKER_COMPOSE) up --build
+
+up-d: ## Start containers detached
+	$(DOCKER_COMPOSE) up --build -d
+
+down: ## Stop + remove containers
+	$(DOCKER_COMPOSE) down
+
+logs: ## Tail container logs
+	$(DOCKER_COMPOSE) logs -f
+
+ps: ## Show containers
+	$(DOCKER_COMPOSE) ps
+
+{% if cookiecutter.orm != "beanie" and cookiecutter.include_alembic == "yes" %}
+migrate-create: ## New autogenerated migration (asks message)
+	@read -p "Migration message: " msg; \
+	$(DOCKER_COMPOSE) exec api alembic revision --autogenerate -m "$$msg"
+
+migrate-up: ## Apply pending migrations
+	$(DOCKER_COMPOSE) exec api alembic upgrade head
+
+migrate-down: ## Rollback last
+	$(DOCKER_COMPOSE) exec api alembic downgrade -1
+{% endif %}
+
+seed: ## Run init seeders
+	$(DOCKER_COMPOSE) exec api python3 -m app.scripts.init
+
+test: ## Run tests
+	$(DOCKER_COMPOSE) exec api pytest

fastapi_basekit-0.3.0/fastapi_basekit/templates/project/{{cookiecutter.project_slug}}/README.md

@@ -0,0 +1,41 @@
+# {{ cookiecutter.project_name }}
+
+{{ cookiecutter.description }}
+
+Built with [fastapi-basekit](https://github.com/mundobien2025/fastapi-basekit) — async CBV pattern, repositories + services + controllers, JWT middleware, soft delete.
+
+## Stack
+
+- **Python** {{ cookiecutter.python_version }}
+- **ORM** {{ cookiecutter.orm }}
+- **Database** {{ cookiecutter.database }}
+- **Server** {{ cookiecutter.server }}
+{% if cookiecutter.cache == "redis" %}- **Cache** Redis{% endif %}
+{% if cookiecutter.background_tasks == "arq" %}- **Background tasks** ARQ{% endif %}
+{% if cookiecutter.bucket == "s3" %}- **Object storage** S3{% endif %}
+{% if cookiecutter.include_alembic == "yes" and cookiecutter.orm != "beanie" %}- **Migrations** Alembic{% endif %}
+
+## Quickstart
+
+```bash
+cp .env.example .env
+{% if cookiecutter.include_docker == "yes" %}make up-d
+{% if cookiecutter.orm != "beanie" and cookiecutter.include_alembic == "yes" %}make migrate-create   # answer: baseline
+make migrate-up
+{% endif %}make seed
+{% else %}pip install -r requirements.txt
+uvicorn app.main:app --reload
+{% endif %}```
+
+Open http://localhost:8000/docs
+
+## Default admin
+
+```
+{{ "${ADMIN_EMAIL}" }}   (default: admin@example.com)
+{{ "${ADMIN_PASSWORD}" }} (default: ChangeMe2026!)
+```
+
+## License
+
+{{ cookiecutter.license }}