Skip to main content

Abstracts out the implementation of elementtree behind the zope component architecture. And provides helper functions for testing XML output in tests.

Project description

z3c.etree

z3c.etree provides some mechanisms (a common interface) for integrating any ElementTree engine with the Zope component architecture. This allows applications to look up a engine against this interface. As such this package does not implement the ElementTree API.

z3c.etree also provides a set of utilities that can be used to make testing XML output in doctests easier. This functionality can also be called from a python based unit test via the assertXMLEqual method.

Developers

>>> import z3c.etree
>>> import z3c.etree.testing
>>> engine = z3c.etree.testing.etreeSetup()

Here are some examples for how to use z3c.etree with your own code.

To generate a Element object with the tag DAV:getcontenttype all we have to do is:

>>> etree = z3c.etree.getEngine()
>>> elem = etree.Element("{DAV:}getcontenttype")
>>> elem #doctest:+ELLIPSIS
<Element ...>
>>> z3c.etree.testing.assertXMLEqual(etree.tostring(elem), """
...    <getcontenttype xmlns="DAV:"/>""")

Now to add a value this element use just use the elem variable has the API suggests.

>>> elem.text = "text/plain"
>>> z3c.etree.testing.assertXMLEqual(etree.tostring(elem), """
...    <getcontenttype xmlns="DAV:">text/plain</getcontenttype>""")

Tear-down

>>> z3c.etree.testing.etreeTearDown()

Changes in z3c.etree

0.9.2

  • Bug: Fix Python 2.5 support.

  • Bug: Declared z3c as a namespace.

  • Implemented a way of comparing two XML fragments while ignoring the ordering of elements at the same level.

  • Allow the use of NORMALIZE_WHITESPACE with tag contents.

0.9.1

  • fix bug in getting access to the elementree engine

0.9

  • Start registering the elmenttree modules directly instead of using some proxy objects.

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

z3c.etree-0.9.2.tar.gz (12.0 kB view details)

Uploaded Source

File details

Details for the file z3c.etree-0.9.2.tar.gz.

File metadata

  • Download URL: z3c.etree-0.9.2.tar.gz
  • Upload date:
  • Size: 12.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for z3c.etree-0.9.2.tar.gz
Algorithm Hash digest
SHA256 2bc74352095267e2b8f30106b308c68589c57c44750d47bbb4905d85393cde83
MD5 b92ea245aa471074c4a6891f58bc9fe6
BLAKE2b-256 41ea8b17f5acf2196643632cc590b91e6e9c30318c0eb424fb10a971969363d8

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