hbutils.string.trunc

Overview:

Useful utilities for truncate (shorten) your string.

truncate

hbutils.string.trunc.truncate(text: str, width: int = 70, tail_length: int = 0, show_length: bool = False)

Overview:

Truncate string into short form.

Arguments:

• text (str): Original text to be truncated.

• width (int): Final width of the new string, default is 70.

• tail_length (int): Tail’s length of the new string, default is 0 which means no tail.

• show_length (bool): Show length in middle part or not, default is False which means do not show this.

Returns:

• shortened (str) Short-formed string.

Examples::

>>> from hbutils.string import truncate
>>> truncate('abc ' * 30, width=30)
'abc abc abc abc abc abc ... '
>>> truncate('abc ' * 30, width=40, tail_length=10)
'abc abc abc abc abc abc ... c abc abc '
>>> truncate('abc ' * 30, width=40, tail_length=10, show_length=True)
'abc abc abc ..(120 chars).. c abc abc '