home *** CD-ROM | disk | FTP | other *** search
/ Freelog Special Freeware 31 / FreelogHS31.iso / Texte / scribus / scribus-1.3.3.9-win32-install.exe / lib / xml / sax / __init__.py next >
Text File  |  2002-05-31  |  4KB  |  109 lines
  1. """Simple API for XML (SAX) implementation for Python.
  2.  
  3. This module provides an implementation of the SAX 2 interface;
  4. information about the Java version of the interface can be found at
  5. http://www.megginson.com/SAX/.  The Python version of the interface is
  6. documented at <...>.
  7.  
  8. This package contains the following modules:
  9.  
  10. handler -- Base classes and constants which define the SAX 2 API for
  11.            the 'client-side' of SAX for Python.
  12.  
  13. saxutils -- Implementation of the convenience classes commonly used to
  14.             work with SAX.
  15.  
  16. xmlreader -- Base classes and constants which define the SAX 2 API for
  17.              the parsers used with SAX for Python.
  18.  
  19. expatreader -- Driver that allows use of the Expat parser with SAX.
  20. """
  21.  
  22. from xmlreader import InputSource
  23. from handler import ContentHandler, ErrorHandler
  24. from _exceptions import SAXException, SAXNotRecognizedException, \
  25.                         SAXParseException, SAXNotSupportedException, \
  26.                         SAXReaderNotAvailable
  27.  
  28.  
  29. def parse(source, handler, errorHandler=ErrorHandler()):
  30.     parser = make_parser()
  31.     parser.setContentHandler(handler)
  32.     parser.setErrorHandler(errorHandler)
  33.     parser.parse(source)
  34.  
  35. def parseString(string, handler, errorHandler=ErrorHandler()):
  36.     try:
  37.         from cStringIO import StringIO
  38.     except ImportError:
  39.         from StringIO import StringIO
  40.  
  41.     if errorHandler is None:
  42.         errorHandler = ErrorHandler()
  43.     parser = make_parser()
  44.     parser.setContentHandler(handler)
  45.     parser.setErrorHandler(errorHandler)
  46.  
  47.     inpsrc = InputSource()
  48.     inpsrc.setByteStream(StringIO(string))
  49.     parser.parse(inpsrc)
  50.  
  51. # this is the parser list used by the make_parser function if no
  52. # alternatives are given as parameters to the function
  53.  
  54. default_parser_list = ["xml.sax.expatreader"]
  55.  
  56. # tell modulefinder that importing sax potentially imports expatreader
  57. _false = 0
  58. if _false:
  59.     import xml.sax.expatreader
  60.  
  61. import os, sys
  62. if os.environ.has_key("PY_SAX_PARSER"):
  63.     default_parser_list = os.environ["PY_SAX_PARSER"].split(",")
  64. del os
  65.  
  66. _key = "python.xml.sax.parser"
  67. if sys.platform[:4] == "java" and sys.registry.containsKey(_key):
  68.     default_parser_list = sys.registry.getProperty(_key).split(",")
  69.  
  70.  
  71. def make_parser(parser_list = []):
  72.     """Creates and returns a SAX parser.
  73.  
  74.     Creates the first parser it is able to instantiate of the ones
  75.     given in the list created by doing parser_list +
  76.     default_parser_list.  The lists must contain the names of Python
  77.     modules containing both a SAX parser and a create_parser function."""
  78.  
  79.     for parser_name in parser_list + default_parser_list:
  80.         try:
  81.             return _create_parser(parser_name)
  82.         except ImportError,e:
  83.             import sys
  84.             if sys.modules.has_key(parser_name):
  85.                 # The parser module was found, but importing it
  86.                 # failed unexpectedly, pass this exception through
  87.                 raise
  88.         except SAXReaderNotAvailable:
  89.             # The parser module detected that it won't work properly,
  90.             # so try the next one
  91.             pass
  92.  
  93.     raise SAXReaderNotAvailable("No parsers found", None)
  94.  
  95. # --- Internal utility methods used by make_parser
  96.  
  97. if sys.platform[ : 4] == "java":
  98.     def _create_parser(parser_name):
  99.         from org.python.core import imp
  100.         drv_module = imp.importName(parser_name, 0, globals())
  101.         return drv_module.create_parser()
  102.  
  103. else:
  104.     def _create_parser(parser_name):
  105.         drv_module = __import__(parser_name,{},{},['create_parser'])
  106.         return drv_module.create_parser()
  107.  
  108. del sys
  109.