fastapi-voyager 0.11.7__tar.gz → 0.11.9__tar.gz

{fastapi_voyager-0.11.7 → fastapi_voyager-0.11.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fastapi-voyager
-Version: 0.11.7
+Version: 0.11.9
 Summary: Visualize FastAPI application's routing tree and dependencies
 Project-URL: Homepage, https://github.com/allmonday/fastapi-voyager
 Project-URL: Source, https://github.com/allmonday/fastapi-voyager
@@ -34,14 +34,7 @@ Description-Content-Type: text/markdown
 
 > This repo is still in early stage, it supports pydantic v2 only
 
-FastAPI can help you:
-
-- design your API
-- inspect your API
-- refactor your API
-
-interactively !!
-
+Visualize your FastAPI endpoints, and explore them interactively.
 
 [visit online demo](https://www.newsyeah.fun/voyager/) of project: [composition oriented development pattern](https://github.com/allmonday/composition-oriented-development-pattern)
 
@@ -59,6 +52,9 @@ uv add fastapi-voyager
 voyager -m path.to.your.app.module --server
 ```
 
+> *sub_app* is not supported yet.
+
+
 ## Mount into project
 
 ```python
@@ -177,6 +173,7 @@ or you can open router_viz.dot with vscode extension `graphviz interactive previ
     - [ ] add route/tag list
 - [ ] type alias should not be kept as node instead of compiling to original type
 - [ ] how to correctly handle the generic type ?
+- [ ] support Google analysis config
 
 ### in analysis
 - [ ] click field to highlight links
@@ -276,6 +273,10 @@ or you can open router_viz.dot with vscode extension `graphviz interactive previ
     - [x] optimize loading static resource 
 - 0.11.7
     - [x] fix swagger link
+- 0.11.8
+    - [x] fix swagger link in another way
+- 0.11.9
+    - [x] replace issubclass with safe_issubclass to prevent exception.
 
 #### 0.12
 - [ ] add tests
@@ -287,12 +288,13 @@ or you can open router_viz.dot with vscode extension `graphviz interactive previ
 - [ ] config release pipeline
 
 
-## Using with pydantic-resolve
+## About pydantic-resolve
 
-WIP: ...
+pydantic-resolve's `@ensure_subset` decorator helps safely pick fields from the 'source class' while indicating the reference from the current class to the base class.
 
-pydantic-resolve's @ensure_subset decorator is helpful to pick fields from `source class` in safe.
+pydantic-resolve is a lightweight tool designed to build complex, nested data in a simple, declarative way. In version 2, it will introduce an important feature: ER model definition, and fastapi-voyager will support and visualize these diagrams.
 
+Developers can use fastapi-voyager without needing to know about pydantic-resolve.
 
 
 ## Credits
@@ -307,3 +309,26 @@ pydantic-resolve's @ensure_subset decorator is helpful to pick fields from `sour
 - [pydantic-resolve](https://github.com/allmonday/pydantic-resolve)
 - Quasar
 
+
+## How to develop & contribute?
+
+fork, clone.
+
+install uv.
+
+```shell
+uv venv
+source .venv/bin/activate
+uv pip install ".[dev]"
+uvicorn tests.programatic:app  --reload
+```
+
+open `localhost:8000/voyager`
+
+
+frontend: `src/web/vue-main.js`
+backend: `voyager.py`, `render.py`, `server.py`
+
+## Branch and Release flow
+
+TODO

{fastapi_voyager-0.11.7 → fastapi_voyager-0.11.9}/README.md

@@ -5,14 +5,7 @@
 
 > This repo is still in early stage, it supports pydantic v2 only
 
-FastAPI can help you:
-
-- design your API
-- inspect your API
-- refactor your API
-
-interactively !!
-
+Visualize your FastAPI endpoints, and explore them interactively.
 
 [visit online demo](https://www.newsyeah.fun/voyager/) of project: [composition oriented development pattern](https://github.com/allmonday/composition-oriented-development-pattern)
 
@@ -30,6 +23,9 @@ uv add fastapi-voyager
 voyager -m path.to.your.app.module --server
 ```
 
+> *sub_app* is not supported yet.
+
+
 ## Mount into project
 
 ```python
@@ -148,6 +144,7 @@ or you can open router_viz.dot with vscode extension `graphviz interactive previ
     - [ ] add route/tag list
 - [ ] type alias should not be kept as node instead of compiling to original type
 - [ ] how to correctly handle the generic type ?
+- [ ] support Google analysis config
 
 ### in analysis
 - [ ] click field to highlight links
@@ -247,6 +244,10 @@ or you can open router_viz.dot with vscode extension `graphviz interactive previ
     - [x] optimize loading static resource 
 - 0.11.7
     - [x] fix swagger link
+- 0.11.8
+    - [x] fix swagger link in another way
+- 0.11.9
+    - [x] replace issubclass with safe_issubclass to prevent exception.
 
 #### 0.12
 - [ ] add tests
@@ -258,12 +259,13 @@ or you can open router_viz.dot with vscode extension `graphviz interactive previ
 - [ ] config release pipeline
 
 
-## Using with pydantic-resolve
+## About pydantic-resolve
 
-WIP: ...
+pydantic-resolve's `@ensure_subset` decorator helps safely pick fields from the 'source class' while indicating the reference from the current class to the base class.
 
-pydantic-resolve's @ensure_subset decorator is helpful to pick fields from `source class` in safe.
+pydantic-resolve is a lightweight tool designed to build complex, nested data in a simple, declarative way. In version 2, it will introduce an important feature: ER model definition, and fastapi-voyager will support and visualize these diagrams.
 
+Developers can use fastapi-voyager without needing to know about pydantic-resolve.
 
 
 ## Credits
@@ -278,3 +280,26 @@ pydantic-resolve's @ensure_subset decorator is helpful to pick fields from `sour
 - [pydantic-resolve](https://github.com/allmonday/pydantic-resolve)
 - Quasar
 
+
+## How to develop & contribute?
+
+fork, clone.
+
+install uv.
+
+```shell
+uv venv
+source .venv/bin/activate
+uv pip install ".[dev]"
+uvicorn tests.programatic:app  --reload
+```
+
+open `localhost:8000/voyager`
+
+
+frontend: `src/web/vue-main.js`
+backend: `voyager.py`, `render.py`, `server.py`
+
+## Branch and Release flow
+
+TODO

{fastapi_voyager-0.11.7 → fastapi_voyager-0.11.9}/src/fastapi_voyager/server.py

@@ -38,18 +38,15 @@ class Payload(BaseModel):
 	show_module: bool = True
 
 
-def create_route(
+def create_voyager(
 	target_app: FastAPI,
 	module_color: dict[str, str] | None = None,
-	swagger_url: Optional[str] = None,
+	gzip_minimum_size: int | None = 500,
 	module_prefix: Optional[str] = None,
+	swagger_url: Optional[str] = None,
 	online_repo_url: Optional[str] = None,
 	initial_page_policy: INITIAL_PAGE_POLICY = 'first',
-):
-	"""
-	module_color: dict mapping module name to color string, e.g. {'models': 'lightblue'}
-	module_prefix: prefix string to define schemas show in brief mode
-	"""
+) -> FastAPI:
 	router = APIRouter(tags=['fastapi-voyager'])
 
 	@router.get("/dot", response_model=OptionParam)
@@ -207,27 +204,6 @@ def create_route(
 				content={"error": f"Internal error: {str(e)}"}
 			)
         
-	return router
-
-
-def create_voyager(
-	target_app: FastAPI,
-	module_color: dict[str, str] | None = None,
-	gzip_minimum_size: int | None = 500,
-	module_prefix: Optional[str] = None,
-	swagger_url: Optional[str] = None,
-	online_repo_url: Optional[str] = None,
-	initial_page_policy: INITIAL_PAGE_POLICY = 'first',
-) -> FastAPI:
-	router = create_route(
-		target_app, 
-		module_color=module_color, 
-		module_prefix=module_prefix, 
-		swagger_url=swagger_url,
-		online_repo_url=online_repo_url,
-		initial_page_policy=initial_page_policy,
-		)
-
 	app = FastAPI(title="fastapi-voyager demo server")
 	if gzip_minimum_size is not None and gzip_minimum_size >= 0:
 		app.add_middleware(GZipMiddleware, minimum_size=gzip_minimum_size)

{fastapi_voyager-0.11.7 → fastapi_voyager-0.11.9}/src/fastapi_voyager/type_helper.py

@@ -283,7 +283,7 @@ def is_generic_container(cls):
     
 def is_non_pydantic_type(tp):
     for schema in get_core_types(tp):
-        if schema and issubclass(schema, BaseModel):
+        if schema and safe_issubclass(schema, BaseModel):
             return False
     return True
 

{fastapi_voyager-0.11.7 → fastapi_voyager-0.11.9}/src/fastapi_voyager/version.py

@@ -1,2 +1,2 @@
 __all__ = ["__version__"]
-__version__ = "0.11.7"
+__version__ = "0.11.9"

{fastapi_voyager-0.11.7 → fastapi_voyager-0.11.9}/src/fastapi_voyager/voyager.py

@@ -29,7 +29,6 @@ class Voyager:
             route_name: str | None = None,
             hide_primitive_route: bool = False,
             show_module: bool = True,
-            route_name_fn: Callable | None = None
         ):
 
         self.routes: list[Route] = []
@@ -52,7 +51,6 @@ class Voyager:
         self.route_name = route_name
         self.hide_primitive_route = hide_primitive_route
         self.show_module = show_module
-        self.route_name_fn = route_name_fn
     
 
     def _get_available_route(self, app: FastAPI):
@@ -126,7 +124,7 @@ class Voyager:
                     id=route_id,
                     name=route_name,
                     module=route_module,
-                    unique_id=self.route_name_fn(route) if self.route_name_fn else route.unique_id,
+                    unique_id=route.operation_id or route.unique_id,
                     response_schema=get_type_name(route.response_model),
                     is_primitive=is_primitive_response
                 )

{fastapi_voyager-0.11.7 → fastapi_voyager-0.11.9}/tests/demo.py

@@ -104,4 +104,8 @@ def get_page_test_3_no_response_model():
 
 @app.get("/page_test_5/", tags=['long_long_long_tag_name', 'group_b'])
 def get_page_test_3_no_response_model():
-    return True
+    return True
+
+
+for r in app.router.routes:
+    r.operation_id = r.name

{fastapi_voyager-0.11.7 → fastapi_voyager-0.11.9}/tests/programatic.py

@@ -5,7 +5,7 @@ app.mount(
     '/voyager', 
     create_voyager(
         app, 
-        module_color={"tests.service": "red"}, 
+        module_color={"tests.service": "purple"}, 
         module_prefix="tests.service", 
         swagger_url="/docs",
         initial_page_policy='first',