philiprehberger-string-truncate 0.1.6

Truncate strings intelligently without cutting words

philiprehberger-string-truncate

Truncate strings intelligently without cutting words.

Installation

pip install philiprehberger-string-truncate

Usage

from philiprehberger_string_truncate import truncate, truncate_middle, truncate_path

truncate("Hello beautiful world", max_length=15)
# "Hello…"

truncate("Hello beautiful world", max_length=15, suffix="...")
# "Hello..."

truncate_middle("Hello beautiful world of code", max_length=20)
# "Hello bea…l of code"

truncate_path("/very/long/path/to/some/file.txt", max_length=25)
# "/very/long/.../file.txt"

API

Function / Class	Description
truncate(text, max_length, suffix="…", break_words=False)	Word-boundary truncation
truncate_middle(text, max_length, separator="…")	Keep start and end
truncate_path(path, max_length, separator="/", placeholder="...")	Path-aware truncation

Development

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

License

MIT