fastapi-gen 0.9.3.dev4__tar.gz → 0.11.0__tar.gz

{fastapi_gen-0.9.3.dev4 → fastapi_gen-0.11.0}/.gitignore

@@ -162,7 +162,7 @@ cython_debug/
 .ruff_cache
 .DS_Store
 
-src/templates/**/.pytest_cache
-src/templates/**/__pycache__
-src/templates/**/venv
-src/templates/advanced/app.db
+# packages/template*/.pytest_cache
+# packages/template*/__pycache__
+# packages/template*/venv
+# packages/template-advanced/app.db

{fastapi_gen-0.9.3.dev4 → fastapi_gen-0.11.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fastapi-gen
-Version: 0.9.3.dev4
+Version: 0.11.0
 Summary: Set up a modern REST API by running one command.
 Project-URL: Documentation, https://github.com/mirpo/fastapi-gen#readme
 Project-URL: Issues, https://github.com/mirpo/fastapi-gen/issues
@@ -38,10 +38,6 @@ Requires-Python: >=3.11
 Requires-Dist: click==8.3.0
 Requires-Dist: colorama==0.4.6
 Requires-Dist: importlib-resources==6.5.2
-Provides-Extra: dev
-Requires-Dist: coverage[toml]==7.11.0; extra == 'dev'
-Requires-Dist: pytest==8.4.2; extra == 'dev'
-Requires-Dist: ruff==0.14.1; extra == 'dev'
 Description-Content-Type: text/markdown
 
 <div align="center">
@@ -77,19 +73,22 @@ Description-Content-Type: text/markdown
 Get a fully functional FastAPI app running in **30 seconds**:
 
 ```bash
-# Install
-pip install fastapi-gen
+# Recommended: using uvx (no installation needed)
+uvx fastapi-gen my_app
+cd my_app && make start
+```
 
-# Create your app
+**Or install with uv:**
+```bash
+uv tool install fastapi-gen
 fastapi-gen my_app
-
-# Run it
 cd my_app && make start
 ```
 
-**Or use pipx for one-time execution:**
+**Or use pip:**
 ```bash
-pipx run fastapi-gen my_app
+pip install fastapi-gen
+fastapi-gen my_app
 cd my_app && make start
 ```
 
@@ -99,13 +98,10 @@ cd my_app && make start
 
 ## Why FastAPI Gen?
 
-<div align="center">
-
-| **Focus on Code** | **Production Ready** | **Testing Included** | **Zero Config** |
-|:---:|:---:|:---:|:---:|
-| Skip boilerplate setup | Enterprise patterns | Real test coverage | Ready-to-run templates |
-
-</div>
+**Focus on Code** - Skip boilerplate setup and start building
+**Production Ready** - Enterprise patterns and best practices built-in
+**Testing Included** - Real test coverage from day one
+**Zero Config** - Ready-to-run templates that just work
 
 ---
 
@@ -117,16 +113,14 @@ cd my_app && make start
 **Best for:** Learning FastAPI fundamentals and starting new projects
 
 **Key Features:**
-- **REST API Fundamentals** - Complete CRUD with validation
-- **Configuration Management** - Both pydantic-settings & dotenv
-- **Dependency Injection** - Clean architecture with `Depends()`
-- **Background Tasks** - Async processing with logging
-- **Exception Handling** - Professional error responses
-- **Input Validation** - Advanced Pydantic constraints
-- **Health Monitoring** - Built-in health endpoints
-- **Complete Tests** - 100% test coverage
+- REST API fundamentals with complete CRUD
+- Configuration management (pydantic-settings & dotenv)
+- Dependency injection and clean architecture
+- Background tasks and exception handling
+- Input validation and health monitoring
+- Complete test coverage
 
-[📖 View Details →](src/templates/hello_world/README.md)
+[View Details →](packages/template-hello-world/README.md)
 
 </details>
 
@@ -136,16 +130,14 @@ cd my_app && make start
 **Best for:** Production applications with enterprise features
 
 **Key Features:**
-- **JWT Authentication** - Registration, login, protected routes
-- **Database Integration** - SQLAlchemy 2.0 async (SQLite/PostgreSQL)
-- **Rate Limiting** - DDoS protection per endpoint
-- **Caching System** - In-memory + Redis integration ready
-- **WebSocket Support** - Real-time communication
-- **File Upload** - Secure handling + cloud storage ready
-- **Enhanced Security** - CORS, validation, production patterns
-- **Full Test Suite** - Auth, CRUD, WebSocket, integration
+- JWT authentication with registration and login
+- Database integration with SQLAlchemy 2.0 async
+- Rate limiting and caching system
+- WebSocket support and file upload
+- Enhanced security and CORS configuration
+- Full test suite
 
-[📖 View Details →](src/templates/advanced/README.md)
+[View Details →](packages/template-advanced/README.md)
 
 </details>
 
@@ -155,14 +147,13 @@ cd my_app && make start
 **Best for:** AI applications with natural language processing
 
 **Key Features:**
-- **8 NLP Capabilities** - Summarization, NER, generation, QA, embeddings, sentiment, classification, similarity
-- **Production Architecture** - Startup model loading, device auto-detection
-- **Smart Configuration** - Environment-based config, multiple models
-- **Performance Optimized** - Model caching, concurrent handling, hardware acceleration
-- **Production Monitoring** - Health checks, model status, logging
-- **Real AI Testing** - Actual model inference validation
+- 8 NLP capabilities: summarization, NER, generation, QA, embeddings, sentiment, classification, similarity
+- Production architecture with startup model loading
+- Smart configuration and device auto-detection
+- Performance optimized with model caching
+- Real AI testing with actual inference
 
-[📖 View Details →](src/templates/nlp/README.md)
+[View Details →](packages/template-nlp/README.md)
 
 </details>
 
@@ -172,14 +163,13 @@ cd my_app && make start
 **Best for:** Applications using LangChain for LLM workflows
 
 **Key Features:**
-- **Optimized Loading** - Startup caching, memory management
-- **Modern Patterns** - Latest LangChain best practices
-- **Smart Config** - Auto device detection (CPU/GPU)
-- **Production Ready** - Health checks, monitoring, error handling
-- **Real Testing** - Actual model inference tests
-- **Dual Endpoints** - Text generation & question answering
+- Optimized loading with startup caching
+- Modern LangChain patterns and best practices
+- Smart config with auto device detection
+- Production ready with health checks
+- Dual endpoints: text generation and question answering
 
-[📖 View Details →](src/templates/langchain/README.md)
+[View Details →](packages/template-langchain/README.md)
 
 </details>
 
@@ -189,16 +179,15 @@ cd my_app && make start
 **Best for:** Local LLM inference with llama-cpp-python
 
 **Key Features:**
-- **Local LLM Focus** - Optimized for Gemma/Llama GGUF models
-- **GPU Acceleration** - Auto GPU detection, configurable layers
-- **Advanced Config** - Context windows, threading, performance tuning
-- **Production Ready** - Lifecycle management, health monitoring
-- **Real Testing** - Actual model inference validation
-- **Easy Setup** - Auto model download, optimized defaults
+- Local LLM focus optimized for Gemma/Llama GGUF models
+- GPU acceleration with auto detection
+- Advanced config for context windows and threading
+- Production ready with lifecycle management
+- Easy setup with auto model download
 
 > **Requirements:** ~4GB model download + 4GB+ RAM
 
-[📖 View Details →](src/templates/llama/README.md)
+[View Details →](packages/template-llama/README.md)
 
 </details>
 
@@ -206,13 +195,13 @@ cd my_app && make start
 
 ## Template Comparison
 
-| Template | Best For | Complexity | AI/ML | Database | Auth |
-|----------|----------|------------|--------|----------|------|
-| **Hello World** | Learning, Simple APIs | ⭐ | ❌ | ❌ | ❌ |
-| **Advanced** | Production Apps | ⭐⭐⭐ | ❌ | ✅ | ✅ |
-| **NLP** | AI Text Processing | ⭐⭐⭐⭐ | ✅ | ❌ | ❌ |
-| **LangChain** | LLM Workflows | ⭐⭐⭐⭐ | ✅ | ❌ | ❌ |
-| **Llama** | Local LLM | ⭐⭐⭐⭐⭐ | ✅ | ❌ | ❌ |
+| Template        | Best For              | Complexity | AI/ML | Database | Auth |
+| --------------- | --------------------- | ---------- | ----- | -------- | ---- |
+| **Hello World** | Learning, Simple APIs | Basic      | No    | No       | No   |
+| **Advanced**    | Production Apps       | Medium     | No    | Yes      | Yes  |
+| **NLP**         | AI Text Processing    | Advanced   | Yes   | No       | No   |
+| **LangChain**   | LLM Workflows         | Advanced   | Yes   | No       | No   |
+| **Llama**       | Local LLM             | Advanced   | Yes   | No       | No   |
 
 ## What You Get Out of the Box
 
@@ -227,66 +216,38 @@ cd my_app && make start
 All dependencies (FastAPI, Pydantic, Pytest, etc.) are preconfigured. Just create and run:
 
 ```bash
-fastapi-gen my_app    # Create
+fastapi-gen my_app   # Create
 cd my_app            # Enter  
 make start           # Run!
 ```
 
 **Every Template Includes:**
-- **Ready-to-run** development environment
-- **Industry-standard** project structure
-- **Comprehensive** test suites with examples
-- **Ruff** linting and formatting
-- **Auto-generated** OpenAPI documentation
-- **Makefile** with common development commands
-
-## Creating an App
-
-**You'll need to have Python 3.12+ or later version on your local development machine**. We recommend using the latest LTS version. You can use [pyenv](https://github.com/pyenv/pyenv) (macOS/Linux) to switch Python versions between different projects.
-
-### Basic template
+- Ready-to-run development environment
+- Industry-standard project structure
+- Comprehensive test suites with examples
+- Ruff linting and formatting
+- Auto-generated OpenAPI documentation
+- Makefile with common development commands
 
-```console
-pip3 install fastapi-gen
-fastapi-gen my_app
-```
-
-or
-
-```console
-pip3 install fastapi-gen
-fastapi-gen my_app --template hello_world
-```
-
-### Advanced template
-
-```console
-pip3 install fastapi-gen
-fastapi-gen my_app --template advanced
-```
+## Installation & Usage
 
-### NLP template
+**You'll need to have Python 3.11+ or later version on your local development machine**. We recommend using the latest version. You can use [uv](https://docs.astral.sh/uv/) for Python version management and project workflows.
 
-```console
-pip install fastapi-gen
-fastapi-gen my_app --template nlp
-```
+### Choose Your Template
 
-### Langchain template
+```bash
+# Default (hello_world)
+uvx fastapi-gen my_app
 
-```console
-pip install fastapi-gen
-fastapi-gen my_app --template Langchain
+# Or specify a template
+uvx fastapi-gen my_app --template <template-name>
 ```
 
-### Llama template
+Available templates: `hello_world`, `advanced`, `nlp`, `langchain`, `llama`
 
-```console
-pip install fastapi-gen
-fastapi-gen my_app --template llama
-```
+### Built-in Commands
 
-Inside the newly created project, you can run some built-in commands:
+Inside the newly created project, you can run:
 
 ### `make start`
 

fastapi_gen-0.11.0/README.md

@@ -0,0 +1,224 @@
+<div align="center">
+  
+# FastAPI Gen
+
+**Create production-ready FastAPI applications in seconds**
+
+*From simple APIs to LLM-enabled applications, all without build configuration.*
+
+<p align="center">
+  <a href="https://github.com/mirpo/fastapi-gen/actions/workflows/test.yml?query=workflow%3Atest+event%3Apush+branch%main">
+    <img src="https://github.com/mirpo/fastapi-gen/actions/workflows/test.yml/badge.svg?branch=main" alt="Test Status">
+  </a>
+  <a href="https://pypi.org/project/fastapi-gen">
+    <img src="https://img.shields.io/pypi/v/fastapi-gen?color=%2334D058&label=pypi" alt="PyPI version">
+  </a>
+  <a href="https://pypi.org/project/fastapi-gen">
+    <img src="https://img.shields.io/pypi/pyversions/fastapi-gen.svg?color=%2334D058" alt="Python versions">
+  </a>
+  <a href="https://pypi.org/project/fastapi-gen">
+    <img src="https://img.shields.io/pypi/dm/fastapi-gen?color=blue" alt="Downloads">
+  </a>
+  <a href="https://github.com/mirpo/fastapi-gen/blob/main/LICENSE">
+    <img src="https://img.shields.io/badge/license-MIT-green" alt="License">
+  </a>
+</p>
+
+</div>
+
+## Quick Start
+
+Get a fully functional FastAPI app running in **30 seconds**:
+
+```bash
+# Recommended: using uvx (no installation needed)
+uvx fastapi-gen my_app
+cd my_app && make start
+```
+
+**Or install with uv:**
+```bash
+uv tool install fastapi-gen
+fastapi-gen my_app
+cd my_app && make start
+```
+
+**Or use pip:**
+```bash
+pip install fastapi-gen
+fastapi-gen my_app
+cd my_app && make start
+```
+
+**That's it!** Open [http://localhost:8000/docs](http://localhost:8000/docs) to see your OpenAPI documentation.
+
+> **Platform Support:** Works on macOS and Linux | [Report Issues](https://github.com/mirpo/fastapi-gen/issues/new)
+
+## Why FastAPI Gen?
+
+**Focus on Code** - Skip boilerplate setup and start building
+**Production Ready** - Enterprise patterns and best practices built-in
+**Testing Included** - Real test coverage from day one
+**Zero Config** - Ready-to-run templates that just work
+
+---
+
+## Templates Overview
+
+<details>
+<summary><strong>Hello World</strong> - Perfect for Learning FastAPI</summary>
+
+**Best for:** Learning FastAPI fundamentals and starting new projects
+
+**Key Features:**
+- REST API fundamentals with complete CRUD
+- Configuration management (pydantic-settings & dotenv)
+- Dependency injection and clean architecture
+- Background tasks and exception handling
+- Input validation and health monitoring
+- Complete test coverage
+
+[View Details →](packages/template-hello-world/README.md)
+
+</details>
+
+<details>
+<summary><strong>Advanced</strong> - Enterprise Production Template</summary>
+
+**Best for:** Production applications with enterprise features
+
+**Key Features:**
+- JWT authentication with registration and login
+- Database integration with SQLAlchemy 2.0 async
+- Rate limiting and caching system
+- WebSocket support and file upload
+- Enhanced security and CORS configuration
+- Full test suite
+
+[View Details →](packages/template-advanced/README.md)
+
+</details>
+
+<details>
+<summary><strong>NLP</strong> - Comprehensive AI Language Processing</summary>
+
+**Best for:** AI applications with natural language processing
+
+**Key Features:**
+- 8 NLP capabilities: summarization, NER, generation, QA, embeddings, sentiment, classification, similarity
+- Production architecture with startup model loading
+- Smart configuration and device auto-detection
+- Performance optimized with model caching
+- Real AI testing with actual inference
+
+[View Details →](packages/template-nlp/README.md)
+
+</details>
+
+<details>
+<summary><strong>LangChain</strong> - Modern LLM Integration</summary>
+
+**Best for:** Applications using LangChain for LLM workflows
+
+**Key Features:**
+- Optimized loading with startup caching
+- Modern LangChain patterns and best practices
+- Smart config with auto device detection
+- Production ready with health checks
+- Dual endpoints: text generation and question answering
+
+[View Details →](packages/template-langchain/README.md)
+
+</details>
+
+<details>
+<summary><strong>Llama</strong> - Local LLM Powerhouse</summary>
+
+**Best for:** Local LLM inference with llama-cpp-python
+
+**Key Features:**
+- Local LLM focus optimized for Gemma/Llama GGUF models
+- GPU acceleration with auto detection
+- Advanced config for context windows and threading
+- Production ready with lifecycle management
+- Easy setup with auto model download
+
+> **Requirements:** ~4GB model download + 4GB+ RAM
+
+[View Details →](packages/template-llama/README.md)
+
+</details>
+
+---
+
+## Template Comparison
+
+| Template        | Best For              | Complexity | AI/ML | Database | Auth |
+| --------------- | --------------------- | ---------- | ----- | -------- | ---- |
+| **Hello World** | Learning, Simple APIs | Basic      | No    | No       | No   |
+| **Advanced**    | Production Apps       | Medium     | No    | Yes      | Yes  |
+| **NLP**         | AI Text Processing    | Advanced   | Yes   | No       | No   |
+| **LangChain**   | LLM Workflows         | Advanced   | Yes   | No       | No   |
+| **Llama**       | Local LLM             | Advanced   | Yes   | No       | No   |
+
+## What You Get Out of the Box
+
+<div align="center">
+
+**Zero Configuration** • **Production Patterns** • **Complete Testing** • **Code Quality** • **Auto Documentation** • **Deployment Ready**
+
+</div>
+
+**Focus on Your Code, Not Setup**
+
+All dependencies (FastAPI, Pydantic, Pytest, etc.) are preconfigured. Just create and run:
+
+```bash
+fastapi-gen my_app   # Create
+cd my_app            # Enter  
+make start           # Run!
+```
+
+**Every Template Includes:**
+- Ready-to-run development environment
+- Industry-standard project structure
+- Comprehensive test suites with examples
+- Ruff linting and formatting
+- Auto-generated OpenAPI documentation
+- Makefile with common development commands
+
+## Installation & Usage
+
+**You'll need to have Python 3.11+ or later version on your local development machine**. We recommend using the latest version. You can use [uv](https://docs.astral.sh/uv/) for Python version management and project workflows.
+
+### Choose Your Template
+
+```bash
+# Default (hello_world)
+uvx fastapi-gen my_app
+
+# Or specify a template
+uvx fastapi-gen my_app --template <template-name>
+```
+
+Available templates: `hello_world`, `advanced`, `nlp`, `langchain`, `llama`
+
+### Built-in Commands
+
+Inside the newly created project, you can run:
+
+### `make start`
+
+Runs the app in development mode.<br>
+Open [http://localhost:8000/docs](http://localhost:8000/docs) to view OpenAPI documentation in the browser.
+
+The page will automatically reload if you make changes to the code.
+
+### `make test`
+
+Runs tests.<br>
+By default, runs tests related to files changed since the last commit.
+
+## License
+
+`fastapi-gen` is distributed under the terms of the [MIT](https://github.com/mirpo/fastapi-gen/blob/main/LICENSE) license.

fastapi_gen-0.11.0/packages/template-advanced/Makefile

@@ -0,0 +1,18 @@
+.PHONY: install start test lint lint-fix
+
+install:
+	uv sync
+
+start:
+	uv run uvicorn advanced.main:app --reload
+
+test:
+	uv run pytest
+
+lint:
+	uv run ruff check src tests
+	uv run ruff format --check src tests
+
+lint-fix:
+	uv run ruff check --fix src tests
+	uv run ruff format src tests