Skip to main content

Python text markup and conversion

Project description

pyth3 - Python text markup and conversion

Pyth is intended to make it easy to convert marked-up text between different common formats. This is a (rather incomplete so far) port of pyth 0.6.0 to Python 3.

Marked-up text means text which has:

  • Paragraphs
  • Headings
  • Bold, italic, and underlined text
  • Hyperlinks
  • Bullet lists
  • Simple tables
  • Very little else

Formats that have (very varying) degrees of support are

  • Plain text
  • RTF (Rich Text Format)
  • PDF (output only)

Design principles/goals

  • Ignore unsupported information in input formats (e.g. page layout)
  • Ignore font issues -- output in a single font.
  • Ignore specific text sizes, but maintain italics, boldface, subscript/superscript
  • Have no dependencies unless they are written in Python, and work
  • Make it easy to add support for new formats, by using an architecture based on plugins and adapters.


See directory examples.

Python 3 migration

The code was originally written for Python 2. It has been partially(!) upgraded to Python 3 compatibility (starting via 'modernize'). This does not mean it will actually work!

pyth.plugins.rtf15.reader has been debugged and now appears to work correctly. pyth.plugins.xhtml.writer has been debugged and now appears to work correctly. pyth.plugins.plaintext.writer has been debugged and now appears to work correctly. Everything else is unknown (or definitely broken on Python 3: even many of the tests fail) See directory py3migration for a bit more detail. (If you find something is broken on Python 2 that worked before, please either fix it or simply stick to pyth version 0.6.0.)



  • bulleted or enumerated items will be returned as plain paragraphs (no indentation, no bullets).
  • cannot cope with Symbol font correctly:
    • from MS Word: lower-coderange characters (greek mostly) work
    • from MS Word: higher-coderange characters are missing, because Word encodes them in a horribly complicated manner not supported by pyth currently
    • from Wordpad: lower- and higher-coderange characters come out in the wrong encoding (ANSI, I think)


  • very limited functionality


  • very very limited functionality


  • will not work on Python 3 without some porting love-and-care


Don't try to run them all, it's frustrating. py.test -v is a good way to run the least frustrating subset of them. It is normal that most others will fail on Python 3. generates test cases dynamically based on existing input files in tests/rtfs and existing reference output files in tests/rtf-as-html and tests/rtf-as-html. The empty or missing output files indicate where functionality is missing, which nicely indicates possible places to jump in if you want to help.


Only the most important two of the dependencies, are actually declared in, because the others are large, yet are required only in pyth components not yet ported to Python 3. They are:

  • reportlab for PDFWriter
  • docutils for LatexWriter

Project details

Release history Release notifications | RSS feed

This version


Download files

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

Source Distribution

pyth3-0.7.tar.gz (29.0 kB view hashes)

Uploaded Source

Built Distribution

pyth3-0.7-py3-none-any.whl (29.1 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page