fastapi-voyager 0.8.3__py3-none-any.whl → 0.9.2__py3-none-any.whl

fastapi_voyager/__init__.py

@@ -3,3 +3,7 @@
 Utilities to introspect a FastAPI application and visualize its routing tree.
 """
 from .version import __version__  # noqa: F401
+
+from .server import create_voyager
+
+__all__ = ["__version__", "create_voyager"]

fastapi_voyager/cli.py

@@ -281,7 +281,7 @@ Examples:
             except ImportError:
                 print("Error: uvicorn is required to run the server. Install via 'pip install uvicorn' or 'uv add uvicorn'.")
                 sys.exit(1)
-            app_server = viz_server.create_app_with_fastapi(
+            app_server = viz_server.create_voyager(
                 app,
                 module_color=module_color,
                 module_prefix=args.module_prefix,

fastapi_voyager/server.py

@@ -6,23 +6,18 @@ from pydantic import BaseModel
 from fastapi.responses import HTMLResponse, PlainTextResponse, JSONResponse
 from fastapi.staticfiles import StaticFiles
 from fastapi_voyager.voyager import Voyager
-from fastapi_voyager.type import Tag, FieldInfo, CoreData
+from fastapi_voyager.type import Tag, FieldInfo, CoreData, SchemaNode
 from fastapi_voyager.render import Renderer
+from fastapi_voyager.type_helper import get_source, get_vscode_link
 
 
 WEB_DIR = Path(__file__).parent / "web"
 WEB_DIR.mkdir(exist_ok=True)
 
-class SchemaType(BaseModel):
-	name: str
-	fullname: str
-	source_code: str
-	vscode_link: str
-	fields: list[FieldInfo]
 
 class OptionParam(BaseModel):
 	tags: list[Tag]
-	schemas: list[SchemaType]
+	schemas: list[SchemaNode]
 	dot: str
 
 class Payload(BaseModel):
@@ -40,26 +35,22 @@ def create_route(
 	module_color: dict[str, str] | None = None,
 	module_prefix: Optional[str] = None,
 ):
+	"""
+	module_color: dict mapping module name to color string, e.g. {'models': 'lightblue'}
+	module_prefix: prefix string to define schemas show in brief mode
+	"""
 	router = APIRouter(tags=['fastapi-voyager'])
 
 	@router.get("/dot", response_model=OptionParam)
 	def get_dot() -> str:
-		voyager = Voyager(module_color=module_color, load_meta=True)
+		voyager = Voyager(module_color=module_color)
 		voyager.analysis(target_app)
 		dot = voyager.render_dot()
 
 		# include tags and their routes
 		tags = voyager.tags
 
-		schemas = [
-			SchemaType(
-				name=s.name,
-				fullname=s.id,
-				fields=s.fields,
-				source_code=s.source_code,
-				vscode_link=s.vscode_link
-			) for s in voyager.nodes
-		]
+		schemas = voyager.nodes[:]
 		schemas.sort(key=lambda s: s.name)
 
 		return OptionParam(tags=tags, schemas=schemas, dot=dot)
@@ -74,7 +65,6 @@ def create_route(
 			show_fields=payload.show_fields,
 			module_color=module_color,
 			route_name=payload.route_name,
-			load_meta=False,
 			hide_primitive_route=payload.hide_primitive_route,
 		)
 		voyager.analysis(target_app)
@@ -92,7 +82,6 @@ def create_route(
 			show_fields=payload.show_fields,
 			module_color=module_color,
 			route_name=payload.route_name,
-			load_meta=False,
 		)
 		voyager.analysis(target_app)
 		return voyager.dump_core_data()
@@ -117,11 +106,90 @@ def create_route(
 		</body>
 		</html>
 		"""
+	
+	class SourcePayload(BaseModel):
+		schema_name: str
 
+	@router.post("/source")
+	def get_object_by_module_name(payload: SourcePayload):
+		"""
+		input: __module__ + __name__, eg: tests.demo.PageStories
+		output: source code of the object
+		"""
+		try:
+			components = payload.schema_name.split('.')
+			if len(components) < 2:
+				return JSONResponse(
+					status_code=400, 
+					content={"error": "Invalid schema name format. Expected format: module.ClassName"}
+				)
+			
+			module_name = '.'.join(components[:-1])
+			class_name = components[-1]
+			
+			mod = __import__(module_name, fromlist=[class_name])
+			obj = getattr(mod, class_name)
+			source_code = get_source(obj)
+			
+			return JSONResponse(content={"source_code": source_code})
+		except ImportError as e:
+			return JSONResponse(
+				status_code=404,
+				content={"error": f"Module not found: {e}"}
+			)
+		except AttributeError as e:
+			return JSONResponse(
+				status_code=404,
+				content={"error": f"Class not found: {e}"}
+			)
+		except Exception as e:
+			return JSONResponse(
+				status_code=500,
+				content={"error": f"Internal error: {str(e)}"}
+			)
+
+	@router.post("/vscode-link")
+	def get_vscode_link_by_module_name(payload: SourcePayload):
+		"""
+		input: __module__ + __name__, eg: tests.demo.PageStories
+		output: source path of the object
+		"""
+		try:
+			components = payload.schema_name.split('.')
+			if len(components) < 2:
+				return JSONResponse(
+					status_code=400, 
+					content={"error": "Invalid schema name format. Expected format: module.ClassName"}
+				)
+			
+			module_name = '.'.join(components[:-1])
+			class_name = components[-1]
+			
+			mod = __import__(module_name, fromlist=[class_name])
+			obj = getattr(mod, class_name)
+			link = get_vscode_link(obj)
+			
+			return JSONResponse(content={"link": link})
+		except ImportError as e:
+			return JSONResponse(
+				status_code=404,
+				content={"error": f"Module not found: {e}"}
+			)
+		except AttributeError as e:
+			return JSONResponse(
+				status_code=404,
+				content={"error": f"Class not found: {e}"}
+			)
+		except Exception as e:
+			return JSONResponse(
+				status_code=500,
+				content={"error": f"Internal error: {str(e)}"}
+			)
+        
 	return router
 
 
-def create_app_with_fastapi(
+def create_voyager(
 	target_app: FastAPI,
 	module_color: dict[str, str] | None = None,
 	gzip_minimum_size: int | None = 500,

fastapi_voyager/type.py

@@ -22,8 +22,6 @@ class Tag(NodeBase):
 @dataclass
 class Route(NodeBase):
     module: str
-    source_code: str = ''
-    vscode_link: str = ''  # optional vscode deep link
     response_schema: str = ''
     is_primitive: bool = True
 
@@ -37,8 +35,6 @@ class ModuleRoute:
 @dataclass
 class SchemaNode(NodeBase):
     module: str
-    source_code: str = ''  # optional for tests / backward compatibility
-    vscode_link: str = ''  # optional vscode deep link
     fields: list[FieldInfo] = field(default_factory=list)
 
 @dataclass

fastapi_voyager/version.py

@@ -1,2 +1,2 @@
 __all__ = ["__version__"]
-__version__ = "0.8.3"
+__version__ = "0.9.2"

fastapi_voyager/voyager.py

@@ -29,7 +29,6 @@ class Voyager:
             module_color: dict[str, str] | None = None,
             route_name: str | None = None,
             hide_primitive_route: bool = False,
-            load_meta: bool = False
         ):
 
         self.routes: list[Route] = []
@@ -50,7 +49,6 @@ class Voyager:
         self.show_fields = show_fields if show_fields in ('single','object','all') else 'object'
         self.module_color = module_color or {}
         self.route_name = route_name
-        self.load_meta = load_meta
         self.hide_primitive_route = hide_primitive_route
     
 
@@ -85,7 +83,7 @@ class Voyager:
                 self.tags.append(tag_obj)
 
             # add route and create links
-            route_id = f'{route.endpoint.__name__}_{route.path.replace("/", "_")}'
+            route_id = full_class_name(route.endpoint)
             route_name = route.endpoint.__name__
             route_module = route.endpoint.__module__
 
@@ -110,8 +108,6 @@ class Voyager:
                 id=route_id,
                 name=route_name,
                 module=route_module,
-                vscode_link=get_vscode_link(route.endpoint) if self.load_meta else '',
-                source_code=inspect.getsource(route.endpoint) if self.load_meta else '',
                 response_schema=get_type_name(route.response_model),
                 is_primitive=is_primitive_response
             )
@@ -154,8 +150,6 @@ class Voyager:
                 id=full_name, 
                 module=schema.__module__,
                 name=schema.__name__,
-                source_code=get_source(schema) if self.load_meta else '',
-                vscode_link=get_vscode_link(schema) if self.load_meta else '',
                 fields=get_pydantic_fields(schema, bases_fields)
             )
         return full_name

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

@@ -4,60 +4,119 @@ const { defineComponent, ref, watch, onMounted } = window.Vue;
 // Props:
 //   routeId: route id key in routeItems
 //   modelValue: dialog visibility
-//   routes: object map { id: { id, name, source_code } }
 export default defineComponent({
-  name: 'RouteCodeDisplay',
+  name: "RouteCodeDisplay",
   props: {
     routeId: { type: String, required: true },
     modelValue: { type: Boolean, default: false },
-    routes: { type: Object, default: () => ({}) },
   },
-  emits: ['close'],
+  emits: ["close"],
   setup(props, { emit }) {
-    const code = ref('');
-    const error = ref(null);
-    const link = ref('');
+    const loading = ref(false);
+    const code = ref("");
+    const error = ref("");
+    const link = ref("");
 
-    function close() { emit('close'); }
+    function close() {
+      emit("close");
+    }
 
     function highlightLater() {
       requestAnimationFrame(() => {
         try {
           if (window.hljs) {
-            const block = document.querySelector('.frv-route-code-display pre code.language-python');
+            const block = document.querySelector(
+              ".frv-route-code-display pre code.language-python"
+            );
             if (block) {
               window.hljs.highlightElement(block);
             }
           }
         } catch (e) {
-          console.warn('highlight failed', e);
+          console.warn("highlight failed", e);
         }
       });
     }
 
-    function load() {
+    async function load() {
+      if (!props.routeId) {
+        code.value = "";
+        return;
+      }
+
+      loading.value = true;
       error.value = null;
-      if (!props.routeId) { code.value=''; return; }
-      const item = props.routes[props.routeId];
-      if (item && item.source_code) {
-        code.value = item.source_code;
-        link.value = item.vscode_link || '';
+      code.value = "";
+      link.value = "";
+
+      // try to fetch from server: POST /source with { schema_name: routeId }
+      const payload = { schema_name: props.routeId };
+      try {
+        const resp = await fetch(`source`, {
+          method: "POST",
+          headers: {
+            Accept: "application/json",
+            "Content-Type": "application/json",
+          },
+          body: JSON.stringify(payload),
+        });
+
+        const data = await resp.json().catch(() => ({}));
+        if (resp.ok) {
+          code.value = data.source_code || "// no source code available";
+        } else {
+          error.value = (data && data.error) || "Failed to load source";
+        }
+      } catch (e) {
+        error.value = e && e.message ? e.message : "Failed to load source";
+      } finally {
+        loading.value = false;
+      }
+
+      try {
+        const resp = await fetch(`vscode-link`, {
+          method: "POST",
+          headers: {
+            Accept: "application/json",
+            "Content-Type": "application/json",
+          },
+          body: JSON.stringify(payload),
+        });
+
+        const data = await resp.json().catch(() => ({}));
+        if (resp.ok) {
+          link.value = data.link || "// no source code available";
+        } else {
+          error.value += (data && data.error) || "Failed to load vscode link";
+        }
+      } catch (e) {
+      } finally {
+        loading.value = false;
+      }
+
+      if (!error.value) {
         highlightLater();
-      } else if (item) {
-        code.value = '// no source code available';
-        link.value = item.vscode_link || '';
-      } else {
-        error.value = 'Route not found';
-        link.value = '';
       }
     }
 
-    watch(() => props.modelValue, (v) => { if (v) load(); });
-    watch(() => props.routeId, () => { if (props.modelValue) load(); });
+    watch(
+      () => props.modelValue,
+      (v) => {
+        if (v) load();
+      }
+    );
+    watch(
+      () => props.routeId,
+      () => {
+        if (props.modelValue) load();
+      }
+    );
 
-    onMounted(() => { if (props.modelValue) load(); });
+    onMounted(() => {
+      if (props.modelValue) load();
+    });
 
-    return { code, error, close, link };
+    return { loading, code, error, close, link };
   },
   template: `
   <div class="frv-route-code-display" style="border:1px solid #ccc; position:relative; width:50vw; max-width:50vw; height:100%; background:#fff;">
@@ -66,8 +125,9 @@ export default defineComponent({
       <a :href="link" target="_blank" rel="noopener" style="font-size:12px; color:#3b82f6;">Open in VSCode</a>
     </div>
     <div style="padding:40px 16px 16px 16px; height:100%; box-sizing:border-box; overflow:auto;">
-      <div v-if="error" style="color:#c10015; font-family:Menlo, monospace; font-size:12px;">{{ error }}</div>
+      <div v-if="loading" style="font-family:Menlo, monospace; font-size:12px;">Loading source...</div>
+      <div v-else-if="error" style="color:#c10015; font-family:Menlo, monospace; font-size:12px;">{{ error }}</div>
       <pre v-else style="margin:0;"><code class="language-python">{{ code }}</code></pre>
     </div>
-  </div>`
+  </div>`,
 });

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

@@ -14,17 +14,16 @@ export default defineComponent({
   props: {
     schemaName: { type: String, required: true },
     modelValue: { type: Boolean, default: false },
-    source: { type: String, default: null },
-    schemas: { type: Array, default: () => [] },
+    schemas: { type: Object, default: () => ({}) },
   },
   emits: ["close"],
   setup(props, { emit }) {
     const loading = ref(false);
     const code = ref("");
     const link = ref("");
-    const error = ref(null);
+    const error = ref("");
     const fields = ref([]); // schema fields list
-    const tab = ref('source');
+    const tab = ref("source");
 
     function close() {
       emit("close");
@@ -48,38 +47,73 @@ export default defineComponent({
       });
     }
 
-    function loadSource() {
+    async function loadSource() {
       if (!props.schemaName) return;
-      if (props.source) {
-        code.value = props.source;
-        highlightLater();
-        return;
-      }
+
       loading.value = true;
       error.value = null;
+      code.value = "";
+      link.value = "";
+
+      // try to fetch from server: /source/{schema_name}
+      const payload = { schema_name: props.schemaName };
       try {
-        const item = props.schemas.find((s) => s.fullname === props.schemaName);
-        if (item) {
-          link.value = item.vscode_link || "";
-          code.value = item.source_code || "// no source code available";
-          // capture fields if provided
-          fields.value = Array.isArray(item.fields) ? item.fields : [];
-          highlightLater();
+        // validate input: ensure we have a non-empty schemaName
+        const resp = await fetch(`source`, {
+          method: "POST",
+          headers: {
+            Accept: "application/json",
+            "Content-Type": "application/json",
+          },
+          body: JSON.stringify(payload),
+        });
+        // surface server-side validation message for bad request
+        const data = await resp.json().catch(() => ({}));
+        if (resp.ok) {
+          code.value = data.source_code || "// no source code available";
+        } else {
+          error.value = (data && data.error) || "Failed to load source";
+        }
+      } catch (e) {
+        error.value = "Failed to load source";
+      } finally {
+        loading.value = false;
+      }
+
+      try {
+        const resp = await fetch(`vscode-link`, {
+          method: "POST",
+          headers: {
+            Accept: "application/json",
+            "Content-Type": "application/json",
+          },
+          body: JSON.stringify(payload),
+        });
+        // surface server-side validation message for bad request
+        const data = await resp.json().catch(() => ({}));
+        if (resp.ok) {
+          link.value = data.link || "// no vscode link available";
         } else {
-          error.value = "Schema not found";
+          error.value += (data && data.error) || "Failed to load source";
         }
       } catch (e) {
         error.value = "Failed to load source";
       } finally {
         loading.value = false;
       }
+
+      fields.value = props.schemas[props.schemaName].fields || []
+
+      if (!error.value && tab.value === "source") {
+        highlightLater();
+      }
     }
 
     // re-highlight when switching back to source tab
     watch(
       () => tab.value,
       (val) => {
-        if (val === 'source') {
+        if (val === "source") {
           highlightLater();
         }
       }

fastapi_voyager/web/component/schema-field-filter.js

@@ -14,7 +14,8 @@ export default defineComponent({
   name: "SchemaFieldFilter",
   props: {
     schemaName: { type: String, default: null }, // external injection triggers auto-query
-    schemas: { type: Array, default: () => [] }, // externally provided schemas (state.rawSchemasFull or similar)
+    // externally provided schemas dict (state.rawSchemasFull): { [id]: schema }
+    schemas: { type: Object, default: () => ({}) },
   },
   emits: ["queried", "close"],
   setup(props, { emit }) {
@@ -39,12 +40,14 @@ export default defineComponent({
     let lastAppliedExternal = null;
 
     async function loadSchemas() {
-      // Refactored: use externally provided props.schemas directly; no network call.
+      // Use externally provided props.schemas dict directly; no network call.
       state.error = null;
-      state.schemas = Array.isArray(props.schemas) ? props.schemas : [];
+      const dict = props.schemas && typeof props.schemas === "object" ? props.schemas : {};
+      // Flatten to array for local operations
+      state.schemas = Object.values(dict);
       state.schemaOptions = state.schemas.map((s) => ({
-        label: `${s.name} (${s.fullname})`,
-        value: s.fullname,
+        label: `${s.name} (${s.id})`,
+        value: s.id,
       }));
       // Maintain compatibility: loadingSchemas flag toggled quickly (no async work)
       state.loadingSchemas = false;
@@ -54,8 +57,8 @@ export default defineComponent({
       const needle = (val || "").toLowerCase();
       update(() => {
         let opts = state.schemas.map((s) => ({
-          label: `${s.name} (${s.fullname})`,
-          value: s.fullname,
+          label: `${s.name} (${s.id})`,
+          value: s.id,
         }));
         if (needle) {
           opts = opts.filter((o) => o.label.toLowerCase().includes(needle));
@@ -67,7 +70,7 @@ export default defineComponent({
     function onSchemaChange(val) {
       state.schemaFullname = val;
       state.fieldName = null;
-      const schema = state.schemas.find((s) => s.fullname === val);
+      const schema = state.schemas.find((s) => s.id === val);
       state.fieldOptions = schema ? schema.fields.map((f) => f.name) : [];
     }
 
@@ -106,9 +109,9 @@ export default defineComponent({
     function applyExternalSchema(name) {
       if (!name || !state.schemas.length) return;
       if (lastAppliedExternal === name) return; // avoid duplicate
-      const schema = state.schemas.find((s) => s.fullname === name);
+      const schema = state.schemas.find((s) => s.id === name);
       if (!schema) return;
-      state.schemaFullname = schema.fullname;
+      state.schemaFullname = schema.id;
       state.fieldOptions = schema.fields.map((f) => f.name);
       state.fieldName = null; // reset field for external injection
       lastAppliedExternal = name;

fastapi_voyager/web/index.html

@@ -197,7 +197,7 @@
           </div>
         </div>
       </div>
-      <div style="flex: 1 1 auto; min-height: 0;">
+      <div style="flex: 1 1 auto; min-height: 10px;">
         <q-splitter
           v-model="state.splitter"
           unit="px"
@@ -323,7 +323,6 @@
         <route-code-display
           :route-id="routeCodeId"
           :model-value="showRouteCode"
-          :routes="state.routeItems"
           @close="showRouteCode = false"
         />
       </q-dialog>

fastapi_voyager/web/vue-main.js

@@ -9,13 +9,9 @@ const app = createApp({
   setup() {
     const state = reactive({
       // options and selections
-      tag: null,
-      tagOptions: [], // array of strings
-      routeId: null,
-      routeOptions: [], // [{ label, value }]
-      schemaFullname: null,
-      schemaOptions: [], // [{ label, value }]
-      routeItems: {}, // { id: { label, value } }
+      tag: null, // picked tag
+      routeId: null, // picked route
+      schemaId: null, // picked schema
       showFields: "object",
       fieldOptions: [
         { label: "No fields", value: "single" },
@@ -26,17 +22,17 @@ const app = createApp({
       hidePrimitiveRoute: false,
       generating: false,
       rawTags: [], // [{ name, routes: [{ id, name }] }]
-      rawSchemas: [], // [{ name, fullname }]
-      rawSchemasFull: [], // full objects with source_code & fields
+      rawSchemas: new Set(), // [{ name, id }]
+      rawSchemasFull: {}, // full schemas dict: { [schema.id]: schema }
       initializing: true,
       // Splitter size (left panel width in px)
       splitter: 300,
     });
+
     const showDetail = ref(false);
     const showSchemaFieldFilter = ref(false);
     const showSchemaCode = ref(false);
     const showRouteCode = ref(false);
-    // Dump/Import dialogs and rendered graph dialog
     const showDumpDialog = ref(false);
     const dumpJson = ref("");
     const showImportDialog = ref(false);
@@ -47,6 +43,7 @@ const app = createApp({
     const schemaFieldFilterSchema = ref(null); // external schemaName for schema-field-filter
     const schemaCodeName = ref("");
     const routeCodeId = ref("");
+
     function openDetail() {
       showDetail.value = true;
     }
@@ -54,47 +51,18 @@ const app = createApp({
       showDetail.value = false;
     }
 
-    function onFilterTags(val, update) {
-      const normalized = (val || "").toLowerCase();
-      update(() => {
-        if (!normalized) {
-          state.tagOptions = state.rawTags.map((t) => t.name);
-          return;
-        }
-        state.tagOptions = state.rawTags
-          .map((t) => t.name)
-          .filter((n) => n.toLowerCase().includes(normalized));
-      });
-    }
-
-    function onFilterSchemas(val, update) {
-      const normalized = (val || "").toLowerCase();
-      update(() => {
-        const makeLabel = (s) => `${s.name} (${s.fullname})`;
-        let list = state.rawSchemas.map((s) => ({
-          label: makeLabel(s),
-          value: s.fullname,
-        }));
-        if (normalized) {
-          list = list.filter((opt) =>
-            opt.label.toLowerCase().includes(normalized)
-          );
-        }
-        state.schemaOptions = list;
-      });
-    }
-
     async function loadInitial() {
       state.initializing = true;
       try {
         const res = await fetch("dot");
         const data = await res.json();
         state.rawTags = Array.isArray(data.tags) ? data.tags : [];
-        state.rawSchemasFull = Array.isArray(data.schemas) ? data.schemas : [];
-        state.rawSchemas = state.rawSchemasFull.map((s) => ({
-          name: s.name,
-          fullname: s.fullname,
-        }));
+        const schemasArr = Array.isArray(data.schemas) ? data.schemas : [];
+        // Build dict keyed by id for faster lookups and simpler prop passing
+        state.rawSchemasFull = Object.fromEntries(
+          schemasArr.map((s) => [s.id, s])
+        );
+        state.rawSchemas = new Set(Object.keys(state.rawSchemasFull));
         state.routeItems = data.tags
           .map((t) => t.routes)
           .flat()
@@ -103,13 +71,7 @@ const app = createApp({
             return acc;
           }, {});
 
-        state.tagOptions = state.rawTags.map((t) => t.name);
-        state.schemaOptions = state.rawSchemas.map((s) => ({
-          label: `${s.name} (${s.fullname})`,
-          value: s.fullname,
-        }));
         // default route options placeholder
-        state.routeOptions = [];
       } catch (e) {
         console.error("Initial load failed", e);
       } finally {
@@ -117,16 +79,16 @@ const app = createApp({
       }
     }
 
-    async function onGenerate(resetZoom=true) {
+    async function onGenerate(resetZoom = true) {
       state.generating = true;
       try {
         const payload = {
           tags: state.tag ? [state.tag] : null,
-          schema_name: state.schemaFullname || null,
+          schema_name: state.schemaId || null,
           route_name: state.routeId || null,
           show_fields: state.showFields,
           brief: state.brief,
-          hide_primitive_route: state.hidePrimitiveRoute
+          hide_primitive_route: state.hidePrimitiveRoute,
         };
 
         const res = await fetch("dot", {
@@ -138,21 +100,20 @@ const app = createApp({
 
         // create graph instance once
         const graphUI = new GraphUI("#graph", {
-          onSchemaClick: (name) => {
-            if (state.rawSchemas.find((s) => s.fullname === name)) {
-              schemaFieldFilterSchema.value = name;
+          onSchemaClick: (id) => {
+            if (state.rawSchemas.has(id)) {
+              schemaFieldFilterSchema.value = id;
               showSchemaFieldFilter.value = true;
             }
           },
-          onSchemaAltClick: (name) => {
-            // priority: schema full name; else route id
-            if (state.rawSchemas.find((s) => s.fullname === name)) {
-              schemaCodeName.value = name;
+          onSchemaAltClick: (id) => {
+            if (state.rawSchemas.has(id)) {
+              schemaCodeName.value = id;
               showSchemaCode.value = true;
               return;
             }
-            if (name in state.routeItems) {
-              routeCodeId.value = name;
+            if (id in state.routeItems) {
+              routeCodeId.value = id;
               showRouteCode.value = true;
               return;
             }
@@ -171,7 +132,7 @@ const app = createApp({
       try {
         const payload = {
           tags: state.tag ? [state.tag] : null,
-          schema_name: state.schemaFullname || null,
+          schema_name: state.schemaId || null,
           route_name: state.routeId || null,
           show_fields: state.showFields,
           brief: state.brief,
@@ -232,16 +193,16 @@ const app = createApp({
     async function onReset() {
       state.tag = null;
       state.routeId = "";
-      state.schemaFullname = null;
+      state.schemaId = null;
       // state.showFields = "object";
       state.brief = false;
-      onGenerate()
+      onGenerate();
     }
 
     function toggleTag(tagName, expanded = null) {
       if (expanded === true) {
         state.tag = tagName;
-        state.routeId = ''
+        state.routeId = "";
         onGenerate();
         return;
       }
@@ -249,26 +210,26 @@ const app = createApp({
 
     function selectRoute(routeId) {
       if (state.routeId === routeId) {
-        state.routeId = ''
+        state.routeId = "";
       } else {
-        state.routeId = routeId
+        state.routeId = routeId;
       }
-      onGenerate()
+      onGenerate();
     }
 
     function toggleShowField(field) {
       state.showFields = field;
-      onGenerate(false)
+      onGenerate(false);
     }
 
     function toggleBrief(val) {
       state.brief = val;
-      onGenerate()
+      onGenerate();
     }
-    
+
     function toggleHidePrimitiveRoute(val) {
       state.hidePrimitiveRoute = val;
-      onGenerate(false)
+      onGenerate(false);
     }
 
     onMounted(async () => {
@@ -281,8 +242,6 @@ const app = createApp({
       toggleBrief,
       toggleHidePrimitiveRoute,
       selectRoute,
-      onFilterTags,
-      onFilterSchemas,
       onGenerate,
       onReset,
       showDetail,
@@ -308,14 +267,14 @@ const app = createApp({
       // render graph dialog
       showRenderGraph,
       renderCoreData,
-      toggleShowField
+      toggleShowField,
     };
   },
 });
 app.use(window.Quasar);
 // Set Quasar primary theme color to green
-if (window.Quasar && typeof window.Quasar.setCssVar === 'function') {
-  window.Quasar.setCssVar('primary', '#009485');
+if (window.Quasar && typeof window.Quasar.setCssVar === "function") {
+  window.Quasar.setCssVar("primary", "#009485");
 }
 app.component("schema-field-filter", SchemaFieldFilter);
 app.component("schema-code-display", SchemaCodeDisplay);

{fastapi_voyager-0.8.3.dist-info → fastapi_voyager-0.9.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fastapi-voyager
-Version: 0.8.3
+Version: 0.9.2
 Summary: Visualize FastAPI application's routing tree and dependencies
 Project-URL: Homepage, https://github.com/allmonday/fastapi-voyager
 Project-URL: Source, https://github.com/allmonday/fastapi-voyager
@@ -28,13 +28,12 @@ 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)
 
-<p align="center"><img src="./voyager.jpg" alt="" /></p>
-
-> This repo is still in early stage, currently it supports pydantic v2 only, previous name: fastapi-router-viz
+> This repo is still in early stage, it supports pydantic v2 only
 
-Inspect your API interactively
+Inspect your API interactively!
 
-<img width="1480" height="648" alt="image" src="https://github.com/user-attachments/assets/a6ccc9f1-cf06-493a-b99b-eb07767564bd" />
+<p align="center"><img src="./voyager.jpg" alt="" /></p>
+<p align="center"><a target="_blank" rel="" href="https://www.youtube.com/watch?v=PGlbQq1M-n8"><img src="http://img.youtube.com/vi/PGlbQq1M-n8/0.jpg" alt="" style="max-width: 100%;"></a></p>
 
 ## Installation
 
@@ -48,11 +47,6 @@ uv add fastapi-voyager
 voyager -m path.to.your.app.module --server
 ```
 
-## Dependencies
-
-- FastAPI
-- [pydantic-resolve](https://github.com/allmonday/pydantic-resolve)
-
 
 ## Feature
 
@@ -75,9 +69,9 @@ voyager -m tests.demo
 ```
 
 ### generate the graph
-after initialization, pick tag, rotue (optional) and click `generate`.
+after initialization, pick tag, rotue to render graph
 
-<img width="1919" height="898" alt="image" style="border: 1px solid #aaa" src="https://github.com/user-attachments/assets/05e321d0-49f3-4af6-a7c7-f4c9c6b1dbfd" />
+<img width="1628" height="765" alt="image" src="https://github.com/user-attachments/assets/b4712f82-e754-453b-aa69-24c932b8f48f" />
 
 ### 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.
@@ -85,9 +79,9 @@ click a node to highlight it's upperstream and downstream nodes. figure out the
 <img width="1485" height="616" alt="image" style="border: 1px solid #aaa" src="https://github.com/user-attachments/assets/70c4095f-86c7-45da-a6f0-fd41ac645813" />
 
 ### filter related nodes
-`shift` click a node to check related node, pick a field to narrow the result.
+`shift` click a node to check related node, pick a field to narrow the result, picked node is marked as red.
 
-<img width="1917" height="800" alt="image" style="border: 1px solid #aaa" src="https://github.com/user-attachments/assets/e770dc70-f293-49e1-bcd7-d8dffa15d9ea" />
+<img width="1423" height="552" alt="image" src="https://github.com/user-attachments/assets/468a058d-afa1-4601-a7c5-c6aad6a8a557" />
 
 ### view source code
 `alt` click a node to show source code or open file in vscode.
@@ -105,10 +99,10 @@ click a node to highlight it's upperstream and downstream nodes. figure out the
 
 ```python
 from fastapi import FastAPI
-from fastapi_voyager.server import create_app_with_fastapi
+from fastapi_voyager import create_voyager
 from tests.demo import app
 
-app.mount('/voyager', create_app_with_fastapi(
+app.mount('/voyager', create_voyager(
     app, 
     module_color={"tests.service": "red"}, 
     module_prefix="tests.service"))
@@ -164,7 +158,25 @@ or you can open router_viz.dot with vscode extension `graphviz interactive previ
 
 ## Plan before v1.0
 
-features:
+
+### backlog
+- [ ] user can generate nodes/edges manually and connect to generated ones
+    - [ ] add owner
+    - [ ] add extra info for schema
+- [ ] fixed left/right bar show field information
+- [ ] display standard ER diagram `hard`
+    - [ ] display potential invalid links
+- [ ] support dataclass (pending)
+
+### in analysis
+- [ ] click field to highlight links
+- [ ] animation effect for edges
+- [ ] customrized right click panel
+    - [ ] show own dependencies
+- [ ] clean up fe code
+
+### plan:
+#### <0.9:
 - [x] group schemas by module hierarchy
 - [x] module-based coloring via Analytics(module_color={...})
 - [x] view in web browser
@@ -183,49 +195,80 @@ features:
 - [x] add tooltips
 - [x] route
     - [x] group routes by module hierarchy
-    - [ ] add response_model in route
-- [ ] support dataclass (pending)
-- [ ] click field to highlight links
-- [ ] user can generate nodes/edges manually and connect to generated ones
-    - [ ] add owner
-    - [ ] add extra info for schema
-- [ ] ui optimization
-    - [ ] fixed left/right bar show field information
-    - [x] fixed left bar show tag/ route
-- [ ] display standard ER diagram `difference`
-    - [ ] display potential invalid links
-- [ ] integration with pydantic-resolve
-    - [ ] show difference between resolve, post fields
-    - [x] strikethrough for excluded fields
-    - [ ] display loader as edges
+    - [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`
-- [ ] show tips for routes not return pydantic type.
-- [ ] add http method for route
-
-bugs & non feature:
+- [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.10
+- [ ] support opening route in swagger
+    - config docs path
+- [ ] add http method for route
+- [ ] enable/disable module cluster  (may save space)
+- [ ] logging information
 - [ ] add tests
-- [x] refactor
-    - [x] abstract render module
+- [ ] hide brief mode if not configured
+- [ ] optimize static resource
+- [ ] show route count in tag expansion item
+- [ ] route list show have a max height to trigger scrollable
+- [ ] fix layout issue when rendering huge graph
+
+#### 0.11
+- [ ] improve user experience
+    - double click to show detail
+    - improve search dialog
+
+#### 0.12
+- [ ] integration with pydantic-resolve
+    - [ ] show hint for resolve, post fields
+    - [ ] display loader as edges
+
 
 ## Using with pydantic-resolve
 
+WIP: ...
+
 pydantic-resolve's @ensure_subset decorator is helpful to pick fields from `source class` in safe.
 
-TODO: ...
 
 
 ## Credits
 
-- https://apis.guru/graphql-voyager/, for inspiration.
-- https://github.com/tintinweb/vscode-interactive-graphviz, for web visualization.
+- 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
 
 
 ## Changelog
 
+- 0.9:
+    - 0.9.2:
+        - fix: missing fields in schema detail panel
+        - optimization: clean up fe codes.
+    - 0.9.1:
+        - api change: from `create_app_with_fastapi` to `create_voyager`, and expose as `from fastapi_voyager import create_voyager`
+        - optimization: lazy load vscode link and source code, speed up the initialization.
 - 0.8:
+    - 0.8.3
+        - upgrade theme
     - 0.8.2
         - fix silly typo.
     - 0.8.1

{fastapi_voyager-0.8.3.dist-info → fastapi_voyager-0.9.2.dist-info}/RECORD

@@ -1,24 +1,24 @@
-fastapi_voyager/__init__.py,sha256=E5WTV_sYs2LK8I6jzA7AuvFU5a8_vjnDseC3DMha0iQ,149
-fastapi_voyager/cli.py,sha256=2eixX7mtPsZvukc4vrwQOt6XTPJgHUKIGLBy3IIC2jE,11127
+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=2Yt37o8mhqSqleafO4YRrumh_ExYUqzXFOxQRPuTbAc,8078
 fastapi_voyager/module.py,sha256=Z2QHNmiLk6ZAJlm2nSmO875Q33TweSg8UxZSzIpU9zY,3499
 fastapi_voyager/render.py,sha256=qy3g1Rz1s8XkuR_6n1Q1YPwy_oMOjWjNswTHQjdz4N0,7765
-fastapi_voyager/server.py,sha256=Q9-f0frKHC4d0vN8ZasZyw6AsWKwLRB0P7z8dZ0lzjQ,4108
-fastapi_voyager/type.py,sha256=k62cDofqmy-2q5rInW5LydLaRuDpKLsdbapps8Osqys,1838
+fastapi_voyager/server.py,sha256=pg-LHDj4yU0usDA1b2X2Kt2_OCrexFA2G9ifGxb52Uc,6196
+fastapi_voyager/type.py,sha256=pWYKmgb9e0W_JeD7k54Mr2lxUZV_Ir9TNpewGRwHyHQ,1629
 fastapi_voyager/type_helper.py,sha256=hjBC4E0tgBpQDlYxGg74uK07SXjsrAgictEETJfIpYM,9231
-fastapi_voyager/version.py,sha256=oFsY5N35bJE0AakSBQ3J7JuwVWsgL4KEN-zNDsKGJ-Q,48
-fastapi_voyager/voyager.py,sha256=Tz-cJW1Pg9Ei6zX2CPCdAnkTqErp2OIIhhxeeDd6Nss,11221
+fastapi_voyager/version.py,sha256=Su4VudgwOkDWEBzNahJ3LX1SbIA7uezku9g1zsUddHU,48
+fastapi_voyager/voyager.py,sha256=pXvA3ye5Jq6aJ6YrZFbTHjJ9MzdydqWllIgY8RFK_4A,10793
 fastapi_voyager/web/graph-ui.js,sha256=0hqMCzsPJfhgWDuwiXVXaGQL-_7urT_zryo4sXMN8jQ,4209
 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=AnsqXfzDrUPO12EWtiT_XJdJ6Kx3qBsRn1IfX393G48,14298
+fastapi_voyager/web/index.html,sha256=pmctp4OizRd8ETKEI0vl0Seu9nIQklfnbFDDyztFoy4,14264
 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=F-JUjwsN0Mdu5KWKNjqIEAzoucVQ9Zu-zE61fMDTdME,9551
+fastapi_voyager/web/vue-main.js,sha256=ZRJQBV54YqoKkLI2a8WHF6uYeFUpqwBl-lykkaYxCXI,8182
 fastapi_voyager/web/component/render-graph.js,sha256=e8Xgh2Kl-nYU0P1gstEmAepCgFnk2J6UdxW8TlMafGs,2322
-fastapi_voyager/web/component/route-code-display.js,sha256=NECC1OGcPCdDfbghtRJEnmFM6HmH5J3win2ibapWPeA,2649
-fastapi_voyager/web/component/schema-code-display.js,sha256=oOusgTvCaWGnoKb-NBwu0SXqJJf2PTUtp3lUczokTBM,5515
-fastapi_voyager/web/component/schema-field-filter.js,sha256=5lK2mdgp7_UWcwURi9djRCkIwih-3f4EmDbhKFuLBDc,6266
+fastapi_voyager/web/component/route-code-display.js,sha256=Pdg8JX_yHhoUUGSqgRs_zTciIfw5wYzG6-kQfHtdWFU,3956
+fastapi_voyager/web/component/schema-code-display.js,sha256=Aa_mXxmNgIbImoT1_zuzsPgbPq8QaakUAzNWTxHxM58,6584
+fastapi_voyager/web/component/schema-field-filter.js,sha256=PR8d2_u1UiSLrS5zqAvY2UR8LbvjBqiUDt71tm1DJTs,6345
 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
@@ -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.8.3.dist-info/METADATA,sha256=bA7QuzvsXCjTX3vqS31SFzKrquWrad7NKHot6pXFRvw,8082
-fastapi_voyager-0.8.3.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-fastapi_voyager-0.8.3.dist-info/entry_points.txt,sha256=pEIKoUnIDXEtdMBq8EmXm70m16vELIu1VPz9-TBUFWM,53
-fastapi_voyager-0.8.3.dist-info/licenses/LICENSE,sha256=lNVRR3y_bFVoFKuK2JM8N4sFaj3m-7j29kvL3olFi5Y,1067
-fastapi_voyager-0.8.3.dist-info/RECORD,,
+fastapi_voyager-0.9.2.dist-info/METADATA,sha256=k_l0KTvYeGwMhRPdulVlob3_q-uZ9UTEHo_KLeXTHsQ,9221
+fastapi_voyager-0.9.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+fastapi_voyager-0.9.2.dist-info/entry_points.txt,sha256=pEIKoUnIDXEtdMBq8EmXm70m16vELIu1VPz9-TBUFWM,53
+fastapi_voyager-0.9.2.dist-info/licenses/LICENSE,sha256=lNVRR3y_bFVoFKuK2JM8N4sFaj3m-7j29kvL3olFi5Y,1067
+fastapi_voyager-0.9.2.dist-info/RECORD,,