fastapi-voyager 0.11.7__py3-none-any.whl → 0.11.9__py3-none-any.whl

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/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/version.py

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

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.dist-info → fastapi_voyager-0.11.9.dist-info}/METADATA

@@ -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.dist-info → fastapi_voyager-0.11.9.dist-info}/RECORD

@@ -3,11 +3,11 @@ fastapi_voyager/cli.py,sha256=kQb4g6JEGZR99e5r8LyFFEeb_-uT-n_gp_sDoYG3R7k,11118
 fastapi_voyager/filter.py,sha256=GY2J9Vfsf_wbFwC-0t74-Lf-OlO77PnhEXD_rmgkfSw,11574
 fastapi_voyager/module.py,sha256=Z2QHNmiLk6ZAJlm2nSmO875Q33TweSg8UxZSzIpU9zY,3499
 fastapi_voyager/render.py,sha256=vdwqIync2wsP8gMPY0v_XjRhdPBtbKyRT8yTBa_Ep3Y,8744
-fastapi_voyager/server.py,sha256=upc38XFWr3UqAxbst-EAqf3_uaA9eS0Q_pzn3gE59jk,7143
+fastapi_voyager/server.py,sha256=G48St-leUcEwshIhTYVotxuFWXDAvzjthOCK9AKh9dI,6497
 fastapi_voyager/type.py,sha256=VmcTB1G-LOT70EWCzi4LU_FUkSGWUIBJX15T_J5HnOo,1764
-fastapi_voyager/type_helper.py,sha256=QqP4c642vEkoWTZAtl_Vvt-kys3MkVDp4BNkLrw5mHQ,9477
-fastapi_voyager/version.py,sha256=FDsWNAszzeAI5uYptGQNcnHKwUJ5yQ8avSPu41kgadI,49
-fastapi_voyager/voyager.py,sha256=Ocj4gKK8S3QMBlJYUmqRzSEKjGLV1lBuNsljEKYLV5M,13673
+fastapi_voyager/type_helper.py,sha256=uJI3UQHJ8zcJq_QBnU9FtHl8m2XKTU6ATOhj6IIP91U,9482
+fastapi_voyager/version.py,sha256=Wb6eX7VamWPEx6nEYtqHwXME7cHmNHnzkrPw148hvJk,49
+fastapi_voyager/voyager.py,sha256=nioo56oFDeZ8nwwPWDtaQbkpe4pVssFoBVHCWFhs0K4,13549
 fastapi_voyager/web/graph-ui.js,sha256=DTedkpZNbtufexONVkJ8mOwF_-VnvxoReYHtox6IKR4,5842
 fastapi_voyager/web/graphviz.svg.css,sha256=zDCjjpT0Idufu5YOiZI76PL70-avP3vTyzGPh9M85Do,1563
 fastapi_voyager/web/graphviz.svg.js,sha256=lvAdbjHc-lMSk4GQp-iqYA2PCFX4RKnW7dFaoe0LUHs,16005
@@ -26,8 +26,8 @@ fastapi_voyager/web/icon/favicon-16x16.png,sha256=JC07jEzfIYxBIoQn_FHXvyHuxESdhW
 fastapi_voyager/web/icon/favicon-32x32.png,sha256=C7v1h58cfWOsiLp9yOIZtlx-dLasBcq3NqpHVGRmpt4,1859
 fastapi_voyager/web/icon/favicon.ico,sha256=tZolYIXkkBcFiYl1A8ksaXN2VjGamzcSdes838dLvNc,15406
 fastapi_voyager/web/icon/site.webmanifest,sha256=ep4Hzh9zhmiZF2At3Fp1dQrYQuYF_3ZPZxc1KcGBvwQ,263
-fastapi_voyager-0.11.7.dist-info/METADATA,sha256=M0F4nnUPt_wY5cot9IIf_fpFieR80iMDwN8nBmwblfk,9780
-fastapi_voyager-0.11.7.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-fastapi_voyager-0.11.7.dist-info/entry_points.txt,sha256=pEIKoUnIDXEtdMBq8EmXm70m16vELIu1VPz9-TBUFWM,53
-fastapi_voyager-0.11.7.dist-info/licenses/LICENSE,sha256=lNVRR3y_bFVoFKuK2JM8N4sFaj3m-7j29kvL3olFi5Y,1067
-fastapi_voyager-0.11.7.dist-info/RECORD,,
+fastapi_voyager-0.11.9.dist-info/METADATA,sha256=Lu6dgQqkJyfjVIO-NSzXKRdnq4HF30lD6_XXPqt51m8,10655
+fastapi_voyager-0.11.9.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+fastapi_voyager-0.11.9.dist-info/entry_points.txt,sha256=pEIKoUnIDXEtdMBq8EmXm70m16vELIu1VPz9-TBUFWM,53
+fastapi_voyager-0.11.9.dist-info/licenses/LICENSE,sha256=lNVRR3y_bFVoFKuK2JM8N4sFaj3m-7j29kvL3olFi5Y,1067
+fastapi_voyager-0.11.9.dist-info/RECORD,,