sPyTial: Lightweight Diagrams for Structured Python Data

pip install spytial-diagramming

Docs: https://sidprasad.github.io/spytial/ — start with Getting Started for install, badges, and your first diagram.

Sometimes you just want to see your data.

You're working with a tree, a graph, a recursive object — maybe an AST, a neural network, or a symbolic term. You don't need an interactive dashboard or a production-grade visualization system. You just need a diagram that lays it out clearly so you can understand what's going on.

That's what sPyTial is for. It is designed for developers, educators, and researchers who work with structured data and need to make that structure visible — to themselves or to others — with minimal effort.

Why spatial layout

Spatial arrangement helps people understand structure: when elements are grouped, aligned, and oriented meaningfully, patterns and errors become easier to see. sPyTial gives you that layout by default — the diagram reflects how the parts are connected, not how they happen to be stored.

You get:

a box-and-arrow diagram that shows the shape of your data
a layout driven by declarative constraints (orientation, align, cyclic, group)
a tool that flags when a constraint can't be satisfied

Quick start

import spytial

data = {
    "name": "root",
    "children": [
        {"value": 1},
        {"value": 2},
        {"value": 3},
    ],
}

# Opens in a browser tab, or inline in a Jupyter notebook.
spytial.diagram(data)

# Or save to a file:
spytial.diagram(data, method="file")

Not sure where to start with a class of your own? from spytial.suggest import suggest then suggest(MyClass) reads the class and scaffolds a starting set of layout directives you can edit — see Suggesting Specs.

For stepping through sequences of states, custom relationalizers, and annotation-driven layouts, see the docs.

Related projects

spytial-clrs — a Jupyter notebook collection that implements the data structures from the CLRS algorithms textbook (Cormen, Leiserson, Rivest, Stein) using sPyTial: heaps, linked lists, hash tables, BST / red-black / B / van Emde Boas trees, disjoint-set forests, graphs with MST and SCC views, and more. The best place to see sPyTial on realistic structures.
spytial-core — the browser-side rendering engine sPyTial uses under the hood. Shared across all sPyTial language hosts (Python, Rust, Pyret, Lean).

License

MIT — see LICENSE.

Metadata

Release files for spytial-diagramming 1.12.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for spytial-diagramming 1.12.0
File	Size	Uploaded
spytial_diagramming-1.12.0.tar.gz	545.7 kB	Aug 25, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for spytial-diagramming 1.12.0
File	Interpreter	ABI	Platform	Reset
spytial_diagramming-1.12.0-py3-none-any.whl 362.3 kB Aug 25, 2026	Python 3	none	any	Details

Total release size: 908.0 kB

Release files / spytial_diagramming-1.12.0.tar.gz

Download URL	spytial_diagramming-1.12.0.tar.gz
Size	545.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`a76c38d8d3061a08e9466b87b6cfbc39d0d7c075322ff4a1a403f244604e87a3`
BLAKE2b-256 checksum How to use checksums	`5c7cf06eca0e8dae8f90959458236ebec198a52a40551f0065e13ac3c266610c`
Upload date	Aug 25, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Release files / spytial_diagramming-1.12.0-py3-none-any.whl

Download URL	spytial_diagramming-1.12.0-py3-none-any.whl
Size	362.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`106ac4c91abb8ab4a57fb6692d92354befc784858e4fc1d4f4fe4deb10c826fa`
BLAKE2b-256 checksum How to use checksums	`82d8fa995210cb8f9bc7f3ce107ab5b2c2403266d05c723517eab2cbceb753b7`
Upload date	Aug 25, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`