Welcome, guest | Sign In | My Account | Store | Cart

Notice! PyPM is being replaced with the ActiveState Platform, which enhances PyPM’s build and deploy capabilities. Create your free Platform account to download ActivePython or customize Python with the packages you require and get automatic updates.


rst2atom is unavailable in PyPM, because there aren't any builds for it in the package repositories. Click the linked icons to find out why.

 Python 2.7Python 3.2Python 3.3
Windows (32-bit)
0.1.1 Failed View build log
0.1 Failed View build log
Windows (64-bit)
0.1.1 Failed View build log
0.1 Failed View build log
Mac OS X (10.5+)
0.1.1 Failed View build log
0.1 Failed View build log
Linux (32-bit)
0.1.1 Failed View build log
0.1 Failed View build log
Linux (64-bit)
0.1.1 Failed View build log
0.1 Failed View build log
Lastest release
version 0.1.1 on Jan 24th, 2011


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.


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.


Using easy_install:

easy_install rst2atom

or pip:

pip install rst2atom

or download the source package and type:

python setup.py install


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


.. sourcecode:: python

        def print_(obj):
                print obj


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 \


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:

This field sets the entry author if is child of docinfo. If it is child of authors add a contributor.
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.
This sets the updated attribute.
Sets the rights attribute.

Subscribe to package updates

Last updated Jan 24th, 2011

What does the lock icon mean?

Builds marked with a lock icon are only available via PyPM to users with a current ActivePython Business Edition subscription.

Need custom builds or support?

ActivePython Enterprise Edition guarantees priority access to technical support, indemnification, expert consulting and quality-assured language builds.

Plan on re-distributing ActivePython?

Get re-distribution rights and eliminate legal risks with ActivePython OEM Edition.