Skip to main content

Dot notation for ElementTrees

Project description

build-status-image pypi-version wheel

Overview

Wouldn’t it be nice to use dot notation for ElementTrees? This package allows for:

tree = ET.fromstring('<root><a><b c="asdf" /></a></root>')
a = tree.a
b = a.b
b.attrib['c'] == "asdf" # True

tree.a will be a `Element <https://docs.python.org/3.4/library/xml.etree.elementtree.html#xml.etree.ElementTree.Element>`__ with the extra `__getattr__ <https://github.com/arve0/objectifiedetree/blob/master/objectifiedetree/__init__.py#L11-12>`__ method. This means that you can use the element as you would do normally, but names in your XML that crases with python’s methods or attributes must be accessed through tree.find(xpath).

This package uses the python implementation of etree, which makes it slower than etree found in CPython. An alternative would be to monkey-patch the built-in with forbiddenfruit, but I haven’t looked into this.

objectifiedetree has copied the python implementation of etree from CPython 3.4 Lib/xml/etree and will probably only work with Python 3.4.

Installation

Install using pip

pip install objectifiedetree

Example

from objectifiedetree import *

tree = ET.parse('/path/to/file.xml')
# dot notation :-)
el = tree.xpath.to.your.element

# use normal etree attributes
print(el.attrib)

# access name crashes
attrib_el = el.find('./attrib')

Development

Install dependencies and link development version of objectifiedetree to pip:

git clone https://github.com/arve0/objectifiedetree
cd objectifiedetree
pip install -r requirements.txt # install dependencies and objectifiedetree-package

Testing

tox

Build documentation locally

To build the documentation:

pip install -r docs/requirements.txt
make docs

Project details


Download files

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

Source Distribution

objectifiedetree-0.0.1.tar.gz (27.6 kB view details)

Uploaded Source

Built Distribution

objectifiedetree-0.0.1-py2.py3-none-any.whl (25.4 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file objectifiedetree-0.0.1.tar.gz.

File metadata

File hashes

Hashes for objectifiedetree-0.0.1.tar.gz
Algorithm Hash digest
SHA256 4a79af55ca09e0239be4d6c0f85b58e6f96ccf9ca3361799d4f7b2932e1cb672
MD5 d8f1c4dc91b63ceaa504b2c14ce09bf3
BLAKE2b-256 5a20d3223783b8e8c4a05bc07615de6e04ab203c6643d7e165c40800c6ae1d8d

See more details on using hashes here.

File details

Details for the file objectifiedetree-0.0.1-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for objectifiedetree-0.0.1-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 f8cfdff46c9e78dc7d6c806981733e32c57d29033b828a05021d580788bf37ce
MD5 1c059389b5afedf8edfbb1f39cbe99a0
BLAKE2b-256 1b587abafae2a0bbe04ffcbccb13d406f25569788cb32ee4d98d526ece6f9ad0

See more details on using hashes here.

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