This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description

Welcome to jxmlease: a Python module for converting XML to intelligent Python data structures, and converting Python data structures to XML.

What is jxmlease?

Do you have a requirement to process XML data, but find it cumbersome to process XML data in Python? If so, you are not alone.

The main problem with processing XML data in Python is that it doesn’t map well to native Python data structures. XML contains both data and metadata, while native Python objects (lists, dictionaries, and strings) only contain data.

But, wait! That’s not completely true. Actually, Python objects do have the ability to hold metadata. jxmlease subclasses Python list, dictionary, and string types to create new, smart XML classes that can represent the XML data as normal Python objects while also maintaining the metadata for you to use.

For example, consider this sample XML document:

<a>
  <b>
    <z changed="true">foo</z>
  </b>
  <c>
    <d>
      <z changed="true">bar</z>
    </d>
  </c>
  <e>
    <z>baz</z>
  </e>
</a>

Using jxmlease, you can get a standard Python representation of the data in this XML document:

>>> root = jxmlease.parse(xml)
>>> root.prettyprint()
{u'a': {u'b': {u'z': u'foo'},
        u'c': {u'd': {u'z': u'bar'}},
        u'e': {u'z': u'baz'}}}

You can also still access the metadata:

>>> root['a']['b']['z'].get_xml_attr("changed")
u'true'

jxmlease also provides flexibility for parsing your data. If you only need select information from your XML data, you can have jxmlease return it while it is parsing the document:

>>> for path, _, node in jxmlease.parse(xml, generator="z"):
...     changed = node.get_xml_attr("changed", None) is not None
...     print("%-8s: %s %s" % (path, node, "(changed)" if changed else ""))
...
/a/b/z  : foo (changed)
/a/c/d/z: bar (changed)
/a/e/z  : baz

You can also iterate over the full, parsed document:

>>> for node in root.find_nodes_with_tag("z"):
...     changed = node.get_xml_attr("changed", None) is not None
...     print("%s %s" % (node, "(changed)" if changed else ""))
...
foo (changed)
bar (changed)
baz

These iterations can even return part of an XML tree:

>>> for node in root.find_nodes_with_tag(("b", "c")):
...     print("<%s>: %s" % (node.tag, node))
...
<b>: {u'z': u'foo'}
<c>: {u'd': {u'z': u'bar'}}

And, importantly, these objects are subclasses of Python objects, so things like string comparisons work correctly:

>>> root['a']['b']['z'] == "foo"
True
>>> root['a']['b']['z'] == "bar"
False

You can also easily produce XML output from typical Python objects:

>>> print(jxmlease.emit_xml({'a': {'b': 'foo', 'c': 'bar'}}))
<?xml version="1.0" encoding="utf-8"?>
<a>
    <c>bar</c>
    <b>foo</b>
</a>

We think that these features, and others, combine to ease XML processing in Python: hence, the name: jxmlease.

Documentation

The documentation is hosted on readthedocs.

Installation

See the installation instructions. for more information on installing jxmlease.

Release History

Release History

1.0.1

This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

1.0

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
jxmlease-1.0.1-py2.py3-none-any.whl (37.7 kB) Copy SHA256 Checksum SHA256 2.7 Wheel Apr 18, 2016
jxmlease-1.0.1.tar.gz (49.2 kB) Copy SHA256 Checksum SHA256 Source Apr 18, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS HPE HPE Development 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