Convert XML documents into Python objects
Project description
untangle
========
* Converts XML to a Python object.
* Siblings with similar names are grouped into a list.
* Children can be accessed with ``parent.child``, attributes with ``element['attribute']``.
* You can call the ``parse()`` method with a filename, an URL or an XML string.
* Substitutes ``-`` with ``_`` and ``.`` with ``_`` so ``<foobar><foo-bar/></foobar>`` can be accessed with ``foobar.foo_bar``
and ``<foo.bar.baz/>`` can be accessed with ``foo_bar_baz``
Installation
------------
```
git clone git://github.com/stchris/untangle.git
python setup.py test
python setup.py install
```
Works on Python 2.6, 2.7 and Pypy so far. Doesn't (completely) work on 2.4, 2.5, 3.x yet.
Usage
-----
(See and run <a href="https://github.com/stchris/untangle/blob/master/examples.py">examples.py</a> for more info)
```python
import untangle
obj = untangle.parse(resource)
```
``resource`` can be:
* a URL
* a filename
* an XML string
Running the above code and passing this XML:
```xml
<?xml version="1.0"?>
<root>
<child name="child1">
</root>
```
allows it to be navigated from the ``untangle``d object like this:
```python
obj.root.child['name'] # u'child1'
```
========
* Converts XML to a Python object.
* Siblings with similar names are grouped into a list.
* Children can be accessed with ``parent.child``, attributes with ``element['attribute']``.
* You can call the ``parse()`` method with a filename, an URL or an XML string.
* Substitutes ``-`` with ``_`` and ``.`` with ``_`` so ``<foobar><foo-bar/></foobar>`` can be accessed with ``foobar.foo_bar``
and ``<foo.bar.baz/>`` can be accessed with ``foo_bar_baz``
Installation
------------
```
git clone git://github.com/stchris/untangle.git
python setup.py test
python setup.py install
```
Works on Python 2.6, 2.7 and Pypy so far. Doesn't (completely) work on 2.4, 2.5, 3.x yet.
Usage
-----
(See and run <a href="https://github.com/stchris/untangle/blob/master/examples.py">examples.py</a> for more info)
```python
import untangle
obj = untangle.parse(resource)
```
``resource`` can be:
* a URL
* a filename
* an XML string
Running the above code and passing this XML:
```xml
<?xml version="1.0"?>
<root>
<child name="child1">
</root>
```
allows it to be navigated from the ``untangle``d object like this:
```python
obj.root.child['name'] # u'child1'
```
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
untangle-0.3.tar.gz
(2.7 kB
view hashes)