tw@43: EmeraldTree, a light-weight toolkit for XML processing in Python tw@43: ================================================================ tw@42: tw@43: EmeraldTree is a fork of ElementTree - the main differences are: tw@43: * It has a slightly different API: tw@42: * Handling of text: it uses unicode objects as children (not as tw@42: "tail" attributes of the elements) tw@42: * API cleanups, removing backward compatibility tw@42: * Better unicode support tw@42: * Other improvements / optimizations tw@42: tw@42: The fork happened at ElementTree 1.3a3-20070912-preview, for more details tw@42: please see the EmeraldTree repository: tw@42: tw@42: http://hg.moinmo.in/EmeraldTree/ tw@42: tw@43: Please note: EmeraldTree works with Python 2.4 (or later). tw@43: tw@42: Changes are (c) by their authors (see also source files) and licensed tw@43: under the same Python (MIT style) license as ElementTree (see below): tw@42: * Bastian Blank tw@42: tw@42: tw@42: Here is the original README contents of ElementTree: bblank@0: bblank@0: ======================= bblank@0: The elementtree library bblank@0: ======================= bblank@0: bblank@0: This kit contains the ElementTree library, a light-weight toolkit for bblank@0: XML processing in Python. bblank@0: bblank@0: For more information on this library, see: bblank@0: bblank@0: docs/index.html bblank@0: http://effbot.org/zone/element.htm bblank@0: bblank@0: The 1.3 release is designed to work with Python 2.2 and newer. If you bblank@0: need support for earlier Python releases, use ElementTree 1.2.6. bblank@0: bblank@0: Enjoy /F bblank@0: bblank@0: fredrik@pythonware.com bblank@0: http://www.pythonware.com bblank@0: bblank@0: -------------------------------------------------------------------- bblank@0: release info bblank@0: -------------------------------------------------------------------- bblank@0: bblank@0: This is release 1.3 alpha 3 of the ElementTree library. bblank@0: bblank@0: For a list of changes in this release, see the CHANGES document. bblank@0: bblank@0: The latest version of this library can be downloaded from: bblank@0: bblank@0: http://effbot.org/downloads bblank@0: bblank@0: Comments, bug reports, and patches are welcome. Send them to bblank@0: fredrik@pythonware.com. bblank@0: bblank@0: Note that this is free software, with limited support. If you need bblank@0: commercial support on this module, contact fredrik@pythonware.com. bblank@0: bblank@0: -------------------------------------------------------------------- bblank@0: contents bblank@0: -------------------------------------------------------------------- bblank@0: bblank@0: README This file bblank@0: bblank@0: CHANGES List of changes in this release. bblank@0: bblank@0: elementtree/ bblank@0: bblank@0: ElementTree.py Element tree implementation. For a minimal bblank@0: install, this file is all you need. bblank@0: bblank@0: ElementPath.py Element path support module. Adds limited bblank@0: XPath support to find/findtext/findall. bblank@0: bblank@0: ElementInclude.py Element include support module. Adds limited bblank@0: XInclude support. bblank@0: bblank@0: HTMLTreeBuilder.py Element tree builder for HTML. This only bblank@0: works for mostly well-formed HTML; if you bblank@0: need something that can parse arbitrary bblank@0: HTML at least as good as your browser, use bblank@0: TidyHTMLTreeBuilder or TidyTools (see below). bblank@0: bblank@0: TidyHTMLTreeBuilder.py Element tree builder for HTML, based on the bblank@0: tidylib library. This tree builder requires bblank@0: the _elementtidy extension module (available bblank@0: from http://effbot.org/downloads). bblank@0: bblank@0: SimpleXMLWriter.py Simple XML writer bblank@0: bblank@0: TidyTools.py Build element trees from HTML, using the bblank@0: external 'tidy' utility. bblank@0: bblank@0: setup.py Build/installation script bblank@0: bblank@0: docs/index.html API reference pages. bblank@0: docs/* bblank@0: bblank@0: demo*.py Sample scripts bblank@0: samples/* Sample data bblank@0: bblank@0: selftest.py Selftest (requires Python 2.1 or later) bblank@0: tidytest.py Selftest for TidyHTMLTreeBuilder components. bblank@0: bblank@0: benchmark.py Benchmark script (usage: benchmark.py file) bblank@0: bblank@0: -------------------------------------------------------------------- bblank@0: license bblank@0: -------------------------------------------------------------------- bblank@0: bblank@0: The ElementTree Library is bblank@0: bblank@0: Copyright (c) 1999-2007 by Secret Labs AB bblank@0: Copyright (c) 1999-2007 by Fredrik Lundh bblank@0: bblank@0: By obtaining, using, and/or copying this software and/or its bblank@0: associated documentation, you agree that you have read, understood, bblank@0: and will comply with the following terms and conditions: bblank@0: bblank@0: Permission to use, copy, modify, and distribute this software and its bblank@0: associated documentation for any purpose and without fee is hereby bblank@0: granted, provided that the above copyright notice appears in all bblank@0: copies, and that both that copyright notice and this permission notice bblank@0: appear in supporting documentation, and that the name of Secret Labs bblank@0: AB or the author not be used in advertising or publicity pertaining to bblank@0: distribution of the software without specific, written prior bblank@0: permission. bblank@0: bblank@0: SECRET LABS AB AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO bblank@0: THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND bblank@0: FITNESS. IN NO EVENT SHALL SECRET LABS AB OR THE AUTHOR BE LIABLE FOR bblank@0: ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES bblank@0: WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN bblank@0: ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT bblank@0: OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. bblank@0: --------------------------------------------------------------------