---
id: structout
version: "0.1.63"
license: GPLv3
license_treatment: copyleft
maintenance: active
---

# structout — pretty print data structures

License: copyleft · Maintenance: active · Downloads: 83.9K/mo

## What it is and what it does

StructOut is a terminal-based pretty-printer for graphs and large integer lists. It renders graphs as ASCII art with optional node coloring, edge labels, and zoom-to-subgraph capability, and formats number lists with configurable binning and chunking strategies. The package has no runtime dependencies and is designed as a utility for developers who need readable terminal output of complex data structures during development or analysis.

The package includes specialized rendering for RNA structures and heatmaps. It's actively maintained, supports Python >=3.8, and carries a GPLv3 copyleft license.

Use it for:

- Debug graph algorithms by printing intermediate graph states with node coloring to highlight specific subsets.
- Explore datasets by rendering heatmaps in the terminal with configurable dimensions and operators.
- Visualize RNA secondary structures using the specialized RNAprint formatter during analysis.
- Format and display large integer ranges or statistical summaries in the terminal with logarithmic or evenly-spaced binning.
- Zoom into subgraphs during interactive exploration by specifying focal nodes and maximum distance.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Formats and displays graphs and large integer lists as readable terminal output with customizable layout, coloring, and zoom options.

Yes, if you work with graphs or large number lists in terminal environments and accept the GPLv3 copyleft constraint. The package is actively maintained, has no runtime dependencies, and fills a specific niche for ASCII-art data visualization. Not suitable for proprietary projects due to copyleft licensing.

## Install

pip install structout
uv add structout
poetry add structout

## Installing structout

Before you install: High install friction with no runtime dependencies. The package is actively maintained (last commit 2026-06-18) and supports current Python versions, but the single tarball distribution and lack of wheels may slow installation.

License in practice: GPLv3 copyleft license means any derivative work or software that links this package must also be released under GPLv3. This is a significant constraint for proprietary or differently-licensed projects.

Quickstart:

pip install structout

import structout as so

so.lprint(range(1000), length=70)
so.gprint(graph)

Requires Python >=3.8.

Verify before relying:

- Whether the package works correctly with modern graph library versions and what the minimum/maximum supported versions are.
- Performance characteristics when rendering very large graphs or lists (memory usage, rendering time).
- Whether the heatmap function requires NumPy as an optional dependency despite not being listed in runtime deps.
- What graph library or format the gprint function accepts as input.

## Package facts

- License: GPLv3 (copyleft)
- Python support: supports_current
- Install friction: high
- Maintenance: active
- Downloads: 83.9K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

pretty print graphs terminal, terminal graph visualization, format large number lists, ascii graph display, structured data terminal output, terminal-visualization, ascii-art

[View on SkillFed](https://skillfed.io/packages/structout) · [View on PyPI](https://pypi.org/project/structout/)