Python textwrap — ELI5
Have you ever typed a really long sentence in a text message, and your phone automatically breaks it into neat lines so you don’t have to scroll sideways? That’s basically what Python’s textwrap module does.
When your program has a long string of text — maybe a paragraph from a book or a help message — textwrap chops it into lines that fit inside a certain width. You tell it “I want each line to be at most 70 characters wide,” and it does the rest, breaking at word boundaries so nothing looks weird.
What else can it do?
- Indent text — add spaces or symbols at the start of each line (great for quoting or formatting output)
- Dedent text — remove common leading whitespace (handy when you have text inside indented code)
- Shorten text — cut a long string down to a max width and add ”…” at the end
Why not just do it yourself?
You could split text manually, but you’d have to handle word boundaries, hyphens, long words that don’t fit, and extra whitespace. textwrap has already solved all those edge cases.
One thing to remember
textwrap is your text-fitting tool — give it a paragraph and a width, and it hands back perfectly wrapped lines, no manual splitting needed.
See Also
- Python Atexit How Python's atexit module lets your program clean up after itself right before it shuts down.
- Python Bisect Sorted Lists How Python's bisect module finds things in sorted lists the way you'd find a word in a dictionary — by jumping to the middle.
- Python Contextlib How Python's contextlib module makes the 'with' statement work for anything, not just files.
- Python Copy Module Why copying data in Python isn't as simple as it sounds, and how the copy module prevents sneaky bugs.
- Python Dataclass Field Metadata How Python dataclass fields can carry hidden notes — like sticky notes on a filing cabinet that tools read automatically.