"""Simple API for XML (SAX) implementation for Python. | |
This module provides an implementation of the SAX 2 interface; | |
information about the Java version of the interface can be found at | |
http://www.megginson.com/SAX/. The Python version of the interface is | |
documented at <...>. | |
This package contains the following modules: | |
handler -- Base classes and constants which define the SAX 2 API for | |
the 'client-side' of SAX for Python. | |
saxutils -- Implementation of the convenience classes commonly used to | |
work with SAX. | |
xmlreader -- Base classes and constants which define the SAX 2 API for | |
the parsers used with SAX for Python. | |
expatreader -- Driver that allows use of the Expat parser with SAX. | |
""" | |
from xmlreader import InputSource | |
from handler import ContentHandler, ErrorHandler | |
from _exceptions import SAXException, SAXNotRecognizedException, \ | |
SAXParseException, SAXNotSupportedException, \ | |
SAXReaderNotAvailable | |
def parse(source, handler, errorHandler=ErrorHandler()): | |
parser = make_parser() | |
parser.setContentHandler(handler) | |
parser.setErrorHandler(errorHandler) | |
parser.parse(source) | |
def parseString(string, handler, errorHandler=ErrorHandler()): | |
try: | |
from cStringIO import StringIO | |
except ImportError: | |
from StringIO import StringIO | |
if errorHandler is None: | |
errorHandler = ErrorHandler() | |
parser = make_parser() | |
parser.setContentHandler(handler) | |
parser.setErrorHandler(errorHandler) | |
inpsrc = InputSource() | |
inpsrc.setByteStream(StringIO(string)) | |
parser.parse(inpsrc) | |
# this is the parser list used by the make_parser function if no | |
# alternatives are given as parameters to the function | |
default_parser_list = ["xml.sax.expatreader"] | |
# tell modulefinder that importing sax potentially imports expatreader | |
_false = 0 | |
if _false: | |
import xml.sax.expatreader | |
import os, sys | |
if "PY_SAX_PARSER" in os.environ: | |
default_parser_list = os.environ["PY_SAX_PARSER"].split(",") | |
del os | |
_key = "python.xml.sax.parser" | |
if sys.platform[:4] == "java" and sys.registry.containsKey(_key): | |
default_parser_list = sys.registry.getProperty(_key).split(",") | |
def make_parser(parser_list = []): | |
"""Creates and returns a SAX parser. | |
Creates the first parser it is able to instantiate of the ones | |
given in the list created by doing parser_list + | |
default_parser_list. The lists must contain the names of Python | |
modules containing both a SAX parser and a create_parser function.""" | |
for parser_name in parser_list + default_parser_list: | |
try: | |
return _create_parser(parser_name) | |
except ImportError,e: | |
import sys | |
if parser_name in sys.modules: | |
# The parser module was found, but importing it | |
# failed unexpectedly, pass this exception through | |
raise | |
except SAXReaderNotAvailable: | |
# The parser module detected that it won't work properly, | |
# so try the next one | |
pass | |
raise SAXReaderNotAvailable("No parsers found", None) | |
# --- Internal utility methods used by make_parser | |
if sys.platform[ : 4] == "java": | |
def _create_parser(parser_name): | |
from org.python.core import imp | |
drv_module = imp.importName(parser_name, 0, globals()) | |
return drv_module.create_parser() | |
else: | |
def _create_parser(parser_name): | |
drv_module = __import__(parser_name,{},{},['create_parser']) | |
return drv_module.create_parser() | |
del sys |