Skip to main content

A simple Python API for generating RestructuredText.

Project description

Background and Goals

reStructuredText is a powerful human-centric markup language that is well defined, flexible, with powerful tools that make writing and maintaining text easy and pleasurable. Humans can edit reStructuredText without the aide of complex editing tools, and the resulting source is easy to manipulate and process.

One of the key features of reSturcturedText is it’s relatively complete extension API, which makes it possible to minimize fragile repetitive structures in source files and increase the ease of production. While you can use these extensions to build custom content types with ease, extensions make reStructuredText source less portable and less intuitive to edit for casual contributors.

As an alternative and a supplement, RstCloth is a Python API for writing well formed reStructuredText programatically. RstCloth facilitates :

  • generating data-driven content views into existing reStructuredText environments and tools.
  • automating content generation and modification without creating unportable-restructured text.
  • ensuring that the tool chain is easily debugable by using transparent intermediate formats.

Example Use

The following RstCloth code:

from rstcloth import RstCloth

d = RstCloth()

d.title('Example Use')
d.directive(name="contents", fields=[('local', ''), ('backlinks', 'None')])
d.h2('Code -- shebang')


Would result in the following reStructuredText:

Example Use


.. contents::
   :backlinks: None

Code -- shebang




RstCloth is undergoing ongoing development and expansion is not stable at this point. Current features and projects include:

  • improve documentation.
  • develop unit testing framework to ensure consistent API behavior.
  • build/extend a table generation API.
  • improve paragraph level content generation API.

See the issue tracker for a more complete list of current and future projects.

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 rstcloth, version 0.2.6
Filename, size File type Python version Upload date Hashes
Filename, size rstcloth-0.2.6.tar.gz (10.0 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page