fastapi-voyager 0.15.4__py3-none-any.whl → 0.15.6__py3-none-any.whl

fastapi_voyager/version.py

@@ -1,2 +1,2 @@
 __all__ = ["__version__"]
-__version__ = "0.15.4"
+__version__ = "0.15.6"

fastapi_voyager/web/graph-ui.js

@@ -1,4 +1,15 @@
 export class GraphUI {
+  // ====================
+  // Constants
+  // ====================
+
+  static HIGHLIGHT_COLOR = "#822dba"
+  static HIGHLIGHT_STROKE_WIDTH = "3.0"
+
+  // ====================
+  // Constructor
+  // ====================
+
   constructor(selector = "#graph", options = {}) {
     this.selector = selector
     this.options = options // e.g. { onSchemaClick: (name) => {} }
@@ -9,6 +20,10 @@ export class GraphUI {
     this._init()
   }
 
+  // ====================
+  // Highlight Methods
+  // ====================
+
   _highlight(mode = "bidirectional") {
     let highlightedNodes = $()
     for (const selection of this.currentSelection) {
@@ -68,49 +83,79 @@ export class GraphUI {
     return $result
   }
 
+  // ====================
+  // Schema Banner Methods
+  // ====================
+
   highlightSchemaBanner(node) {
-    // Get all polygons in the node
     const polygons = node.querySelectorAll("polygon")
-
-    // The first polygon is typically the outer frame of the entire node
     const outerFrame = polygons[0]
-    // The second polygon is typically the title background
     const titleBg = polygons[1]
 
     if (outerFrame) {
-      // Save original attributes for potential restoration
-      if (!outerFrame.hasAttribute("data-original-stroke")) {
-        outerFrame.setAttribute("data-original-stroke", outerFrame.getAttribute("stroke") || "")
-        outerFrame.setAttribute(
-          "data-original-stroke-width",
-          outerFrame.getAttribute("stroke-width") || "1"
-        )
-        outerFrame.setAttribute("data-original-fill", outerFrame.getAttribute("fill") || "")
-      }
-
-      // Apply bold purple border to the outer frame
-      outerFrame.setAttribute("stroke", "#822dba")
-      outerFrame.setAttribute("stroke-width", "3.0")
+      this._saveOriginalAttributes(outerFrame)
+      outerFrame.setAttribute("stroke", GraphUI.HIGHLIGHT_COLOR)
+      outerFrame.setAttribute("stroke-width", GraphUI.HIGHLIGHT_STROKE_WIDTH)
     }
 
     if (titleBg) {
-      // Save original attributes
-      if (!titleBg.hasAttribute("data-original-stroke")) {
-        titleBg.setAttribute("data-original-stroke", titleBg.getAttribute("stroke") || "")
-        titleBg.setAttribute(
-          "data-original-stroke-width",
-          titleBg.getAttribute("stroke-width") || "1"
-        )
-        titleBg.setAttribute("data-original-fill", titleBg.getAttribute("fill") || "")
-      }
+      this._saveOriginalAttributes(titleBg)
+      titleBg.setAttribute("fill", GraphUI.HIGHLIGHT_COLOR)
+      titleBg.setAttribute("stroke", GraphUI.HIGHLIGHT_COLOR)
+    }
+  }
 
-      // Apply purple background to title
-      titleBg.setAttribute("fill", "#822dba")
-      // Also update the stroke to match
-      titleBg.setAttribute("stroke", "#822dba")
+  clearSchemaBanners() {
+    if (this.gv) {
+      this.gv.highlight()
+    }
+
+    const allPolygons = document.querySelectorAll("polygon[data-original-stroke]")
+    allPolygons.forEach((polygon) => {
+      polygon.removeAttribute("data-original-stroke")
+      polygon.removeAttribute("data-original-stroke-width")
+      polygon.removeAttribute("data-original-fill")
+    })
+  }
+
+  _saveOriginalAttributes(element) {
+    if (!element.hasAttribute("data-original-stroke")) {
+      element.setAttribute("data-original-stroke", element.getAttribute("stroke") || "")
+      element.setAttribute(
+        "data-original-stroke-width",
+        element.getAttribute("stroke-width") || "1"
+      )
+      element.setAttribute("data-original-fill", element.getAttribute("fill") || "")
     }
   }
 
+  _applyNodeHighlight(node) {
+    const set = $()
+    set.push(node)
+    const obj = { set, direction: "bidirectional" }
+
+    this.clearSchemaBanners()
+    this.currentSelection = [obj]
+    this._highlight()
+
+    return obj
+  }
+
+  _triggerCallback(callbackName, schemaName) {
+    const callback = this.options[callbackName]
+    if (callback && schemaName) {
+      try {
+        callback(schemaName)
+      } catch (e) {
+        console.warn(`${callbackName} callback failed`, e)
+      }
+    }
+  }
+
+  // ====================
+  // Initialization & Events
+  // ====================
+
   _init() {
     const self = this
     $(this.selector).graphviz({
@@ -127,80 +172,64 @@ export class GraphUI {
 
         nodes.on("dblclick.graphui", function (event) {
           event.stopPropagation()
+
+          self._applyNodeHighlight(this)
+
           try {
             self.highlightSchemaBanner(this)
           } catch (e) {
             console.log(e)
           }
-          const set = $()
-          set.push(this)
-          const schemaName = event.currentTarget.dataset.name
-          if (schemaName) {
-            try {
-              self.options.onSchemaClick(schemaName)
-            } catch (e) {
-              console.warn("onSchemaClick callback failed", e)
-            }
-          }
+
+          self._triggerCallback("onSchemaClick", event.currentTarget.dataset.name)
         })
 
         edges.on("click.graphui", function (event) {
+          const [upStreamNode, downStreamNode] = event.currentTarget.dataset.name.split("->")
+          const nodes = self.gv.nodesByName()
+
           const up = $()
           const down = $()
           const edge = $()
-          const [upStreamNode, downStreamNode] = event.currentTarget.dataset.name.split("->")
-          const nodes = self.gv.nodesByName()
+
           up.push(nodes[upStreamNode])
           down.push(nodes[downStreamNode])
           edge.push(this)
-          const upObj = { set: up, direction: "upstream" }
-          const downObj = { set: down, direction: "downstream" }
-          const edgeOjb = { set: edge, direction: "single" }
-          self.currentSelection = [upObj, downObj, edgeOjb]
+
+          self.currentSelection = [
+            { set: up, direction: "upstream" },
+            { set: down, direction: "downstream" },
+            { set: edge, direction: "single" },
+          ]
 
           self._highlightEdgeNodes()
         })
 
         nodes.on("click.graphui", function (event) {
-          const set = $()
-          set.push(this)
-          const obj = { set, direction: "bidirectional" }
-
-          const schemaName = event.currentTarget.dataset.name
-          console.log("shift click detected")
-          if (event.shiftKey && self.options.onSchemaShiftClick) {
-            if (schemaName) {
-              try {
-                self.options.onSchemaShiftClick(schemaName)
-              } catch (e) {
-                console.warn("onSchemaShiftClick callback failed", e)
-              }
-            }
+          if (event.shiftKey) {
+            self._triggerCallback("onSchemaShiftClick", event.currentTarget.dataset.name)
           } else {
-            self.currentSelection = [obj]
-            self._highlight()
+            self._applyNodeHighlight(this)
           }
         })
 
         $(document)
           .off("click.graphui")
           .on("click.graphui", function (evt) {
-            // if outside container, do nothing
             const graphContainer = $(self.selector)[0]
             if (!graphContainer || !evt.target || !graphContainer.contains(evt.target)) {
               return
             }
 
-            let isNode = false
             const $everything = self.gv.$nodes.add(self.gv.$edges).add(self.gv.$clusters)
             const node = evt.target.parentNode
-            $everything.each(function () {
-              if (this === node) {
-                isNode = true
-              }
+            const isNode = $everything.is(function () {
+              return this === node
             })
+
             if (!isNode && self.gv) {
-              self.gv.highlight()
+              self.clearSchemaBanners()
+
               if (self.options.resetCb) {
                 self.options.resetCb()
               }
@@ -210,6 +239,10 @@ export class GraphUI {
     })
   }
 
+  // ====================
+  // Render Method
+  // ====================
+
   async render(dotSrc, resetZoom = true) {
     const height = this.options.height || "100%"
     return new Promise((resolve, reject) => {

fastapi_voyager/web/graphviz.svg.js

@@ -17,6 +17,13 @@
 
   GraphvizSvg.GVPT_2_PX = 32.5 // used to ease removal of extra space
 
+  // SVG element selectors for color manipulation
+  // NOTE: If you need to add more element types for highlighting/dimming,
+  // update SHAPE_ELEMENTS and the code will automatically handle them
+  GraphvizSvg.SHAPE_ELEMENTS = "polygon, ellipse, path, polyline"
+  GraphvizSvg.TEXT_ELEMENTS = "text"
+  GraphvizSvg.ALL_COLOR_ELEMENTS = GraphvizSvg.SHAPE_ELEMENTS + ", " + GraphvizSvg.TEXT_ELEMENTS
+
   GraphvizSvg.DEFAULTS = {
     url: null,
     svg: null,
@@ -178,8 +185,8 @@
       this.setInteractiveCursor($el, type === "edge")
     }
 
-    // save the colors of the paths, ellipses and polygons
-    $el.find("polygon, ellipse, path").each(function () {
+    // Save the colors of shape elements (polygon, ellipse, path, polyline)
+    $el.find(GraphvizSvg.SHAPE_ELEMENTS).each(function () {
       var $this = $(this)
       if ($this.attr("data-graphviz-hitbox") === "true") {
         return
@@ -196,6 +203,20 @@
       }
     })
 
+    // Save the colors of text elements
+    $el.find(GraphvizSvg.TEXT_ELEMENTS).each(function () {
+      var $this = $(this)
+      // text elements might not have explicit fill attribute, use black as default
+      var fill = $this.attr("fill")
+      if (!fill || fill === "none") {
+        fill = "#000000" // default black color for text
+      }
+      $this.data("graphviz.svg.color", {
+        fill: fill,
+        stroke: $this.attr("stroke"),
+      })
+    })
+
     // save the node name and check if theres a comment above; save it
     var $title = $el.children("title")
     if ($title[0]) {
@@ -404,6 +425,57 @@
     return retval
   }
 
+  // Helper function to apply color transformation to elements
+  GraphvizSvg.prototype._applyColorToElements = function (
+    $elements,
+    colorTransformer,
+    bgColor,
+    setStrokeWidth
+  ) {
+    var that = this
+    $elements.each(function () {
+      var $this = $(this)
+      if ($this.attr("data-graphviz-hitbox") === "true") {
+        return
+      }
+      var color = $this.data("graphviz.svg.color")
+      if (color) {
+        if (color.fill && color.fill != "none") {
+          $this.attr("fill", colorTransformer(color.fill, bgColor))
+        }
+        if (color.stroke && color.stroke != "none") {
+          $this.attr("stroke", colorTransformer(color.stroke, bgColor))
+        }
+        if (setStrokeWidth !== undefined) {
+          $this.attr("stroke-width", setStrokeWidth)
+        }
+      }
+    })
+  }
+
+  // Helper function to restore original colors
+  GraphvizSvg.prototype._restoreElementColors = function ($elements, setStrokeWidth) {
+    var that = this
+    $elements.each(function () {
+      var $this = $(this)
+      if ($this.attr("data-graphviz-hitbox") === "true") {
+        return
+      }
+      var color = $this.data("graphviz.svg.color")
+      if (color) {
+        if (color.fill && color.fill != "none") {
+          $this.attr("fill", color.fill)
+        }
+        if (color.stroke && color.stroke != "none") {
+          $this.attr("stroke", color.stroke)
+        }
+        if (setStrokeWidth !== undefined) {
+          $this.attr("stroke-width", setStrokeWidth)
+        }
+      }
+    })
+  }
+
   GraphvizSvg.prototype.findEdge = function (nodeName, testEdge, $retval) {
     var retval = []
     for (var name in this._edgesByName) {
@@ -439,37 +511,14 @@
 
   GraphvizSvg.prototype.colorElement = function ($el, getColor) {
     var bg = this.$element.css("background")
-    $el.find("polygon, ellipse, path").each(function () {
-      var $this = $(this)
-      if ($this.attr("data-graphviz-hitbox") === "true") {
-        return
-      }
-      var color = $this.data("graphviz.svg.color")
-      if (color.fill && color.fill != "none") {
-        $this.attr("fill", getColor(color.fill, bg)) // don't set  fill if it's a path
-      }
-      if (color.stroke && color.stroke != "none") {
-        $this.attr("stroke", getColor(color.stroke, bg))
-      }
-      $this.attr("stroke-width", 1.6)
-    })
+
+    // Apply color transformation to all elements (shapes + text)
+    this._applyColorToElements($el.find(GraphvizSvg.ALL_COLOR_ELEMENTS), getColor, bg)
   }
 
   GraphvizSvg.prototype.restoreElement = function ($el) {
-    $el.find("polygon, ellipse, path").each(function () {
-      var $this = $(this)
-      if ($this.attr("data-graphviz-hitbox") === "true") {
-        return
-      }
-      var color = $this.data("graphviz.svg.color")
-      if (color.fill && color.fill != "none") {
-        $this.attr("fill", color.fill) // don't set  fill if it's a path
-      }
-      if (color.stroke && color.stroke != "none") {
-        $this.attr("stroke", color.stroke)
-      }
-      $this.attr("stroke-width", 1)
-    })
+    // Restore original colors for all elements (shapes + text)
+    this._restoreElementColors($el.find(GraphvizSvg.ALL_COLOR_ELEMENTS), 1)
   }
 
   // methods users can actually call

fastapi_voyager/web/store.js

@@ -325,7 +325,7 @@ const actions = {
           onGenerate()
           return
         }
-        renderBasedOnInitialPolicy()
+        renderBasedOnInitialPolicy(onGenerate)
       }
 
       // default route options placeholder

fastapi_voyager-0.15.6.dist-info/METADATA

@@ -0,0 +1,303 @@
+Metadata-Version: 2.4
+Name: fastapi-voyager
+Version: 0.15.6
+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.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: jinja2>=3.0.0
+Requires-Dist: pydantic-resolve>=2.4.3
+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)
+
+
+# FastAPI Voyager
+
+Visualize your FastAPI endpoints and explore them interactively.
+
+Its vision is to make code easier to read and understand, serving as an ideal documentation tool.
+
+> This repo is still in early stage, it supports Pydantic v2 only.
+
+- **Live Demo**: https://www.newsyeah.fun/voyager/
+- **Example Source**: [composition-oriented-development-pattern](https://github.com/allmonday/composition-oriented-development-pattern)
+
+<img width="1597" height="933" alt="fastapi-voyager overview" src="https://github.com/user-attachments/assets/020bf5b2-6c69-44bf-ba1f-39389d388d27" />
+
+## Table of Contents
+
+- [Quick Start](#quick-start)
+- [Installation](#installation)
+- [Features](#features)
+- [Command Line Usage](#command-line-usage)
+- [About pydantic-resolve](#about-pydantic-resolve)
+- [Development](#development)
+- [Dependencies](#dependencies)
+- [Credits](#credits)
+
+## Quick Start
+
+With simple configuration, fastapi-voyager can be embedded into FastAPI:
+
+```python
+from fastapi import FastAPI
+from fastapi_voyager import create_voyager
+
+app = FastAPI()
+
+app.mount('/voyager',
+          create_voyager(
+            app,
+            module_color={'src.services': 'tomato'},
+            module_prefix='src.services',
+            swagger_url="/docs",
+            ga_id="G-XXXXXXXXVL",
+            initial_page_policy='first',
+            online_repo_url='https://github.com/allmonday/composition-oriented-development-pattern/blob/master',
+            enable_pydantic_resolve_meta=True))
+```
+
+Visit `http://localhost:8000/voyager` to explore your API visually.
+
+[View full example](https://github.com/allmonday/composition-oriented-development-pattern/blob/master/src/main.py#L48)
+
+## Installation
+
+### Install via pip
+
+```bash
+pip install fastapi-voyager
+```
+
+### Install via uv
+
+```bash
+uv add fastapi-voyager
+```
+
+### Run with CLI
+
+```bash
+voyager -m path.to.your.app.module --server
+```
+
+For sub-application scenarios (e.g., `app.mount("/api", api)`), specify the app name:
+
+```bash
+voyager -m path.to.your.app.module --server --app api
+```
+
+> **Note**: [Sub-Application mounts](https://fastapi.tiangolo.com/advanced/sub-applications/) are not supported yet, but you can specify the name of the FastAPI application with `--app`. Only a single application (default: `app`) can be selected.
+
+## Features
+
+fastapi-voyager is designed for scenarios using FastAPI as internal API integration endpoints. It helps visualize dependencies and serves as an architecture tool to identify implementation issues such as wrong relationships, overfetching, and more.
+
+**Best Practice**: When building view models following the ER model pattern, fastapi-voyager can fully realize its potential - quickly identifying which APIs use specific entities and vice versa.
+
+### Highlight Nodes and Links
+
+Click a node to highlight its upstream and downstream nodes. Figure out the related models of one page, or how many pages are related with one model.
+
+<img width="1100" height="700" alt="highlight nodes and dependencies" src="https://github.com/user-attachments/assets/3e0369ea-5fa4-469a-82c1-ed57d407e53d" />
+
+### View Source Code
+
+Double-click a node or route to show source code or open the file in VSCode.
+
+<img width="1297" height="940" alt="view source code" src="https://github.com/user-attachments/assets/c8bb2e7d-b727-42a6-8c9e-64dce297d2d8" />
+
+### Quick Search
+
+Search schemas by name and display their upstream and downstream dependencies. Use `Shift + Click` on any node to quickly search for it.
+
+<img width="1587" height="873" alt="quick search functionality" src="https://github.com/user-attachments/assets/ee4716f3-233d-418f-bc0e-3b214d1498f7" />
+
+### Display ER Diagram
+
+ER diagram is a feature from pydantic-resolve which provides a solid expression for business descriptions. You can visualize application-level entity relationship diagrams.
+
+```python
+from pydantic_resolve import ErDiagram, Entity, Relationship
+
+diagram = ErDiagram(
+    configs=[
+        Entity(
+            kls=Team,
+            relationships=[
+                Relationship(field='id', target_kls=list[Sprint], loader=sprint_loader.team_to_sprint_loader),
+                Relationship(field='id', target_kls=list[User], loader=user_loader.team_to_user_loader)
+            ]
+        ),
+        Entity(
+            kls=Sprint,
+            relationships=[
+                Relationship(field='id', target_kls=list[Story], loader=story_loader.sprint_to_story_loader)
+            ]
+        ),
+        Entity(
+            kls=Story,
+            relationships=[
+                Relationship(field='id', target_kls=list[Task], loader=task_loader.story_to_task_loader),
+                Relationship(field='owner_id', target_kls=User, loader=user_loader.user_batch_loader)
+            ]
+        ),
+        Entity(
+            kls=Task,
+            relationships=[
+                Relationship(field='owner_id', target_kls=User, loader=user_loader.user_batch_loader)
+            ]
+        )
+    ]
+)
+
+# Display in voyager
+app.mount('/voyager',
+          create_voyager(
+            app,
+            er_diagram=diagram
+          ))
+```
+
+<img width="1276" height="613" alt="ER diagram visualization" src="https://github.com/user-attachments/assets/ea0091bb-ee11-4f71-8be3-7129d956c910" />
+
+### Show Pydantic Resolve Meta Info
+
+Set `enable_pydantic_resolve_meta=True` in `create_voyager`, then toggle the "pydantic resolve meta" button to visualize resolve/post/expose/collect operations.
+
+<img width="1604" height="535" alt="pydantic resolve meta information" src="https://github.com/user-attachments/assets/d1639555-af41-4a08-9970-4b8ef314596a" />
+
+## Command Line Usage
+
+### Start Server
+
+```bash
+# Open in browser (default port 8000)
+voyager -m tests.demo --server
+
+# Custom port
+voyager -m tests.demo --server --port=8002
+
+# Specify app name
+voyager -m tests.demo --server --app my_app
+```
+
+### Generate DOT File
+
+```bash
+# Generate .dot file
+voyager -m tests.demo
+
+# Specify app
+voyager -m tests.demo --app my_app
+
+# Filter by schema
+voyager -m tests.demo --schema Task
+
+# Show all fields
+voyager -m tests.demo --show_fields all
+
+# Custom module colors
+voyager -m tests.demo --module_color=tests.demo:red --module_color=tests.service:tomato
+
+# Output to file
+voyager -m tests.demo -o my_visualization.dot
+
+# Version and help
+voyager --version
+voyager --help
+```
+
+## About pydantic-resolve
+
+pydantic-resolve is a lightweight tool designed to build complex, nested data in a simple, declarative way. In v2, it introduced an important feature: **ER Diagram**, and fastapi-voyager has supported this feature, allowing for a clearer understanding of business relationships.
+
+The ~~`@ensure_subset` decorator~~ `DefineSubset` metaclass helps safely pick fields from the 'source class' while **indicating the reference** from the current class to the base class.
+
+Developers can use fastapi-voyager without needing to know anything about pydantic-resolve, but I still highly recommend everyone to give it a try.
+
+## Development
+
+### Setup Development Environment
+
+```bash
+# Fork and clone the repository
+git clone https://github.com/your-username/fastapi-voyager.git
+cd fastapi-voyager
+
+# Install uv
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# Create virtual environment and install dependencies
+uv venv
+source .venv/bin/activate
+uv pip install ".[dev]"
+
+# Run development server
+uvicorn tests.programatic:app --reload
+```
+
+Visit `http://localhost:8000/voyager` to see changes.
+
+### Setup Git Hooks (Optional)
+
+Enable automatic code formatting before commits:
+
+```bash
+./setup-hooks.sh
+# or manually:
+git config core.hooksPath .githooks
+```
+
+This will run Prettier automatically before each commit. See [`.githooks/README.md`](./.githooks/README.md) for details.
+
+### Project Structure
+
+**Frontend:**
+- `src/fastapi_voyager/web/vue-main.js` - Main JavaScript entry
+
+**Backend:**
+- `voyager.py` - Main entry point
+- `render.py` - Generate DOT files
+- `server.py` - Server mode
+
+## Roadmap
+
+- [Ideas](./docs/idea.md)
+- [Changelog & Roadmap](./docs/changelog.md)
+
+## Dependencies
+
+- [FastAPI](https://fastapi.tiangolo.com/)
+- [pydantic-resolve](https://github.com/allmonday/pydantic-resolve)
+- [Quasar Framework](https://quasar.dev/)
+
+## Credits
+
+- [graphql-voyager](https://apis.guru/graphql-voyager/) - Thanks for inspiration
+- [vscode-interactive-graphviz](https://github.com/tintinweb/vscode-interactive-graphviz) - Thanks for web visualization
+
+## License
+
+MIT License

{fastapi_voyager-0.15.4.dist-info → fastapi_voyager-0.15.6.dist-info}/RECORD

@@ -9,7 +9,7 @@ fastapi_voyager/render_style.py,sha256=mPOuChEl71-3agCbPwkMt2sFmax2AEKDI6dK90eFP
 fastapi_voyager/server.py,sha256=E0gGU7D1pBvnV7gFLBUvnkwtiBFbU1PbxEXHHSIA1oA,9115
 fastapi_voyager/type.py,sha256=zluWvh5vpnjXJ9aAmyNJTSmXZPjAHCvgRT5oQRAjHrg,2104
 fastapi_voyager/type_helper.py,sha256=FmfrZAI3Z4uDdh3sH_kH7UGoY6yNVPapneSN86qY_wo,10209
-fastapi_voyager/version.py,sha256=AgJGrnhFIPGdn_tW4I4oEPuyTOgMXEkK0I5qVj2kag0,49
+fastapi_voyager/version.py,sha256=ILB2INUiq4EGupYfMT2L0gsR_3dHm9fPDuoUnU5BSf0,49
 fastapi_voyager/voyager.py,sha256=4vonmL-xt54C5San-DRBq4mjoV8Q96eoWRy68MJ1IJw,14169
 fastapi_voyager/templates/dot/cluster.j2,sha256=I2z9KkfCzmAtqXe0gXBnxnOfBXUSpdlATs3uf-O8_B8,307
 fastapi_voyager/templates/dot/cluster_container.j2,sha256=2tH1mOJvPoVKE_aHVMR3t06TfH_dYa9OeH6DBqSHt_A,204
@@ -24,13 +24,13 @@ fastapi_voyager/templates/html/pydantic_meta.j2,sha256=_tsSqjucs_QrAlPIVRy9u6I2-
 fastapi_voyager/templates/html/schema_field_row.j2,sha256=KfKexHO_QJV-OIJS0eiY_7fqA8031fWpD2g2wTv4BuE,111
 fastapi_voyager/templates/html/schema_header.j2,sha256=9WpuHLy3Zbv5GHG08qqaj5Xf-gaR-79ErBYuANZp7iA,179
 fastapi_voyager/templates/html/schema_table.j2,sha256=rzphiGk1il7uv4Gr2p_HLPHqyLZk63vLrGAmIduTdSE,117
-fastapi_voyager/web/graph-ui.js,sha256=4gEkXTgbA6CouD4IDMW5yKYfJTxHN2vL9G0CAr6w4qA,7662
+fastapi_voyager/web/graph-ui.js,sha256=9b2auyGWEpUcF65YV231GNojQ9Uk6FsT1SlRR3lSYnc,7664
 fastapi_voyager/web/graphviz.svg.css,sha256=K218ov_mdSe3ga4KwhiBB92ynVvm5zaAk9_D9a3d8hE,1546
-fastapi_voyager/web/graphviz.svg.js,sha256=deI815RgxpZ3_MpELeV-TBYy2MVuUvZtQOHfS3aeXHY,18203
+fastapi_voyager/web/graphviz.svg.js,sha256=VokgCghvP4zm3SFiFVPIikdW6XzjkZJXQkBbCrEitug,19885
 fastapi_voyager/web/index.html,sha256=wM9vJ_UfHR8p98F6SEMCKKjJcBEl0EyosWuPqVZYXvA,23496
 fastapi_voyager/web/quasar.min.css,sha256=F5jQe7X2XT54VlvAaa2V3GsBFdVD-vxDZeaPLf6U9CU,203145
 fastapi_voyager/web/quasar.min.js,sha256=h0ftyPMW_CRiyzeVfQqiup0vrVt4_QWojpqmpnpn07E,502974
-fastapi_voyager/web/store.js,sha256=7anY7HGF7aEx1xpXWz58Ca5WbnYCRnzdj7kqNjcaT_M,15103
+fastapi_voyager/web/store.js,sha256=vwiqeLw7DfTOUDu9oN7b6nSBw8KG6W-5Dc-voQ1leL8,15113
 fastapi_voyager/web/vue-main.js,sha256=4lJi6ADrcaOzjXcQePkp7CyiCkAnvhnO-nkF3E6G3s4,10650
 fastapi_voyager/web/component/demo.js,sha256=sAklFGhKGmMy9-ofgOw2oPIidAoIOgHu6yvV51L_MAA,350
 fastapi_voyager/web/component/render-graph.js,sha256=9wnO70n3eyPKTpa744idgs5PSwgvzbfv4InZ68eEOKs,2454
@@ -43,8 +43,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=GRozZ5suTykYcPMap1QhjrAB8PLW0mbT_phhzw_utvQ,316
-fastapi_voyager-0.15.4.dist-info/METADATA,sha256=6BftnkJpr0w8cKiAubLyJ6ZiOeGmvlkOwE9jZLZ5UMM,8513
-fastapi_voyager-0.15.4.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-fastapi_voyager-0.15.4.dist-info/entry_points.txt,sha256=pEIKoUnIDXEtdMBq8EmXm70m16vELIu1VPz9-TBUFWM,53
-fastapi_voyager-0.15.4.dist-info/licenses/LICENSE,sha256=lNVRR3y_bFVoFKuK2JM8N4sFaj3m-7j29kvL3olFi5Y,1067
-fastapi_voyager-0.15.4.dist-info/RECORD,,
+fastapi_voyager-0.15.6.dist-info/METADATA,sha256=D-09okYHB5uaatoDc5SqmOVr_jTbw18o4_76pmxO4_g,9870
+fastapi_voyager-0.15.6.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+fastapi_voyager-0.15.6.dist-info/entry_points.txt,sha256=pEIKoUnIDXEtdMBq8EmXm70m16vELIu1VPz9-TBUFWM,53
+fastapi_voyager-0.15.6.dist-info/licenses/LICENSE,sha256=lNVRR3y_bFVoFKuK2JM8N4sFaj3m-7j29kvL3olFi5Y,1067
+fastapi_voyager-0.15.6.dist-info/RECORD,,

fastapi_voyager-0.15.4.dist-info/METADATA

@@ -1,256 +0,0 @@
-Metadata-Version: 2.4
-Name: fastapi-voyager
-Version: 0.15.4
-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.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: jinja2>=3.0.0
-Requires-Dist: pydantic-resolve>=2.4.3
-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)
-
-
-Visualize your FastAPI endpoints, and explore them interactively.
-
-Its vision is to make code easier to read and understand, serving as an ideal documentation tool.
-
-> This repo is still in early stage, it supports pydantic v2 only
-
-visit [live demo](https://www.newsyeah.fun/voyager/) 
-source code:[composition oriented development pattern](https://github.com/allmonday/composition-oriented-development-pattern)
-
-<img width="1597" height="933" alt="image" src="https://github.com/user-attachments/assets/020bf5b2-6c69-44bf-ba1f-39389d388d27" />
-
-with simple configuration it can be embedded into FastAPI.
-
-```python
-app.mount('/voyager', 
-          create_voyager(
-            app, 
-            module_color={'src.services': 'tomato'}, 
-            module_prefix='src.services', 
-            swagger_url="/docs",
-            ga_id="G-XXXXXXXXVL",
-            initial_page_policy='first',
-            online_repo_url='https://github.com/allmonday/composition-oriented-development-pattern/blob/master',
-            enable_pydantic_resolve_meta=True))
-```
-
-https://github.com/allmonday/composition-oriented-development-pattern/blob/master/src/main.py#L48
-
-## Plan & Raodmap
-- [ideas](./docs/idea.md)
-- [changelog & roadmap](./docs/changelog.md)
-
-## Installation
-
-```bash
-pip install fastapi-voyager
-# or
-uv add fastapi-voyager
-```
-
-run with cli:
-
-```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
-```
-
-
-## Features
-
-For scenarios of using FastAPI as internal API integration endpoints, `fastapi-voyager` helps to visualize the dependencies.
-
-It is also an architecture tool that can identify issues inside implementation, finding out wrong relationships, overfetchs, or anything else.
-
-**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
-
-Given ErDiagram defined by pydantic-resolve, application level entity relationship diagram can be visualized too.
-
-
-### 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" />
-
-### 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" />
-
-### quick search
-
-seach schemas by name and dispaly it's upstream and downstreams.
-
-shift + click can quickly search current one
-
-<img width="1587" height="873" alt="image" src="https://github.com/user-attachments/assets/ee4716f3-233d-418f-bc0e-3b214d1498f7" />
-
-### display ER diagram
-
-ER diagram is a new feature from pydantic-resolve which provide a solid expression for business descritpions. 
-
-```python
-diagram = ErDiagram(
-    configs=[
-        Entity(
-            kls=Team,
-            relationships=[
-                Relationship( field='id', target_kls=list[Sprint], loader=sprint_loader.team_to_sprint_loader),
-                Relationship( field='id', target_kls=list[User], loader=user_loader.team_to_user_loader)
-            ]
-        ),
-        Entity(
-            kls=Sprint,
-            relationships=[
-                Relationship( field='id', target_kls=list[Story], loader=story_loader.sprint_to_story_loader)
-            ]
-        ),
-        Entity(
-            kls=Story,
-            relationships=[
-                Relationship( field='id', target_kls=list[Task], loader=task_loader.story_to_task_loader),
-                Relationship( field='owner_id', target_kls=User, loader=user_loader.user_batch_loader)
-            ]
-        ),
-        Entity(
-            kls=Task,
-            relationships=[
-                Relationship( field='owner_id', target_kls=User, loader=user_loader.user_batch_loader)
-            ]
-        )
-    ]
-)
-
-# display in voyager
-app.mount('/voyager', 
-          create_voyager(
-            app,
-            er_diagram=diagram)
-```
-
-<img width="1276" height="613" alt="image" src="https://github.com/user-attachments/assets/ea0091bb-ee11-4f71-8be3-7129d956c910" />
-
-### Show pydantic resolve meta info
-
-setting `enable_pydantic_resolve_meta=True` in `create_voyager`, toggle `pydantic resolve meta`. 
-
-<img width="1604" height="535" alt="image" src="https://github.com/user-attachments/assets/d1639555-af41-4a08-9970-4b8ef314596a" />
-
-
-## 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 is a lightweight tool designed to build complex, nested data in a simple, declarative way. In v2 it introduced an important feature: ER Diagram, and fastapi-voyager has supported this feature, allowing for a clearer understanding of the business relationships.
-
-pydantic-resolve's ~~`@ensure_subset` decorator~~ `DefineSubset` metaclass helps safely pick fields from the 'source class' while **indicating the reference** from the current class to the base class.
-
-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
-```
-
-### Setup Git Hooks (Optional)
-
-Enable automatic code formatting before commits:
-
-```shell
-./setup-hooks.sh
-# or manually:
-git config core.hooksPath .githooks
-```
-
-This will run Prettier automatically before each commit. See [`.githooks/README.md`](./.githooks/README.md) for details.
-
-open `localhost:8000/voyager`
-
-
-frontend:
-- `src/fastapi_voyager/web/vue-main.js`: main js
-
-backend:
-- `voyager.py`: main entry
-- `render.py`: generate dot file
-- `server.py`: serve mode