fastapi-voyager 0.11.10__py3-none-any.whl → 0.12.1__py3-none-any.whl

fastapi_voyager/cli.py

@@ -1,15 +1,18 @@
 """Command line interface for fastapi-voyager."""
 import argparse
-import sys
-import importlib.util
 import importlib
+import importlib.util
+import logging
 import os
+import sys
 from typing import Optional
 
 from fastapi import FastAPI
-from fastapi_voyager.voyager import Voyager
-from fastapi_voyager.version import __version__
 from fastapi_voyager import server as viz_server
+from fastapi_voyager.version import __version__
+from fastapi_voyager.voyager import Voyager
+
+logger = logging.getLogger(__name__)
 
 
 def load_fastapi_app_from_file(module_path: str, app_name: str = "app") -> Optional[FastAPI]:
@@ -22,7 +25,7 @@ def load_fastapi_app_from_file(module_path: str, app_name: str = "app") -> Optio
         # Load the module
         spec = importlib.util.spec_from_file_location("app_module", module_path)
         if spec is None or spec.loader is None:
-            print(f"Error: Could not load module from {module_path}")
+            logger.error(f"Could not load module from {module_path}")
             return None
             
         module = importlib.util.module_from_spec(spec)
@@ -34,15 +37,13 @@ def load_fastapi_app_from_file(module_path: str, app_name: str = "app") -> Optio
             app = getattr(module, app_name)
             if isinstance(app, FastAPI):
                 return app
-            else:
-                print(f"Error: '{app_name}' is not a FastAPI instance")
-                return None
-        else:
-            print(f"Error: No attribute '{app_name}' found in the module")
+            logger.error(f"'{app_name}' is not a FastAPI instance")
             return None
+        logger.error(f"No attribute '{app_name}' found in the module")
+        return None
             
     except Exception as e:
-        print(f"Error loading FastAPI app: {e}")
+        logger.error(f"Error loading FastAPI app: {e}")
         return None
 
 
@@ -66,22 +67,20 @@ def load_fastapi_app_from_module(module_name: str, app_name: str = "app") -> Opt
                 app = getattr(module, app_name)
                 if isinstance(app, FastAPI):
                     return app
-                else:
-                    print(f"Error: '{app_name}' is not a FastAPI instance")
-                    return None
-            else:
-                print(f"Error: No attribute '{app_name}' found in module '{module_name}'")
+                logger.error(f"'{app_name}' is not a FastAPI instance")
                 return None
+            logger.error(f"No attribute '{app_name}' found in module '{module_name}'")
+            return None
         finally:
             # Cleanup: if we added the path, remove it
             if path_added and current_dir in sys.path:
                 sys.path.remove(current_dir)
             
     except ImportError as e:
-        print(f"Error: Could not import module '{module_name}': {e}")
+        logger.error(f"Could not import module '{module_name}': {e}")
         return None
     except Exception as e:
-        print(f"Error loading FastAPI app from module '{module_name}': {e}")
+        logger.error(f"Error loading FastAPI app from module '{module_name}': {e}")
         return None
 
 
@@ -110,9 +109,9 @@ def generate_visualization(
     # Optionally write to file
     with open(output_file, 'w', encoding='utf-8') as f:
         f.write(dot_content)
-    print(f"DOT file generated: {output_file}")
-    print("To render the graph, use: dot -Tpng router_viz.dot -o router_viz.png")
-    print("Or view online: https://dreampuf.github.io/GraphvizOnline/")
+    logger.info(f"DOT file generated: {output_file}")
+    logger.info("To render the graph, use: dot -Tpng router_viz.dot -o router_viz.png")
+    logger.info("Or view online: https://dreampuf.github.io/GraphvizOnline/")
 
 
 def main():
@@ -217,41 +216,30 @@ Examples:
         help="Filter by route id (format: <endpoint>_<path with _>)"
     )
     parser.add_argument(
-        "--demo",
-        action="store_true",
-        help="Run built-in demo (equivalent to: --module tests.demo --server --module_color=tests.service:blue --module_color=tests.demo:tomato)"
+        "--log-level",
+        dest="log_level",
+        default="INFO",
+        help="Logging level: DEBUG, INFO, WARNING, ERROR, CRITICAL (default: INFO)"
     )
     
     args = parser.parse_args()
     
-    # Handle demo mode: override module_name and defaults
-    if args.demo:
-        # Force module loading path
-        args.module_name = "tests.demo"
-        # Ensure server mode on
-        args.server = True
-        # Inject default module colors if absent / merge
-        demo_defaults = ["tests.service:blue", "tests.demo:tomato"]
-        existing = set(args.module_color or [])
-        for d in demo_defaults:
-            # only add if same key not already provided
-            key = d.split(":", 1)[0]
-            if not any(mc.startswith(key + ":") for mc in existing):
-                args.module_color = (args.module_color or []) + [d]
-
     if args.module_prefix and not args.server:
         parser.error("--module_prefix can only be used together with --server")
 
-    # Validate required target if not demo
-    if not args.demo and not (args.module_name or args.module):
-        parser.error("You must provide a module file, -m module name, or use --demo")
+    if not (args.module_name or args.module):
+        parser.error("You must provide a module file, -m module name")
+
+    # Configure logging based on --log-level
+    level_name = (args.log_level or "INFO").upper()
+    logging.basicConfig(level=level_name)
 
     # Load FastAPI app based on the input method (module_name takes precedence)
     if args.module_name:
         app = load_fastapi_app_from_module(args.module_name, args.app)
     else:
         if not os.path.exists(args.module):
-            print(f"Error: File '{args.module}' not found")
+            logger.error(f"File '{args.module}' not found")
             sys.exit(1)
         app = load_fastapi_app_from_file(args.module, args.app)
     
@@ -279,15 +267,15 @@ Examples:
             try:
                 import uvicorn
             except ImportError:
-                print("Error: uvicorn is required to run the server. Install via 'pip install uvicorn' or 'uv add uvicorn'.")
+                logger.info("uvicorn is required to run the server. Install via 'pip install uvicorn' or 'uv add uvicorn'.")
                 sys.exit(1)
             app_server = viz_server.create_voyager(
                 app,
                 module_color=module_color,
                 module_prefix=args.module_prefix,
             )
-            print(f"Starting preview server at http://{args.host}:{args.port} ... (Ctrl+C to stop)")
-            uvicorn.run(app_server, host=args.host, port=args.port)
+            logger.info(f"Starting preview server at http://{args.host}:{args.port} ... (Ctrl+C to stop)")
+            uvicorn.run(app_server, host=args.host, port=args.port, log_level=level_name.lower())
         else:
             # Generate and write dot file locally
             generate_visualization(
@@ -300,7 +288,7 @@ Examples:
                 route_name=args.route_name,
             )
     except Exception as e:
-        print(f"Error generating visualization: {e}")
+        logger.info(f"Error generating visualization: {e}")
         sys.exit(1)
 
 

fastapi_voyager/filter.py

@@ -236,7 +236,6 @@ def filter_subgraph_from_tag_to_schema_by_module_prefix(
     seen_pairs: set[tuple[str, str]] = set()
 
     for link in tag_route_links:
-        # print(link)
         tag_id = link.source_origin
         start_node_id = link.target_origin
         if tag_id is None or start_node_id is None:

fastapi_voyager/render.py

@@ -1,6 +1,9 @@
 from typing import Optional
 from fastapi_voyager.type import SchemaNode, ModuleNode, Link, Tag, Route, FieldType, PK, ModuleRoute
 from fastapi_voyager.module import build_module_schema_tree, build_module_route_tree
+from logging import getLogger
+
+logger = getLogger(__name__)
 
 
 class Renderer:
@@ -17,7 +20,10 @@ class Renderer:
         self.schema = schema
         self.show_module = show_module
 
-    def render_schema_label(self, node: SchemaNode) -> str:
+        logger.info(f'show_module: {self.show_module}')
+        logger.info(f'module_color: {self.module_color}')
+
+    def render_schema_label(self, node: SchemaNode, color: Optional[str]=None) -> str:
         has_base_fields = any(f.from_base for f in node.fields)
         fields = [n for n in node.fields if n.from_base is False]
 
@@ -38,7 +44,8 @@ class Renderer:
             field_str = f"""<tr><td align="left" port="f{field.name}" cellpadding="8"><font>  {display_xml}    </font></td></tr>"""
             fields_parts.append(field_str)
 
-        header_color = 'tomato' if node.id == self.schema else '#009485'
+        default_color = '#009485' if color is None else color
+        header_color = 'tomato' if node.id == self.schema else default_color
         header = f"""<tr><td cellpadding="6" bgcolor="{header_color}" align="center" colspan="1" port="{PK}"> <font color="white">    {node.name}    </font></td> </tr>"""
         field_content = ''.join(fields_parts) if fields_parts else ''
         return f"""<<table border="1" cellborder="0" cellpadding="0" bgcolor="white"> {header} {field_content}   </table>>"""
@@ -67,43 +74,56 @@ class Renderer:
             raise ValueError(f'Unknown link type: {link.type}')
 
     def render_module_schema_content(self, nodes: list[SchemaNode]) -> str:
-        def render_node(node: SchemaNode) -> str:
+        def render_node(node: SchemaNode, color: Optional[str]=None) -> str:
             return f'''
                 "{node.id}" [
-                    label = {self.render_schema_label(node)}
+                    label = {self.render_schema_label(node, color)}
                     shape = "plain"
                     margin="0.5,0.1"
                 ];'''
-        def render_module_schema(mod: ModuleNode) -> str:
-            color: Optional[str] = None
 
+        def render_module_schema(mod: ModuleNode, inherit_color: Optional[str]=None, show_cluster:bool=True) -> str:
+            color: Optional[str] = inherit_color
+
+            # recursively vist module from short to long:  'a', 'a.b', 'a.b.c'
+            # color_flag: {'a', 'a.b.c'}
+            # at first 'a', match 'a' -> color, remove 'a' from color_flag
+            # at 'a.b', no match
+            # at 'a.b.c', match 'a.b.c' -> color, remove 'a.b.c' from color_flag
             for k in module_color_flag:
-                if mod.fullname.startswith(k):
+                if mod.fullname.startswith(k):  
                     module_color_flag.remove(k)
                     color = self.module_color[k]
                     break
 
-            inner_nodes = [ render_node(node) for node in mod.schema_nodes ]
+            inner_nodes = [ render_node(node, color) 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'''
-                subgraph cluster_module_{mod.fullname.replace('.', '_')} {{
-                    tooltip="{mod.fullname}"
-                    color = "#666"
-                    style="rounded"
-                    label = "  {mod.name}"
-                    labeljust = "l"
-                    {(f'pencolor = "{color}"' if color else 'pencolor="#ccc"')}
-                    {(f'penwidth = 3' if color else 'penwidth=""')}
+            child_str = '\n'.join(render_module_schema(mod=m, inherit_color=color, show_cluster=show_cluster) for m in mod.modules)
+
+            if show_cluster:
+                return f'''
+                    subgraph cluster_module_{mod.fullname.replace('.', '_')} {{
+                        tooltip="{mod.fullname}"
+                        color = "#666"
+                        style="rounded"
+                        label = "  {mod.name}"
+                        labeljust = "l"
+                        {(f'pencolor = "{color}"' if color else 'pencolor="#ccc"')}
+                        {(f'penwidth = 3' if color else 'penwidth=""')}
+                        {inner_nodes_str}
+                        {child_str}
+                    }}'''
+            else:
+                return f'''
                     {inner_nodes_str}
                     {child_str}
-                }}'''
-        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)
+                '''
+
+        # 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(mod=m, show_cluster=self.show_module) for m in module_schemas)
+
     
     def render_module_route_content(self, routes: list[Route]) -> str:
         def render_route(route: Route) -> str:
@@ -115,29 +135,32 @@ class Renderer:
                     shape = "record"
                 ];'''
 
-        def render_module_route(mod: ModuleRoute) -> str:
+        def render_module_route(mod: ModuleRoute, show_cluster: bool=True) -> 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"
+            child_str = '\n'.join(render_module_route(m, show_cluster=show_cluster) for m in mod.modules)
+            if show_cluster:
+                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}
+                    }}'''
+            else:
+                return f'''
                     {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)
+                '''
+        module_routes = build_module_route_tree(routes)
+        module_routes_str = '\n'.join(render_module_route(m, show_cluster=self.show_module) for m in module_routes)
+        return module_routes_str
 
 
     def render_dot(self, tags: list[Tag], routes: list[Route], nodes: list[SchemaNode], links: list[Link], spline_line=False) -> str:

fastapi_voyager/server.py

@@ -57,6 +57,9 @@ def create_voyager(
 
 		# include tags and their routes
 		tags = voyager.tags
+		for t in tags:
+			t.routes.sort(key=lambda r: r.name)
+		tags.sort(key=lambda t: t.name)
 
 		schemas = voyager.nodes[:]
 		schemas.sort(key=lambda s: s.name)

fastapi_voyager/type_helper.py

@@ -1,4 +1,5 @@
 import inspect
+import logging
 import os
 from pydantic import BaseModel
 from typing import get_origin, get_args, Union, Annotated, Any, Type, Generic, Optional
@@ -6,6 +7,8 @@ from fastapi_voyager.type import FieldInfo
 from types import UnionType
 import pydantic_resolve.constant as const
 
+logger = logging.getLogger(__name__)
+
 # Python <3.12 compatibility: TypeAliasType exists only from 3.12 (PEP 695)
 try:  # pragma: no cover - import guard
     from typing import TypeAliasType  # type: ignore
@@ -228,12 +231,11 @@ def get_source(kls):
         return "failed to get source"
 
 
-def safe_issubclass(kls, classinfo):
+def safe_issubclass(kls, target_kls):
     try:
-        return issubclass(kls, classinfo)
+        return issubclass(kls, target_kls)
     except TypeError:
-        # may raise error for corner case such as ForwardRef
-        print(str(kls), 'is not a target class')  
+        logger.debug(f'{kls.__module__}:{kls.__qualname__} is not subclass of {target_kls.__module__}:{target_kls.__qualname__}')  
         return False
 
 

fastapi_voyager/version.py

@@ -1,2 +1,2 @@
 __all__ = ["__version__"]
-__version__ = "0.11.10"
+__version__ = "0.12.1"

fastapi_voyager/web/component/schema-code-display.js

@@ -157,6 +157,7 @@ export default defineComponent({
         <q-linear-progress indeterminate color="primary" size="2px"/>
       </div>
       <div class="q-ml-lg q-mt-md">
+        <p style="font-size: 16px;"> {{ schemaName }} </p>
         <a :href="link" target="_blank" rel="noopener" style="font-size:12px; color:#3b82f6;">
           Open in VSCode
         </a>

fastapi_voyager/web/graph-ui.js

@@ -58,9 +58,10 @@ export class GraphUI {
   }
 
   highlightSchemaBanner(node) {
-    const ele = node.querySelector("polygon[fill='#009485']")
+    const polygons = node.querySelectorAll("polygon");
+    const ele = polygons[2]; // select the second polygon
     if (ele) {
-      ele.setAttribute('fill', 'tomato');
+      ele.setAttribute('stroke-width', '3.5');
     }
   }
 
@@ -160,12 +161,6 @@ export class GraphUI {
               }
             }
           });
-
-        $(document).on("keydown.graphui", function (evt) {
-          if (evt.keyCode === 27 && self.gv) {
-            self.gv.highlight();
-          }
-        });
       },
     });
   }

fastapi_voyager/web/index.html

@@ -59,6 +59,9 @@
     .adjust-fit {
       height: calc(100vh - 54px);
     }
+
+    .github-corner:hover .octo-arm{animation:octocat-wave 560ms ease-in-out}@keyframes octocat-wave{0%,100%{transform:rotate(0)}20%,60%{transform:rotate(-25deg)}40%,80%{transform:rotate(10deg)}}@media (max-width:500px){.github-corner:hover .octo-arm{animation:none}.github-corner .octo-arm{animation:octocat-wave 560ms ease-in-out}}
+
     /* App boot loading overlay & gating */
     #app-loading-overlay {
       position: fixed;
@@ -167,9 +170,8 @@
                   </div>
                 </q-tooltip>
               </q-btn>
-            <a href="https://github.com/allmonday/fastapi-voyager" target="_blank" class="github-corner" aria-label="View source on GitHub"><svg width="52" height="52" viewBox="0 0 250 250" style="fill:#009485; color:#fff; position: absolute; top: 0; border: 0; right: 0;" aria-hidden="true"><path d="M0,0 L115,115 L130,115 L142,142 L250,250 L250,0 Z"/><path d="M128.3,109.0 C113.8,99.7 119.0,89.6 119.0,89.6 C122.0,82.7 120.5,78.6 120.5,78.6 C119.2,72.0 123.4,76.3 123.4,76.3 C127.3,80.9 125.5,87.3 125.5,87.3 C122.9,97.6 130.6,101.9 134.4,103.2" fill="currentColor" style="transform-origin: 130px 106px;" class="octo-arm"/><path d="M115.0,115.0 C114.9,115.1 118.7,116.5 119.8,115.4 L133.7,101.6 C136.9,99.2 139.9,98.4 142.2,98.6 C133.8,88.0 127.5,74.4 143.8,58.0 C148.5,53.4 154.0,51.2 159.7,51.0 C160.3,49.4 163.2,43.6 171.4,40.1 C171.4,40.1 176.1,42.5 178.8,56.2 C183.1,58.6 187.2,61.8 190.9,65.4 C194.5,69.0 197.7,73.2 200.1,77.6 C213.8,80.2 216.3,84.9 216.3,84.9 C212.7,93.1 206.9,96.0 205.4,96.6 C205.1,102.4 203.0,107.8 198.3,112.5 C181.9,128.9 168.3,122.5 157.7,114.1 C157.9,116.9 156.7,120.9 152.7,124.9 L141.0,136.5 C139.8,137.7 141.6,141.9 141.8,141.8 Z" fill="currentColor" class="octo-body"/></svg></a><style>.github-corner:hover .octo-arm{animation:octocat-wave 560ms ease-in-out}@keyframes octocat-wave{0%,100%{transform:rotate(0)}20%,60%{transform:rotate(-25deg)}40%,80%{transform:rotate(10deg)}}@media (max-width:500px){.github-corner:hover .octo-arm{animation:none}.github-corner .octo-arm{animation:octocat-wave 560ms ease-in-out}}</style></div>
-            <!-- <q-toolbar-title class="text-primary row">
-            </q-toolbar-title> -->
+            <a href="https://github.com/allmonday/fastapi-voyager" target="_blank" class="github-corner" aria-label="View source on GitHub"><svg width="52" height="52" viewBox="0 0 250 250" style="fill:#009485; color:#fff; position: absolute; top: 0; border: 0; right: 0;" aria-hidden="true"><path d="M0,0 L115,115 L130,115 L142,142 L250,250 L250,0 Z"/><path d="M128.3,109.0 C113.8,99.7 119.0,89.6 119.0,89.6 C122.0,82.7 120.5,78.6 120.5,78.6 C119.2,72.0 123.4,76.3 123.4,76.3 C127.3,80.9 125.5,87.3 125.5,87.3 C122.9,97.6 130.6,101.9 134.4,103.2" fill="currentColor" style="transform-origin: 130px 106px;" class="octo-arm"/><path d="M115.0,115.0 C114.9,115.1 118.7,116.5 119.8,115.4 L133.7,101.6 C136.9,99.2 139.9,98.4 142.2,98.6 C133.8,88.0 127.5,74.4 143.8,58.0 C148.5,53.4 154.0,51.2 159.7,51.0 C160.3,49.4 163.2,43.6 171.4,40.1 C171.4,40.1 176.1,42.5 178.8,56.2 C183.1,58.6 187.2,61.8 190.9,65.4 C194.5,69.0 197.7,73.2 200.1,77.6 C213.8,80.2 216.3,84.9 216.3,84.9 C212.7,93.1 206.9,96.0 205.4,96.6 C205.1,102.4 203.0,107.8 198.3,112.5 C181.9,128.9 168.3,122.5 157.7,114.1 C157.9,116.9 156.7,120.9 152.7,124.9 L141.0,136.5 C139.8,137.7 141.6,141.9 141.8,141.8 Z" fill="currentColor" class="octo-body"/></svg></a>
+          </div>
           </q-toolbar>
         </q-header>
 

fastapi_voyager/web/vue-main.js

@@ -59,6 +59,66 @@ const app = createApp({
       showDetail.value = false;
     }
 
+    function readQuerySelection() {
+      if (typeof window === "undefined") {
+        return { tag: null, route: null };
+      }
+      const params = new URLSearchParams(window.location.search);
+      return {
+        tag: params.get("tag") || null,
+        route: params.get("route") || null,
+      };
+    }
+
+    function findTagByRoute(routeId) {
+      return (
+        state.rawTags.find((tag) =>
+          (tag.routes || []).some((route) => route.id === routeId)
+        )?.name || null
+      );
+    }
+
+    function syncSelectionToUrl() {
+      if (typeof window === "undefined") {
+        return;
+      }
+      const params = new URLSearchParams(window.location.search);
+      if (state.tag) {
+        params.set("tag", state.tag);
+      } else {
+        params.delete("tag");
+      }
+      if (state.routeId) {
+        params.set("route", state.routeId);
+      } else {
+        params.delete("route");
+      }
+      const hash = window.location.hash || "";
+      const search = params.toString();
+      const base = window.location.pathname;
+      const newUrl = search ? `${base}?${search}${hash}` : `${base}${hash}`;
+      window.history.replaceState({}, "", newUrl);
+    }
+
+    function applySelectionFromQuery(selection) {
+      let applied = false;
+      if (selection.tag && state.rawTags.some((tag) => tag.name === selection.tag)) {
+        state.tag = selection.tag;
+        state._tag = selection.tag;
+        applied = true;
+      }
+      if (selection.route && state.routeItems?.[selection.route]) {
+        state.routeId = selection.route;
+        applied = true;
+        const inferredTag = findTagByRoute(selection.route);
+        if (inferredTag) {
+          state.tag = inferredTag;
+          state._tag = inferredTag;
+        }
+      }
+      return applied;
+    }
+
     async function loadInitial() {
       state.initializing = true;
       try {
@@ -82,6 +142,14 @@ const app = createApp({
         state.version = data.version || "";
         state.swaggerUrl = data.swagger_url || null
 
+        const querySelection = readQuerySelection();
+        const restoredFromQuery = applySelectionFromQuery(querySelection);
+        if (restoredFromQuery) {
+          syncSelectionToUrl();
+          onGenerate();
+          return;
+        }
+
         switch (data.initial_page_policy) {
           case "full":
             onGenerate()
@@ -246,6 +314,7 @@ const app = createApp({
       state.focus = false;
       schemaCodeName.value = "";
       onGenerate();
+      syncSelectionToUrl();
     }
 
     function toggleTag(tagName, expanded = null) {
@@ -262,6 +331,7 @@ const app = createApp({
 
       state.detailDrawer = false;
       showRouteDetail.value = false;
+      syncSelectionToUrl();
     }
 
     function selectRoute(routeId) {
@@ -275,6 +345,7 @@ const app = createApp({
       state.focus = false;
       schemaCodeName.value = "";
       onGenerate();
+      syncSelectionToUrl();
     }
 
     function toggleShowModule(val) {

fastapi_voyager-0.12.1.dist-info/METADATA

@@ -0,0 +1,183 @@
+Metadata-Version: 2.4
+Name: fastapi-voyager
+Version: 0.12.1
+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
+Author-email: Tangkikodo <allmonday@126.com>
+License: MIT
+License-File: LICENSE
+Keywords: fastapi,openapi,routing,visualization
+Classifier: Framework :: FastAPI
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+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
+Provides-Extra: dev
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
+Requires-Dist: uvicorn; extra == 'dev'
+Description-Content-Type: text/markdown
+
+[![pypi](https://img.shields.io/pypi/v/fastapi-voyager.svg)](https://pypi.python.org/pypi/fastapi-voyager)
+![Python Versions](https://img.shields.io/pypi/pyversions/fastapi-voyager)
+[![PyPI Downloads](https://static.pepy.tech/badge/fastapi-voyager/month)](https://pepy.tech/projects/fastapi-voyager)
+
+
+> This repo is still in early stage, it supports pydantic v2 only
+
+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)
+
+<img width="1600" height="986" alt="image" src="https://github.com/user-attachments/assets/8829cda0-f42d-4c84-be2f-b019bb5fe7e1" />
+
+## Installation
+
+```bash
+pip install fastapi-voyager
+# or
+uv add fastapi-voyager
+```
+
+```shell
+voyager -m path.to.your.app.module --server
+```
+
+> [Sub-Application mounts](https://fastapi.tiangolo.com/advanced/sub-applications/) are not supported yet, but you can specify the name of the FastAPI application used with `--app`. Only a single application (default: 'app') can be selected, but in a scenario where `api` is attached through `app.mount("/api", api)`, you can select `api` like this:
+
+```shell
+voyager -m path.to.your.app.module --server --app api
+```
+
+## 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")
+```
+
+## Features
+
+For scenarios of using FastAPI as internal API integration endpoints, `fastapi-voyager` helps to visualize the dependencies.
+
+It is also an architecture inspection tool that can identify issues in data relationships during design phase before turly implemtatioin.
+
+If the process of building the view model follows the ER model, the full potential of fastapi-voyager can be realized. It allows for quick identification of APIs  that use entities, as well as which entities are used by a specific API
+
+### highlight nodes and links
+click a node to highlight it's upperstream and downstream nodes. figure out the related models of one page, or homw many pages are related with one model.
+
+
+<img width="1100" height="700" alt="image" src="https://github.com/user-attachments/assets/3e0369ea-5fa4-469a-82c1-ed57d407e53d" />
+
+### focus on nodes
+
+Double click a node, and then toggle focus to hide irrelevant nodes.
+
+<img width="1061" height="937" alt="image" src="https://github.com/user-attachments/assets/79709b02-7571-43fc-abc9-17a287a97515" />
+
+### view source code
+
+double click a node or route to show source code or open file in vscode.
+
+<img width="1297" height="940" alt="image" src="https://github.com/user-attachments/assets/c8bb2e7d-b727-42a6-8c9e-64dce297d2d8" />
+
+<img width="1132" height="824" alt="image" src="https://github.com/user-attachments/assets/b706e879-e4fc-48dd-ace1-99bf97e3ed6a" />
+
+
+## Command Line Usage
+
+### open in browser
+
+```bash
+# open in browser
+voyager -m tests.demo --server  
+
+voyager -m tests.demo --server --port=8002
+```
+
+### generate the dot file
+```bash
+# generate .dot file
+voyager -m tests.demo  
+
+voyager -m tests.demo --app my_app
+
+voyager -m tests.demo --schema Task
+
+voyager -m tests.demo --show_fields all
+
+voyager -m tests.demo --module_color=tests.demo:red --module_color=tests.service:tomato
+
+voyager -m tests.demo -o my_visualization.dot
+
+voyager --version
+
+voyager --help
+```
+
+## About pydantic-resolve
+
+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 is a lightweight tool designed to build complex, nested data in a simple, declarative way. In version 2.0.0alpha, it will introduce an important feature: ER Diagram, and fastapi-voyager will support this feature, allowing for a clearer understanding of the business relationships between the data.
+
+Developers can use fastapi-voyager without needing to know anything about pydantic-resolve, but I still highly recommend everyone to give it a try.
+
+## Dependencies
+
+- FastAPI
+- [pydantic-resolve](https://github.com/allmonday/pydantic-resolve)
+- Quasar
+
+
+## Credits
+
+- https://apis.guru/graphql-voyager/, thanks for inspiration.
+- https://github.com/tintinweb/vscode-interactive-graphviz, thanks for web visualization.
+
+
+## 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`: main js
+
+backend: 
+- `voyager.py`: main entry
+- `render.py`: generate dot file
+- `server.py`: serve mode
+
+
+## Plan & Raodmap
+- [ideas](./docs/idea.md)
+- [changelog & roadmap](./docs/changelog.md)

{fastapi_voyager-0.11.10.dist-info → fastapi_voyager-0.12.1.dist-info}/RECORD

@@ -1,23 +1,23 @@
 fastapi_voyager/__init__.py,sha256=tZy0Nkj8kTaMgbvHy-mGxVcFGVX0Km-36dnzsAIG2uk,230
-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/cli.py,sha256=xK8DT-m2qP38FK2dGhLP-sHEuS29SBw6ACrnX9w85P0,10521
+fastapi_voyager/filter.py,sha256=9Y-NepveIiCLOI-5eXk6DNK9H3dr5_h4xUbWYHkbo7M,11552
 fastapi_voyager/module.py,sha256=Z2QHNmiLk6ZAJlm2nSmO875Q33TweSg8UxZSzIpU9zY,3499
-fastapi_voyager/render.py,sha256=vdwqIync2wsP8gMPY0v_XjRhdPBtbKyRT8yTBa_Ep3Y,8744
-fastapi_voyager/server.py,sha256=G48St-leUcEwshIhTYVotxuFWXDAvzjthOCK9AKh9dI,6497
+fastapi_voyager/render.py,sha256=8hVsEDQi2-aP3QKN6KI3RnNz0uG-FuDr_k4D7QNsdQQ,9823
+fastapi_voyager/server.py,sha256=XEWEfW02eha07piXfEOYeVC1lD6sMgzsCpRcNWgs_HE,6587
 fastapi_voyager/type.py,sha256=VmcTB1G-LOT70EWCzi4LU_FUkSGWUIBJX15T_J5HnOo,1764
-fastapi_voyager/type_helper.py,sha256=CxlUIDlM9fo2MP9UDPNkgFOYTeycBAVk3WRYanBMy6I,9448
-fastapi_voyager/version.py,sha256=-MakJnXzJx3P6EPKM_MRAeT0qupzHiUMfwjS2gq2lvY,50
+fastapi_voyager/type_helper.py,sha256=TqtYP2_54aar_iQjD0XhjJPXYhfi6icnPPrxkj0a4sk,9523
+fastapi_voyager/version.py,sha256=RTrsxEThIEJd6F22bbMAXSloKYEyLTUiKljxyyCXfjQ,49
 fastapi_voyager/voyager.py,sha256=nioo56oFDeZ8nwwPWDtaQbkpe4pVssFoBVHCWFhs0K4,13549
-fastapi_voyager/web/graph-ui.js,sha256=DTedkpZNbtufexONVkJ8mOwF_-VnvxoReYHtox6IKR4,5842
+fastapi_voyager/web/graph-ui.js,sha256=9ONPxQHvk4HxYq6KtKc_2VbJmUgd-gh7i3Biv1rkqC4,5734
 fastapi_voyager/web/graphviz.svg.css,sha256=zDCjjpT0Idufu5YOiZI76PL70-avP3vTyzGPh9M85Do,1563
 fastapi_voyager/web/graphviz.svg.js,sha256=lvAdbjHc-lMSk4GQp-iqYA2PCFX4RKnW7dFaoe0LUHs,16005
-fastapi_voyager/web/index.html,sha256=FJtx1_SiNq7tTMRXMKIx7zMInhEMCusw6VFTYBPtpak,19444
+fastapi_voyager/web/index.html,sha256=JgkoMbFTKuufSVVLs9_6mNP2_fDCrQPgTjN3EymBK3Y,19352
 fastapi_voyager/web/quasar.min.css,sha256=F5jQe7X2XT54VlvAaa2V3GsBFdVD-vxDZeaPLf6U9CU,203145
 fastapi_voyager/web/quasar.min.js,sha256=h0ftyPMW_CRiyzeVfQqiup0vrVt4_QWojpqmpnpn07E,502974
-fastapi_voyager/web/vue-main.js,sha256=D1H6UhwAlQta73shjZLmQAKbss7X2Y471fjC1H58p9g,11156
+fastapi_voyager/web/vue-main.js,sha256=m6U24ythzjQuAYXUm9BsTdFrApFNqW26B0Bf7TsybqQ,13275
 fastapi_voyager/web/component/render-graph.js,sha256=e8Xgh2Kl-nYU0P1gstEmAepCgFnk2J6UdxW8TlMafGs,2322
 fastapi_voyager/web/component/route-code-display.js,sha256=8NJPPjNRUC21gjpY8XYEQs4RBbhX1pCiqEhJp39ku6k,3678
-fastapi_voyager/web/component/schema-code-display.js,sha256=FjoD3CLl967VMfbZNQMdbiEnS0z-doLJDJIeDCmKGew,6983
+fastapi_voyager/web/component/schema-code-display.js,sha256=qKUMV2RFQzR8deof2iC4vyp65UaWadtVsDAXjY-i3vE,7042
 fastapi_voyager/web/component/schema-field-filter.js,sha256=c--XiXJrhIS7sYo1x8ZwMoqak0k9xLkNYTWoli-zd38,6253
 fastapi_voyager/web/icon/android-chrome-192x192.png,sha256=35sBy6jmUFJCcquStaafHH1qClZIbd-X3PIKSeLkrNo,37285
 fastapi_voyager/web/icon/android-chrome-512x512.png,sha256=eb2eDjCwIruc05029_0L9hcrkVkv8KceLn1DJMYU0zY,210789
@@ -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.10.dist-info/METADATA,sha256=X_RI_ODfUGnK0XWGptR1coXHtV4ojNMQiyyNJiBfzjk,10713
-fastapi_voyager-0.11.10.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-fastapi_voyager-0.11.10.dist-info/entry_points.txt,sha256=pEIKoUnIDXEtdMBq8EmXm70m16vELIu1VPz9-TBUFWM,53
-fastapi_voyager-0.11.10.dist-info/licenses/LICENSE,sha256=lNVRR3y_bFVoFKuK2JM8N4sFaj3m-7j29kvL3olFi5Y,1067
-fastapi_voyager-0.11.10.dist-info/RECORD,,
+fastapi_voyager-0.12.1.dist-info/METADATA,sha256=huz9XjY9D2KrxDQFgnq1ZJgANwmKZyT0qRRI9btk8uA,6060
+fastapi_voyager-0.12.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+fastapi_voyager-0.12.1.dist-info/entry_points.txt,sha256=pEIKoUnIDXEtdMBq8EmXm70m16vELIu1VPz9-TBUFWM,53
+fastapi_voyager-0.12.1.dist-info/licenses/LICENSE,sha256=lNVRR3y_bFVoFKuK2JM8N4sFaj3m-7j29kvL3olFi5Y,1067
+fastapi_voyager-0.12.1.dist-info/RECORD,,

fastapi_voyager-0.11.10.dist-info/METADATA

@@ -1,336 +0,0 @@
-Metadata-Version: 2.4
-Name: fastapi-voyager
-Version: 0.11.10
-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
-Author-email: Tangkikodo <allmonday@126.com>
-License: MIT
-License-File: LICENSE
-Keywords: fastapi,openapi,routing,visualization
-Classifier: Framework :: FastAPI
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-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
-Provides-Extra: dev
-Requires-Dist: pytest; extra == 'dev'
-Requires-Dist: ruff; extra == 'dev'
-Requires-Dist: uvicorn; extra == 'dev'
-Description-Content-Type: text/markdown
-
-[![pypi](https://img.shields.io/pypi/v/fastapi-voyager.svg)](https://pypi.python.org/pypi/fastapi-voyager)
-![Python Versions](https://img.shields.io/pypi/pyversions/fastapi-voyager)
-[![PyPI Downloads](https://static.pepy.tech/badge/fastapi-voyager/month)](https://pepy.tech/projects/fastapi-voyager)
-
-
-> This repo is still in early stage, it supports pydantic v2 only
-
-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)
-
-<img width="1600" height="986" alt="image" src="https://github.com/user-attachments/assets/8829cda0-f42d-4c84-be2f-b019bb5fe7e1" />
-
-## Installation
-
-```bash
-pip install fastapi-voyager
-# or
-uv add fastapi-voyager
-```
-
-```shell
-voyager -m path.to.your.app.module --server
-```
-
-> *sub_app* is not supported yet.
-
-
-## 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
-
-For scenarios of using FastAPI as internal API integration endpoints, `fastapi-voyager` helps to visualize the dependencies.
-
-It is also an architecture inspection tool that can identify issues in data relationships through visualization during the design phase.
-
-If the process of building the view model follows the ER model, the full potential of fastapi-voyager can be realized. It allows for quick identification of APIs  that use entities, as well as which entities are used by a specific API
-
-
-
-```shell
-git clone https://github.com/allmonday/fastapi-voyager.git
-cd fastapi-voyager
-
-voyager -m tests.demo 
-           --server --port=8001 
-           --module_color=tests.service:blue 
-           --module_color=tests.demo:tomato
-```
-
-### highlight
-click a node to highlight it's upperstream and downstream nodes. figure out the related models of one page, or homw many pages are related with one model.
-
-<img width="1100" height="700" alt="image" src="https://github.com/user-attachments/assets/3e0369ea-5fa4-469a-82c1-ed57d407e53d" />
-
-### focus on nodes
-toggle focus to hide nodes not related with current picked one.
-
-before: 
-<img width="1066" height="941" alt="image" src="https://github.com/user-attachments/assets/39f30817-899a-4289-93f4-a1646d3441c1" />
-after:
-<img width="1061" height="937" alt="image" src="https://github.com/user-attachments/assets/79709b02-7571-43fc-abc9-17a287a97515" />
-
-### view source code
-double click a node to show source code or open file in vscode.
-<img width="1297" height="940" alt="image" src="https://github.com/user-attachments/assets/c8bb2e7d-b727-42a6-8c9e-64dce297d2d8" />
-
-double click a route to show source code or open file in vscode
-<img width="1132" height="824" alt="image" src="https://github.com/user-attachments/assets/b706e879-e4fc-48dd-ace1-99bf97e3ed6a" />
-
-
-
-## Command Line Usage
-
-### open in browser
-
-```bash
-# open in browser
-voyager -m tests.demo --server  
-
-voyager -m tests.demo --server --port=8002
-```
-
-### generate the dot file
-```bash
-# generate .dot file
-voyager -m tests.demo  
-
-voyager -m tests.demo --app my_app
-
-voyager -m tests.demo --schema Task
-
-voyager -m tests.demo --show_fields all
-
-voyager -m tests.demo --module_color=tests.demo:red --module_color=tests.service:tomato
-
-voyager -m tests.demo -o my_visualization.dot
-
-voyager --version
-```
-
-The tool will generate a DOT file that you can render using Graphviz:
-
-```bash
-# Install graphviz
-brew install graphviz  # macOS
-apt-get install graphviz  # Ubuntu/Debian
-
-# Render the graph
-dot -Tpng router_viz.dot -o router_viz.png
-
-# Or view online at: https://dreampuf.github.io/GraphvizOnline/
-```
-
-or you can open router_viz.dot with vscode extension `graphviz interactive preview`
-
-
-## Plan before v1.0
-
-
-### backlog
-- [ ] user can generate nodes/edges manually and connect to generated ones
-    - [ ] eg: add owner
-    - [ ] add extra info for schema
-- [ ] display standard ER diagram `hard`
-    - [ ] display potential invalid links
-- [ ] optimize static resource (allow manually config url)
-- [ ] improve search dialog
-    - [ ] 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
-- [ ] animation effect for edges
-- [ ] customrized right click panel
-    - [ ] show own dependencies
-- [ ] sort field name
-- [ ] set max limit for fields
-- [ ] logging information
-
-### plan:
-#### <0.9:
-- [x] group schemas by module hierarchy
-- [x] module-based coloring via Analytics(module_color={...})
-- [x] view in web browser
-    - [x] config params
-    - [x] make a explorer dashboard, provide list of routes, schemas, to make it easy to switch and search
-- [x] support programmatic usage
-- [x] better schema /router node appearance
-- [x] hide fields duplicated with parent's (show `parent fields` instead)
-- [x] refactor the frontend to vue, and tweak the build process
-- [x] find dependency based on picked schema and it's field.
-- [x] optimize static resource (cdn -> local)
-- [x] add configuration for highlight (optional)
-- [x] alt+click to show field details
-- [x] display source code of routes (including response_model)
-- [x] handle excluded field 
-- [x] add tooltips
-- [x] route
-    - [x] group routes by module hierarchy
-    - [x] add response_model in route
-- [x] fixed left bar show tag/ route
-- [x] export voyager core data into json (for better debugging)
-    - [x] add api to rebuild core data from json, and render it
-- [x] fix Generic case  `test_generic.py`
-- [x] show tips for routes not return pydantic type.
-- [x] fix duplicated link from class and parent class, it also break clicking highlight
-- [x] refactor: abstract render module
-
-#### 0.9
-- [x] refactor: server.py
-    - [x] rename create_app_with_fastapi -> create_voyager
-    - [x] add doc for parameters
-- [x] improve initialization time cost
-    - [x] query route / schema info through realtime api
-    - [x] adjust fe
-- 0.9.3
-    - [x] adjust layout 
-        - [x] show field detail in right panel
-        - [x] show route info in bottom
-- 0.9.4
-    - [x] close schema sidebar when switch tag/route
-    - [x] schema detail panel show fields by default
-    - [x] adjust schema panel's height
-    - [x] show from base information in subset case
-- 0.9.5
-    - [x] route list should have a max height 
-
-#### 0.10
-- 0.10.1
-    - [x] refactor voyager.py tag -> route structure
-    - [x] fix missing route (tag has only one route which return primitive value)
-    - [x] make right panel resizable by dragging
-    - [x] allow closing tag expansion item
-    - [x] hide brief mode if not configured
-    - [x] add focus button to only show related nodes under current route/tag graph in dialog
-- 0.10.2
-    - [x] fix graph height
-    - [x] show version in title
-- 0.10.3
-    - [x] fix focus in brief-mode
-    - [x] ui: adjust focus position
-    - [x] refactor naming
-    - [x] fix layout issue when rendering huge graph
-- 0.10.4
-    - [x] fix: when focus is on, should ensure changes from other params not broken.
-- 0.10.5
-    - [x] double click to show details, and highlight as tomato
-    
-
-#### 0.11
-- 0.11.1
-    - [x] support opening route in swagger
-        - [x] config docs path
-    - [x] provide option to hide routes in brief mode (auto hide in full graph mode)
-- 0.11.2
-    - [x] enable/disable module cluster  (to save space)
-- 0.11.3
-    - [x] support online repo url
-- 0.11.4
-    - [x] add loading for field detail panel
-- 0.11.5
-    - [x] optimize open in swagger link
-    - [x] change jquery cdn
-- 0.11.6
-    - [x] flag of loading full graph in first render or not
-    - [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.11.10
-    - [x] fix bug during updating forward refs
-
-#### 0.12
-- [ ] add tests
-- [ ] integration with pydantic-resolve
-    - [ ] show hint for resolve, post fields
-    - [ ] display loader as edges
-
-#### 0.13
-- [ ] config release pipeline
-
-
-## About pydantic-resolve
-
-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 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
-
-- https://apis.guru/graphql-voyager/, thanks for inspiration.
-- https://github.com/tintinweb/vscode-interactive-graphviz, thanks for web visualization.
-
-
-## Dependencies
-
-- FastAPI
-- [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