racerapi 0.0.3__tar.gz

racerapi-0.0.3/LICENSE.md

@@ -0,0 +1,25 @@
+MIT License
+
+Copyright (c) 2025 Prathamesh More
+
+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:
+
+1. The above copyright notice and this permission notice shall be included
+   in all copies or substantial portions of the Software.
+
+2. **This package 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.**
+
+3. **This software is open-source and developed in India by Prathamesh More. It is highly useful for building stable backend systems with FastAPI, but please use at your own discretion.**
+
+4. **If you use this package, please mention it in your project or application as a courtesy to acknowledge the contribution.**

racerapi-0.0.3/MANIFEST.in

@@ -0,0 +1,3 @@
+include README.md
+include LICENSE
+recursive-include RacerAPI *

racerapi-0.0.3/PKG-INFO

@@ -0,0 +1,69 @@
+Metadata-Version: 2.4
+Name: racerapi
+Version: 0.0.3
+Summary: RacerAPI - Opinionated Backend Framework on Top of FastAPI
+Home-page: https://github.com/23bg/racerapi
+Author: Prathamesh More
+Author-email: "Mr. Prathamesh More" <iamprathamshmore07@gmail.com>
+License: MIT
+Classifier: Development Status :: 3 - Alpha
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Intended Audience :: Developers
+Classifier: Framework :: FastAPI
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE.md
+Requires-Dist: fastapi>=0.115
+Requires-Dist: uvicorn[standard]>=0.30
+Requires-Dist: typer[all]>=0.9
+Requires-Dist: python-dotenv>=1.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+Requires-Dist: black>=24.0; extra == "dev"
+Requires-Dist: ruff>=0.4.0; extra == "dev"
+Requires-Dist: mypy>=1.9.0; extra == "dev"
+Requires-Dist: pre-commit>=3.7.0; extra == "dev"
+Dynamic: license-file
+
+# ⚡ RacerAPI
+
+A modern, opinionated, and production-ready **Python-based backend framework** built on top of [FastAPI](https://fastapi.tiangolo.com/). RacerAPI provides a clean architecture, essential folder structure, and a CLI tool to bootstrap and scale backend services with ease.
+
+---
+
+## 🚀 Why RacerAPI?
+
+RacerAPI is created for developers and teams who need:
+
+- ✅ **Stability** – Built on proven Python standards and FastAPI.
+- ✅ **Maintainability** – Enforced structure keeps large codebases organized.
+- ✅ **CLI Productivity** – Scaffold projects quickly with the built-in CLI.
+- ✅ **Scalability** – Easily extend to microservices and modular architecture.
+- ✅ **Speed** – FastAPI is one of the fastest Python web frameworks.
+
+---
+
+## 🧰 Features
+
+- 📁 Predefined scalable project folder structure
+- ⚙️ Built-in CLI for generating projects
+- 🧪 Testing support with `pytest`
+- 🪶 Lightweight and flexible by default
+- 🔐 Ready for integrations (JWT, OAuth, DB, etc.)
+- 📦 Easily extendable with plugins and code generators
+
+---
+
+## 📦 Install (Local Development)
+
+Clone the repo and install in editable mode:
+
+```bash
+git clone https://github.com/23bg/RacerAPI.git
+cd RacerAPI
+pip install -e .

racerapi-0.0.3/README.md

@@ -0,0 +1,37 @@
+# ⚡ RacerAPI
+
+A modern, opinionated, and production-ready **Python-based backend framework** built on top of [FastAPI](https://fastapi.tiangolo.com/). RacerAPI provides a clean architecture, essential folder structure, and a CLI tool to bootstrap and scale backend services with ease.
+
+---
+
+## 🚀 Why RacerAPI?
+
+RacerAPI is created for developers and teams who need:
+
+- ✅ **Stability** – Built on proven Python standards and FastAPI.
+- ✅ **Maintainability** – Enforced structure keeps large codebases organized.
+- ✅ **CLI Productivity** – Scaffold projects quickly with the built-in CLI.
+- ✅ **Scalability** – Easily extend to microservices and modular architecture.
+- ✅ **Speed** – FastAPI is one of the fastest Python web frameworks.
+
+---
+
+## 🧰 Features
+
+- 📁 Predefined scalable project folder structure
+- ⚙️ Built-in CLI for generating projects
+- 🧪 Testing support with `pytest`
+- 🪶 Lightweight and flexible by default
+- 🔐 Ready for integrations (JWT, OAuth, DB, etc.)
+- 📦 Easily extendable with plugins and code generators
+
+---
+
+## 📦 Install (Local Development)
+
+Clone the repo and install in editable mode:
+
+```bash
+git clone https://github.com/23bg/RacerAPI.git
+cd RacerAPI
+pip install -e .

racerapi-0.0.3/pyproject.toml

@@ -0,0 +1,72 @@
+[build-system]
+requires = ["setuptools>=69", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "racerapi"
+version = "0.0.3"
+description = "RacerAPI - Opinionated Backend Framework on Top of FastAPI"
+readme = "README.md"
+requires-python = ">=3.8"
+license = { text = "MIT" }
+
+authors = [
+  { name = "Mr. Prathamesh More", email = "iamprathamshmore07@gmail.com" },
+]
+
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.8",
+  "License :: OSI Approved :: MIT License",
+  "Operating System :: OS Independent",
+  "Intended Audience :: Developers",
+  "Framework :: FastAPI",
+  "Topic :: Software Development :: Libraries :: Application Frameworks",
+]
+
+# ====== RUNTIME DEPENDENCIES ======
+dependencies = [
+  "fastapi>=0.115",
+  "uvicorn[standard]>=0.30",
+  "typer[all]>=0.9",
+  "python-dotenv>=1.0.0",
+]
+
+# ====== OPTIONAL DEV DEPENDENCIES ======
+[project.optional-dependencies]
+dev = [
+  "pytest>=8.0",
+  "pytest-cov>=4.0",
+  "black>=24.0",
+  "ruff>=0.4.0",
+  "mypy>=1.9.0",
+  "pre-commit>=3.7.0",
+]
+
+# ====== CLI ENTRYPOINT ======
+[project.scripts]
+RacerAPI = "racerapi_cli.__main__:main"
+
+# ====== PACKAGE DISCOVERY ======
+[tool.setuptools.packages.find]
+where = ["src"]
+
+# ====== INCLUDE TEMPLATE FILES IN WHEELS ======
+[tool.setuptools.package-data]
+RacerAPI_cli = ["templates/**/*"]
+
+# ====== FORMATTERS AND LINTING (OPTIONAL BUT RECOMMENDED) ======
+[tool.black]
+line-length = 88
+target-version = ["py38"]
+
+[tool.ruff]
+line-length = 88
+select = ["E", "F", "I"]
+ignore = ["E501"]
+
+[tool.mypy]
+python_version = "3.8"
+ignore_missing_imports = true
+strict = false

racerapi-0.0.3/setup.cfg

@@ -0,0 +1,35 @@
+[metadata]
+name = RacerAPI
+version = 0.0.3
+description = A Python-based backend framework built on FastAPI.
+long_description = file: README.md
+long_description_content_type = text/markdown
+author = Prathamesh More
+author_email = iamprathameshmore07@gmail.com
+url = https://github.com/23bg/racerapi
+license = MIT
+classifiers = 
+	Programming Language :: Python :: 3
+	Programming Language :: Python :: 3.8
+	License :: OSI Approved :: MIT License
+	Operating System :: OS Independent
+	Intended Audience :: Developers
+	Topic :: Software Development :: Libraries :: Python Modules
+	Framework :: FastAPI
+
+[options]
+packages = find:
+python_requires = >=3.8
+install_requires = 
+	typer[all]
+	fastapi
+	pytest
+
+[options.entry_points]
+console_scripts = 
+	myfastapi = racerapi.cli:app
+
+[egg_info]
+tag_build = 
+tag_date = 0
+

racerapi-0.0.3/src/racerapi/version.py

@@ -0,0 +1 @@
+__version__ = "0.0.3"

racerapi-0.0.3/src/racerapi.egg-info/PKG-INFO

@@ -0,0 +1,69 @@
+Metadata-Version: 2.4
+Name: racerapi
+Version: 0.0.3
+Summary: RacerAPI - Opinionated Backend Framework on Top of FastAPI
+Home-page: https://github.com/23bg/racerapi
+Author: Prathamesh More
+Author-email: "Mr. Prathamesh More" <iamprathamshmore07@gmail.com>
+License: MIT
+Classifier: Development Status :: 3 - Alpha
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Intended Audience :: Developers
+Classifier: Framework :: FastAPI
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE.md
+Requires-Dist: fastapi>=0.115
+Requires-Dist: uvicorn[standard]>=0.30
+Requires-Dist: typer[all]>=0.9
+Requires-Dist: python-dotenv>=1.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+Requires-Dist: black>=24.0; extra == "dev"
+Requires-Dist: ruff>=0.4.0; extra == "dev"
+Requires-Dist: mypy>=1.9.0; extra == "dev"
+Requires-Dist: pre-commit>=3.7.0; extra == "dev"
+Dynamic: license-file
+
+# ⚡ RacerAPI
+
+A modern, opinionated, and production-ready **Python-based backend framework** built on top of [FastAPI](https://fastapi.tiangolo.com/). RacerAPI provides a clean architecture, essential folder structure, and a CLI tool to bootstrap and scale backend services with ease.
+
+---
+
+## 🚀 Why RacerAPI?
+
+RacerAPI is created for developers and teams who need:
+
+- ✅ **Stability** – Built on proven Python standards and FastAPI.
+- ✅ **Maintainability** – Enforced structure keeps large codebases organized.
+- ✅ **CLI Productivity** – Scaffold projects quickly with the built-in CLI.
+- ✅ **Scalability** – Easily extend to microservices and modular architecture.
+- ✅ **Speed** – FastAPI is one of the fastest Python web frameworks.
+
+---
+
+## 🧰 Features
+
+- 📁 Predefined scalable project folder structure
+- ⚙️ Built-in CLI for generating projects
+- 🧪 Testing support with `pytest`
+- 🪶 Lightweight and flexible by default
+- 🔐 Ready for integrations (JWT, OAuth, DB, etc.)
+- 📦 Easily extendable with plugins and code generators
+
+---
+
+## 📦 Install (Local Development)
+
+Clone the repo and install in editable mode:
+
+```bash
+git clone https://github.com/23bg/RacerAPI.git
+cd RacerAPI
+pip install -e .

racerapi-0.0.3/src/racerapi.egg-info/SOURCES.txt

@@ -0,0 +1,33 @@
+LICENSE.md
+MANIFEST.in
+README.md
+pyproject.toml
+setup.cfg
+src/racerapi/__init__.py
+src/racerapi/version.py
+src/racerapi.egg-info/PKG-INFO
+src/racerapi.egg-info/SOURCES.txt
+src/racerapi.egg-info/dependency_links.txt
+src/racerapi.egg-info/entry_points.txt
+src/racerapi.egg-info/requires.txt
+src/racerapi.egg-info/top_level.txt
+src/racerapi_cli/__init__.py
+src/racerapi_cli/__main__.py
+src/racerapi_cli/templates/project/main.py
+src/racerapi_cli/templates/project/app/__init__.py
+src/racerapi_cli/templates/project/app/common/exceptions.py
+src/racerapi_cli/templates/project/app/common/response.py
+src/racerapi_cli/templates/project/app/core/app_factory.py
+src/racerapi_cli/templates/project/app/core/config.py
+src/racerapi_cli/templates/project/app/core/logging.py
+src/racerapi_cli/templates/project/app/modules/__init__.py
+src/racerapi_cli/templates/project/app/modules/system/api/http.py
+src/racerapi_cli/templates/project/app/modules/system/data/system_repository.py
+src/racerapi_cli/templates/project/app/modules/system/domain/app_info.py
+src/racerapi_cli/templates/project/app/modules/system/services/system_service.py
+src/racerapi_cli/templates/project/tests/test_e2e.py
+src/racerapi_cli/templates/project/tests/system/test_health.py
+src/racerapi_cli/templates/resource/controllers.py
+src/racerapi_cli/templates/resource/routes.py
+src/racerapi_cli/templates/resource/schemas.py
+src/racerapi_cli/templates/resource/services.py

racerapi-0.0.3/src/racerapi.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

racerapi-0.0.3/src/racerapi.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+RacerAPI = racerapi_cli.__main__:main

racerapi-0.0.3/src/racerapi.egg-info/requires.txt

@@ -0,0 +1,12 @@
+fastapi>=0.115
+uvicorn[standard]>=0.30
+typer[all]>=0.9
+python-dotenv>=1.0.0
+
+[dev]
+pytest>=8.0
+pytest-cov>=4.0
+black>=24.0
+ruff>=0.4.0
+mypy>=1.9.0
+pre-commit>=3.7.0

racerapi-0.0.3/src/racerapi.egg-info/top_level.txt

@@ -0,0 +1,2 @@
+racerapi
+racerapi_cli

racerapi-0.0.3/src/racerapi_cli/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.0.3"

racerapi-0.0.3/src/racerapi_cli/__main__.py

@@ -0,0 +1,101 @@
+from pathlib import Path
+import subprocess
+import typer
+
+app = typer.Typer(help="RacerAPI CLI - FastAPI project generator")
+
+BASE_DIR = Path(__file__).parent
+TEMPLATES_DIR = BASE_DIR / "templates"
+PROJECT_TEMPLATE_DIR = TEMPLATES_DIR / "project"
+RESOURCE_TEMPLATE_DIR = TEMPLATES_DIR / "resource"
+
+
+def copy_tree(src: Path, dest: Path, context: dict):
+    for path in src.rglob("*"):
+        rel = path.relative_to(src)
+        target = dest / rel
+
+        if path.is_dir():
+            target.mkdir(parents=True, exist_ok=True)
+            continue
+
+        content = path.read_text()
+        for key, value in context.items():
+            content = content.replace(f"{{{{ {key} }}}}", value)
+
+        target.parent.mkdir(parents=True, exist_ok=True)
+        target.write_text(content)
+
+
+@app.command()
+def new(name: str):
+    project_root = Path(name)
+
+    if project_root.exists():
+        typer.echo(f"Directory '{name}' already exists.")
+        raise typer.Exit(1)
+
+    if not PROJECT_TEMPLATE_DIR.exists():
+        typer.echo(
+            f"[ERROR] Project template directory not found: {PROJECT_TEMPLATE_DIR}"
+        )
+        raise typer.Exit(1)
+
+    typer.echo(f"Creating RacerAPI project in '{name}'...")
+    copy_tree(
+        PROJECT_TEMPLATE_DIR,
+        project_root,
+        {
+            "project_name": name,
+            "project_slug": name.replace("-", "_"),
+        },
+    )
+    typer.echo("✅ RacerAPI project created")
+    typer.echo(f"👉 cd {name}")
+    typer.echo("👉 RacerAPI dev")
+
+
+@app.command()
+def generate(kind: str, name: str):
+    kind = kind.lower()
+    name = name.lower()
+
+    if kind != "resource":
+        typer.echo("Only 'resource' generator is supported for now.")
+        raise typer.Exit(1)
+
+    if not RESOURCE_TEMPLATE_DIR.exists():
+        typer.echo(
+            f"[ERROR] Resource template directory not found: {RESOURCE_TEMPLATE_DIR}"
+        )
+        raise typer.Exit(1)
+
+    module_path = Path("app/modules") / name
+
+    if module_path.exists():
+        typer.echo(f"Module '{name}' already exists.")
+        raise typer.Exit(1)
+
+    typer.echo(f"Generating resource '{name}'...")
+    copy_tree(
+        RESOURCE_TEMPLATE_DIR,
+        module_path,
+        {
+            "resource_name": name,
+            "class_name": name.capitalize(),
+        },
+    )
+    typer.echo("✅ Resource generated")
+
+
+@app.command()
+def dev():
+    subprocess.run(["uvicorn", "main:app", "--reload"])
+
+
+def main():
+    app()
+
+
+if __name__ == "__main__":
+    main()

racerapi-0.0.3/src/racerapi_cli/templates/project/app/core/app_factory.py

@@ -0,0 +1,10 @@
+from fastapi import FastAPI
+
+
+def create_app() -> FastAPI:
+    app = FastAPI(
+        title="{{ project_name }}",
+        version="0.0.3",
+    )
+
+    return app

racerapi-0.0.3/src/racerapi_cli/templates/project/app/core/config.py

@@ -0,0 +1,16 @@
+import os
+from dotenv import load_dotenv
+
+load_dotenv()
+
+
+class Settings:
+    APP_NAME: str = os.getenv("APP_NAME", "RacerAPI")
+    APP_ENV: str = os.getenv("APP_ENV", "development")
+    APP_DEBUG: bool = os.getenv("APP_DEBUG", "true") == "true"
+
+    DATABASE_URL: str = os.getenv("DATABASE_URL", "sqlite:///./dev.db")
+    SECRET_KEY: str = os.getenv("SECRET_KEY", "secret")
+
+
+settings = Settings()

racerapi-0.0.3/src/racerapi_cli/templates/project/app/modules/system/api/http.py

@@ -0,0 +1,13 @@
+from fastapi import APIRouter
+from app.modules.system.services.system_service import SystemService
+
+router = APIRouter(tags=["System"])
+service = SystemService()
+
+@router.get("/health")
+def health():
+    return service.health()
+
+@router.get("/version")
+def version():
+    return service.version()

racerapi-0.0.3/src/racerapi_cli/templates/project/app/modules/system/data/system_repository.py

@@ -0,0 +1,7 @@
+
+
+class SystemRepository:
+    def health(self):
+        pass
+
+    

racerapi-0.0.3/src/racerapi_cli/templates/project/app/modules/system/domain/app_info.py

@@ -0,0 +1,4 @@
+class AppInfo:
+    def __init__(self):
+        self.name = "MyApp"
+        self.version = "0.0.3"

racerapi-0.0.3/src/racerapi_cli/templates/project/app/modules/system/services/system_service.py

@@ -0,0 +1,9 @@
+from app.modules.system.domain.app_info import AppInfo
+
+class SystemService:
+    def health(self):
+        return {"status": "ok"}
+
+    def version(self):
+        info = AppInfo()
+        return {"name": info.name, "version": info.version}

racerapi-0.0.3/src/racerapi_cli/templates/project/main.py

@@ -0,0 +1,4 @@
+from fastapi import FastAPI
+from app.core.app_factory import create_app
+
+app = create_app()

racerapi-0.0.3/src/racerapi_cli/templates/project/tests/system/test_health.py

@@ -0,0 +1,3 @@
+def test_health(client):
+    res = client.get("/health")
+    assert res.status_code == 200

racerapi-0.0.3/src/racerapi_cli/templates/resource/controllers.py

@@ -0,0 +1,14 @@
+
+from .services import {{ class_name }}Service
+from .schemas import {{ class_name }}Create, {{ class_name }}Out
+
+
+class {{ class_name }}Controller:
+    def __init__(self):
+        self.service = {{ class_name }}Service()
+
+    async def list(self) -> list[{{ class_name }}Out]:
+        return await self.service.list()
+
+    async def create(self, payload: {{ class_name }}Create):
+        return await self.service.create(payload)

racerapi-0.0.3/src/racerapi_cli/templates/resource/routes.py

@@ -0,0 +1,16 @@
+from fastapi import APIRouter
+from .controllers import {{ class_name }}Controller
+
+router = APIRouter(prefix="/{{ resource_name }}", tags=["{{ class_name }}"])
+
+controller = {{ class_name }}Controller()
+
+
+@router.get("/")
+async def list_items():
+    return await controller.list()
+
+
+@router.post("/")
+async def create_item(payload: dict):
+    return await controller.create(payload)

racerapi-0.0.3/src/racerapi_cli/templates/resource/schemas.py

@@ -0,0 +1,13 @@
+from pydantic import BaseModel
+
+
+class {{ class_name }}Base(BaseModel):
+    name: str
+
+
+class {{ class_name }}Create({{ class_name }}Base):
+    pass
+
+
+class {{ class_name }}Out({{ class_name }}Base):
+    id: int

racerapi-0.0.3/src/racerapi_cli/templates/resource/services.py

@@ -0,0 +1,6 @@
+class {{ class_name }}Service:
+    async def list(self):
+        return []
+
+    async def create(self, payload):
+        return payload