framify 0.1.0

Dead simple terminal framing, tables and underlining – with proper wide‑character support.

framify 🖼️

Dead simple terminal framing, tables and underlining – with proper wide‑character support.

Why?

Building CLI tools often means manually aligning borders and tables, counting spaces for CJK characters or emoji. framify does the boring geometry for you, so you can focus on content.

Install

pip install framify

Quick examples

1. Box

from framify import frame

print(frame("Hello\nWorld"))

┌───────┐
│ Hello │
│ World │
└───────┘

2. Box with title and padding

print(frame("Success!", style="double", padding=2, title=" STATUS "))

3. Table

from framify import table

data = [
    ["Alice", "32", "Engineer"],
    ["Bob", "28", "Designer"],
]
print(table(data, headers=["Name", "Age", "Job"], style="rounded"))

4. Underline

from framify import underline

print(underline("Important"))

Style gallery

· single (default) · double · ascii · rounded · heavy

All handle CJK and emoji widths correctly thanks to wcwidth.

API

frame(text, *, style='single', padding=1, title=None, align='left')

Wrap multi‑line text in a box.

table(data, *, headers=None, style='single', col_align=None)

Format a list of lists as a table.

underline(text, char='─')

Return underlined text.

overline(text, char='─')

Return overlined text.

strikethrough(text, char='─')

Visual strikethrough (line below text).

License

MIT © itz_rival