parawrap 1.0

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.

$ pip install parawrap

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