comparison README @ 0:5169fce2d144 upstream

Import ElementTree (1.3a3-20070912-preview).
author Bastian Blank <bblank@thinkmo.de>
date Fri, 30 May 2008 18:02:30 +0200
parents
children 7e448d707f62
comparison
equal deleted inserted replaced
-1:000000000000 0:5169fce2d144
1 $Id: README 3277 2007-09-12 07:14:03Z fredrik $
2
3 =======================
4 The elementtree library
5 =======================
6
7 This kit contains the ElementTree library, a light-weight toolkit for
8 XML processing in Python.
9
10 For more information on this library, see:
11
12 docs/index.html
13 http://effbot.org/zone/element.htm
14
15 The 1.3 release is designed to work with Python 2.2 and newer. If you
16 need support for earlier Python releases, use ElementTree 1.2.6.
17
18 Enjoy /F
19
20 fredrik@pythonware.com
21 http://www.pythonware.com
22
23 --------------------------------------------------------------------
24 release info
25 --------------------------------------------------------------------
26
27 This is release 1.3 alpha 3 of the ElementTree library.
28
29 For a list of changes in this release, see the CHANGES document.
30
31 The latest version of this library can be downloaded from:
32
33 http://effbot.org/downloads
34
35 Comments, bug reports, and patches are welcome. Send them to
36 fredrik@pythonware.com.
37
38 Note that this is free software, with limited support. If you need
39 commercial support on this module, contact fredrik@pythonware.com.
40
41 --------------------------------------------------------------------
42 contents
43 --------------------------------------------------------------------
44
45 README This file
46
47 CHANGES List of changes in this release.
48
49 elementtree/
50
51 ElementTree.py Element tree implementation. For a minimal
52 install, this file is all you need.
53
54 ElementPath.py Element path support module. Adds limited
55 XPath support to find/findtext/findall.
56
57 ElementInclude.py Element include support module. Adds limited
58 XInclude support.
59
60 HTMLTreeBuilder.py Element tree builder for HTML. This only
61 works for mostly well-formed HTML; if you
62 need something that can parse arbitrary
63 HTML at least as good as your browser, use
64 TidyHTMLTreeBuilder or TidyTools (see below).
65
66 TidyHTMLTreeBuilder.py Element tree builder for HTML, based on the
67 tidylib library. This tree builder requires
68 the _elementtidy extension module (available
69 from http://effbot.org/downloads).
70
71 SimpleXMLWriter.py Simple XML writer
72
73 TidyTools.py Build element trees from HTML, using the
74 external 'tidy' utility.
75
76 setup.py Build/installation script
77
78 docs/index.html API reference pages.
79 docs/*
80
81 demo*.py Sample scripts
82 samples/* Sample data
83
84 selftest.py Selftest (requires Python 2.1 or later)
85 tidytest.py Selftest for TidyHTMLTreeBuilder components.
86
87 benchmark.py Benchmark script (usage: benchmark.py file)
88
89 --------------------------------------------------------------------
90 license
91 --------------------------------------------------------------------
92
93 The ElementTree Library is
94
95 Copyright (c) 1999-2007 by Secret Labs AB
96 Copyright (c) 1999-2007 by Fredrik Lundh
97
98 By obtaining, using, and/or copying this software and/or its
99 associated documentation, you agree that you have read, understood,
100 and will comply with the following terms and conditions:
101
102 Permission to use, copy, modify, and distribute this software and its
103 associated documentation for any purpose and without fee is hereby
104 granted, provided that the above copyright notice appears in all
105 copies, and that both that copyright notice and this permission notice
106 appear in supporting documentation, and that the name of Secret Labs
107 AB or the author not be used in advertising or publicity pertaining to
108 distribution of the software without specific, written prior
109 permission.
110
111 SECRET LABS AB AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO
112 THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
113 FITNESS. IN NO EVENT SHALL SECRET LABS AB OR THE AUTHOR BE LIABLE FOR
114 ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
115 WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
116 ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
117 OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
118 --------------------------------------------------------------------