a
XC?h�� � @ s d Z ddlmZmZmZ ddlmZmZmZ ddlm Z ddl
m Z m Z ddl
mZ ejZejZejZejjZejjZejjZejjZe�� Ze�dd�e�dd �e�dd
�e�dd �e�dd �e�dd
�e�dd�e�dd�e�dd�d� ZG dd� de�Z dd� Z dd� Z G dd� d�Z eeefZ G dd� de�Z!G d d � d e�Z"G d d � d e"�Z#G d d!� d!e"�Z$d"Z%d#e% Z&G d$d%� d%e �Z'G d&d'� d'�Z(G d(d)� d)e(e �Z)G d*d+� d+e(e'�Z*G d,d-� d-e+�Z,G d.d/� d/e �Z-d;d1d2�Z.dd7d8�Z1d9d:� Z2dS )?z�Facility to use the Expat parser to load a minidom instance
from a string or file.
This avoids all the overhead of SAX and pulldom to gain performance.
� )�
xmlbuilder�minidom�Node)�EMPTY_NAMESPACE� EMPTY_PREFIX�XMLNS_NAMESPACE)�expat)�
_append_child�_set_attribute_node)�
NodeFilterNZcdata� enumeration�entity�entities�idZidrefZidrefsZnmtokenZnmtokens) ZCDATA�ENUMZENTITYZENTITIES�IDZIDREFZIDREFSZNMTOKENZNMTOKENSc @ sZ e Zd ZdZddd�Zdd� Zdd� Zd d
� Zd d � Zd
d� Z dd� Z
dd� Z dd� Z dS )� ElementInfo��
_attr_info�_model�tagNameNc C s || _ g | _|| _d S �N)r r r )�selfr �model� r �9/opt/alt/python39/lib64/python3.9/xml/dom/expatbuilder.py�__init__? s zElementInfo.__init__c C s | j | j| jfS r r �r r r r � __getstate__D s zElementInfo.__getstate__c C s |\| _ | _| _d S r r )r �stater r r � __setstate__G s zElementInfo.__setstate__c C sN | j D ]@}|d |kr|d }|d dkr6td S t|d S qtjS )N� �����r �(r )r �
_typeinfo_mapr �_no_type)r �aname�info�tr r r �getAttributeTypeJ s
z ElementInfo.getAttributeTypec C s t jS r )r r% )r � namespaceURI� localNamer r r �getAttributeTypeNST s z ElementInfo.getAttributeTypeNSc C s, | j r$| j d }|tjjtjjfvS dS d S �Nr F)r r r Z
XML_CTYPE_ANYZXML_CTYPE_MIXED)r �typer r r �isElementContentW s
�z ElementInfo.isElementContentc C s | j r| j d tjjkS dS d S r- )r r r ZXML_CTYPE_EMPTYr r r r �isEmpty_ s zElementInfo.isEmptyc C s, | j D ] }|d |kr|d dk S qdS )Nr! r" r F)r )r r& r' r r r �isIde s
zElementInfo.isIdc C s | � ||f�S r )r1 )r ZeuriZenameZaurir& r r r �isIdNSk s zElementInfo.isIdNS)N)
�__name__�
__module__� __qualname__� __slots__r r r r) r, r/ r0 r1 r2 r r r r r < s
r c C s | � ||�S r )�_intern_setdefault)�builder�sr r r �_interno s r: c C s� d|v s J �|� d�}| j}t|�dkr^|\}}}|||�}d||f }|||�}|||�}n4t|�dkr�|\}}t}|||� }}n td| ��|||�|||fS )N� � z%s:%s� z4Unsupported syntax: spaces in URIs not supported: %r)�splitr7 �lenr �
ValueError)r8 �name�parts�intern�uri� localname�prefix�qnamer r r �_parse_ns_namer s
rH c @ s� e Zd ZdZd;dd�Zdd� Zdd� Zd d
� Zd d � Zd
d� Z dd� Z
dd� Z dd� Z dd� Z
dd� Zdd� Zdd � Zd d � Zd d � Zd!d"� Zd#d$� Zd%d&� Zd'd(� Zd)d*� Zd+d,� Zd-d.� Zd/d0� Zd1d2� Zd3d4� Z d5d6� Z d7d8� Z d9d:� Z dS )<� ExpatBuilderzPDocument builder that uses Expat to build a ParsedXML.DOM document
instance.Nc C sP |d u rt �� }|| _| jjd ur2t| jj�| _n d | _t| _d | _| � � d S r )
r ZOptions�_options�filter�FilterVisibilityController�_filterr �_finish_start_element�_parser�reset)r �optionsr r r r � s zExpatBuilder.__init__c C s t �� S )zCreate a new parser object.)r � ParserCreater r r r � createParser� s zExpatBuilder.createParserc C sF | j s@| �� | _ | j jj| _d| j _d| j _d| j _| �| j � | j S )z7Return the parser object, creating a new one if needed.T) rO rS rC �
setdefaultr7 Z buffer_textZordered_attributesZspecified_attributes�installr r r r � getParser� s
zExpatBuilder.getParserc C s, t �tdd�| _| j| _| jj| _d| _dS )z6Free all data structures used during DOM construction.NF)�theDOMImplementationZcreateDocumentr �document�curNode�
_elem_info�_cdatar r r r rP � s �
zExpatBuilder.resetc C s� | j |_| j|_| j|_| j|_| jj r0| j
|_ | j |_
| jjrH| j|_| jjrj| 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�
pi_handler� ProcessingInstructionHandlerrJ r �entity_decl_handler�EntityDeclHandler�notation_decl_handler�NotationDeclHandler�comments�comment_handler�CommentHandlerZcdata_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_handlerZXmlDeclHandler�element_decl_handlerZElementDeclHandler�attlist_decl_handlerZAttlistDeclHandler�r �parserr r r rU � s$
zExpatBuilder.installc C s� | � � }d}zH|�d�}|s qF|�|d� |r@| jjr@| �|� d}q|�dd� W n tyf Y n0 | j}| �� d| _|S )zIParse a document from a file object, returning the document
node.Ti @ F� N) rV �read�ParserX �documentElement�
_setup_subset� ParseEscaperP rO )r �filerx Z first_buffer�buffer�docr r r � parseFile� s"
zExpatBuilder.parseFilec C sN | � � }z|�|d� | �|� W n ty4 Y n0 | j}| �� d| _|S )z | j �|�}t| j|� | jr:| j�|�tkr:| j�|� d S r )rX Z
createCommentr rY rM r� r� r� )r r� r� r r r ri I s z ExpatBuilder.comment_handlerc C s d| _ d| _d S )NTF�r[ r� r r r r rk O s z(ExpatBuilder.start_cdata_section_handlerc C s d| _ d| _d S )NFr� r r r r rm S s z&ExpatBuilder.end_cdata_section_handlerc C s dS �Nr! r )r �contextr� r� r� r r r rr W s z(ExpatBuilder.external_entity_ref_handlerc C s2 | j d u r| jst| _| j| �� _| �||� d S r )rM rZ r r� �start_element_handlerrV r_ )r rA �
attributesr r r r^ Z s z"ExpatBuilder.first_element_handlerc C s� | j �|�}t| j|� || _|rptdt|�d�D ]<}t�|| td t �}||d }||_
| j |_ t ||� q2|| j j
ur�| �|� d S )Nr r= r! )rX Z
createElementr rY �ranger? r �Attrr r r� r� r
r| rN )r rA r� r� �i�ar� r r r r� ` s � z"ExpatBuilder.start_element_handlerc C sj | j rf|| jju rd S | j �|�}|tkr4t| � n|tkrFt| � nd S |j| _ |j�
|� |� � d S r ) rM rX r| �startContainerr� �Rejecter� FILTER_SKIP�Skipper�
parentNoderY r� �unlink)r r� Zfiltr r r rN q s
z"ExpatBuilder._finish_start_elementc C s | j }|j| _ | �|� d S r )rY r� r� )r rA rY r r r r` � s z ExpatBuilder.end_element_handlerc C s\ | j �|j�}|r | �||� | jrX|| jju r4d S | j�|�tkrX| j �
|� |� � d S r ) rZ �getr �_handle_white_text_nodesrM rX r| r� r� rY r� r� )r rY r' r r r r� � s z ExpatBuilder._finish_end_elementc C sZ | j js|�� sd S g }|jD ]"}|jtkr |j�� s |�|� q |D ]}|� |� qFd S r )
rJ Z whitespace_in_element_contentr/ r� r� r� r� �stripr� r� )r r� r' �Lr� r r r r� � s �
z%ExpatBuilder._handle_white_text_nodesc C s> | j �|�}|d u r&t||�| j |< n|jd u s4J �||_d S r )rZ r� r r )r rA r r' r r r ru � s
z!ExpatBuilder.element_decl_handlerc
C sF | j �|�}|d u r&t|�}|| j |< |j�d |d d |d||g� d S �Nr )rZ r� r r r� )r �elemrA r. �defaultZrequiredr' r r r rv � s
�z!ExpatBuilder.attlist_decl_handlerc C s2 || j _|| j _|dkr.|r&d| j _nd| j _d S )Nr TF)rX �version�encoding�
standalone)r r� r� r� r r r rt � s
z ExpatBuilder.xml_decl_handler)N) r3 r4 r5 �__doc__r rS rV rP rU r� r� r} r\ r� rb ro rq rd rf ri rk rm rr r^ r� rN r` r� r� ru rv rt r r r r rI � s:
rI c @ s� e Zd ZdZdZdd� Zdd� Zdd� Zej e
j ej e
j
eje
jeje
jeje
jeje
jeje
jeje
jeje
jej e
j ej e
j ej e
j!i Z"d S )
rL zoWrapper around a DOMBuilderFilter which implements the checks
to make the whatToShow filter attribute work.�rK c C s
|| _ d S r r� )r rK r r r r � s z#FilterVisibilityController.__init__c C sT | j |j }| jj|@ rL| j�|�}|tkr0t�|tvrHtdt |� ��|S t
S d S )Nz)startContainer() returned illegal value: ) �_nodetype_maskr� rK �
whatToShowr� �FILTER_INTERRUPTr~ �_ALLOWED_FILTER_RETURNSr@ �reprr� )r r� �mask�valr r r r� � s
�z)FilterVisibilityController.startContainerc C s� | j |j }| jj|@ r|| j�|�}|tkr0t�|tkr`|j}|j d d � D ]}|�
|� qLt S |t vrxt
dt|� ��|S tS d S )Nz%acceptNode() returned illegal value: )r� r� rK r� r� r� r~ r� r� r� Z appendChildr� r� r@ r� r� )r r� r� r� �parentr� r r r r� � s
�z%FilterVisibilityController.acceptNodeN)#r3 r4 r5 r� r6 r r� r� r Z ELEMENT_NODEr Z SHOW_ELEMENTZATTRIBUTE_NODEZSHOW_ATTRIBUTEr� Z SHOW_TEXTr� ZSHOW_CDATA_SECTIONZENTITY_REFERENCE_NODEZSHOW_ENTITY_REFERENCEZ ENTITY_NODEZ SHOW_ENTITYZPROCESSING_INSTRUCTION_NODEZSHOW_PROCESSING_INSTRUCTIONZ COMMENT_NODEZ SHOW_COMMENT�
DOCUMENT_NODEZ
SHOW_DOCUMENTZDOCUMENT_TYPE_NODEZSHOW_DOCUMENT_TYPEZDOCUMENT_FRAGMENT_NODEZSHOW_DOCUMENT_FRAGMENTZ
NOTATION_NODEZ
SHOW_NOTATIONr� r r r r rL � s$
�rL c @ s e Zd ZdZdd� ZdS )� FilterCrutch)�_builder�_level�
_old_start�_old_endc C s6 d| _ || _|j}|j| _|j| _| j|_| j|_d S r� ) r� r� rO r_ r� ra r� r� r` )r r8 rx r r r r s zFilterCrutch.__init__N)r3 r4 r5 r6 r r r r r r� s r� c @ s( e Zd ZdZdd� Zdd� Zdd� ZdS ) r� r c C s, t �| |� |j}dD ]}t||d � qd S )N)rc rj rp rl rn rs )r� r rO �setattr)r r8 rx rA r r r r s zRejecter.__init__c G s | j d | _ d S r� )r� �r �argsr r r r� s z Rejecter.start_element_handlerc G s@ | j dkr0| jj}| j�|� | j|_| j|_n | j d | _ d S �Nr r! )r� r� rO rU r� r_ r� ra )r r� rx r r r r` s
z Rejecter.end_element_handlerN)r3 r4 r5 r6 r r� r` r r r r r� s r� c @ s e Zd ZdZdd� Zdd� ZdS )r� r c G s. | j j}| j|� | j j|ur*| jd | _d S r� )r� rY r� r� )r r� r� r r r r� - s
z Skipper.start_element_handlerc G sD | j dkr*| j| jj_| j| jj_d | _n| j d | _ | j|� d S r� )r� r� r� rO r_ r� ra r� r r r r` 3 s
zSkipper.end_element_handlerN)r3 r4 r5 r6 r� r` r r r r r� * s r� z8http://xml.python.org/entities/fragment-builder/internalz�
%%s
]>
&fragment-builder-internal;c @ sJ e Zd ZdZddd�Zdd� Zdd� Zd d
� Zd d � Zd
d� Z dd� Z
dS )�FragmentBuilderz�Builder which constructs document fragments given XML source
text and a context node.
The context node is expected to provide information about the
namespace declarations which are in scope at the start of the
fragment.
Nc C s6 |j tkr|| _|| _n|j| _|| _t�| |� d S r )r� r� �originalDocumentr� r� rI r )r r� rQ r r r r [ s
zFragmentBuilder.__init__c C s t �| � d | _d S r )rI rP �fragmentr r r r rP d s
zFragmentBuilder.resetc C s | � |�� �S )zRParse a document fragment from a file object, returning the
fragment node.)r� rz �r r r r r r� h s zFragmentBuilder.parseFilec C s� || _ | �� }| jj}d}|rV|jp*| �� }|jrDd|j|jf }qZ|jrZd|j }nd}| �� }t |||f }z|�
|d� W n | � � � Y n0 | j }| � � |S )zMParse a document fragment from a string, returning the
fragment node.� zPUBLIC "%s" "%s"z SYSTEM "%s"T)
�_sourcerV r� r� r� �_getDeclarationsr� r� � _getNSattrs�_FRAGMENT_BUILDER_TEMPLATEr{ rP r� ) r r� rx r� Zidentr� ZnsattrsrX r� r r r r� m s.
� zFragmentBuilder.parseStringc C s | j jj}d}|�rt|jj�D ]R}|j�|�}|r<|d }d||jf }|jrdd||j|j f }q d||j f }q t|j
j�D ]�}|j
�|�}|r�|d }d||jf }|jr�d||j|j f }n&|j r�d||j f }nd ||j j f }|j
r�d
||j
f }|d }q�|S ) z�Re-create the internal subset from the DocumentType node.
This is only needed if we don't already have the
internalSubset as a string.
r� z
z%sz%s SYSTEM "%s">z
%s)r� r� r� r� r� Zlength�item�nodeNamer� r� r Z
firstChildr� r� )r r� r9 r� Znotationr
r r r r� � s:
� �
z FragmentBuilder._getDeclarationsc C s dS )Nr� r r r r r r� � s zFragmentBuilder._getNSattrsc C s� |t krz| j}| j}| j�|�}| j| _| j�� | _| j| _z$|�| j d� W || _|| _d | _ n|| _|| _d | _ 0 dS t
� | ||||�S d S )NTr� ) �$_FRAGMENT_BUILDER_INTERNAL_SYSTEM_IDrX rY rO ZExternalEntityParserCreater� ZcreateDocumentFragmentr� r{ r� rI rr )r r� r� r� r� Z old_documentZ old_cur_noderx r r r rr � s& �
�z+FragmentBuilder.external_entity_ref_handler)N) r3 r4 r5 r� r rP r� r� r� r� rr r r r r r� R s
$r� c @ s@ e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
d � Zd d
� Z dS )�
Namespacesz7Mix-in class for builders; adds support for namespaces.c C s
g | _ d S r )�_ns_ordered_prefixesr r r r �_initNamespaces� s zNamespaces._initNamespacesc C s t jdd�}d|_|S )z'Create a new namespace-handling parser.r; )Znamespace_separatorT)r rR Znamespace_prefixesrw r r r rS � s zNamespaces.createParserc C s t �| |� | jjr | j|_dS )z.Insert the namespace-handlers onto the parser.N)rI rU rJ Znamespace_declarations� start_namespace_decl_handlerZStartNamespaceDeclHandlerrw r r r rU � s �zNamespaces.installc C s | j �||f� dS )z/Push this namespace declaration on our storage.N)r� r� )r rF rD r r r r� � s z'Namespaces.start_namespace_decl_handlerc C s� d|v r t | |�\}}}}nt}|}d }t}t�||||�}| j|_t| j|� || _| j r�| j D ]P\}}|r�t�
t | d| �t |d�}nt�
dt dt�}||_
| j|_t||� qb| j d d �= |�r~|�� |j} |j}
tdt|�d�D ]�} || } || d }
d| v �rDt | | �\}}}}t�
||||�}|| |< ||
||f< n$t�
| t| t�}|| | < ||
t| f< | j|_|
|_
||_q�d S )Nr; �xmlns:�xmlnsr r= r! )rH r r r ZElementrX r� r rY r� r� r: r r� r
Z_ensure_attributes�_attrs�_attrsNSr� r? Z ownerElement)r rA r� rD rE rF rG r� r� r� r� r� r& r� r r r r� � sV ��
� z Namespaces.start_element_handlerc C s� | j }d|v rHt| |�\}}}}|j|kr>|j|kr>|j|kslJ d��n$|j|ksZJ d��|jtkslJ d��|j| _ | �|� d S )Nr; z$element stack messed up! (namespace)z&element stack messed up - bad nodeNamez*element stack messed up - bad namespaceURI) rY rH r* r+ rF r� r r� r� )r rA rY rD rE rF rG r r r r` s$
��� � �z Namespaces.end_element_handlerN)
r3 r4 r5 r� r� rS rU r� r� r` r r r r r� � s 5r� c @ s e Zd ZdZdd� ZdS )�ExpatBuilderNSz*Document builder that supports namespaces.c C s t �| � | �� d S r )rI rP r� r r r r rP ) s
zExpatBuilderNS.resetN)r3 r4 r5 r� rP r r r r r� & s r� c @ s e Zd ZdZdd� Zdd� ZdS )�FragmentBuilderNSz*Fragment builder that supports namespaces.c C s t �| � | �� d S r )r� rP r� r r r r rP 1 s
zFragmentBuilderNS.resetc C s� d}| j }g }|r~t|d�rv|j�� D ]N\}}||v r8q&|�|� |rPd| }nd}|rhd|||f }q&d||f }q&|j}q|S )zNReturn string of namespace attributes from this element and
ancestors.r� �_ns_prefix_urir� r� z%s
%s='%s'z %s='%s')r� �hasattrr� �itemsr� r� )r �attrsr� r� rF rD Zdeclnamer r r r� 5 s"
z FragmentBuilderNS._getNSattrsN)r3 r4 r5 r� rP r� r r r r r� . s r� c @ s e Zd ZdZdS )r~ zEException raised to short-circuit parsing in InternalSubsetExtractor.N)r3 r4 r5 r� r r r r r~ S s r~ c @ sL e Zd ZdZdZdd� Zdd� Zdd� Zd d
� Zd d � Z d
d� Z
dd� Z dS )r� zBXML processor which can rip out the internal document type subset.Nc C s | j S )z'Return the internal subset as a string.)r� r r r r r� \ s z!InternalSubsetExtractor.getSubsetc C s( zt �| |� W n ty" Y n0 d S r )rI r� r~ r� r r r r� ` s z!InternalSubsetExtractor.parseFilec C s( zt �| |� W n ty" Y n0 d S r )rI r� r~ )r r� r r r r� f s z#InternalSubsetExtractor.parseStringc C s | j |_| j|_d S r )r\ r] r� r_ rw r r r rU l s z InternalSubsetExtractor.installc C s0 |r&| � � }g | _| jj|_| j|_nt� �d S r )rV r� r� ZDefaultHandlerr� r� r~ )r rA r� r� r� rx r r r r\ p s
z2InternalSubsetExtractor.start_doctype_decl_handlerc C s, d� | j��dd��dd�}|| _t� �d S )Nr� z
�
�
)�joinr� �replacer~ )r r9 r r r r� z s z0InternalSubsetExtractor.end_doctype_decl_handlerc C s
t � �d S r )r~ )r rA r� r r r r� s z-InternalSubsetExtractor.start_element_handler) r3 r4 r5 r� r� r� r� r� rU r\ r� r� r r r r r� W s
r� Tc C s` |r t � }nt� }t| t�rRt| d��}|�|�}W d � q\1 sF0 Y n
|�| �}|S )z{Parse a document, returning the resulting Document node.
'file' may be either a file name or an open file object.
�rbN)r� rI �
isinstance�str�openr� )r �
namespacesr8 �fp�resultr r r �parse� s
*
r� c C s |r t � }nt� }|�| �S )zOParse a document from a string, returning the resulting
Document node.
)r� rI r� )r� r� r8 r r r r� � s r� c C sd |rt |�}nt|�}t| t�rVt| d��}|�|�}W d � q`1 sJ0 Y n
|�| �}|S )z�Parse a fragment of a document, given the context from which it
was originally extracted. context should be the parent of the
node(s) which are in the fragment.
'file' may be either a file name or an open file object.
r� N)r� r� r� r� r� r� )r r� r� r8 r� r� r r r �
parseFragment� s
*
r� c C s |rt |�}nt|�}|�| �S )z�Parse a fragment of a document from a string, given the context
from which it was originally extracted. context should be the
parent of the node(s) which are in the fragment.
)r� r� r� )r� r� r� r8 r r r �parseFragmentString� s
r� c C s | j rt| �S t| �S dS )z,Create a builder based on an Options object.N)r� r� rI )rQ r r r � makeBuilder� s r� )T)T)T)T)3r� Zxml.domr r r r r r Z xml.parsersr Zxml.dom.minidomr r
Zxml.dom.NodeFilterr r� r� r� ZDOMBuilderFilterr� r� r� r� ZgetDOMImplementationrW ZTypeInfor$ �objectr r: rH rI r� rL r� r� r� r� r� r� r� r� r� � Exceptionr~ r� r� r� r� r� r� r r r r � sf
� 3 C
: � ��
u_%,