/ lib / xml / dom / expatbuilder.pyc
expatbuilder.pyc
  1  o

  2  6�Hc|��@sdZddlmZmZmZddlmZmZmZddlm	Z	ddl
  3  mZmZddl
mZejZejZejZejjZejjZejjZejjZe��Ze�dd�e�dd	�e�dd
  4  �e�dd�e�dd�e�dd
�e�dd�e�dd�e�dd�d�	ZGdd�de�Zdd�Zdd�ZGdd�d�ZeeefZ Gdd�de�Z!Gdd�de�Z"Gdd�de"�Z#Gd d!�d!e"�Z$d"Z%d#e%Z&Gd$d%�d%e�Z'Gd&d'�d'�Z(Gd(d)�d)e(e�Z)Gd*d+�d+e(e'�Z*Gd,d-�d-e+�Z,Gd.d/�d/e�Z-d;d1d2�Z.d;d3d4�Z/d;d5d6�Z0d;d7d8�Z1d9d:�Z2dS)<z�Facility to use the Expat parser to load a minidom instance
  5  from a string or file.
  6  
  7  This avoids all the overhead of SAX and pulldom to gain performance.
  8  �)�
  9  xmlbuilder�minidom�Node)�EMPTY_NAMESPACE�EMPTY_PREFIX�XMLNS_NAMESPACE)�expat)�
_append_child�_set_attribute_node)�
 10  NodeFilterN�cdata�enumeration�entity�entities�idZidrefZidrefsZnmtokenZnmtokens)	�CDATA�ENUMZENTITYZENTITIES�IDZIDREFZIDREFSZNMTOKENZNMTOKENSc@sZeZdZdZddd�Zdd�Zdd�Zd	d
 11  �Zdd�Zd
d�Z	dd�Z
 12  dd�Zdd�ZdS)�ElementInfo��
 13  _attr_info�_model�tagNameNcCs||_g|_||_dS�N)rrr)�selfr�model�r�|C:\Program Files\WindowsApps\PythonSoftwareFoundation.Python.3.10_3.10.2800.0_x64__qbz5n2kfra8p0\lib\xml\dom\expatbuilder.py�__init__?s
 14  zElementInfo.__init__cCs|j|j|jfSrr�rrrr�__getstate__D�zElementInfo.__getstate__cCs|\|_|_|_dSrr)r�staterrr�__setstate__GszElementInfo.__setstate__cCsN|jD] }|d|kr#|d}|ddkrtdSt|dSqtjS)N������r�(r)r�
_typeinfo_mapr�_no_type)r�aname�info�trrr�getAttributeTypeJs
 15  �zElementInfo.getAttributeTypecCstjSr)rr()r�namespaceURI�	localNamerrr�getAttributeTypeNST�zElementInfo.getAttributeTypeNScCs(|jr|jd}|tjjtjjfvSdS�NrF)rrr�
XML_CTYPE_ANY�XML_CTYPE_MIXED)r�typerrr�isElementContentWs
 16  �zElementInfo.isElementContentcCs|jr|jdtjjkSdSr1)rrr�XML_CTYPE_EMPTYrrrr�isEmpty_szElementInfo.isEmptycCs,|jD]}|d|kr|ddkSqdS)Nr$r%rF)r)rr)r*rrr�isIdes
 17  
 18  �zElementInfo.isIdcCs|�||f�Sr)r8)rZeuri�enameZaurir)rrr�isIdNSkszElementInfo.isIdNSr)
�__name__�
 19  __module__�__qualname__�	__slots__rr r#r,r/r5r7r8r:rrrrr<s
 20  
 21  rcCs|�||�Sr)�_intern_setdefault)�builder�srrr�_internosrBcCs�d|vsJ�|�d�}|j}t|�dkr/|\}}}|||�}d||f}|||�}|||�}nt|�dkrC|\}}t}|||�}}ntd|��|||�|||fS)N� �z%s:%s�z4Unsupported syntax: spaces in URIs not supported: %r)�splitr?�lenr�
 22  ValueError)r@�name�parts�intern�uri�	localname�prefix�qnamerrr�_parse_ns_namers
 23  
 24  
 25  
 26  rPc@s�eZdZdZd;dd�Zdd�Zdd�Zd	d
 27  �Zdd�Zd
d�Z	dd�Z
 28  dd�Zdd�Zdd�Z
dd�Zdd�Zdd�Zdd�Zdd �Zd!d"�Zd#d$�Zd%d&�Zd'd(�Zd)d*�Zd+d,�Zd-d.�Zd/d0�Zd1d2�Zd3d4�Zd5d6�Zd7d8�Zd9d:�ZdS)<�ExpatBuilderzPDocument builder that uses Expat to build a ParsedXML.DOM document
 29      instance.NcCsP|durt��}||_|jjdurt|jj�|_nd|_t|_d|_|�	�dSr)
 30  r�Options�_options�filter�FilterVisibilityController�_filterr�_finish_start_element�_parser�reset)r�optionsrrrr�szExpatBuilder.__init__cCst��S)zCreate a new parser object.)r�ParserCreaterrrr�createParser�szExpatBuilder.createParsercCsF|js |��|_|jjj|_d|j_d|j_d|j_|�|j�|jS)z7Return the parser object, creating a new one if needed.T)	rXr\rK�
 31  setdefaultr?�buffer_text�ordered_attributes�specified_attributes�installrrrr�	getParser�s
 32  zExpatBuilder.getParsercCs,t�tdd�|_|j|_|jj|_d|_dS)z6Free all data structures used during DOM construction.NF)�theDOMImplementation�createDocumentr�document�curNode�
 33  _elem_info�_cdatarrrrrY�s�
 34  
 35  zExpatBuilder.resetcCs�|j|_|j|_|j|_|j|_|jj	r|j
 36  |_|j|_
|jjr$|j|_|jjr5|j|_|j|_|j|_n|j|_|j|_|j|_|j|_|j|_ dS)z>Install the callbacks needed to build the DOM into the parser.N)!�start_doctype_decl_handler�StartDoctypeDeclHandler�first_element_handler�StartElementHandler�end_element_handler�EndElementHandler�
 37  pi_handler�ProcessingInstructionHandlerrSr�entity_decl_handler�EntityDeclHandler�notation_decl_handler�NotationDeclHandler�comments�comment_handler�CommentHandler�cdata_sections�start_cdata_section_handler�StartCdataSectionHandler�end_cdata_section_handler�EndCdataSectionHandler�character_data_handler_cdata�CharacterDataHandler�character_data_handler�external_entity_ref_handler�ExternalEntityRefHandler�xml_decl_handler�XmlDeclHandler�element_decl_handler�ElementDeclHandler�attlist_decl_handler�AttlistDeclHandler�r�parserrrrra�s$
 38  zExpatBuilder.installcCs�|��}d}z%	|�d�}|sn|�|d�|r!|jjr!|�|�d}q|�dd�Wn	ty4Ynw|j}|��d|_|S)zIParse a document from a file object, returning the document
 39          node.Tr$i@F�N)	rb�read�Parsere�documentElement�
_setup_subset�ParseEscaperYrX)r�filer�Zfirst_buffer�buffer�docrrr�	parseFile�s(
 40  
 41  ��zExpatBuilder.parseFilecCsN|��}z
|�|d�|�|�Wn	tyYnw|j}|��d|_|S)z<Parse a document from a string, returning the document node.TN)rbr�r�r�rerYrX)r�stringr�r�rrr�parseString�s�zExpatBuilder.parseStringcCs2|jjrt�}|�|�|��}||jj_dSdS)z/Load the internal subset if there might be one.N)re�doctype�InternalSubsetExtractorr��	getSubset�internalSubset)rr��	extractor�subsetrrrr��s
 42  �zExpatBuilder._setup_subsetcCs�|jj�|||�}|j|_t|j|�||j_|jr5|j�|�tkr5d|j_|jj	d=d}d|j
 43  _d|j
 44  _|rR|durCg|j
_g|j_d|j
 45  _d|j
 46  _|j|j
 47  _dSdS�N�����)re�implementation�createDocumentType�
ownerDocumentr	r�rV�
 48  acceptNode�
FILTER_REJECT�
 49  childNodesrXrrrtr�_seq�	notationsrwrp�end_doctype_decl_handler�EndDoctypeDeclHandler)rZdoctypeName�systemId�publicId�has_internal_subsetr�rrrri�s(�
 50  �z'ExpatBuilder.start_doctype_decl_handlercCs:|jjr	|j|j_|j|j_|js|jst	|_
 51  dSdSdSr)rSrurvrXrwrorprgrVr�_finish_end_elementrrrrr�s
 52  
 53  
 54  �z%ExpatBuilder.end_doctype_decl_handlercCsH|j�||�}t|j|�|jr |j�|�tkr"|j�|�dSdSdSr)re�createProcessingInstructionr	rfrVr�r��removeChild)r�target�data�noderrrros
 55  �zExpatBuilder.pi_handlercCs�|jj}|jr$|jr|djtkr|d�|�dS|j�|�}d|_n"|r;|djt	kr;|d}|j
 56  |}||_
 57  dSt��}||_
 58  |j|_
t|j|�dS)Nr�T)rfr�rh�_cdata_continue�nodeType�CDATA_SECTION_NODE�
 59  appendDatare�createCDATASection�	TEXT_NODEr�r�Textr�r	)rr�r�r��valuerrrr}s"
 60  z)ExpatBuilder.character_data_handler_cdatacCs^|jj}|r|djtkr|d}|j||_dSt��}|j||_|j|_t	|j|�dSr�)
 61  rfr�r�r�r�rr�rer�r	)rr�r�r�rrrr&sz#ExpatBuilder.character_data_handlerc
 62  Cs�|rdS|jjs
 63  dS|j�||||�}|dur#|j�|�}	|j�|	�|jjjj�|�|j	r@|j	�
 64  |�tkrB|jjjjd=dSdSdSr�)rSrre�_create_entity�createTextNoder��appendr�r�rVr�r�)
 65  rZ
 66  entityName�is_parameter_entityr��baser�r��notationNamer��childrrrrq1s
 67  ��z ExpatBuilder.entity_decl_handlercCsR|j�|||�}|jjjj�|�|jr%|j�|�tkr'|jjjjd=dSdSdSr�)	re�_create_notationr�r�r�r�rVr��
FILTER_ACCEPT)rr�r�r�r�r�rrrrsCs
 68  �z"ExpatBuilder.notation_decl_handlercCsF|j�|�}t|j|�|jr|j�|�tkr!|j�|�dSdSdSr)re�
createCommentr	rfrVr�r�r�)rr�r�rrrrvIs
 69  �zExpatBuilder.comment_handlercCsd|_d|_dS)NTF�rhr�rrrrryO�
 70  z(ExpatBuilder.start_cdata_section_handlercCsd|_d|_dS)NFr�rrrrr{Sr�z&ExpatBuilder.end_cdata_section_handlercC�dS�Nr$r)r�contextr�r�r�rrrr�W�z(ExpatBuilder.external_entity_ref_handlercCs2|jdur|jst|_|j|��_|�||�dSr)rVrgrr��start_element_handlerrbrl)rrI�
 71  attributesrrrrkZsz"ExpatBuilder.first_element_handlercCs�|j�|�}t|j|�||_|r8tdt|�d�D]}t�||tdt	�}||d}||_
 72  |j|_t||�q||jj
urE|�|�dSdS)NrrEr$)re�
createElementr	rf�rangerGr�Attrrrr�r�r
 73  r�rW)rrIr�r��i�ar�rrrr�`s��z"ExpatBuilder.start_element_handlercCsn|jr5||jjurdS|j�|�}|tkrt|�n|tkr#t|�ndS|j|_	|j�
 74  |�|��dSdSr)rVrer��startContainerr��Rejecter�FILTER_SKIP�Skipper�
 75  parentNoderfr��unlink)rr��filtrrrrWqs
 76  
 77  �z"ExpatBuilder._finish_start_elementcCs|j}|j|_|�|�dSr)rfr�r�)rrIrfrrrrm�sz ExpatBuilder.end_element_handlercCsd|j�|j�}|r|�||�|jr.||jjurdS|j�|�tkr0|j	�
 78  |�|��dSdSdSr)rg�getr�_handle_white_text_nodesrVrer�r�r�rfr�r�)rrfr*rrrr��s�z ExpatBuilder._finish_end_elementcCsZ|jjs|��s
 79  dSg}|jD]}|jtkr |j��s |�|�q|D]}|�	|�q#dSr)
 80  rS�whitespace_in_element_contentr5r�r�r�r��stripr�r�)rr�r*�Lr�rrrr��s�
 81  
 82  ��z%ExpatBuilder._handle_white_text_nodescCs@|j�|�}|durt||�|j|<dS|jdusJ�||_dSr)rgr�rr)rrIrr*rrrr��s
 83  
 84  z!ExpatBuilder.element_decl_handlerc
 85  CsF|j�|�}|durt|�}||j|<|j�d|dd|d||g�dS�Nr)rgr�rrr�)r�elemrIr4�default�requiredr*rrrr��s
 86  �z!ExpatBuilder.attlist_decl_handlercCs8||j_||j_|dkr|rd|j_dSd|j_dSdS)NrTF)re�version�encoding�
 87  standalone)rr�r�r�rrrr��s�zExpatBuilder.xml_decl_handlerr) r;r<r=�__doc__rr\rbrYrar�r�r�rir�ror}rrqrsrvryr{r�rkr�rWrmr�r�r�r�r�rrrrrQ�s<
 88  
rQc@s�eZdZdZdZdd�Zdd�Zdd�Zej	e
 89  jeje
 90  j
eje
 91  jeje
 92  jeje
 93  jeje
 94  jeje
 95  jeje
 96  jeje
 97  jeje
 98  jeje
 99  jej e
100  j!iZ"d	S)
101  rUzoWrapper around a DOMBuilderFilter which implements the checks
102      to make the whatToShow filter attribute work.�rTcCs
103  ||_dSrr�)rrTrrrr�s
104  z#FilterVisibilityController.__init__cCsP|j|j}|jj|@r&|j�|�}|tkrt�|tvr$tdt	|���|St
105  S)Nz)startContainer() returned illegal value: )�_nodetype_maskr�rT�
106  whatToShowr��FILTER_INTERRUPTr��_ALLOWED_FILTER_RETURNSrH�reprr�)rr��mask�valrrrr��s
107  �z)FilterVisibilityController.startContainercCs�|j|j}|jj|@r>|j�|�}|tkrt�|tkr0|j}|j	dd�D]}|�
108  |�q&tS|tvr<t
dt|���|StS)Nz%acceptNode() returned illegal value: )r�r�rTr�r�r�r�r�r�r��appendChildr�r�rHr�r�)rr�r�r��parentr�rrrr��s 
109  �z%FilterVisibilityController.acceptNodeN)#r;r<r=r�r>rr�r�r�ELEMENT_NODEr�SHOW_ELEMENT�ATTRIBUTE_NODE�SHOW_ATTRIBUTEr��	SHOW_TEXTr��SHOW_CDATA_SECTION�ENTITY_REFERENCE_NODE�SHOW_ENTITY_REFERENCE�ENTITY_NODE�SHOW_ENTITY�PROCESSING_INSTRUCTION_NODE�SHOW_PROCESSING_INSTRUCTION�COMMENT_NODE�SHOW_COMMENT�
DOCUMENT_NODE�
SHOW_DOCUMENT�DOCUMENT_TYPE_NODE�SHOW_DOCUMENT_TYPE�DOCUMENT_FRAGMENT_NODE�SHOW_DOCUMENT_FRAGMENT�
NOTATION_NODE�
SHOW_NOTATIONr�rrrrrU�s&
�rUc@�eZdZdZdd�ZdS)�FilterCrutch)�_builder�_level�
110  _old_start�_old_endcCs6d|_||_|j}|j|_|j|_|j|_|j|_dSr�)	rrrXrlrrnr	r�rm)rr@r�rrrrszFilterCrutch.__init__N)r;r<r=r>rrrrrr�rc@s(eZdZdZdd�Zdd�Zdd�ZdS)	r�rcCs,t�||�|j}dD]}t||d�qdS)N)rprwr~rzr|r�)rrrX�setattr)rr@r�rIrrrrs
111  �zRejecter.__init__cGs|jd|_dSr�)r�r�argsrrrr�r!zRejecter.start_element_handlercGsB|jdkr|jj}|j�|�|j|_|j|_dS|jd|_dS�Nrr$)rrrXrarrlr	rn)rr
r�rrrrm s
112  zRejecter.end_element_handlerN)r;r<r=r>rr�rmrrrrr�s
113  r�c@� eZdZdZdd�Zdd�ZdS)r�rcGs2|jj}|j|�|jj|ur|jd|_dSdSr�)rrfrr)rr
r�rrrr�-s
114  
115  �zSkipper.start_element_handlercGsF|jdkr|j|jj_|j|jj_d|_dS|jd|_|j|�dSr)rrrrXrlr	rnrrrrrm3s
116  
117  zSkipper.end_element_handlerN)r;r<r=r>r�rmrrrrr�*sr�z8http://xml.python.org/entities/fragment-builder/internalz�<!DOCTYPE wrapper
118    %%s [
119    <!ENTITY fragment-builder-internal
120      SYSTEM "%s">
121  %%s
122  ]>
123  <wrapper %%s
124  >&fragment-builder-internal;</wrapper>c@sJeZdZdZddd�Zdd�Zdd�Zd	d
125  �Zdd�Zd
d�Z	dd�Z
126  dS)�FragmentBuilderz�Builder which constructs document fragments given XML source
127      text and a context node.
128  
129      The context node is expected to provide information about the
130      namespace declarations which are in scope at the start of the
131      fragment.
132      NcCs6|jtkr||_||_n|j|_||_t�||�dSr)r�r��originalDocumentr�r�rQr)rr�rZrrrr[s
133  zFragmentBuilder.__init__cCst�|�d|_dSr)rQrY�fragmentrrrrrYds
134  
135  zFragmentBuilder.resetcCs|�|���S)zRParse a document fragment from a file object, returning the
136          fragment node.)r�r��rr�rrrr�hszFragmentBuilder.parseFilec	Cs�||_|��}|jj}d}|r+|jp|��}|jr"d|j|jf}n|jr*d|j}nd}|��}t	|||f}z|�
137  |d�Wn|���|j}|��|S)zMParse a document fragment from a string, returning the
138          fragment node.�zPUBLIC "%s" "%s"zSYSTEM "%s"T)
�_sourcerbrr�r��_getDeclarationsr�r��_getNSattrs�_FRAGMENT_BUILDER_TEMPLATEr�rYr)	rr�r�r��identr�Znsattrsrerrrrr�ms0
139  �
140  �zFragmentBuilder.parseStringcCs
141  |jjj}d}|r�t|jj�D])}|j�|�}|r|d}d||jf}|jr1d||j|j	f}qd||j	f}qt|j
142  j�D]C}|j
143  �|�}|rM|d}d||jf}|jrad||j|j	f}n|j	rld||j	f}nd	||jjf}|j
r~d
144  ||j
f}|d}q?|S)z�Re-create the internal subset from the DocumentType node.
145  
146          This is only needed if we don't already have the
147          internalSubset as a string.
148          rz
149    z%s<!NOTATION %sz!%s PUBLIC "%s"
150               "%s">z%s SYSTEM "%s">z
%s<!ENTITY %sz %s PUBLIC "%s"
151               "%s"z%s SYSTEM "%s"z%s "%s"z%s NOTATION %s�>)r�r�r�r�r��length�item�nodeNamer�r�r�
152  firstChildr�r�)rr�rAr��notationrrrrr�s:
153  ��
154  z FragmentBuilder._getDeclarationscCr�)Nrrrrrrr�r�zFragmentBuilder._getNSattrscCs�|tkr<|j}|j}|j�|�}|j|_|j��|_|j|_z|�|j	d�W||_||_d|_	dS||_||_d|_	wt
155  �|||||�S)NTr�)�$_FRAGMENT_BUILDER_INTERNAL_SYSTEM_IDrerfrX�ExternalEntityParserCreater�createDocumentFragmentrr�rrQr�)rr�r�r�r�Zold_documentZold_cur_noder�rrrr��s&�
156  �z+FragmentBuilder.external_entity_ref_handlerr)r;r<r=r�rrYr�r�rrr�rrrrrRs
157  	$rc@sBeZdZdZdd�Zdd�Zdd�Zdd	�Zd
158  d�Z	d
d�Z	dS)�
159  Namespacesz7Mix-in class for builders; adds support for namespaces.cCs
160  g|_dSr)�_ns_ordered_prefixesrrrr�_initNamespaces�s
161  zNamespaces._initNamespacescCstjdd�}d|_|S)z'Create a new namespace-handling parser.rC)Znamespace_separatorT)rr[�namespace_prefixesr�rrrr\�szNamespaces.createParsercCs$t�||�|jjr|j|_dSdS)z.Insert the namespace-handlers onto the parser.N)rQrarS�namespace_declarations�start_namespace_decl_handler�StartNamespaceDeclHandlerr�rrrra�s
162  ��zNamespaces.installcCs|j�||f�dS)z/Push this namespace declaration on our storage.N)r$r�)rrNrLrrrr(�sz'Namespaces.start_namespace_decl_handlercCs�d|vrt||�\}}}}nt}|}d}t}t�||||�}|j|_t|j|�||_|j	r`|j	D](\}}|rEt�
163  t|d|�t|d�}nt�
164  dtdt�}||_
|j|_t||�q1|j	dd�=|r�|��|j}	|j}
165  tdt|�d�D]J}||}||d}
d|vr�t||�\}}}}t�
166  ||||�}||	|<||
167  ||f<nt�
168  |t|t�}||	|<||
169  t|f<|j|_|
|_
||_qtdSdS)NrC�xmlns:�xmlnsrrEr$)rPrrr�Elementrer�r	rfr$r�rBrr�r
170  �_ensure_attributes�_attrs�_attrsNSr�rG�ownerElement)rrIr�rLrMrNrOr�r�r.r/r�r)r�rrrr��sZ����z Namespaces.start_element_handlerTcCs�|j}d|vr$t||�\}}}}|j|kr|j|kr|j|ks#Jd��n|j|ks-Jd��|jtks6Jd��|j|_|�|�dS)NrCz$element stack messed up! (namespace)z&element stack messed up - bad nodeNamez*element stack messed up - bad namespaceURI)	rfrPr-r.rNrrr�r�)rrIrfrLrMrNrOrrrrms 
171  
172  ���zNamespaces.end_element_handlerN)
173  r;r<r=r�r%r\rar(r�rmrrrrr#�s/r#c@r)�ExpatBuilderNSz*Document builder that supports namespaces.cC�t�|�|��dSr)rQrYr%rrrrrY)�
174  zExpatBuilderNS.resetN)r;r<r=r�rYrrrrr1&r
175  r1c@r)�FragmentBuilderNSz*Fragment builder that supports namespaces.cCr2r)rrYr%rrrrrY1r3zFragmentBuilderNS.resetcCs�d}|j}g}|r@t|d�r;|j��D]'\}}||vrq|�|�|r(d|}nd}|r4d|||f}qd||f}q|j}|s	|S)zNReturn string of namespace attributes from this element and
176          ancestors.r�_ns_prefix_urir*r+z%s
177      %s='%s'z %s='%s')r��hasattrr5�itemsr�r�)r�attrsr�r�rNrL�declnamerrrr5s$
178  
179  
180  �zFragmentBuilderNS._getNSattrsN)r;r<r=r�rYrrrrrr4.sr4c@seZdZdZdS)r�zEException raised to short-circuit parsing in InternalSubsetExtractor.N)r;r<r=r�rrrrr�Ssr�c@sLeZdZdZdZdd�Zdd�Zdd�Zd	d
181  �Zdd�Z	d
d�Z
182  dd�ZdS)r�zBXML processor which can rip out the internal document type subset.NcCs|jS)z'Return the internal subset as a string.)r�rrrrr�\sz!InternalSubsetExtractor.getSubsetcC�(z	t�||�WdStyYdSwr)rQr�r�rrrrr�`�
183  �z!InternalSubsetExtractor.parseFilecCr:r)rQr�r�)rr�rrrr�fr;z#InternalSubsetExtractor.parseStringcCs|j|_|j|_dSr)rirjr�rlr�rrrralszInternalSubsetExtractor.installcCs.|r|��}g|_|jj|_|j|_dSt��r)rbr�r��DefaultHandlerr�r�r�)rrIr�r�r�r�rrrrips
184  z2InternalSubsetExtractor.start_doctype_decl_handlercCs(d�|j��dd��dd�}||_t��)Nrz
185  �
186  �
)�joinr��replacer�)rrArrrr�zsz0InternalSubsetExtractor.end_doctype_decl_handlercCst��r)r�)rrIr8rrrr�r0z-InternalSubsetExtractor.start_element_handler)r;r<r=r�r�r�r�r�rarir�r�rrrrr�Ws
187  r�TcCsd|rt�}nt�}t|t�r+t|d��}|�|�}Wd�|S1s$wY|S|�|�}|S)z{Parse a document, returning the resulting Document node.
188  
189      'file' may be either a file name or an open file object.
190      �rbN)r1rQ�
191  isinstance�str�openr�)r��
192  namespacesr@�fp�resultrrr�parse�s
193  
194  ��
195  �rHcCs|rt�}nt�}|�|�S)zOParse a document from a string, returning the resulting
196      Document node.
197      )r1rQr�)r�rEr@rrrr��s
198  r�cCsh|rt|�}nt|�}t|t�r-t|d��}|�|�}Wd�|S1s&wY|S|�|�}|S)z�Parse a fragment of a document, given the context from which it
199      was originally extracted.  context should be the parent of the
200      node(s) which are in the fragment.
201  
202      'file' may be either a file name or an open file object.
203      rAN)r4rrBrCrDr�)r�r�rEr@rFrGrrr�
parseFragment�s
204  
205  
206  ��
207  �rIcCs |rt|�}nt|�}|�|�S)z�Parse a fragment of a document from a string, given the context
208      from which it was originally extracted.  context should be the
209      parent of the node(s) which are in the fragment.
210      )r4rr�)r�r�rEr@rrr�parseFragmentString�s
211  
212  rJcCs|jrt|�St|�S)z,Create a builder based on an Options object.)rEr1rQ)rZrrr�makeBuilder�srK)T)3r��xml.domrrrrrr�xml.parsersr�xml.dom.minidomr	r
213  �xml.dom.NodeFilterrr�r�r��DOMBuilderFilterr�r�r�r��getDOMImplementationrc�TypeInfor'�objectrrBrPrQr�rUrr�r�r rrr#r1r4�	Exceptionr�r�rHr�rIrJrKrrrr�<module>sh
214  
215  
216  
217  
218  
219  
220  
221  
222  �3
223  C:�	��
u_%
224  ,
225  
226  
227