txtwrap 2.1.0

A simple text wrapping tool.

TxTWrap🔡

A tool for wrapping a text.🔨

All constants, functions, and classes❕

• LOREM_IPSUM_WORDS
• LOREM_IPSUM_SENTENCES
• LOREM_IPSUM_PARAGRAPHS
• TextWrapper (Updated)
• mono
• word (Updated)
• wrap (Updated)
• align (Updated)
• fillstr (Updated)
• printwrap (Updated)
• indent
• dedent
• shorten (Updated)

Documents📄

Wrapper📦

class TextWrapper:

    def __init__(

        self,
        width: Union[int, float] = 70,
        start: SupportsIndex = 0,
        linegap: Union[int, float] = 0,
        method: Literal['mono', 'word'] = 'word',
        alignment: Literal['left', 'center', 'right', 'fill',
                           'fill-left', 'fill-center', 'fill-right'] = 'left',
        fillchar: str = ' ',
        placeholder: str = '...',
        prefix: Optional[str] = None,
        separator: Optional[str] = None,
        preserve_empty: bool = True,
        use_minimum_width: bool = True,
        justify_last_line: bool = False,
        break_on_hyphens: bool = True,
        sizefunc: Callable[[str], Tuple[Union[int, float],
                                        Union[int, float]]] = lambda s : (len(s), 1),
        predicate: Callable[[str], bool] = lambda line: line.strip()

    ) -> None

width : int | float => The maximum width of the wrapped line. Default: 70.

start : SupportsIndex => The starting index of the text (specific to the shorten method). Default: 0.

linegap : int | float => The gap between lines (specific to the align method). Default: 0.

method : Literal['mono', 'word'] => The text wrapping method. Default: 'word'.

alignment : Literal['left', 'center', 'right', 'fill', 'fill-left', 'fill-center', 'fill-right'] => The text alignment (specific to align and fillstr method). Default: 'left'.

fillchar : str => The character used for padding. Default: ' '.

placeholder : str => The placeholder used when shortening text (specific to the shorten method). Default: '...'.

prefix : Optional[str] => A prefix to add or remove (for the indent method, it must be a string and will be added at the beginning of each line. For dedent, it is optional and removes the prefix from the beginning of each line). Default: None.

separator : Optional[str] => The separator used between words. Default: None.

preserve_empty : bool => Whether to retain empty lines. Default: True.

use_minimum_width : bool => Whether to use the minimum detected width (specific to the align and fillstr methods). Default: True.

justify_last_line : bool => Whether to adjust the alignment of the last line (applies to align and fillstr methods, but only for non-wrapped text and only for fill alignment). Default: False.

break_on_hyphens : bool => Whether to allow breaking words at hyphens (-) (specific to align and fillstr methods). Default: True.

sizefunc : (str) -> tuple[int | float, int | float] => A function to calculate the width and height of the text. The default is a lambda function returning the text length as width and 1 as height.

predicate : (str) -> bool => A function to filter lines (specific to indent and dedent methods). The default is a lambda function that trims empty lines from the left and right.

Mod📦 python -m txtwrap

usage: txtwrap [-h] [-v] [-w <int>] [-s <int>] [-m {word|mono|indent|dedent|shorten}]
               [-a {left|center|right|fill|fill-left|fill-center|fill-right}] [-f <str>] [-p <str>]
               [-x <str>] [-r <str>] [-n] [-i] [-j] [-b] text

Command-line tool for wrapping, aligning, or shortening text.

positional arguments:
  text                  Target text

options:
  -h, --help            show this help message and exit
  -v, --version         Show the version of the txtwrap
  -w <int>, --width <int>
                        Width of the text wrapping (default: current width terminal or 70)
  -s <int>, --start <int>
                        start index of the text to be shorten (default: 0)
  -m {word|mono|indent|dedent|shorten}, --method {word|mono|indent|dedent|shorten}
                        Method to be applied to the text (default: "word")
  -a {left|center|right|fill|fill-left|fill-center|fill-right},
  --alignment {left|center|right|fill|fill-left|fill-center|fill-right}
                        Alignment of the text (default: "left")
  -f <str>, --fillchar <str>
                        Fill character (default: " ")
  -p <str>, --placeholder <str>
                        Placeholder to be used when shortening the text (default: "...")
  -x <str>, --prefix <str>
                        Prefix to be added (indent) or remove (dedent) to the text
  -r <str>, --separator <str>
                        The separator used between words
  -n, --neglect-empty   Neglect empty lines in the text
  -i, --use-minimum-width
                        Whether to use the minimum detected width
  -j, --justify-last-line
                        Whether to adjust the alignment of the last line
  -b, --not-break-on-hyphens
                        Doesn't break on hyphens

for example: python|py -m txtwrap "Lorem ipsum odor amet, consectetuer adipiscing elit." -w 20 `
             -m word -a center

Examples❓

Render a wrap text in PyGame🎮

from typing import Literal, Optional
from txtwrap import align, LOREM_IPSUM_PARAGRAPHS
import pygame

def render_wrap(

    font: pygame.Font,
    text: str,
    width: int,
    antialias: bool,
    color: pygame.Color,
    background: Optional[pygame.Color] = None,
    linegap: int = 0,
    method: Literal['word', 'mono'] = 'word',
    alignment: Literal['left', 'center', 'right', 'fill',
                       'fill-left', 'fill-center', 'fill-right'] = 'left',
    preserve_empty: bool = True,
    use_minimum_width: bool = True,
    justify_last_line: bool = False,
    break_on_hyphens: bool = True

) -> pygame.Surface:

    align_info = align(
        text=text,
        width=width,
        linegap=linegap,
        method=method,
        alignment=alignment,
        preserve_empty=preserve_empty,
        use_minimum_width=use_minimum_width,
        justify_last_line=justify_last_line,
        break_on_hyphens=break_on_hyphens,
        return_details=True,
        sizefunc=font.size
    )

    surface = pygame.Surface(align_info['size'], pygame.SRCALPHA)

    if background is not None:
        surface.fill(background)

    for x, y, text in align_info['aligned']:
        surface.blit(font.render(text, antialias, color), (x, y))

    return surface

# Example usage:
pygame.init()
pygame.display.set_caption("Lorem Ipsum")

running = True
width, height = 800, 600
screen = pygame.display.set_mode((width, height))
clock = pygame.time.Clock()

surface = render_wrap(
    font=pygame.font.SysFont('Arial', 18),
    text=LOREM_IPSUM_PARAGRAPHS,
    width=width,
    antialias=True,
    color='#ffffff',
    background='#303030',
    alignment='fill'
)

wsurf, hsurf = surface.get_size()
pos = ((width - wsurf) / 2, (height - hsurf) / 2)

while running:
    for event in pygame.event.get():
        if event.type == pygame.QUIT:
            running = False
    screen.fill('#000000')
    screen.blit(surface, pos)
    pygame.display.flip()
    clock.tick(60)

Print a wrap text to terminal🔡

from txtwrap import printwrap, LOREM_IPSUM_WORDS

width = 20

printwrap(LOREM_IPSUM_WORDS, width=width, alignment='left')
print('=' * width)
printwrap(LOREM_IPSUM_WORDS, width=width, alignment='center')
print('=' * width)
printwrap(LOREM_IPSUM_WORDS, width=width, alignment='right')
print('=' * width)
printwrap(LOREM_IPSUM_WORDS, width=width, alignment='fill') # or alignment='fill-left'
print('=' * width)
printwrap(LOREM_IPSUM_WORDS, width=width, alignment='fill-center')
print('=' * width)
printwrap(LOREM_IPSUM_WORDS, width=width, alignment='fill-right')

Short a long text🔤

from txtwrap import shorten, LOREM_IPSUM_SENTENCES

print(shorten(LOREM_IPSUM_SENTENCES, width=20, placeholder='…'))

Bonus🎁 - Print a colorfull text to terminal🔥

# Run this code in a terminal that supports ansi characters

from re import compile
from random import randint
from txtwrap import printwrap, LOREM_IPSUM_PARAGRAPHS

# Set the text to be printed here
text = LOREM_IPSUM_PARAGRAPHS

remove_ansi_regex = compile(r'\x1b\[(K|.*?m)').sub

def len_no_ansi(s: str):
    return len(remove_ansi_regex('', s))

while True:
    printwrap(
        ''.join(f'\x1b[{randint(31, 36)}m{char}' for char in text) + '\x1b[0m',
        end='\x1b[H\x1b[J',
        alignment='fill',
        lenfunc=len_no_ansi
    )