- =csxdZ  dZdklZlZlZlZdklZl Z l Z l Z dk Tdkl Z lZlZlZlZlZlZlZlZlZlZlZ,defdYZFdfd YZd fd YZd fd YZdfdYZQdfdYZwdeeeefdYZdfdYZ dS(se This module contains the core classes of version 2.0 of SAX for Python. This file provides only default classes with absolutely minimum functionality, from which drivers and applications can be subclassed. Many of these classes are empty and are included only as documentation of the interfaces. $Id: saxlib.py,v 1.12 2002/05/10 14:49:21 akuchling Exp $ s2.0beta(s ErrorHandlersContentHandlers DTDHandlersEntityResolver(s XMLReaders InputSourcesLocatorsIncrementalParser(s*( sfeature_namespacessfeature_namespace_prefixessfeature_string_interningsfeature_validationsfeature_external_gessfeature_external_pess all_featuressproperty_lexical_handlersproperty_declaration_handlersproperty_dom_nodesproperty_xml_stringsall_propertiess XMLFiltercs5,dZ35edZ;dZ@dZRS(sEInterface for a SAX2 parser filter. A parser filter is an XMLReader that gets its events from another XMLReader (which may in turn also be a filter) rather than from a primary source like a document or other non-SAX data source. Filters can modify a stream of events before passing it on to its handlers.cs&578ti|9||_dS(s\Creates a filter instance, allowing applications to set the parent on instantiation.N(s XMLReaders__init__sselfsparents_parent(sselfsparent((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pys__init__5scs;=>||_dS(sOSets the parent XMLReader of this filter. The argument may not be None.N(sparentsselfs_parent(sselfsparent((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pys setParent;scs@AB|iSdS(s"Returns the parent of this filter.N(sselfs_parent(sself((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pys getParent@s(s__doc__sNones__init__s setParents getParent(((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pys XMLFilter,s  s AttributescsFdZIKdZOdZSdZWdZ\dZadZfdZkdZod Z sd Z wd Z {e d Z d ZdZdZRS(scInterface for a list of XML attributes. Contains a list of XML attributes, accessible by name.csKLMtddS(s-Returns the number of attributes in the list.s This method must be implemented!N(sNotImplementedError(sself((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pys getLengthKscsOPQtddS(s6Returns the type of the attribute with the given name.s This method must be implemented!N(sNotImplementedError(sselfsname((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pysgetTypeOscsSTUtddS(s7Returns the value of the attribute with the given name.s This method must be implemented!N(sNotImplementedError(sselfsname((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pysgetValueSscsWYZtddS(sRReturns the value of the attribute with the given raw (or qualified) name.s This method must be implemented!N(sNotImplementedError(sselfsname((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pysgetValueByQNameWscs\^_tddS(s[Returns the namespace name of the attribute with the given raw (or qualified) name.s This method must be implemented!N(sNotImplementedError(sselfsname((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pysgetNameByQName\scsacdtddS(sBReturns a list of the names of all attributes in the list.s This method must be implemented!N(sNotImplementedError(sself((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pysgetNamesascsfhitddS(sPReturns a list of the raw qualified names of all attributes in the list.s This method must be implemented!N(sNotImplementedError(sself((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pys getQNamesfscsklmtddS(sAlias for getLength.s This method must be implemented!N(sNotImplementedError(sself((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pys__len__kscsopqtddS(sAlias for getValue.s This method must be implemented!N(sNotImplementedError(sselfsname((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pys __getitem__oscsstutddS(s2Returns a list of the attribute names in the list.s This method must be implemented!N(sNotImplementedError(sself((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pyskeyssscswxytddS(s6True if the attribute is in the list, false otherwise.s This method must be implemented!N(sNotImplementedError(sselfsname((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pyshas_keywscs{}~tddS(smReturn the value associated with attribute name; if it is not available, then return the alternative.s This method must be implemented!N(sNotImplementedError(sselfsnames alternative((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pysget{scstddS(s'Return a copy of the Attributes object.s This method must be implemented!N(sNotImplementedError(sself((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pyscopyscstddS(s/Return a list of (attribute_name, value) pairs.s This method must be implemented!N(sNotImplementedError(sself((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pysitemsscstddS(s&Return a list of all attribute values.s This method must be implemented!N(sNotImplementedError(sself((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pysvaluess(s__doc__s getLengthsgetTypesgetValuesgetValueByQNamesgetNameByQNamesgetNamess getQNamess__len__s __getitem__skeysshas_keysNonesgetscopysitemssvalues(((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pys AttributesFs              s DeclHandlercs>dZdZdZdZdZRS(sOptional SAX2 handler for DTD declaration events. Note that some DTD declarations are already reported through the DTDHandler interface. All events reported to this handler will occur between the startDTD and endDTD events of the LexicalHandler. To set the DeclHandler for an XMLReader, use the setProperty method with the identifier http://xml.org/sax/handlers/DeclHandler.cs dS(sReport an attribute type declaration. Only the first declaration will be reported. The type will be one of the strings "CDATA", "ID", "IDREF", "IDREFS", "NMTOKEN", "NMTOKENS", "ENTITY", "ENTITIES", or "NOTATION", or a list of names (in the case of enumerated definitions). elem_name is the element type name, attr_name the attribute type name, type a string representing the attribute type, value_def a string representing the default declaration ('#IMPLIED', '#REQUIRED', '#FIXED' or None). value is a string representing the attribute's default value, or None if there is none.N((sselfs elem_names attr_namestypes value_defsvalue((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pys attributeDecls cs dS(sReport an element type declaration. Only the first declaration will be reported. content_model is the string 'EMPTY', the string 'ANY' or the content model structure represented as tuple (separator, tokens, modifier) where separator is the separator in the token list (that is, '|' or ','), tokens is the list of tokens (element type names or tuples representing parentheses) and modifier is the quantity modifier ('*', '?' or '+').N((sselfs elem_names content_model((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pys elementDecls cs dS(s Report an internal entity declaration. Only the first declaration of an entity will be reported. name is the name of the entity. If it is a parameter entity, the name will begin with '%'. value is the replacement text of the entity.N((sselfsnamesvalue((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pysinternalEntityDeclscs dS(sReport a parsed entity declaration. (Unparsed entities are reported to the DTDHandler.) Only the first declaration for each entity will be reported. name is the name of the entity. If it is a parameter entity, the name will begin with '%'. public_id and system_id are the public and system identifiers of the entity. public_id will be None if none were declared.N((sselfsnames public_ids system_id((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pysexternalEntityDecls (s__doc__s attributeDecls elementDeclsinternalEntityDeclsexternalEntityDecl(((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pys DeclHandlers   sLexicalHandlercsbdZdZdZdZdZdZ dZdZRS(s9Optional SAX2 handler for lexical events. This handler is used to obtain lexical information about an XML document, that is, information about how the document was encoded (as opposed to what it contains, which is reported to the ContentHandler), such as comments and CDATA marked section boundaries. To set the LexicalHandler of an XMLReader, use the setProperty method with the property identifier 'http://xml.org/sax/handlers/LexicalHandler'. There is no guarantee that the XMLReader will support or recognize this property.cs dS(sReports a comment anywhere in the document (including the DTD and outside the document element). content is a string that holds the contents of the comment.N((sselfscontent((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pyscommentscs dS(sReport the start of the DTD declarations, if the document has an associated DTD. A startEntity event will be reported before declaration events from the external DTD subset are reported, and this can be used to infer from which subset DTD declarations derive. name is the name of the document element type, public_id the public identifier of the DTD (or None if none were supplied) and system_id the system identfier of the external subset (or None if none were supplied).N((sselfsnames public_ids system_id((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pysstartDTDs cs dS(s$Signals the end of DTD declarations.N((sself((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pysendDTDscs dS(sReport the beginning of an entity. The start and end of the document entity is not reported. The start and end of the external DTD subset is reported with the pseudo-name '[dtd]'. Skipped entities will be reported through the skippedEntity event of the ContentHandler rather than through this event. name is the name of the entity. If it is a parameter entity, the name will begin with '%'.N((sselfsname((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pys startEntitys cs  dS(sReports the end of an entity. name is the name of the entity, and follows the same conventions as for startEntity.N((sselfsname((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pys endEntityscs  dS(sReports the beginning of a CDATA marked section. The contents of the CDATA marked section will be reported through the characters event.N((sself((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pys startCDATA scs dS(s*Reports the end of a CDATA marked section.N((sself((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pysendCDATAs(s__doc__scommentsstartDTDsendDTDs startEntitys endEntitys startCDATAsendCDATA(((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pysLexicalHandlers     s AttributeListcsdZ%'dZ*dZ-dZ1dZ5dZ8dZ;dZ>dZAe d Z Ed Z Hd Z Kd Z RS( sInterface for an attribute list. This interface provides information about a list of attributes for an element (only specified or defaulted attributes will be reported). Note that the information returned by this object will be valid only during the scope of the DocumentHandler.startElement callback, and the attributes will not necessarily be provided in the order declared or specified.cs '(dS(s(Return the number of attributes in list.N((sself((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pys getLength'scs *+dS(s,Return the name of an attribute in the list.N((sselfsi((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pysgetName*scs -/dS(soReturn the type of an attribute in the list. (Parameter can be either integer index or attribute name.)N((sselfsi((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pysgetType-scs 13dS(spReturn the value of an attribute in the list. (Parameter can be either integer index or attribute name.)N((sselfsi((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pysgetValue1scs 56dS(sAlias for getLength.N((sself((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pys__len__5scs 89dS(sBAlias for getName (if key is an integer) and getValue (if string).N((sselfskey((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pys __getitem__8scs ;<dS(s&Returns a list of the attribute names.N((sself((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pyskeys;scs >?dS(s6True if the attribute is in the list, false otherwise.N((sselfskey((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pyshas_key>scs ACdS(smReturn the value associated with attribute name; if it is not available, then return the alternative.N((sselfskeys alternative((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pysgetAscs EFdS(s#Return a copy of the AttributeList.N((sself((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pyscopyEscs HIdS(s.Return a list of (attribute_name,value) pairs.N((sself((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pysitemsHscs KLdS(s&Return a list of all attribute values.N((sself((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pysvaluesKs(s__doc__s getLengthsgetNamesgetTypesgetValues__len__s __getitem__skeysshas_keysNonesgetscopysitemssvalues(((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pys AttributeLists           sDocumentHandlercsnQdZZ\dZ_dZbdZedZhdZkdZndZqdZRS( s+Handle general document events. This is the main client interface for SAX: it contains callbacks for the most important document events, such as the start and end of elements. You need to create an object that implements this interface, and then register it with the Parser. If you do not want to implement the entire interface, you can derive a class from HandlerBase, which implements the default functionality. You can find the location of any document event using the Locator interface supplied by setDocumentLocator().cs \]dS(sHandle a character data event.N((sselfschsstartslength((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pys characters\scs _`dS(s*Handle an event for the end of a document.N((sself((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pys endDocument_scs bcdS(s*Handle an event for the end of an element.N((sselfsname((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pys endElementbscs efdS(s<Handle an event for ignorable whitespace in element content.N((sselfschsstartslength((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pysignorableWhitespaceescs hidS(s&Handle a processing instruction event.N((sselfstargetsdata((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pysprocessingInstructionhscs kldS(sAReceive an object for locating the origin of SAX document events.N((sselfslocator((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pyssetDocumentLocatorkscs nodS(s0Handle an event for the beginning of a document.N((sself((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pys startDocumentnscs qrdS(s0Handle an event for the beginning of an element.N((sselfsnamesatts((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pys startElementqs( s__doc__s characterss endDocuments endElementsignorableWhitespacesprocessingInstructionssetDocumentLocators startDocuments startElement(((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pysDocumentHandlerQs        s HandlerBasecswdZRS(sDefault base class for handlers. This class implements the default behaviour for four SAX interfaces: EntityResolver, DTDHandler, DocumentHandler, and ErrorHandler: rather than implementing those full interfaces, you may simply extend this class and override the methods that you need. Note that the use of this class is optional (you are free to implement the interfaces directly if you wish).(s__doc__(((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pys HandlerBasews sParsercsndZdZdZdZdZdZdZdZdZRS( sFBasic interface for SAX (Simple API for XML) parsers. All SAX parsers must implement this basic interface: it allows users to register handlers for different types of events and to initiate a parse from a URI, a character stream, or a byte stream. SAX parsers should also implement a zero-argument constructor.csCt|_t|_t|_t|_dS(N( sDocumentHandlersselfs doc_handlers DTDHandlers dtd_handlersEntityResolvers ent_handlers ErrorHandlers err_handler(sself((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pys__init__scs dS(s/Parse an XML document from a system identifier.N((sselfssystemId((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pysparsescs dS(s.Parse an XML document from a file-like object.N((sselfsfileobj((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pys parseFilescs||_dS(s<Register an object to receive basic document-related events.N(shandlersselfs doc_handler(sselfshandler((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pyssetDocumentHandlerscs||_dS(s7Register an object to receive basic DTD-related events.N(shandlersselfs dtd_handler(sselfshandler((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pys setDTDHandlerscs||_dS(s0Register an object to resolve external entities.N(sresolversselfs ent_handler(sselfsresolver((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pyssetEntityResolverscs||_dS(s3Register an object to receive error-message events.N(shandlersselfs err_handler(sselfshandler((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pyssetErrorHandlerscstddS(sHAllow an application to set the locale for errors and warnings. SAX parsers are not required to provide localisation for errors and warnings; if they cannot support the requested locale, however, they must throw a SAX exception. Applications may request a locale change in the middle of a parse.sLocale support not implementedN(sSAXNotSupportedException(sselfslocale((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pys setLocales( s__doc__s__init__sparses parseFilessetDocumentHandlers setDTDHandlerssetEntityResolverssetErrorHandlers setLocale(((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pysParsers        N(!s__doc__sversionshandlers ErrorHandlersContentHandlers DTDHandlersEntityResolvers xmlreaders XMLReaders InputSourcesLocatorsIncrementalParsers _exceptionssfeature_namespacessfeature_namespace_prefixessfeature_string_interningsfeature_validationsfeature_external_gessfeature_external_pess all_featuressproperty_lexical_handlersproperty_declaration_handlersproperty_dom_nodesproperty_xml_stringsall_propertiess XMLFilters Attributess DeclHandlersLexicalHandlers AttributeListsDocumentHandlers HandlerBasesParser(sLexicalHandlersproperty_declaration_handlers HandlerBasesDocumentHandlers ErrorHandlersfeature_external_pess DeclHandlersIncrementalParsersproperty_xml_stringsEntityResolversContentHandlersall_propertiessproperty_lexical_handlersproperty_dom_nodes InputSourcesfeature_string_internings AttributeLists AttributessParsers XMLReaders XMLFiltersLocators DTDHandlersversionsfeature_external_gessfeature_namespacessfeature_namespace_prefixess all_featuressfeature_validation((sA/usr/local/twc/lib/python2.2/site-packages/_xmlplus/sax/saxlib.pys? s  "" RP>J3&"