fastapi-voyager 0.16.0a1__py3-none-any.whl → 0.16.0a2__py3-none-any.whl

fastapi_voyager/adapters/fastapi_adapter.py

@@ -5,11 +5,7 @@ This module provides the FastAPI-specific implementation of the voyager server.
 """
 from typing import Any, Literal
 
-from fastapi import APIRouter, FastAPI
-from fastapi.responses import HTMLResponse, JSONResponse, PlainTextResponse
-from fastapi.staticfiles import StaticFiles
 from pydantic import BaseModel
-from starlette.middleware.gzip import GZipMiddleware
 
 from fastapi_voyager.adapters.base import VoyagerAdapter
 from fastapi_voyager.adapters.common import STATIC_FILES_PATH, VoyagerContext
@@ -98,8 +94,14 @@ class FastAPIAdapter(VoyagerAdapter):
         )
         self.gzip_minimum_size = gzip_minimum_size
 
-    def create_app(self) -> FastAPI:
+    def create_app(self) -> Any:
         """Create and return a FastAPI application with voyager endpoints."""
+        # Lazy import FastAPI to avoid import errors when framework is not installed
+        from fastapi import APIRouter, FastAPI
+        from fastapi.responses import HTMLResponse, JSONResponse, PlainTextResponse
+        from fastapi.staticfiles import StaticFiles
+        from starlette.middleware.gzip import GZipMiddleware
+
         router = APIRouter(tags=["fastapi-voyager"])
 
         @router.post("/er-diagram", response_class=PlainTextResponse)

fastapi_voyager/adapters/litestar_adapter.py

@@ -5,9 +5,6 @@ This module provides the Litestar-specific implementation of the voyager server.
 """
 from typing import Any
 
-from litestar import Litestar, MediaType, Request, Response, get, post
-from litestar.static_files import create_static_files_router
-
 from fastapi_voyager.adapters.base import VoyagerAdapter
 from fastapi_voyager.adapters.common import STATIC_FILES_PATH, WEB_DIR, VoyagerContext
 from fastapi_voyager.type import CoreData, SchemaNode, Tag
@@ -47,8 +44,11 @@ class LitestarAdapter(VoyagerAdapter):
         )
         self.gzip_minimum_size = gzip_minimum_size
 
-    def create_app(self) -> Litestar:
+    def create_app(self) -> Any:
         """Create and return a Litestar application with voyager endpoints."""
+        # Lazy import Litestar to avoid import errors when framework is not installed
+        from litestar import Litestar, MediaType, Request, Response, get, post
+        from litestar.static_files import create_static_files_router
 
         @get("/er-diagram")
         async def get_er_diagram(request: Request) -> str:

fastapi_voyager/cli.py

@@ -5,17 +5,19 @@ import importlib.util
 import logging
 import os
 import sys
-
-from fastapi import FastAPI
+from typing import TYPE_CHECKING
 
 from fastapi_voyager import server as viz_server
 from fastapi_voyager.version import __version__
 from fastapi_voyager.voyager import Voyager
 
+if TYPE_CHECKING:
+    from fastapi import FastAPI
+
 logger = logging.getLogger(__name__)
 
 
-def load_fastapi_app_from_file(module_path: str, app_name: str = "app") -> FastAPI | None:
+def load_fastapi_app_from_file(module_path: str, app_name: str = "app") -> "FastAPI | None":
     """Load FastAPI app from a Python module file."""
     try:
         # Convert relative path to absolute path
@@ -35,6 +37,8 @@ def load_fastapi_app_from_file(module_path: str, app_name: str = "app") -> FastA
         # Get the FastAPI app instance
         if hasattr(module, app_name):
             app = getattr(module, app_name)
+            # Lazy import to avoid import errors when FastAPI is not installed
+            from fastapi import FastAPI
             if isinstance(app, FastAPI):
                 return app
             logger.error(f"'{app_name}' is not a FastAPI instance")
@@ -47,7 +51,7 @@ def load_fastapi_app_from_file(module_path: str, app_name: str = "app") -> FastA
         return None
 
 
-def load_fastapi_app_from_module(module_name: str, app_name: str = "app") -> FastAPI | None:
+def load_fastapi_app_from_module(module_name: str, app_name: str = "app") -> "FastAPI | None":
     """Load FastAPI app from a Python module name."""
     try:
         # Temporarily add the current working directory to sys.path
@@ -65,6 +69,8 @@ def load_fastapi_app_from_module(module_name: str, app_name: str = "app") -> Fas
             # Get the FastAPI app instance
             if hasattr(module, app_name):
                 app = getattr(module, app_name)
+                # Lazy import to avoid import errors when FastAPI is not installed
+                from fastapi import FastAPI
                 if isinstance(app, FastAPI):
                     return app
                 logger.error(f"'{app_name}' is not a FastAPI instance")
@@ -85,7 +91,7 @@ def load_fastapi_app_from_module(module_name: str, app_name: str = "app") -> Fas
 
 
 def generate_visualization(
-    app: FastAPI,
+    app: "FastAPI",
     output_file: str = "router_viz.dot", tags: list[str] | None = None,
     schema: str | None = None,
     show_fields: bool = False,

fastapi_voyager/introspectors/fastapi.py

@@ -4,11 +4,13 @@ FastAPI implementation of the AppIntrospector interface.
 This module provides the adapter that allows fastapi-voyager to work with FastAPI applications.
 """
 from collections.abc import Iterator
-
-from fastapi import FastAPI, routing
+from typing import TYPE_CHECKING, Any
 
 from fastapi_voyager.introspectors.base import AppIntrospector, RouteInfo
 
+if TYPE_CHECKING:
+    from fastapi import FastAPI
+
 
 class FastAPIIntrospector(AppIntrospector):
     """
@@ -18,7 +20,7 @@ class FastAPIIntrospector(AppIntrospector):
     and converts it to the framework-agnostic RouteInfo format.
     """
 
-    def __init__(self, app: FastAPI, swagger_url: str | None = None):
+    def __init__(self, app: "FastAPI", swagger_url: str | None = None):
         """
         Initialize the FastAPI introspector.
 
@@ -26,6 +28,12 @@ class FastAPIIntrospector(AppIntrospector):
             app: The FastAPI application instance
             swagger_url: Optional custom URL to Swagger documentation
         """
+        # Lazy import to avoid import errors when FastAPI is not installed
+        from fastapi import FastAPI
+
+        if not isinstance(app, FastAPI):
+            raise TypeError(f"Expected FastAPI instance, got {type(app)}")
+
         self.app = app
         self.swagger_url = swagger_url or "/docs"
 
@@ -36,6 +44,9 @@ class FastAPIIntrospector(AppIntrospector):
         Yields:
             RouteInfo: Standardized route information for each API route
         """
+        # Lazy import routing to avoid import errors when FastAPI is not installed
+        from fastapi import routing
+
         for route in self.app.routes:
             # Only process APIRoute instances (not static files, etc.)
             if isinstance(route, routing.APIRoute):
@@ -66,7 +77,7 @@ class FastAPIIntrospector(AppIntrospector):
         """
         return self.swagger_url
 
-    def _get_route_id(self, route: routing.APIRoute) -> str:
+    def _get_route_id(self, route: Any) -> str:
         """
         Generate a unique identifier for the route.
 

fastapi_voyager/version.py

@@ -1,2 +1,2 @@
 __all__ = ["__version__"]
-__version__ = "0.16.0alpha-1"
+__version__ = "0.16.0alpha-2"

{fastapi_voyager-0.16.0a1.dist-info → fastapi_voyager-0.16.0a2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fastapi-voyager
-Version: 0.16.0a1
+Version: 0.16.0a2
 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
@@ -20,15 +20,33 @@ Classifier: Programming Language :: Python :: 3.14
 Requires-Python: >=3.10
 Requires-Dist: jinja2>=3.0.0
 Requires-Dist: pydantic-resolve>=2.4.3
+Provides-Extra: all
+Requires-Dist: django-ninja>=1.5.3; extra == 'all'
+Requires-Dist: django>=4.2; extra == 'all'
+Requires-Dist: fastapi>=0.110; extra == 'all'
+Requires-Dist: httpx; extra == 'all'
+Requires-Dist: litestar>=2.19.0; extra == 'all'
+Requires-Dist: pydantic>=2.0; extra == 'all'
+Requires-Dist: pytest; extra == 'all'
+Requires-Dist: pytest-asyncio; extra == 'all'
+Requires-Dist: ruff; extra == 'all'
+Requires-Dist: uvicorn; extra == 'all'
 Provides-Extra: dev
-Requires-Dist: django-ninja; extra == 'dev'
-Requires-Dist: fastapi>=0.110; extra == 'dev'
 Requires-Dist: httpx; extra == 'dev'
-Requires-Dist: litestar; extra == 'dev'
 Requires-Dist: pytest; extra == 'dev'
 Requires-Dist: pytest-asyncio; extra == 'dev'
 Requires-Dist: ruff; extra == 'dev'
-Requires-Dist: uvicorn; extra == 'dev'
+Provides-Extra: django-ninja
+Requires-Dist: django-ninja>=1.5.3; extra == 'django-ninja'
+Requires-Dist: django>=4.2; extra == 'django-ninja'
+Requires-Dist: uvicorn; extra == 'django-ninja'
+Provides-Extra: fastapi
+Requires-Dist: fastapi>=0.110; extra == 'fastapi'
+Requires-Dist: uvicorn; extra == 'fastapi'
+Provides-Extra: litestar
+Requires-Dist: litestar>=2.19.0; extra == 'litestar'
+Requires-Dist: pydantic>=2.0; extra == 'litestar'
+Requires-Dist: uvicorn; extra == 'litestar'
 Description-Content-Type: text/markdown
 
 [![pypi](https://img.shields.io/pypi/v/fastapi-voyager.svg)](https://pypi.python.org/pypi/fastapi-voyager)

{fastapi_voyager-0.16.0a1.dist-info → fastapi_voyager-0.16.0a2.dist-info}/RECORD

@@ -1,5 +1,5 @@
 fastapi_voyager/__init__.py,sha256=1IdDy6JUMgQqQo33qUe2znX9YeI7S35pjVrbt0QLOzY,228
-fastapi_voyager/cli.py,sha256=td3yIIigEomhSdDO-Xkh-CgpEwCafwlwnpvxnT9QsBo,10488
+fastapi_voyager/cli.py,sha256=1o0areaN302fOoBprn-zXPnDFfCFbF81MatFTR1FHrU,10795
 fastapi_voyager/er_diagram.py,sha256=4Ba5u-T7XmVmk9MltVMe-m-18mUAHMTybTdE-zNZLrU,7860
 fastapi_voyager/filter.py,sha256=AN_HIu8-DtKisIq5mFt7CnqRHtxKewedNGyyaI82hSY,11529
 fastapi_voyager/module.py,sha256=h9YR3BpS-CAcJW9WCdVkF4opqwY32w9T67g9GfdLytk,3425
@@ -9,19 +9,19 @@ fastapi_voyager/render_style.py,sha256=1y3aRhBSJSWU-JuSgjn9il_xFEqjv6mJCoUzImLQT
 fastapi_voyager/server.py,sha256=sgUUscbt736VNB6CN2J_6rJ6fpWO4vJFW7oP7FmAjvA,6739
 fastapi_voyager/type.py,sha256=zluWvh5vpnjXJ9aAmyNJTSmXZPjAHCvgRT5oQRAjHrg,2104
 fastapi_voyager/type_helper.py,sha256=5HYUHdghTISZ44NvVsrMWlRGD5C9-xrGeNKuLYDMA6s,10209
-fastapi_voyager/version.py,sha256=0KZ1gUzWpAnbQTYDMdcLc-qEsyVlYlG265SEa7S4Ij4,56
+fastapi_voyager/version.py,sha256=BzQ3H9QQr3tEif7581G5jfiOo26aX4wMpelAXUnXzF0,56
 fastapi_voyager/voyager.py,sha256=S0cCMLFv_wPfEMVdp4cYqbc-Y207SjCTSmsYdqzIDHg,15307
 fastapi_voyager/adapters/__init__.py,sha256=a95rBvV4QVcX_yAzjuJQKOW-EbJ79R--YjUJ3BGkC3k,517
 fastapi_voyager/adapters/base.py,sha256=m-E74LlNgYCpj-gqfYsKl2mzWW5iFiaDTjiBri_5cfo,1283
 fastapi_voyager/adapters/common.py,sha256=DXVLsjLn65U3RR7YyKL_ELV74mnINWmZ4hQ6zISdV0E,9684
 fastapi_voyager/adapters/django_ninja_adapter.py,sha256=tl1rMcotAhOwBxT8poG8rTXm1v3wn_cpaoda79NEFxE,11424
-fastapi_voyager/adapters/fastapi_adapter.py,sha256=-VvCXdMRsV_zZzEkplOGK8HjQ9ICoTyapG3ZluQ1Nvk,5870
-fastapi_voyager/adapters/litestar_adapter.py,sha256=-ILD8jIb82_JKV87p4IfV9IXvhUJ6RSic6i_iHapo5w,6812
+fastapi_voyager/adapters/fastapi_adapter.py,sha256=attD4uuKXElFXk7JT7W-JW5B4S7a-qHzYVToHKBwTqk,5984
+fastapi_voyager/adapters/litestar_adapter.py,sha256=9AfWuLtHHqzKj-VySJaOEtb7HWefRfJSobCQ_Y03ytU,6908
 fastapi_voyager/introspectors/__init__.py,sha256=HbmoUyM-BSwd4Rg2ptd9u-qvZSD3UykKyHYVoRg03OM,917
 fastapi_voyager/introspectors/base.py,sha256=hMfka9gVXr-E8MA1rKSSmYk0OppqgiFPWavfgAkPmQI,2131
 fastapi_voyager/introspectors/detector.py,sha256=rmlpQARJMrFXPty6OUdjmFRTtBYErGDH4l7Tivnu_FQ,3910
 fastapi_voyager/introspectors/django_ninja.py,sha256=Ytneh_kpsakTo_Njv1e4nvqfErjT1PrYelLZ-8xX5Gg,4052
-fastapi_voyager/introspectors/fastapi.py,sha256=SyWGKAH8cM3CENY-Uu3YY6e8kFM5BE-jEBBZLoIF--A,2696
+fastapi_voyager/introspectors/fastapi.py,sha256=TGr1VPO0f6y-w3ZvQpI15o4Jq5L7VcN_twqzY_33fz4,3085
 fastapi_voyager/introspectors/litestar.py,sha256=QXnaT0-hCa_0sByKJoUWuu0vIzRpCCKLokCBDTtv_s4,6100
 fastapi_voyager/templates/dot/cluster.j2,sha256=I2z9KkfCzmAtqXe0gXBnxnOfBXUSpdlATs3uf-O8_B8,307
 fastapi_voyager/templates/dot/cluster_container.j2,sha256=2tH1mOJvPoVKE_aHVMR3t06TfH_dYa9OeH6DBqSHt_A,204
@@ -55,8 +55,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.16.0a1.dist-info/METADATA,sha256=pGOq7n96lV1BKAXvCKPXUU8BvXN89HzgAMI90dmnH_Y,12943
-fastapi_voyager-0.16.0a1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-fastapi_voyager-0.16.0a1.dist-info/entry_points.txt,sha256=pEIKoUnIDXEtdMBq8EmXm70m16vELIu1VPz9-TBUFWM,53
-fastapi_voyager-0.16.0a1.dist-info/licenses/LICENSE,sha256=lNVRR3y_bFVoFKuK2JM8N4sFaj3m-7j29kvL3olFi5Y,1067
-fastapi_voyager-0.16.0a1.dist-info/RECORD,,
+fastapi_voyager-0.16.0a2.dist-info/METADATA,sha256=SskYV4bCVQW96Q5CYbgZQEVt_ajQWPG1BO0uzKnxKmA,13701
+fastapi_voyager-0.16.0a2.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+fastapi_voyager-0.16.0a2.dist-info/entry_points.txt,sha256=pEIKoUnIDXEtdMBq8EmXm70m16vELIu1VPz9-TBUFWM,53
+fastapi_voyager-0.16.0a2.dist-info/licenses/LICENSE,sha256=lNVRR3y_bFVoFKuK2JM8N4sFaj3m-7j29kvL3olFi5Y,1067
+fastapi_voyager-0.16.0a2.dist-info/RECORD,,