Visualize FastAPI endpoints with FastAPI-Voyager

(newsyeah.fun)

62 points | by tank-34 4 hours ago ago

11 comments

  • brulard 3 hours ago

    I would appreciate some quick info what this is all about. Clicking on link presents me with a huge diagram i know nothing about. What am I looking at?

    • tank-34 3 hours ago

      this project is inspired by https://apis.guru/graphql-voyager/, which visualize the entity relationships based on graphviz and add fancy ui effects.

      fastapi-voyager, from left to right, is tag, routes(apis) and response_models, it indicates the internal relationship between routes, which can help developers/PO easily figure out the data structure.

      • agumonkey 3 hours ago

        Pretty nice

      • tonyhart7 3 hours ago

        ok, how is this better than OpenAPI schema???

        • tank-34 3 hours ago

          in swagger, from the definition of schema you are not able to easily figure out the related class, the name is marked as <object> or array<object>

          in voyager their relationships are visualized and very close to the source code.

  • tank-34 18 minutes ago

    if you double click route / pydantic class and click 'view in vscode', it will lead you to the file in github

    and in local env, you can 'really' open it in vscode.

  • btbuildem an hour ago

    Needs more discovery interactions - first one being node mouseover highlights all associated links.

    It's 2025, I don't want to look at a giant hairball. At top level, give me a summary, reveal detail as I drill down.

    Am I using this as a reference? The search looks promising, I can follow thru and find specifics on a particular item I am after.

    • tank-34 20 minutes ago

      thanks for suggestion. this project is still in early stage, I've listed some ux related Todos but not yet finished. TBH, i dont expected it to be noticed in hacker's news LOL

  • tank-34 3 hours ago
  • throwaway0X13 3 hours ago

    Mapping software in /src/ modding, either with GIS software for positional API voyaging, which designate the tiers for endpoints.

  • tank-34 3 hours ago

    scroll to zoom in/out

    pick tag/routes at left panel, and see subgraphs

    double click to see field table and source code, click link to see source code in github

    click focus to hide other nodes.

    ...