home *** CD-ROM | disk | FTP | other *** search
/ PC World 2001 April / PCWorld_2001-04_cd.bin / Software / TemaCD / webclean / !!!python!!! / PyXML-0.6.3.win32-py2.0.exe / xmldoc / README.pyexpat < prev    next >
Text File  |  2000-12-03  |  2KB  |  49 lines
  1. Python Expat wrapper module
  2. ===========================
  3.  
  4. Building the pyexpat module
  5. --------------------------------------
  6.  
  7. The module is built as part of running setup.py
  8.  
  9. Using the pyexpat module
  10. -----------------------
  11.  
  12. The pyexpat module exports two functions:
  13. ParserCreate(encoding) Creates a new parser object. The optional
  14.     encoding arg (a string) specifies the encoding.
  15. ErrorString(number) Return a string corresponding to the given error
  16.     number.
  17.  
  18. Parser objects have one method:
  19. Parse(data, isfinal) Parse some data. If the optional isfinal arg is 1 
  20.     this is the last bit of data. Raises an exception in case of
  21.     an error, the error attributes have information on the error.
  22.  
  23. Parser objects have the following attributes:
  24.  
  25. StartElementHandler, EndElementHandler, CharacterDataHandler,
  26. ProcessingInstructionHandler - The Python handlers called for various
  27.     events. See below for the signatures.
  28. ErrorCode, ErrorLineNumber, ErrorColumnNumber, ErrorByteIndex -
  29.     Readonly integers giving information on the current parse
  30.     error.
  31.  
  32. Testing it
  33. ----------
  34.  
  35. There's a very minimal test script in expattest.py. It should be easy 
  36. to adapt it to generate ESIS (but I'm not familiar enough with ESIS to 
  37. do it). This module parsed Hamlet in 2 seconds on an 180 Mhz R5000 SGI 
  38. O2.
  39.  
  40. Feedback
  41. --------
  42.  
  43. Please report problems to xml-sig@python.org.
  44.  
  45. The author is Jack Jansen, jack@cwi.nl. The expat proper was written
  46. by James Clark and can be found at http://www.jclark.com/xml/ .
  47.  
  48.     Jack Jansen, CWI, Amsterdam
  49.     jack@cwi.nl