Skip to main content

Lightweight OPML parsing.

Project description

2007-03-20 08:30:21 -0700 (Tue, 20 Mar 2007)

Nathan R. Yergler <>

Creative Commons

opml provides simple support for reading OPML files. OPML is an XML-based format for describing outlines and is often used as an interchange format for subscription lists. This package is intended as a light-weight, permissive parser. It does very little validation of the incoming OPML.


The Python OPML package and its dependencies may be installed using easy_install (recommended)

$ easy_install opml

or by using the standard distutils

$ python install

If installing using, lxml will also need to be installed. easy_install will manage this for you.


opml can parse OPML from a URI or from a local string. For example, to parse an example from the OPML validator:

>>> import opml
>>> outline = opml.parse(
... '')

Elements in the OPML header can be accessed as attributes:

>>> outline.title
>>> outline.ownerName
'Dave Winer'
>>> outline.ownerEmail

Items in an OPML outline are stored in <outline> elements; these are accessible via the standard Python sequence operators:

>>> len(outline)
>>> outline[0]
<opml.OutlineElement object at ...>

An OutlineElement object exposes the attributes associated with the element as properties:

>>> outline[0].text
>>> outline[0].type

outline elements may contain other outline elements:

>>> len(outline[0])

When parsing a feed with nested items, the sub-items are accessible using the standard Python sequence operators:

>>> nested = \
... opml.parse('')
>>> len(nested[0])
>>> nested[0][0].text
>>> len(nested[0][0])
>>> nested[0][0][0].text


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

opml-0.5.tar.gz (4.9 kB view hashes)

Uploaded source

Built Distribution

opml-0.5-py2.5.egg (5.3 kB view hashes)

Uploaded 2 5

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