This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

Transform reStructuredText into XML Atom 1.0

Project Description

About

rst2atom is exactly what you think. It uses gdata.atom.data structures to build the XML.

The package should be considered highly experimental until I learned more about XML Atom and docutils or someone else contributes to the project.

Requirements

rst2atom uses gdata python client library and pygments. While gdata library is required, pygments it isn’t but is recommended to properly parse sourcecode directives.

Install

Using easy_install:

easy_install rst2atom

or pip:

pip install rst2atom

or download the source package and type:

python setup.py install

Usage

rst2atom extends the standard html writer. Write documents as usual and don’t forget to add bibliographic elements like author, date and category (not implemented yet).

Here the classic hello world example:

Hello world
===========

asdfasdfadf

.. sourcecode:: python

        def print_(obj):
                print obj

asdasdf

Try it with livejournal:

$ rst2atom test.rst test.xml
$ curl -d @test.xml --digest -u <YOUR_USERNAME_HERE> -H \
    "Content-Type: application/atom+xml;type=entry" -v \
    http://www.livejournal.com/interface/atom/post

Fields

rst2atom suppose that there is just one entry for feed, maybe this behavior could change in the future but that is it so it sets entry’s field instead of feed’s fields.

For the moment just the following directives are understood by rst2atom:

author
This field sets the entry author if is child of docinfo. If it is child of authors add a contributor.
contact
The contact field sets the email of the author if the node parent is author, else if at least one contributor is given, sets its email.
date
This sets the updated attribute.
copyright
Sets the rights attribute.
Release History

Release History

This version
History Node

0.1.1

History Node

0.1

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
rst2atom-0.1.1.tar.gz (8.6 kB) Copy SHA256 Checksum SHA256 Source Jan 23, 2011

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