philiprehberger-text-table 0.1.6

Render data as clean ASCII/Unicode tables in the terminal with zero configuration

philiprehberger-text-table

Render data as clean ASCII/Unicode tables in the terminal with zero configuration.

Installation

pip install philiprehberger-text-table

Usage

from philiprehberger_text_table import table

headers = ["Name", "Age", "City"]
rows = [
    ["Alice", 30, "New York"],
    ["Bob", 25, "London"],
    ["Charlie", 35, "Tokyo"],
]

print(table(headers, rows))

Output:

┌─────────┬─────┬──────────┐
│ Name    │ Age │ City     │
├─────────┼─────┼──────────┤
│ Alice   │  30 │ New York │
│ Bob     │  25 │ London   │
│ Charlie │  35 │ Tokyo    │
└─────────┴─────┴──────────┘

From dictionaries

from philiprehberger_text_table import from_dicts

data = [
    {"name": "Alice", "score": 95},
    {"name": "Bob", "score": 87},
]

print(from_dicts(data))

From CSV

from philiprehberger_text_table import from_csv

print(from_csv("data.csv"))

Styles

# ASCII style
print(table(headers, rows, style="ascii"))

# Markdown style
print(table(headers, rows, style="markdown"))

# Minimal style (no borders)
print(table(headers, rows, style="minimal"))

# Compact style (no outer borders)
print(table(headers, rows, style="compact"))

Truncation

print(table(headers, rows, max_width=10))

API

Function	Description
table(headers, rows, *, style="unicode", max_width=None)	Render a table from headers and row data
from_dicts(data, *, style="unicode", max_width=None)	Render a table from a list of dictionaries
from_csv(path, *, style="unicode", max_width=None)	Read a CSV file and render as a table

Styles: "unicode", "ascii", "markdown", "minimal", "compact"

Development

pip install -e .
python -m pytest tests/ -v

License

MIT