Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Paragraph wrapping and filling.

Project Description

The parawrap module is an extended version of the built-in textwrap module. Like the standard module, it provides two convenience functions, wrap() and fill(). It also provides ParagraphWrapper, which is the class that does all the work. In addition, there is a split() function that splits up paragraphs.

parawrap.wrap(text[, width[, …]])

Wraps text (a string) so every line is at most width characters long. Respects paragraph breaks, which are lines separated by multiple newlines. Returns a list of output lines, without final newlines.

Optional keyword arguments correspond to the instance attributes of ParagraphWrapper, which mirrors textwrap.TextWrapper. width defaults to 70.

parawrap.fill(text[, width[, …]])

Wraps text and returns a single string containing the wrapped paragraphs. fill() is shorthand for:

"\n".join(wrap(text, ...))

In particular, fill() accepts exactly the same keyword arguments as wrap().

Splits text into multiple paragraphs, returning a list of paragraphs.


To install from PyPi:

$ pip install parawrap

You can get a copy of the source by using:

$ git clone

Note that this program requires Python 2.6 or higher.

Reporting bugs and submitting patches

Please check our issue tracker for known bugs and feature requests.

We accept pull requests for fixes and new features.


Simon Law wrote this program, with the generous support of Ecometrica.

Release History

This version
History Node


Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
(3.0 kB) Copy SHA256 Hash SHA256
Source None Jan 31, 2013

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Google Google Cloud Servers DreamHost DreamHost Log Hosting