Skip to main content

The medium-featured, flexible reStructuredText utility

Project description

Flexirest is a project that was born out of the authors long-running interest for reStructuredText, and the idea of writing everyday documents like letters, invoices and other simple documents in this way.

Flexirest tries to strike a middle ground between docutils own command line tool chain (rst2html et al), that I find a little to minimalistic and Sphinx, that I find very nice but a little heavy to use for a quickie document like a random letter or some such.

In short, the goal of flexirest is to enable you to use the reST format for everyday documents instead of a word processor or similar with minimal fuzz. Hence you get to stay in the comfy environment of your text editor and tool chain. And you can check in your docs in text format into your version control system of choice. And, if used correctly, you get to reuse a couple of stylings that you only need to create once.

There are some modestly advanced tricks you can do too, primarily writing your own docutils roles, but I wouldn’t consider those the major points of flexirest.

For more information on how to operate flexirest, see the quick manual.



  • A mechanism of two-stage writing used to support a new writer, latex2pdf that renders directly to PDF via LaTeX if a suitable executable is available on the host system.
  • –infile option to specify input from a file
  • –outfile option to specify output to a file
  • –dump-parts option to inspect output from different docutils parts.
  • –list-writer option to list available writers on the host system.
  • No traceback when specifying a non-existant writer
  • All writers have at least the minimal template (%(whole)s)
  • Switch to Distribute instead of setuptools for development and packaging.
  • Many small bugfixes and stability improvements

Project details

Download files

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

Files for flexirest, version 0.8.2
Filename, size File type Python version Upload date Hashes
Filename, size flexirest-0.8.2-py2.5.egg (17.0 kB) File type Egg Python version 2.5 Upload date Hashes View
Filename, size flexirest-0.8.2-py2.6.egg (17.0 kB) File type Egg Python version 2.6 Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page