|
Server : Apache/2.2.2 (Fedora) System : Linux App1.pathumtani.go.th 2.6.20-1.2320.fc5smp #1 SMP Tue Jun 12 19:40:16 EDT 2007 i686 User : apache ( 48) PHP Version : 5.2.9 Disable Function : NONE Directory : /proc/self/root/usr/lib/python2.4/site-packages/_xmlplus/sax/ |
Upload File : |
m
<c @ sK d Z d Z d k l Z l Z l Z l Z d k l Z l Z l
Z
l Z d k Td k l
Z
l Z l Z l Z l Z l Z l Z l Z l Z l Z l Z l Z d e f d YZ d f d YZ d
f d YZ d f d
YZ d f d YZ d f d YZ d e e e e f d YZ d f d YZ d S( 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 $
s 2.0beta( s ErrorHandlers ContentHandlers
DTDHandlers EntityResolver( s XMLReaders InputSources Locators IncrementalParser( t *( s feature_namespacess feature_namespace_prefixess feature_string_internings feature_validations feature_external_gess feature_external_pess all_featuress property_lexical_handlers property_declaration_handlers property_dom_nodes property_xml_strings all_propertiest XMLFilterc B s, t Z d Z e d Z d Z d Z RS( sE Interface 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.c C s t i | | | _ d S( s\ Creates a filter instance, allowing applications to set the
parent on instantiation.N( t XMLReadert __init__t selft parentt _parent( R R ( ( t7 /usr/lib/python2.4/site-packages/_xmlplus/sax/saxlib.pyR 5 s
c C s
| | _ d S( sO Sets the parent XMLReader of this filter. The argument may
not be None.N( R R R ( R R ( ( R t setParent; s c C s | i S( s" Returns the parent of this filter.N( R R ( R ( ( R t getParent@ s ( t __name__t
__module__t __doc__t NoneR R R ( ( ( R R , s t
Attributesc B s t Z d Z d Z d Z d Z d Z d Z d Z d Z d Z
d Z d
Z d Z
e d Z d
Z d Z d Z RS( sc Interface for a list of XML attributes.
Contains a list of XML attributes, accessible by name.c C s t d d S( s- Returns the number of attributes in the list.s This method must be implemented!N( t NotImplementedError( R ( ( R t getLengthK s c C s t d d S( s6 Returns the type of the attribute with the given name.s This method must be implemented!N( R ( R t name( ( R t getTypeO s c C s t d d S( s7 Returns the value of the attribute with the given name.s This method must be implemented!N( R ( R R ( ( R t getValueS s c C s t d d S( sR Returns the value of the attribute with the given raw (or
qualified) name.s This method must be implemented!N( R ( R R ( ( R t getValueByQNameW s c C s t d d S( s[ Returns the namespace name of the attribute with the given
raw (or qualified) name.s This method must be implemented!N( R ( R R ( ( R t getNameByQName\ s c C s t d d S( sB Returns a list of the names of all attributes
in the list.s This method must be implemented!N( R ( R ( ( R t getNamesa s c C s t d d S( sP Returns a list of the raw qualified names of all attributes
in the list.s This method must be implemented!N( R ( R ( ( R t getQNamesf s c C s t d d S( s Alias for getLength.s This method must be implemented!N( R ( R ( ( R t __len__k s c C s t d d S( s Alias for getValue.s This method must be implemented!N( R ( R R ( ( R t __getitem__o s c C s t d d S( s2 Returns a list of the attribute names in the list.s This method must be implemented!N( R ( R ( ( R t keyss s c C s t d d S( s6 True if the attribute is in the list, false otherwise.s This method must be implemented!N( R ( R R ( ( R t has_keyw s c C s t d d S( sm Return the value associated with attribute name; if it is not
available, then return the alternative.s This method must be implemented!N( R ( R R t alternative( ( R t get{ s c C s t d d S( s' Return a copy of the Attributes object.s This method must be implemented!N( R ( R ( ( R t copy s c C s t d d S( s/ Return a list of (attribute_name, value) pairs.s This method must be implemented!N( R ( R ( ( R t items s c C s t d d S( s& Return a list of all attribute values.s This method must be implemented!N( R ( R ( ( R t values s ( R
R R R R R R R R R R R R R R
R R R R ( ( ( R R F s t DeclHandlerc B s2 t Z d Z d Z d Z d Z d Z RS( s Optional 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.c C s d S( s Report 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( ( R t elem_namet attr_namet typet value_deft value( ( R t
attributeDecl s
c C s d S( s Report 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( ( R R" t
content_model( ( R t elementDecl s
c C s d S( 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( ( R R R& ( ( R t internalEntityDecl s c C s d S( s Report 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( ( R R t public_idt system_id( ( R t externalEntityDecl s ( R
R R R' R) R* R- ( ( ( R R! s
t LexicalHandlerc B sM t Z d Z d Z d Z d Z d Z d Z d Z d Z RS( s9 Optional 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.c C s d S( s Reports 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( ( R t content( ( R t comment s c C s d S( s Report 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( ( R R R+ R, ( ( R t startDTD s c C s d S( s$ Signals the end of DTD declarations.N( ( R ( ( R t endDTD s c C s d S( s Report 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( ( R R ( ( R t startEntity s c C s d S( s Reports the end of an entity. name is the name of the
entity, and follows the same conventions as for
startEntity.N( ( R R ( ( R t endEntity s c C s d S( s Reports the beginning of a CDATA marked section.
The contents of the CDATA marked section will be reported
through the characters event.N( ( R ( ( R t
startCDATA s c C s d S( s* Reports the end of a CDATA marked section.N( ( R ( ( R t endCDATA s (
R
R R R0 R1 R2 R3 R4 R5 R6 ( ( ( R R. s
t
AttributeListc B s} t Z d Z d Z d Z d Z d Z d Z d Z d Z d Z
e d Z d
Z
d Z d Z RS(
s Interface 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.c C s d S( s( Return the number of attributes in list.N( ( R ( ( R R ' s c C s d S( s, Return the name of an attribute in the list.N( ( R t i( ( R t getName* s c C s d S( so Return the type of an attribute in the list. (Parameter can be
either integer index or attribute name.)N( ( R R8 ( ( R R - s c C s d S( sp Return the value of an attribute in the list. (Parameter can be
either integer index or attribute name.)N( ( R R8 ( ( R R 1 s c C s d S( s Alias for getLength.N( ( R ( ( R R 5 s c C s d S( sB Alias for getName (if key is an integer) and getValue (if string).N( ( R t key( ( R R 8 s c C s d S( s& Returns a list of the attribute names.N( ( R ( ( R R ; s c C s d S( s6 True if the attribute is in the list, false otherwise.N( ( R R: ( ( R R > s c C s d S( sm Return the value associated with attribute name; if it is not
available, then return the alternative.N( ( R R: R ( ( R R A s c C s d S( s# Return a copy of the AttributeList.N( ( R ( ( R R E s c C s d S( s. Return a list of (attribute_name,value) pairs.N( ( R ( ( R R H s c C s d S( s& Return a list of all attribute values.N( ( R ( ( R R K s ( R
R R R R9 R R R R R R R
R R R R ( ( ( R R7 s t DocumentHandlerc B sV t Z d Z d Z d Z d Z d Z d Z d Z d Z d Z
RS( 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().c C s d S( s Handle a character data event.N( ( R t cht startt length( ( R t
characters\ s c C s d S( s* Handle an event for the end of a document.N( ( R ( ( R t endDocument_ s c C s d S( s* Handle an event for the end of an element.N( ( R R ( ( R t
endElementb s c C s d S( s< Handle an event for ignorable whitespace in element content.N( ( R R< R= R> ( ( R t ignorableWhitespacee s c C s d S( s& Handle a processing instruction event.N( ( R t targett data( ( R t processingInstructionh s c C s d S( sA Receive an object for locating the origin of SAX document events.N( ( R t locator( ( R t setDocumentLocatork s c C s d S( s0 Handle an event for the beginning of a document.N( ( R ( ( R t
startDocumentn s c C s d S( s0 Handle an event for the beginning of an element.N( ( R R t atts( ( R t startElementq s ( R
R R R? R@ RA RB RE RG RH RJ ( ( ( R R; Q s t HandlerBasec B s t Z d Z RS( s Default 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).( R
R R ( ( ( R RK w s t Parserc B sV t Z d Z d Z d Z d Z d Z d Z d Z d Z d Z
RS( sF Basic 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.c C s4 t | _ t | _ t | _ t | _ d S( N( R; R t doc_handlert
DTDHandlert dtd_handlert EntityResolvert ent_handlert ErrorHandlert err_handler( R ( ( R R s c C s d S( s/ Parse an XML document from a system identifier.N( ( R t systemId( ( R t parse s c C s d S( s. Parse an XML document from a file-like object.N( ( R t fileobj( ( R t parseFile s c C s
| | _ d S( s< Register an object to receive basic document-related events.N( t handlerR RM ( R RX ( ( R t setDocumentHandler s c C s
| | _ d S( s7 Register an object to receive basic DTD-related events.N( RX R RO ( R RX ( ( R t
setDTDHandler s c C s
| | _ d S( s0 Register an object to resolve external entities.N( t resolverR RQ ( R R[ ( ( R t setEntityResolver s c C s
| | _ d S( s3 Register an object to receive error-message events.N( RX R RS ( R RX ( ( R t setErrorHandler s c C s t d d S( sH Allow 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.s Locale support not implementedN( t SAXNotSupportedException( R t locale( ( R t setLocale s ( R
R R R RU RW RY RZ R\ R] R` ( ( ( R RL s N(! R t versionRX RR t ContentHandlerRN RP t xmlreaderR t InputSourcet Locatort IncrementalParsert _exceptionst feature_namespacest feature_namespace_prefixest feature_string_interningt feature_validationt feature_external_gest feature_external_pest all_featurest property_lexical_handlert property_declaration_handlert property_dom_nodet property_xml_stringt all_propertiesR R R! R. R7 R; RK RL ( Rp R; R Rs Ri Rq Rd Rj Rb R RN Ra R. Rh Rk RK RR Rm Rf RP Ro R7 RL R Rr Re Rl R! Rn ( ( R t ?
s OP>J3&