steboxing 1.0.0

Put your text in a stylish box.

steboxing

A Python library for drawing Unicode text boxes around strings — supports 36 border styles using thin, bold, double, and round line characters.

Installation

pip install steboxing

Usage

from steboxing import boxing

print(boxing("Hello, World!", box_type="thin"))

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

Multi-line strings are supported:

print(boxing("Line one\nLine two\nLine three", box_type="double"))

╔════════════╗
║ Line one   ║
║ Line two   ║
║ Line three ║
╚════════════╝

box_type defaults to "thin" if omitted.

Box styles

box_type	Preview
thin	┌───────┐ │ lines │ └───────┘
double	╔═══════╗ ║ lines ║ ╚═══════╝
bold	┏━━━━━━━┓ ┃ lines ┃ ┗━━━━━━━┛
round	╭───────╮ │ lines │ ╰───────╯
bold_top_and_bottom	┍━━━━━━━┑ │ lines │ ┕━━━━━━━┙
double_top_and_bottom	╒═══════╕ │ lines │ ╘═══════╛
bold_left_and_right	┎───────┒ ┃ lines ┃ ┖───────┚
double_left_and_right	╓───────╖ ║ lines ║ ╙───────╜
bold_top_only	┍━━━━━━━┑ │ lines │ └───────┘
double_top_only	╒═══════╕ │ lines │ └───────┘
bold_bottom_only	┌───────┐ │ lines │ ┕━━━━━━━┙
double_bottom_only	┌───────┐ │ lines │ ╘═══════╛
bold_right_only	┌───────┒ │ lines ┃ └───────┚
double_right_only	┌───────╖ │ lines ║ └───────╜
bold_left_only	┎───────┐ ┃ lines │ ┖───────┘
double_left_only	╓───────┐ ║ lines │ ╙───────┘
bold_left_and_top	┏━━━━━━━┑ ┃ lines │ ┖───────┘
double_left_and_top	╔═══════╕ ║ lines │ ╙───────┘
bold_right_and_top	┍━━━━━━━┓ │ lines ┃ └───────┚
double_right_and_top	╒═══════╗ │ lines ║ └───────╜
bold_right_and_bottom	┌───────┒ │ lines ┃ ┕━━━━━━━┛
double_right_and_bottom	┌───────╖ │ lines ║ ╘═══════╝
bold_left_and_bottom	┎───────┐ ┃ lines │ ┗━━━━━━━┙
double_left_and_bottom	╓───────┐ ║ lines │ ╚═══════╛
bold_but_bottom	┏━━━━━━━┓ ┃ lines ┃ ┖───────┚
double_but_bottom	╔═══════╗ ║ lines ║ ╙───────╜
bold_but_left	┍━━━━━━━┓ │ lines ┃ ┕━━━━━━━┛
double_but_left	╒═══════╗ │ lines ║ ╘═══════╝
bold_but_top	┎───────┒ ┃ lines ┃ ┗━━━━━━━┛
double_but_top	╓───────╖ ║ lines ║ ╚═══════╝
bold_but_right	┏━━━━━━━┑ ┃ lines │ ┗━━━━━━━┙
double_but_right	╔═══════╕ ║ lines │ ╚═══════╛
bold_corners_only	┏───────┓ │ lines │ ┗───────┛
double_corners_only	╔───────╗ │ lines │ ╚───────╝
bold_chain	┏─━─━─━─┓ │ lines │ ┗─━─━─━─┛
double_chain	╔─═─═─═─╗ │ lines │ ╚─═─═─═─╝

Error handling

Passing an invalid box_type raises a ValueError listing all valid options:

boxing("text", box_type="unknown")
# ValueError: box_type not supported: unknown. Use one of: thin, double, bold, ...

License

MIT