pyright-analysis 1.0.0rc2

Visualise Python project type completeness

Generate a treemap graph from Pyright verifytypes output.

A simple cli tool to visualise the state of a Python project's type completeness, from the output of pyright's --outputjson --verifytypes command:

The interactive graph depicts a projects modules as a tree, with each the size of each module based on the number of exported symbols.

Usage

Use a Python tool manager like uv tool or pipx:

$ uv tool install pyright
$ uv tool install pyright-analysis

Then generate a type compleness JSON report for your package, and transform the report into a graph:

$ pyright --outputjson --ignoreexternal --verifytypes PACKAGE > PACKAGE.json
$ pyright-analysis PACKAGE.json

This will open the resulting graph in your browser.

Full help documentation is available on the command-line:

Features

• Interactive responsive graph. Hover over each package to get more detail about symbol counts and completeness, or click on packages to zoom in.
• Export options:
  • Full stand-alone HTML page.
  • HTML div snippet with configurable HTML id.
  • Static image export as PNG, JPG, WebP, SVG or PDF.
  • Plotly JSON graph representation.