fastapi-voyager 0.11.1__tar.gz → 0.11.2__tar.gz

{fastapi_voyager-0.11.1 → fastapi_voyager-0.11.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fastapi-voyager
-Version: 0.11.1
+Version: 0.11.2
 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
@@ -16,6 +16,8 @@ Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Requires-Python: >=3.10
 Requires-Dist: fastapi>=0.110
 Requires-Dist: pydantic-resolve>=1.13.2
@@ -32,7 +34,14 @@ Description-Content-Type: text/markdown
 
 > This repo is still in early stage, it supports pydantic v2 only
 
-Inspect your API interactively!  
+FastAPI can help you:
+
+- design your API
+- inspect your API
+- refactor your API
+
+interactively !!
+
 
 [visit online demo](https://www.newsyeah.fun/voyager/) of project: [composition oriented development pattern](https://github.com/allmonday/composition-oriented-development-pattern)
 
@@ -51,6 +60,22 @@ uv add fastapi-voyager
 voyager -m path.to.your.app.module --server
 ```
 
+## Mount into project
+
+```python
+from fastapi import FastAPI
+from fastapi_voyager import create_voyager
+from tests.demo import app
+
+app.mount('/voyager', create_voyager(
+    app, 
+    module_color={"tests.service": "red"}, 
+    module_prefix="tests.service"),
+    swagger_url="/docs")
+```
+
+more about [sub application](https://fastapi.tiangolo.com/advanced/sub-applications/?h=sub)
+
 
 ## Feature
 
@@ -99,20 +124,6 @@ click a node to highlight it's upperstream and downstream nodes. figure out the
 <img width="882" height="445" alt="image" src="https://github.com/user-attachments/assets/158560ef-63ca-4991-9b7d-587be4fa04e4" />
 
 
-## Mount to target project
-
-```python
-from fastapi import FastAPI
-from fastapi_voyager import create_voyager
-from tests.demo import app
-
-app.mount('/voyager', create_voyager(
-    app, 
-    module_color={"tests.service": "red"}, 
-    module_prefix="tests.service"))
-```
-
-more about [sub application](https://fastapi.tiangolo.com/advanced/sub-applications/?h=sub)
 
 
 ## Command Line Usage
@@ -257,12 +268,12 @@ or you can open router_viz.dot with vscode extension `graphviz interactive previ
         - [x] config docs path
     - [x] provide option to hide routes in brief mode (auto hide in full graph mode)
 - 0.11.2
-    - [ ] enable/disable module cluster  (to save space)
+    - [x] enable/disable module cluster  (to save space)
+- 0.11.3
+    - [ ] add loading for field detail panel
     - [ ] logging information
     - [ ] sort field name
     - [ ] set max limit for fields
-    - [ ] add info icon alone with schema node
-    - [ ] add loading for field detail panel
 
 #### 0.12
 - [ ] add tests

{fastapi_voyager-0.11.1 → fastapi_voyager-0.11.2}/README.md

@@ -5,7 +5,14 @@
 
 > This repo is still in early stage, it supports pydantic v2 only
 
-Inspect your API interactively!  
+FastAPI can help you:
+
+- design your API
+- inspect your API
+- refactor your API
+
+interactively !!
+
 
 [visit online demo](https://www.newsyeah.fun/voyager/) of project: [composition oriented development pattern](https://github.com/allmonday/composition-oriented-development-pattern)
 
@@ -24,6 +31,22 @@ uv add fastapi-voyager
 voyager -m path.to.your.app.module --server
 ```
 
+## Mount into project
+
+```python
+from fastapi import FastAPI
+from fastapi_voyager import create_voyager
+from tests.demo import app
+
+app.mount('/voyager', create_voyager(
+    app, 
+    module_color={"tests.service": "red"}, 
+    module_prefix="tests.service"),
+    swagger_url="/docs")
+```
+
+more about [sub application](https://fastapi.tiangolo.com/advanced/sub-applications/?h=sub)
+
 
 ## Feature
 
@@ -72,20 +95,6 @@ click a node to highlight it's upperstream and downstream nodes. figure out the
 <img width="882" height="445" alt="image" src="https://github.com/user-attachments/assets/158560ef-63ca-4991-9b7d-587be4fa04e4" />
 
 
-## Mount to target project
-
-```python
-from fastapi import FastAPI
-from fastapi_voyager import create_voyager
-from tests.demo import app
-
-app.mount('/voyager', create_voyager(
-    app, 
-    module_color={"tests.service": "red"}, 
-    module_prefix="tests.service"))
-```
-
-more about [sub application](https://fastapi.tiangolo.com/advanced/sub-applications/?h=sub)
 
 
 ## Command Line Usage
@@ -230,12 +239,12 @@ or you can open router_viz.dot with vscode extension `graphviz interactive previ
         - [x] config docs path
     - [x] provide option to hide routes in brief mode (auto hide in full graph mode)
 - 0.11.2
-    - [ ] enable/disable module cluster  (to save space)
+    - [x] enable/disable module cluster  (to save space)
+- 0.11.3
+    - [ ] add loading for field detail panel
     - [ ] logging information
     - [ ] sort field name
     - [ ] set max limit for fields
-    - [ ] add info icon alone with schema node
-    - [ ] add loading for field detail panel
 
 #### 0.12
 - [ ] add tests

{fastapi_voyager-0.11.1 → fastapi_voyager-0.11.2}/pyproject.toml

@@ -17,6 +17,8 @@ classifiers = [
   "Programming Language :: Python :: 3.10",
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
   "Framework :: FastAPI",
   "Intended Audience :: Developers",
   "License :: OSI Approved :: MIT License"

{fastapi_voyager-0.11.1 → fastapi_voyager-0.11.2}/src/fastapi_voyager/render.py

@@ -10,10 +10,12 @@ class Renderer:
         show_fields: FieldType = 'single',
         module_color: dict[str, str] | None = None,
         schema: str | None = None,
+        show_module: bool = True
     ) -> None:
         self.show_fields = show_fields if show_fields in ('single', 'object', 'all') else 'single'
         self.module_color = module_color or {}
         self.schema = schema
+        self.show_module = show_module
 
     def render_schema_label(self, node: SchemaNode) -> str:
         has_base_fields = any(f.from_base for f in node.fields)
@@ -60,13 +62,18 @@ class Renderer:
         elif link.type == 'subset':
             return f"""{h(link.source)}:e -> {h(link.target)}:w [style = "solid, dashed", dir="back", minlen=3, taillabel = "< subset >", color = "orange", tailport="n"];"""
         elif link.type == 'tag_to_schema':
-            return f"""{h(link.source)}:e -> {h(link.target)}:w [style = "solid", dir="back", arrowtail="odot", minlen=3];"""
+            return f"""{h(link.source)}:e -> {h(link.target)}:w [style = "solid", minlen=3];"""
         else:
             raise ValueError(f'Unknown link type: {link.type}')
 
-    def render_module_schema_content(self, mods: list[ModuleNode]) -> str:
-        module_color_flag = set(self.module_color.keys())
-
+    def render_module_schema_content(self, nodes: list[SchemaNode]) -> str:
+        def render_node(node: SchemaNode) -> str:
+            return f'''
+                "{node.id}" [
+                    label = {self.render_schema_label(node)}
+                    shape = "plain"
+                    margin="0.5,0.1"
+                ];'''
         def render_module_schema(mod: ModuleNode) -> str:
             color: Optional[str] = None
 
@@ -76,14 +83,7 @@ class Renderer:
                     color = self.module_color[k]
                     break
 
-            inner_nodes = [
-                f'''
-                    "{node.id}" [
-                        label = {self.render_schema_label(node)}
-                        shape = "plain"
-                        margin="0.5,0.1"
-                    ];''' for node in mod.schema_nodes
-            ]
+            inner_nodes = [ render_node(node) for node in mod.schema_nodes ]
             inner_nodes_str = '\n'.join(inner_nodes)
             child_str = '\n'.join(render_module_schema(m) for m in mod.modules)
             return f'''
@@ -98,34 +98,49 @@ class Renderer:
                     {inner_nodes_str}
                     {child_str}
                 }}'''
-        return '\n'.join(render_module_schema(m) for m in mods)
+        if self.show_module:
+            module_schemas = build_module_schema_tree(nodes)
+            module_color_flag = set(self.module_color.keys())
+            return '\n'.join(render_module_schema(m) for m in module_schemas)
+        else:
+            return '\n'.join(render_node(n) for n in nodes)
     
-    def render_module_route(self, mod: ModuleRoute) -> str:
-        # Inner route nodes, same style as flat route_str
-        inner_nodes = [
-            f'''
-            "{r.id}" [
-                label = "    {r.name} | {r.response_schema}    "
-                margin="0.5,0.1"
-                shape = "record"
-            ];''' for r in mod.routes
-        ]
-        inner_nodes_str = '\n'.join(inner_nodes)
-        child_str = '\n'.join(self.render_module_route(m) for m in mod.modules)
-        return f'''
-            subgraph cluster_route_module_{mod.fullname.replace('.', '_')} {{
-                tooltip="{mod.fullname}"
-                color = "#666"
-                style="rounded"
-                label = "  {mod.name}"
-                labeljust = "l"
-                {inner_nodes_str}
-                {child_str}
-            }}'''
+    def render_module_route_content(self, routes: list[Route]) -> str:
+        def render_route(route: Route) -> str:
+            response_schema = route.response_schema[:25] + '..' if len(route.response_schema) > 25 else route.response_schema
+            return f'''
+                "{route.id}" [
+                    label = "    {route.name} | {response_schema}    "
+                    margin="0.5,0.1"
+                    shape = "record"
+                ];'''
+
+        def render_module_route(mod: ModuleRoute) -> str:
+            # Inner route nodes, same style as flat route_str
+            inner_nodes = [
+                render_route(r) for r in mod.routes
+            ]
+            inner_nodes_str = '\n'.join(inner_nodes)
+            child_str = '\n'.join(render_module_route(m) for m in mod.modules)
+            return f'''
+                subgraph cluster_route_module_{mod.fullname.replace('.', '_')} {{
+                    tooltip="{mod.fullname}"
+                    color = "#666"
+                    style="rounded"
+                    label = "  {mod.name}"
+                    labeljust = "l"
+                    {inner_nodes_str}
+                    {child_str}
+                }}'''
+        if self.show_module:
+            module_routes = build_module_route_tree(routes)
+            module_routes_str = '\n'.join(render_module_route(m) for m in module_routes)
+            return module_routes_str
+        else:
+            return '\n'.join(render_route(r) for r in routes)
+
 
     def render_dot(self, tags: list[Tag], routes: list[Route], nodes: list[SchemaNode], links: list[Link], spline_line=False) -> str:
-        module_schemas = build_module_schema_tree(nodes)
-        module_routes = build_module_route_tree(routes)
 
         tag_str = '\n'.join([
             f'''
@@ -136,9 +151,8 @@ class Renderer:
             ];''' for t in tags
         ])
 
-
-        module_schemas_str = self.render_module_schema_content(module_schemas)
-        module_routes_str = '\n'.join(self.render_module_route(m) for m in module_routes)
+        module_routes_str = self.render_module_route_content(routes)
+        module_schemas_str = self.render_module_schema_content(nodes)
         link_str = '\n'.join(self.render_link(link) for link in links)
 
         dot_str = f'''

{fastapi_voyager-0.11.1 → fastapi_voyager-0.11.2}/src/fastapi_voyager/server.py

@@ -33,6 +33,7 @@ class Payload(BaseModel):
 	show_meta: bool = False
 	brief: bool = False
 	hide_primitive_route: bool = False
+	show_module: bool = True
 
 
 def create_route(
@@ -77,6 +78,7 @@ def create_route(
 			module_color=module_color,
 			route_name=payload.route_name,
 			hide_primitive_route=payload.hide_primitive_route,
+			show_module=payload.show_module,
 		)
 		voyager.analysis(target_app)
 		if payload.brief:

{fastapi_voyager-0.11.1 → fastapi_voyager-0.11.2}/src/fastapi_voyager/version.py

@@ -1,2 +1,2 @@
 __all__ = ["__version__"]
-__version__ = "0.11.1"
+__version__ = "0.11.2"

{fastapi_voyager-0.11.1 → fastapi_voyager-0.11.2}/src/fastapi_voyager/voyager.py

@@ -27,6 +27,7 @@ class Voyager:
             module_color: dict[str, str] | None = None,
             route_name: str | None = None,
             hide_primitive_route: bool = False,
+            show_module: bool = True
         ):
 
         self.routes: list[Route] = []
@@ -48,6 +49,7 @@ class Voyager:
         self.module_color = module_color or {}
         self.route_name = route_name
         self.hide_primitive_route = hide_primitive_route
+        self.show_module = show_module
     
 
     def _get_available_route(self, app: FastAPI):
@@ -301,7 +303,7 @@ class Voyager:
             node_set=self.node_set,
         )
 
-        renderer = Renderer(show_fields=self.show_fields, module_color=self.module_color, schema=self.schema)
+        renderer = Renderer(show_fields=self.show_fields, module_color=self.module_color, schema=self.schema, show_module=self.show_module)
 
         _tags, _routes, _links = self.handle_hide(_tags, _routes, _links)
         return renderer.render_dot(_tags, _routes, _nodes, _links)
@@ -326,7 +328,7 @@ class Voyager:
             links=_links,
         )
 
-        renderer = Renderer(show_fields=self.show_fields, module_color=self.module_color, schema=self.schema)
+        renderer = Renderer(show_fields=self.show_fields, module_color=self.module_color, schema=self.schema, show_module=self.show_module)
 
         _tags, _routes, _links = self.handle_hide(_tags, _routes, _links)
         return renderer.render_dot(_tags, _routes, _nodes, _links, True)
@@ -350,7 +352,7 @@ class Voyager:
             links=_links,
         )
 
-        renderer = Renderer(show_fields=self.show_fields, module_color=self.module_color, schema=self.schema)
+        renderer = Renderer(show_fields=self.show_fields, module_color=self.module_color, schema=self.schema, show_module=self.show_module)
 
         _tags, _routes, _links = self.handle_hide(_tags, _routes, _links)
         return renderer.render_dot(_tags, _routes, _nodes, _links, True)

{fastapi_voyager-0.11.1 → fastapi_voyager-0.11.2}/src/fastapi_voyager/web/index.html

@@ -148,6 +148,7 @@
           side="right"
           style="border-left: 1px solid #888;"
           bordered
+          overlay
         >
           <!-- 可拖拽的调整栏 -->
           <div 
@@ -265,32 +266,44 @@
               <div style="position: relative; width: 100%; height: 100%;">
                 <div id="graph" class="adjust-fit"></div>
                 <div style="position: absolute; left: 8px; bottom: 8px; z-index: 10; background: rgba(255,255,255,0.85); border-radius: 4px; padding: 2px 8px;">
-                  <div>
+                  <div class="q-mt-sm">
                     <q-toggle
                       v-model="state.focus"
                       v-show="schemaCodeName"
                       @update:model-value="val => onFocusChange(val)"
                       label="Focus"
+                      dense
                       title="pick a schema and toggle focus on to display related nodes only"
                     />
                   </div>
-                  <div>
+                  <div class="q-mt-sm">
                     <q-toggle
                       v-if="state.enableBriefMode"
+                      dense
                       v-model="state.brief"
                       label="Brief Mode"
                       @update:model-value="(val) => toggleBrief(val)"
                       title="skip middle classes, config module_prefix to enable it"
                     />
                   </div>
-                  <div>
+                  <div class="q-mt-sm">
                     <q-toggle
                       v-model="state.hidePrimitiveRoute"
                       @update:model-value="(val) => toggleHidePrimitiveRoute(val)"
                       label="Hide Primitive"
+                      dense
                       title="hide routes return primitive"
                     />
                   </div>
+                  <div class="q-mt-sm">
+                    <q-toggle
+                      v-model="state.showModule"
+                      @update:model-value="(val) => toggleShowModule(val)"
+                      label="Show Module Cluster"
+                      dense
+                      title="show module cluster"
+                    />
+                  </div>
                 </div>
               </div>
             </template>

{fastapi_voyager-0.11.1 → fastapi_voyager-0.11.2}/src/fastapi_voyager/web/vue-main.js

@@ -34,6 +34,7 @@ const app = createApp({
       detailDrawer: false,
       drawerWidth: 300, // drawer 宽度
       version: "", // version from backend
+      showModule: true
     });
 
     const showDetail = ref(false);
@@ -112,6 +113,7 @@ const app = createApp({
           show_fields: state.showFields,
           brief: state.brief,
           hide_primitive_route: state.hidePrimitiveRoute,
+          show_module: state.showModule,
         };
         const res = await fetch("dot", {
           method: "POST",
@@ -261,6 +263,11 @@ const app = createApp({
       onGenerate();
     }
 
+    function toggleShowModule(val) {
+      state.showModule = val;
+      onGenerate()
+    }
+
     function toggleShowField(field) {
       state.showFields = field;
       onGenerate(false);
@@ -337,6 +344,7 @@ const app = createApp({
       toggleShowField,
       startDragDrawer,
       onFocusChange,
+      toggleShowModule
     };
   },
 });