[XML-SIG] Request For Clarification on packages

[Lars Marius Garshol]

* Alexandre Fayolle
| 
|  * xml.sax.drivers contains SAX wrappers for the 4 parsers above, plus
| wrappers for some other parsers

Yep. These are SAX 1.0 and obsolete.
 
|  * xml.sax.drivers2 contains SAX 2.0 wrappers for pyxexpat and xmlproc

Yep.
 
|  * xml.sax.expatreader really belongs to xml.sax.drivers2 but is there for
| backwards compatibility. One should preferably use
| xml.sax.drivers2.drv_pyexpat

This file is empty and uses xml.sax.expatreader. I think this was done
to make interoperation with the main Python distro easier. drv_pyexpat
could really go away.
 
|  * a SAX 2.0 parser should implement the interface defined in
| xml.sax.xmlreader.XmlReader

Yes. If possible, it should also implement IncrementalParser. That is,
if the underlying parser provides the necessary functionality.
 
|  * xml.sax.handler defines the interface that should be implemented by
| someone willing to use a SAX2.0 parser. A parser making callback to
| methods not defined in there is not SAX 2.0 compatible.

True. Parsers can have properties that are callback handlers, however,
and this is the right way to sneak in new callbacks.
 
|  * xml.sax.saxlib defines the interfaces of objects manipulated by a SAX
| 2.0 parser.

Yes. 
 
|  * xml.sax.saxutils provides basic implementations of some of the
| interfaces defined in handler and saxlib

Yes.

|  * xml.dom.ext.reader.Sax contains a DOM generator that uses a SAX parser,
| with the Reader interface

SAX 1.0, yes, and therefore obsolete.
 
|  * xml.dom.ext.reader.Sax2 contains a DOM generator that uses a SAX 2.0
| parser with the Reader interface

Yes.
 
|  * xml.dom.ext.reader.HtmlSax is an HTML DOM generator which uses a SAX
| parser as the input (is this SAX 1 or SAX 2?)

This is SAX 1.0, but turning it into SAX 2.0 should be trivial. Only
ignorableWhitespace() and characters() need to be changed.
 
|  * xml.dom.ext.reader.PyExpat is a DOM generator that uses the raw
| Expat reader together with the Reader interface

Yes.
 
|  * xml.dom.ext.reader.Sax2Lib is redundant with xml.sax.handler

Yes. Some of it is also incompatible, it seems. This should be
deleted, IMHO.
 
--Lars M.