graph-easy

A Python port of Graph::Easy, the Perl tool that lays out directed/undirected graphs and renders them as ASCII art (box-and-wire diagrams rendered in the terminal).

This project faithfully translates the original Perl implementation to Python, in order to provide the same functionality to Python users / as a native Python library and command-line tool.

Provenance & License

Original: Graph::Easy, Copyright (C) 2004 - 2008 by Tels (http://bloodgate.com/).
Upstream repository: https://github.com/ironcamel/Graph-Easy
This port is licensed under the GNU General Public License, version 2 or (at your option) any later version — the same license as the original Graph::Easy, because a port is a derivative work.

See LICENSE for the full LGPL/ GPL text.

Third-party color schemes

This product includes color specifications and designs developed by Cynthia Brewer (http://colorbrewer.org/), used under the Apache-Style Software License for ColorBrewer Color Schemes v1.1, © 2002 Cynthia Brewer, Mark Harrower, and The Pennsylvania State University. See the header of the original Graph::Easy::Attributes for the full notice.

Status

Actively-developed port. Currently implemented:

DSL parser: [ label ]/bare nodes, --> <-- <--> -- arrows, labelled edges (-- label -->), multiline labels (\n), comments
Layout engine: longest-path layering with orthogonal edge routing — chains, branches, merges and cycles all render correctly; independent components stack as separate diagrams
Edge line styles (faithful to upstream Parser::_edge_style): -- solid, .. dotted, == double, ~~ wave, ## bold, .-/..- dot-dash
Two output charsets: Unicode box-drawing by default (┌──┐ ──> ══ ║ ·), plain ASCII via --ascii

The heavier automatic layout engine (Graph::Easy::Layout grid solver) is a follow-up milestone.

Usage

$ printf '[ Bonn ] --> [ Berlin ] --> [ Hamburg ]\n' | graph-easy
┌──────┐         ┌────────┐         ┌─────────┐
│ Bonn │ ───────>│ Berlin │ ───────>│ Hamburg │
└──────┘         └────────┘         └─────────┘

Colours from fill/color attributes are on by default; use --no-color to disable, or --color auto to enable only on a TTY.

# plain-ASCII output
$ printf '[ A ] ..> [ B ]\n' | graph-easy --ascii
+---+         +---+
| A | .......>| B |
+---+         +---+

Development

$ python -m venv .venv && source .venv/bin/activate
$ pip install -e '.[dev]'
$ pytest

Acknowledgments

Thanks to Tels and the Graph::Easy contributors whose careful layout and rendering work this port builds upon.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

graph_easy-0.0.4.tar.gz (22.1 kB view details)

Uploaded Aug 14, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

graph_easy-0.0.4-py3-none-any.whl (20.1 kB view details)

Uploaded Aug 14, 2026 Python 3

File details

Details for the file graph_easy-0.0.4.tar.gz.

File metadata

Download URL: graph_easy-0.0.4.tar.gz
Upload date: Aug 14, 2026
Size: 22.1 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for graph_easy-0.0.4.tar.gz
Algorithm	Hash digest
SHA256	`b324577fc3be54b289e0bdde25234bc5c0aa0d5d9210d8e5f207bfd6ed60dfa1`
MD5	`f66e21bd63deb5feffe9cdd3031246d7`
BLAKE2b-256	`4e81c45d795fc58154fa858dd190d2f32e2ec4bbd3f620163ecfa1ea9138655d`

See more details on using hashes here.

Provenance

The following attestation bundles were made for graph_easy-0.0.4.tar.gz:

Publisher: publish.yml on y9c/graph-easy-py

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: graph_easy-0.0.4.tar.gz
- Subject digest: b324577fc3be54b289e0bdde25234bc5c0aa0d5d9210d8e5f207bfd6ed60dfa1
- Sigstore transparency entry: 2464936254
- Sigstore integration time: Aug 14, 2026
Source repository:
- Permalink: y9c/graph-easy-py@7c8f90456d6da277991b831384e49485efdcbf03
- Branch / Tag: refs/heads/main
- Owner: https://github.com/y9c
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@7c8f90456d6da277991b831384e49485efdcbf03
- Trigger Event: push