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!

generalized pretty print based on Wadler's paper

Project Description


Python’s standard pretty print library (pprint) doesn’t support user defined class. Once I wanted to print Python’s AST prettier, however it’s not possible to use “pprint” for the purpose.

What is it?

This library is an implementation in Python of “A prettier print” introduced by Philip Wadler.

The algorithm was also implemented in Ruby’s standard library: prettyprint.rb.


The purpose of this library is to give prettyprint ability on your class. In examples/ you can see such examples. Here are small samples.

>>> from prettier import *
>>> docs = [Text("1. abc"), Text("2. abc"), Text("3. abc")]

# fill given space
>>> print(pretty(40, fill(docs)))
1. abc 2. abc 3. abc

>>> print(pretty(13, fill(docs)))
1. abc 2. abc
3. abc

>>> print(pretty(8, fill(docs)))
1. abc
2. abc
3. abc

# horizontal only
>>> print(pretty(1, spread(docs)))
1. abc 2. abc 3. abc

# vertical only
>>> print(pretty(100, stack(docs)))
1. abc
2. abc
3. abc

# when there isn't enough space to put horizontal, put vertical
>>> print(pretty(20, stack_or_spread(docs)))
1. abc 2. abc 3. abc

>>> print(pretty(13, stack_or_spread(docs)))
1. abc
2. abc
3. abc

# when there isn't enough space to put horizontal, use indent
>>> print(pretty(10, can_break_with_nest(docs)))
1. abc
  2. abc
  3. abc


$ easy_install prettier


Read the doctest please.


0.92 (2010-09-02)

  • Relative file(“README.rst”) fail on PyPI server. Fixed the bug in
  • Because I didn’t write, README.rst wasn’t included in source distribution. Add it.
  • PEP8 discouraged underscores in module name. Renamed it.

0.91 (2010-09-02)

  • Because I did $ python sdist bdist bdist_egg upload, there comes "dumb" binary. Removed bdist.

0.9 (2010-09-02)

  • first release


  • Make a function pprint(obj) which work like standard pprint.pprint

When the goal is achived the version goes 1.0.

For developer(include me)

Here is the repository:

Don’t forget to run test and confirm tests cover all code:

$ coverage run prettier/ && coverage html

Don’t forget to test README.rst is valid:

$ README.rst > README.html

When you relaese new version, don’t put bdist option.:

$ python sdist bdist_egg upload


Same as Python 3.0.


  • Takayuki SHIMIZUKAWA <shimizukawa at gmail com>
  • Atsushi Odagiri <aodagx at gmail com>
  • yutaka matsubara <yutaka matsubara at gmail com>


NISHIO Hirokazu <nishio (dot) hirokazu (at) gmail (dot) com>

Release History

Release History

This version
History Node


Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
prettier-0.92-py2.6.egg (17.6 kB) Copy SHA256 Checksum SHA256 2.6 Egg Sep 2, 2010
prettier-0.92.tar.gz (6.0 kB) Copy SHA256 Checksum SHA256 Source Sep 2, 2010

Supported By

WebFaction WebFaction Technical Writing 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 Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting