Skip to main content
Help us improve PyPI by participating in user testing. All experience levels needed!

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.newline()
d.h2('Contents')
d.directive(name="contents", fields=[('local', ''), ('backlinks', 'None')])
d.newline()
d.h2('Code -- shebang')
d.codeblock('#!/usr/bin/env')

d.print_content()

Would result in the following reStructuredText:

===========
Example Use
===========

Contents
--------

.. contents::
   :local:
   :backlinks: None

Code -- shebang
---------------

::

   #!/usr/bin/env

Status

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


Release history Release notifications

This version
History Node

0.2.6

History Node

0.2.5

History Node

0.2.4

History Node

0.2.3

History Node

0.2.2

History Node

0.2.1

History Node

0.2.0

History Node

0.1.4

History Node

0.1.2

History Node

0.1.1

History Node

0.1

History Node

0.1-dev

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
rstcloth-0.2.6.tar.gz (10.0 kB) Copy SHA256 hash SHA256 Source None Nov 30, 2016

Supported by

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