fastapi-voyager 0.13.1__py3-none-any.whl → 0.13.3__py3-none-any.whl

fastapi_voyager/er_diagram.py

@@ -70,7 +70,7 @@ class DiagramRenderer:
     def render_link(self, link: Link) -> str:
         h = self._handle_schema_anchor
         if link.type == 'schema':
-            return f"""{h(link.source)}:e -> {h(link.target)}:w [style = "solid", label = "{link.label}", minlen=3];"""
+            return f"""{h(link.source)}:e -> {h(link.target)}:w [style = "{link.style}", label = "{link.label}", minlen=3];"""
         else:
             raise ValueError(f'Unknown link type: {link.type}')
 
@@ -154,6 +154,7 @@ class VoyagerErDiagram:
                  er_diagram: ErDiagram, 
                  show_fields: FieldType = 'single',
                  show_module: bool = False):
+
         self.er_diagram = er_diagram
         self.nodes: list[SchemaNode] = []
         self.node_set: dict[str, SchemaNode] = {}
@@ -186,7 +187,9 @@ class VoyagerErDiagram:
                         target=self.generate_node_head(full_class_name(anno)),
                         target_origin=full_class_name(anno),
                         type='schema',
-                        label=get_type_name(relationship.target_kls))
+                        label=get_type_name(relationship.target_kls),
+                        style='solid' if relationship.loader else 'solid, dashed'
+                        )
 
                 elif isinstance(relationship, MultipleRelationship):
                     for link in relationship.links:
@@ -197,7 +200,8 @@ class VoyagerErDiagram:
                             target_origin=full_class_name(anno),
                             type='schema',
                             biz=link.biz,
-                            label=f'{get_type_name(relationship.target_kls)} / {link.biz} '
+                            label=f'{get_type_name(relationship.target_kls)} / {link.biz} ',
+                            style='solid' if link.loader else 'solid, dashed'
                         )
 
     def add_to_node_set(self, schema, fk_set: set[str] | None = None) -> str:
@@ -226,6 +230,7 @@ class VoyagerErDiagram:
             target_origin: str,
             type: LinkType,
             label: str,
+            style: str,
             biz: str | None = None
         ) -> bool:
         """
@@ -241,7 +246,8 @@ class VoyagerErDiagram:
                 target=target,
                 target_origin=target_origin,
                 type=type,
-                label=label
+                label=label,
+                style=style
             ))
         return result
 

fastapi_voyager/type.py

@@ -16,6 +16,7 @@ class FieldInfo:
     from_base: bool = False
     is_object: bool = False
     is_exclude: bool = False
+    desc: str = ''
 
 @dataclass
 class Tag(NodeBase):
@@ -68,6 +69,7 @@ class Link:
     target_origin: str
     type: LinkType
     label: str | None = None
+    style: str | None = None
 
 FieldType = Literal['single', 'object', 'all']
 PK = "PK"

fastapi_voyager/type_helper.py

@@ -182,7 +182,8 @@ def get_pydantic_fields(schema: type[BaseModel], bases_fields: set[str]) -> list
             name=k,
             from_base=k in bases_fields,
             type_name=get_type_name(anno),
-            is_exclude=bool(v.exclude)
+            is_exclude=bool(v.exclude),
+            desc=v.description or ''
         ))
     return fields
 

fastapi_voyager/version.py

@@ -1,2 +1,2 @@
 __all__ = ["__version__"]
-__version__ = "0.13.1"
+__version__ = "0.13.3"

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

@@ -179,6 +179,7 @@ export default defineComponent({
                 <tr>
                   <th style="text-align:left; border-bottom:1px solid #ddd; padding:4px 6px;">Field</th>
                   <th style="text-align:left; border-bottom:1px solid #ddd; padding:4px 6px;">Type</th>
+                  <th style="text-align:left; border-bottom:1px solid #ddd; padding:4px 6px;">Description</th>
                   <th style="text-align:left; border-bottom:1px solid #ddd; padding:4px 6px;">Inherited</th>
                 </tr>
               </thead>
@@ -186,6 +187,7 @@ export default defineComponent({
                 <tr v-for="f in fields" :key="f.name">
                   <td style="padding:4px 6px; border-bottom:1px solid #f0f0f0;">{{ f.name }}</td>
                   <td style="padding:4px 6px; border-bottom:1px solid #f0f0f0; white-space:nowrap;">{{ f.type_name }}</td>
+                  <td style="padding:4px 6px; border-bottom:1px solid #f0f0f0; max-width: 200px;">{{ f.desc }}</td>
                   <td style="padding:4px 6px; border-bottom:1px solid #f0f0f0; text-align:left;">{{ f.from_base ? '✔︎' : '' }}</td>
                 </tr>
                 <tr v-if="!fields.length">

{fastapi_voyager-0.13.1.dist-info → fastapi_voyager-0.13.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fastapi-voyager
-Version: 0.13.1
+Version: 0.13.3
 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
@@ -35,11 +35,12 @@ Visualize your FastAPI endpoints, and explore them interactively.
 
 > This repo is still in early stage, it supports pydantic v2 only
 
-[live demo](https://www.newsyeah.fun/voyager/) of project: [composition oriented development pattern](https://github.com/allmonday/composition-oriented-development-pattern)
+visit [live demo](https://www.newsyeah.fun/voyager/) 
+source code:[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" />
+<img width="1597" height="933" alt="image" src="https://github.com/user-attachments/assets/020bf5b2-6c69-44bf-ba1f-39389d388d27" />
 
-with configuration:
+with simple configuration it can be embedded into FastAPI.
 
 ```python
 app.mount('/voyager', 
@@ -67,6 +68,8 @@ pip install fastapi-voyager
 uv add fastapi-voyager
 ```
 
+run with cli:
+
 ```shell
 voyager -m path.to.your.app.module --server
 ```
@@ -77,47 +80,81 @@ voyager -m path.to.your.app.module --server
 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.
+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
 
-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" />
 
-### 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" />
+### 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" />
+
 
 
 ## Command Line Usage

{fastapi_voyager-0.13.1.dist-info → fastapi_voyager-0.13.3.dist-info}/RECORD

@@ -1,13 +1,13 @@
 fastapi_voyager/__init__.py,sha256=kqwzThE1YhmQ_7jPKGlnWvqRGC-hFrRqq_lKhKaleYU,229
 fastapi_voyager/cli.py,sha256=td3yIIigEomhSdDO-Xkh-CgpEwCafwlwnpvxnT9QsBo,10488
-fastapi_voyager/er_diagram.py,sha256=I-Fo03FMHu5INYeeycsdECN0oh7LroDHD88YlHwwUGA,10136
+fastapi_voyager/er_diagram.py,sha256=cMiNKk4ufSM147ldvvfdqfv34Q5mj533VcELsp4Gwwc,10384
 fastapi_voyager/filter.py,sha256=AN_HIu8-DtKisIq5mFt7CnqRHtxKewedNGyyaI82hSY,11529
 fastapi_voyager/module.py,sha256=h9YR3BpS-CAcJW9WCdVkF4opqwY32w9T67g9GfdLytk,3425
 fastapi_voyager/render.py,sha256=O_HR8ypOrFhjejkBpKIH_8foB78DgzH0hvO-CWeYt0w,9976
 fastapi_voyager/server.py,sha256=UZi-VdsurjDnqDgf3l5LfgWfZ4OxzilC_A_Ju6x9jQc,8592
-fastapi_voyager/type.py,sha256=uniDpmNSf6r-5qoGVkOP6-k0kxxJyUvXsEBgW5sDFKg,1779
-fastapi_voyager/type_helper.py,sha256=UTCFWluFeGdGkJX3wiE_bZ2EgZsu4JkmqHjsJVdG81Q,9953
-fastapi_voyager/version.py,sha256=XPQT-MiS5izc8d6XhjxYtP7l6JRWW4h0BgwR0e2ndGo,49
+fastapi_voyager/type.py,sha256=SPKEe0CrD4B4iB-lFQ9-wP6jXrO4rSMoU4p5uxbGcU4,1827
+fastapi_voyager/type_helper.py,sha256=hRk1ssjimZwETQ-rRII1-4ReJO_vpsnQtamcZKOA2Gg,9991
+fastapi_voyager/version.py,sha256=G1nfVjtIW-gYs-xjE2TKGW-IoBvxU-80bK_VtkMtqE8,49
 fastapi_voyager/voyager.py,sha256=iWt-_QsoKavhb9ZawhU3W8gv3vTwn8PWTevg8BooyV8,13923
 fastapi_voyager/web/graph-ui.js,sha256=hTsZO1Ly1JuoRg0kZWQ62jeLiD2kbnzACfbSPd0F95U,6634
 fastapi_voyager/web/graphviz.svg.css,sha256=zDCjjpT0Idufu5YOiZI76PL70-avP3vTyzGPh9M85Do,1563
@@ -20,7 +20,7 @@ fastapi_voyager/web/vue-main.js,sha256=BqFfjKRj1b2_nmR0Jmd2pL59Zk6qesrTNjRPpDRYM
 fastapi_voyager/web/component/demo.js,sha256=bQb16Un4XZ3Mf8qL6gvyrXe_mmA3V3mSIRMQAWg2MNk,352
 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=qKUMV2RFQzR8deof2iC4vyp65UaWadtVsDAXjY-i3vE,7042
+fastapi_voyager/web/component/schema-code-display.js,sha256=E4XiX0ahPxQhvPhZxe_uAbm5FdZYJiml3UAfvIRyrBw,7269
 fastapi_voyager/web/icon/android-chrome-192x192.png,sha256=35sBy6jmUFJCcquStaafHH1qClZIbd-X3PIKSeLkrNo,37285
 fastapi_voyager/web/icon/android-chrome-512x512.png,sha256=eb2eDjCwIruc05029_0L9hcrkVkv8KceLn1DJMYU0zY,210789
 fastapi_voyager/web/icon/apple-touch-icon.png,sha256=gnWK46tPnvSw1-oYZjgI02wpoO4OrIzsVzGHC5oKWO0,33187
@@ -28,8 +28,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.13.1.dist-info/METADATA,sha256=9MgyRS-Az5198n87XhUnHLF6xgkghGxBeCM6TRmCitE,6521
-fastapi_voyager-0.13.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-fastapi_voyager-0.13.1.dist-info/entry_points.txt,sha256=pEIKoUnIDXEtdMBq8EmXm70m16vELIu1VPz9-TBUFWM,53
-fastapi_voyager-0.13.1.dist-info/licenses/LICENSE,sha256=lNVRR3y_bFVoFKuK2JM8N4sFaj3m-7j29kvL3olFi5Y,1067
-fastapi_voyager-0.13.1.dist-info/RECORD,,
+fastapi_voyager-0.13.3.dist-info/METADATA,sha256=1jDBavGvAX72SPLnwkZKTlf9G0rv-gkN6J5bCVImAWQ,7777
+fastapi_voyager-0.13.3.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+fastapi_voyager-0.13.3.dist-info/entry_points.txt,sha256=pEIKoUnIDXEtdMBq8EmXm70m16vELIu1VPz9-TBUFWM,53
+fastapi_voyager-0.13.3.dist-info/licenses/LICENSE,sha256=lNVRR3y_bFVoFKuK2JM8N4sFaj3m-7j29kvL3olFi5Y,1067
+fastapi_voyager-0.13.3.dist-info/RECORD,,