Merge dev into main

Author: DinisCruz

README.md

@@ -1,6 +1,6 @@
 # OSBot-Fast-API
 
-![Current Release](https://img.shields.io/badge/release-v0.15.0-blue)
+![Current Release](https://img.shields.io/badge/release-v0.15.5-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)

osbot_fast_api/api/Fast_API.py

@@ -112,6 +112,9 @@ def fast_api_utils(self):
 
         return Fast_API_Utils(self.app())
 
+    def open_api_json(self):
+        return self.app().openapi()
+
     def path_static_folder(self):        # override this to add support for serving static files from this directory
         return None
 

osbot_fast_api/api/decorators/Fast_API__Thread__Trace_Request.py

@@ -1,10 +1,6 @@
-
-import sys
 from functools                              import wraps
 from fastapi                                import Request
 from osbot_utils.helpers.trace.Trace_Call   import Trace_Call
-from osbot_utils.utils.Objects import obj_info
-
 
 # this is needed to add support for tracing a request for the FastAPI requests that execute in the threat pool
 #   i.e. any request that doesn't use async in the method definition

osbot_fast_api/api/routes/Fast_API__Routes.py

@@ -8,9 +8,9 @@
 from fastapi.exceptions                                             import RequestValidationError
 from osbot_utils.type_safe.type_safe_core.shared.Type_Safe__Cache   import type_safe_cache
 from osbot_fast_api.api.routes.Fast_API__Route__Parser              import Fast_API__Route__Parser
+from osbot_fast_api.api.transformers.Type_Safe__To__BaseModel       import type_safe__to__basemodel
 from osbot_fast_api.schemas.Safe_Str__Fast_API__Route__Prefix       import Safe_Str__Fast_API__Route__Prefix
 from osbot_fast_api.schemas.Safe_Str__Fast_API__Route__Tag          import Safe_Str__Fast_API__Route__Tag
-from osbot_fast_api.utils.type_safe.Type_Safe__To__BaseModel        import type_safe__to__basemodel
 
 
 class Fast_API__Routes(Type_Safe):       # refactor to Fast_API__Routes
@@ -208,7 +208,7 @@ def wrapper(*args, **kwargs):
                             })
                     elif param_name in type_safe_conversions:                                               # Handle Type_Safe params (complex objects in GET)
                         type_safe_class, _ = type_safe_conversions[param_name]                              # Get the Type_Safe class
-                        converted_kwargs[param_name] = param_value                                          # Placeholder - needs custom query param parsing
+                        converted_kwargs[param_name] = param_value                                          # todo: question: is this comment this relevant (with current codebase) -> Placeholder - needs custom query param parsing
                     else:
                         converted_kwargs[param_name] = param_value                                          # Pass through unchanged
 

osbot_fast_api/api/routes/Routes__Config.py

@@ -1,8 +1,11 @@
-from fastapi.responses                              import HTMLResponse
-from osbot_fast_api.api.routes.Fast_API__Routes     import Fast_API__Routes
-from osbot_fast_api.utils.Fast_API__Routes__Paths   import Fast_API__Routes__Paths
-from osbot_fast_api.utils.Fast_API__Server_Info     import fast_api__server_info
-from osbot_fast_api.utils.Version                   import version__osbot_fast_api
+from fastapi                                             import Response
+from fastapi.responses                                   import HTMLResponse
+from osbot_fast_api.api.decorators.route_path            import route_path
+from osbot_fast_api.api.routes.Fast_API__Routes          import Fast_API__Routes
+from osbot_fast_api.api.transformers.OpenAPI__To__Python import OpenAPI__To__Python
+from osbot_fast_api.utils.Fast_API__Routes__Paths        import Fast_API__Routes__Paths
+from osbot_fast_api.utils.Fast_API__Server_Info          import fast_api__server_info
+from osbot_fast_api.utils.Version                        import version__osbot_fast_api
 
 
 class Routes__Config(Fast_API__Routes):
@@ -24,9 +27,18 @@ def routes__html(self):
         html_content = Fast_API__Routes__Paths(app=self.app).routes_html()
         return HTMLResponse(content=html_content)
 
+    @route_path('/openapi.py')
+    def openapi_python(self):
+        open_api_to_python = OpenAPI__To__Python()
+        client_python_code = open_api_to_python.generate_from_app(app=self.app)
+
+        return Response(content    = client_python_code,
+                        media_type = "text/x-python"   )
+
     def setup_routes(self):
-        self.add_route_get(self.info       )
-        self.add_route_get(self.status     )
-        self.add_route_get(self.version    )
-        self.add_route_get(self.routes__json)
-        self.add_route_get(self.routes__html)
+        self.add_route_get(self.info          )
+        self.add_route_get(self.status        )
+        self.add_route_get(self.version       )
+        self.add_route_get(self.routes__json  )
+        self.add_route_get(self.routes__html  )
+        self.add_route_get(self.openapi_python)