Skip to main content

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().

parawrap.split(text)
Splits text into multiple paragraphs, returning a list of paragraphs.

Installation

To install from PyPi:

$ pip install parawrap

You can get a copy of the source by using:

$ git clone https://github.com/ecometrica/parawrap.git

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.

Credits

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

Project details


Release history Release notifications

This version

1.0

Download files

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

Files for parawrap, version 1.0
Filename, size File type Python version Upload date Hashes
Filename, size parawrap-1.0.tar.gz (3.0 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page