Merge dev into main

Author: DinisCruz

README.md

@@ -1,6 +1,6 @@
 # OSBot-Fast-API
 
-![Current Release](https://img.shields.io/badge/release-v0.12.0-blue)
+![Current Release](https://img.shields.io/badge/release-v0.12.1-blue)
 ![Python](https://img.shields.io/badge/python-3.8+-green)
 ![FastAPI](https://img.shields.io/badge/FastAPI-0.100+-red)
 ![Type-Safe](https://img.shields.io/badge/Type--Safe-✓-brightgreen)
@@ -30,30 +30,33 @@ pip install osbot-fast-api
 
 ```python
 from osbot_fast_api.api.Fast_API import Fast_API
-from osbot_fast_api.api.Fast_API_Routes import Fast_API_Routes
+from osbot_fast_api.api.Fast_API__Routes import Fast_API__Routes
 from osbot_utils.type_safe.Type_Safe import Type_Safe
 
+
 # Define Type-Safe schema
 class User(Type_Safe):
     username: str
     email: str
     age: int
 
+
 # Create routes
-class Routes_Users(Fast_API_Routes):
+class Routes_Users(Fast_API__Routes):
     tag = 'users'
-    
+
     def create_user(self, user: User):
         # user is automatically converted from BaseModel to Type_Safe
         return {'created': user.username}
-    
+
     def get_user__id(self, id: str):  # Becomes /users/get-user/{id}
         return {'user_id': id}
-    
+
     def setup_routes(self):
         self.add_route_post(self.create_user)
         self.add_route_get(self.get_user__id)
 
+
 # Setup application
 fast_api = Fast_API(enable_cors=True)
 fast_api.setup()
@@ -145,7 +148,7 @@ class Person(Type_Safe):
     addresses: List[Address] = []
 
 # Use directly in routes - automatic conversion happens
-class Routes_People(Fast_API_Routes):
+class Routes_People(Fast_API__Routes):
     tag = 'people'
 
     def create_person(self, person: Person):
@@ -250,7 +253,7 @@ def lambda_handler(event, context):
 osbot_fast_api/
 ├── api/
 │   ├── Fast_API.py                 # Main FastAPI wrapper
-│   ├── Fast_API_Routes.py          # Route organization base class
+│   ├── Fast_API__Routes.py          # Route organization base class
 │   ├── Fast_API__Http_Event*.py    # Event tracking components
 │   └── middlewares/                # Built-in middleware
 ├── utils/
@@ -291,7 +294,7 @@ Comprehensive documentation is available in the [`/docs`](./docs) folder:
 - **AWS Ready**: Direct Lambda integration with Mangum
 
 ### For Teams
-- **Organized Code**: Clear separation with Fast_API_Routes classes
+- **Organized Code**: Clear separation with Fast_API__Routes classes
 - **Consistent Patterns**: Standardized route naming and structure
 - **Easy Testing**: Type-Safe test utilities
 - **Documentation**: Auto-generated OpenAPI/Swagger docs

docs/README.md

@@ -19,7 +19,7 @@ This documentation follows a structured approach to thoroughly document the OSBo
 
 ### API Documentation
 - [Fast_API Class](./code/osbot_fast_api/api/Fast_API.py.md) - Main FastAPI wrapper
-- [Fast_API_Routes](./code/osbot_fast_api/api/Fast_API_Routes.py.md) - Route organization
+- [Fast_API__Routes](./code/osbot_fast_api/api/Fast_API__Routes.py.md) - Route organization
 - [Type Converters](./code/osbot_fast_api/utils/type_safe/) - Type-Safe to BaseModel converters
 
 ### Usage Guides
@@ -39,7 +39,7 @@ graph TB
     
     subgraph "OSBot-Fast-API Core"
         FA[Fast_API Wrapper]
-        FAR[Fast_API_Routes Base]
+        FAR[Fast_API__Routes Base]
         TS[Type Converters]
         HE[HTTP Events]
         MW[Middleware Stack]
@@ -84,7 +84,7 @@ graph TB
 | Component | Purpose | Location |
 |-----------|---------|----------|
 | `Fast_API` | Main FastAPI wrapper with Type-Safe support | `/api/Fast_API.py` |
-| `Fast_API_Routes` | Base class for route organization | `/api/Fast_API_Routes.py` |
+| `Fast_API__Routes` | Base class for route organization | `/api/Fast_API__Routes.py` |
 | `Fast_API__Http_Events` | HTTP request/response tracking | `/api/Fast_API__Http_Events.py` |
 | `Type_Safe__To__BaseModel` | Type conversion system | `/utils/type_safe/` |
 | `Fast_API_Server` | Test server for integration testing | `/utils/Fast_API_Server.py` |
@@ -93,25 +93,28 @@ graph TB
 
 ```python
 from osbot_fast_api.api.Fast_API import Fast_API
-from osbot_fast_api.api.Fast_API_Routes import Fast_API_Routes
+from osbot_fast_api.api.Fast_API__Routes import Fast_API__Routes
 from osbot_utils.type_safe.Type_Safe import Type_Safe
 
+
 # Define a Type-Safe schema
 class User(Type_Safe):
     name: str
     email: str
     age: int
 
+
 # Create routes
-class Routes_Users(Fast_API_Routes):
+class Routes_Users(Fast_API__Routes):
     tag = 'users'
-    
+
     def create_user(self, user: User):
         return {'created': user.name}
-    
+
     def setup_routes(self):
         self.add_route_post(self.create_user)
 
+
 # Setup application
 fast_api = Fast_API()
 fast_api.setup()

docs/architecture/osbot-fast-api-architecture.md

@@ -44,7 +44,7 @@ graph TB
         end
         
         subgraph "Routing"
-            FAR[Fast_API_Routes]
+            FAR[Fast_API__Routes]
             RC[Route Config]
             RM[Route Methods]
         end
@@ -134,7 +134,7 @@ classDiagram
     Fast_API --|> Type_Safe
     Fast_API *-- Fast_API__Http_Events
     Fast_API ..> FastAPI : creates
-    Fast_API ..> Fast_API_Routes : manages
+    Fast_API ..> Fast_API__Routes : manages
 ```
 
 **Responsibilities**:
@@ -144,13 +144,13 @@ classDiagram
 - HTTP event coordination
 - Global exception handling
 
-### Fast_API_Routes Class
+### Fast_API__Routes Class
 
 Base class for organizing routes with automatic Type-Safe conversion:
 
 ```mermaid
 classDiagram
-    class Fast_API_Routes {
+    class Fast_API__Routes {
         +APIRouter router
         +FastAPI app
         +str prefix
@@ -164,9 +164,9 @@ classDiagram
         +setup_routes()
     }
     
-    Fast_API_Routes --|> Type_Safe
-    Fast_API_Routes --> APIRouter
-    Fast_API_Routes --> FastAPI
+    Fast_API__Routes --|> Type_Safe
+    Fast_API__Routes --> APIRouter
+    Fast_API__Routes --> FastAPI
 ```
 
 **Route Path Generation Algorithm**:
@@ -344,7 +344,7 @@ class Custom_Fast_API(Fast_API):
 ### Custom Routes
 
 ```python
-class Custom_Routes(Fast_API_Routes):
+class Custom_Routes(Fast_API__Routes):
     def setup_routes(self):
         # Add routes with Type-Safe support
         self.add_route_get(self.custom_method)

docs/architecture/why-async-routes-are-not-used.md

@@ -94,7 +94,7 @@ What makes this particularly dangerous:
 
 ```python
 # ✅ SAFE: OSBot-Fast-API approach
-class Routes_API(Fast_API_Routes):
+class Routes_API(Fast_API__Routes):
     def get_users(self):  # Sync function
         # Safe to use any sync library
         users = db.query("SELECT * FROM users")
@@ -218,7 +218,7 @@ But in a production API where:
 ### Do's ✅
 
 ```python
-class Routes_Safe(Fast_API_Routes):
+class Routes_Safe(Fast_API__Routes):
     def process_data(self, data: dict):
         # Safe to use any sync operation
         result = sync_database.query(data)
@@ -232,7 +232,7 @@ class Routes_Safe(Fast_API_Routes):
 
 ```python
 # Don't try to force async in OSBot-Fast-API
-class Routes_Unsafe(Fast_API_Routes):
+class Routes_Unsafe(Fast_API__Routes):
     async def process_data(self, data: dict):  # Avoid this
         # Mixing async/sync is dangerous
         pass

docs/comparison/fastapi-vs-osbot-fastapi.md

@@ -78,45 +78,50 @@ if __name__ == "__main__":
 ```
 
 #### OSBot-Fast-API
+
 ```python
 from osbot_fast_api.api.Fast_API import Fast_API
-from osbot_fast_api.api.Fast_API_Routes import Fast_API_Routes
+from osbot_fast_api.api.Fast_API__Routes import Fast_API__Routes
 from osbot_utils.type_safe.Type_Safe import Type_Safe
 
+
 # Type-Safe schemas (stronger than Pydantic)
 class User(Type_Safe):
     username: str
     email: str
     age: int
 
+
 class UserResponse(Type_Safe):
     id: str
     username: str
     created: bool
 
+
 # Organized routes in classes
-class Routes_Users(Fast_API_Routes):
+class Routes_Users(Fast_API__Routes):
     tag = 'users'
-    
+
     def create(self, user: User) -> UserResponse:
         # Automatic type conversion
         return UserResponse(
             id="user_123",
             username=user.username,
             created=True
         )
-    
+
     def get__user_id(self, user_id: str):
         return {"user_id": user_id}
-    
+
     def setup_routes(self):
         self.add_route_post(self.create)
         self.add_route_get(self.get__user_id)
 
+
 # Simple setup with built-in features
 fast_api = Fast_API(
-    enable_cors=True,      # CORS configured
-    enable_api_key=True    # API key validation built-in
+    enable_cors=True,  # CORS configured
+    enable_api_key=True  # API key validation built-in
 )
 fast_api.setup()
 fast_api.add_routes(Routes_Users)
@@ -296,7 +301,7 @@ async def create_user(): ...
 
 #### OSBot-Fast-API - Organized by Design
 ```python
-class Routes_Users(Fast_API_Routes):
+class Routes_Users(Fast_API__Routes):
     tag = 'users'  # All routes prefixed with /users
 
     def list(self): ...           # GET /users/list

docs/guides/llm-prompts.md

@@ -11,8 +11,8 @@ This guide provides prompts for Large Language Models (like Claude, GPT-4, etc.)
 ```
 Create a FastAPI service using OSBot-Fast-API that:
 1. Uses the Fast_API class as the base, not regular FastAPI
-2. Implements routes using Fast_API_Routes classes with descriptive tags
-3. Each route class should extend Fast_API_Routes and implement setup_routes()
+2. Implements routes using Fast_API__Routes classes with descriptive tags
+3. Each route class should extend Fast_API__Routes and implement setup_routes()
 4. Use method naming convention: method_name becomes /method-name
 5. For path parameters use double underscore: method__param becomes /method/{param}
 6. Enable CORS and API key authentication if needed
@@ -24,7 +24,7 @@ Create a FastAPI service using OSBot-Fast-API that:
 
 ```
 Add a new route to OSBot-Fast-API that:
-1. Extends Fast_API_Routes with appropriate tag property
+1. Extends Fast_API__Routes with appropriate tag property
 2. Uses Type_Safe classes (not Pydantic BaseModel) for request/response schemas
 3. Type_Safe classes should inherit from Type_Safe, not BaseModel
 4. Implements add_route_get/post/put/delete in setup_routes() method
@@ -55,7 +55,7 @@ Create Type-Safe schemas for OSBot-Fast-API:
 ```
 When working with OSBot-Fast-API type conversions:
 1. Type_Safe classes are automatically converted to/from BaseModel at API boundaries
-2. Conversion happens in Fast_API_Routes methods automatically
+2. Conversion happens in Fast_API__Routes methods automatically
 3. Manual conversion: type_safe__to__basemodel.convert_class(Type_Safe_Class)
 4. Reverse: basemodel__to__type_safe.convert_instance(basemodel_instance)
 5. Collections (List, Dict, Set) are automatically handled
@@ -211,7 +211,7 @@ Add static files and shell server to OSBot-Fast-API:
 ```
 Create a complete OSBot-Fast-API service with:
 1. Type_Safe schemas for all data models
-2. Fast_API_Routes classes for endpoint organization
+2. Fast_API__Routes classes for endpoint organization
 3. Enable CORS for web clients
 4. API key authentication for security
 5. HTTP event tracking for monitoring
@@ -240,7 +240,7 @@ Implement error handling in OSBot-Fast-API:
 ```
 Follow OSBot-Fast-API best practices:
 1. Always use Type_Safe classes, never raw Pydantic BaseModel
-2. Organize routes in Fast_API_Routes classes by domain
+2. Organize routes in Fast_API__Routes classes by domain
 3. Set meaningful tags for OpenAPI documentation
 4. Enable middleware appropriate for environment
 5. Use environment variables for all configuration
@@ -257,7 +257,7 @@ Follow OSBot-Fast-API best practices:
 Critical OSBot-Fast-API implementation details:
 1. NEVER use FastAPI() directly, always use Fast_API()
 2. NEVER use BaseModel for schemas, always use Type_Safe
-3. NEVER use @app.get(), use Fast_API_Routes methods
+3. NEVER use @app.get(), use Fast_API__Routes methods
 4. ALWAYS call setup() before adding routes
 5. ALWAYS implement setup_routes() in route classes
 6. ALWAYS use add_route_get/post/put/delete, not decorators