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 Z namespaceURIZ 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 )r/ )r ZeuriZenameZaurir& r r r �isIdNSk s zElementInfo.isIdNS)N)
�__name__�
__module__� __qualname__� __slots__r r r r) r* r- r. r/ r0 r r r r r < s
r c C s | � ||�S r )�_intern_setdefault)�builder�sr r r �_interno s r8 c C s� |� d�}| j}t|�dkrR|\}}}|||�}d||f }|||�}|||�}n4t|�dkrz|\}}t}|||� }}n td| ��|||�|||fS )N� � z%s:%s� z4Unsupported syntax: spaces in URIs not supported: %r)�splitr5 �lenr �
ValueError)r6 �name�parts�intern�uri� localname�prefix�qnamer r r �_parse_ns_namer s
rF 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) rM rQ rA �
setdefaultr5 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 rN � 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� ProcessingInstructionHandlerrH 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 rS � 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) rT �read�ParserV �documentElement�
_setup_subset� ParseEscaperN rM )r �filerv 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 )rV Z
createCommentr rW rK r� r� r� )r r� r� r r r rg I s z ExpatBuilder.comment_handlerc C s d| _ d| _d S )NTF�rY r� r r r r ri O s z(ExpatBuilder.start_cdata_section_handlerc C s d| _ d| _d S )NFr� r r r r rk S s z&ExpatBuilder.end_cdata_section_handlerc C s dS �Nr! r )r �contextr� r� r� r r r rp W s z(ExpatBuilder.external_entity_ref_handlerc C s2 | j d u r| jst| _| j| �� _| �||� d S r )rK rX r r� �start_element_handlerrT r] )r r? �
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! )rV Z
createElementr rW �ranger= r �Attrr r r� r� r
rz rL )r r? 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 ) rK rV rz �startContainerr� �Rejecter� FILTER_SKIP�Skipper�
parentNoderW r� �unlink)r r� Zfiltr r r rL q s
z"ExpatBuilder._finish_start_elementc C s | j }|j| _ | �|� d S r )rW r� r� )r r? rW 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 ) rX �getr �_handle_white_text_nodesrK rV rz r� r� rW r� r� )r rW 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 )
rH 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 s0 | j �|�}|d u r&t||�| j |< n||_d S r )rX r� r r )r r? r r' r r r rs � s z!ExpatBuilder.element_decl_handlerc
C sF | j �|�}|d u r&t|�}|| j |< |j�d |d d |d||g� d S �Nr )rX r� r r r� )r �elemr? r, �defaultZrequiredr' r r r rt � s
�z!ExpatBuilder.attlist_decl_handlerc C s2 || j _|| j _|dkr.|r&d| j _nd| j _d S )Nr TF)rV �version�encoding�
standalone)r r� r� r� r r r rr � s
z ExpatBuilder.xml_decl_handler)N) r1 r2 r3 �__doc__r rQ rT rN rS r� r� r{ rZ r� r` rm ro rb rd rg ri rk rp r\ r� rL r^ r� r� rs rt rr r r r r rG � s:
rG 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 )
rJ zoWrapper around a DOMBuilderFilter which implements the checks
to make the whatToShow filter attribute work.�rI c C s
|| _ d S r r� )r rI 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� rI �
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� rI 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)#r1 r2 r3 r� r4 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 rJ � s$
�rJ 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� rM r] r� r_ r� r� r^ )r r6 rv r r r r s zFilterCrutch.__init__N)r1 r2 r3 r4 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)ra rh rn rj rl rq )r� r rM �setattr)r r6 rv r? 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� rM rS r� r] r� r_ )r r� rv r r r r^ s
z Rejecter.end_element_handlerN)r1 r2 r3 r4 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� rW 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� rM r] r� r_ r� r r r r^ 3 s
zSkipper.end_element_handlerN)r1 r2 r3 r4 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� rG r )r r� rO r r r r [ s
zFragmentBuilder.__init__c C s t �| � d | _d S r )rG rN �fragmentr r r r rN d s
zFragmentBuilder.resetc C s | � |�� �S )zRParse a document fragment from a file object, returning the
fragment node.)r� rx �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)
�_sourcerT r� r� r� �_getDeclarationsr� r� � _getNSattrs�_FRAGMENT_BUILDER_TEMPLATEry rN r� ) r r� rv r� Zidentr� ZnsattrsrV 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�itemZnodeNamer� r� r Z
firstChildr� r� )r r� r7 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_IDrV rW rM ZExternalEntityParserCreater� ZcreateDocumentFragmentr� ry r� rG rp )r r� r� r� r� Z old_documentZ old_cur_noderv r r r rp � s& �
�z+FragmentBuilder.external_entity_ref_handler)N) r1 r2 r3 r� r rN r� r� r� r� rp r r r r r� R s
$r� c @ s8 e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
d � Zd S )
�
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.r9 )Znamespace_separatorT)r rP Znamespace_prefixesru r r r rQ � s zNamespaces.createParserc C s t �| |� | jjr | j|_dS )z.Insert the namespace-handlers onto the parser.N)rG rS rH Znamespace_declarations� start_namespace_decl_handlerZStartNamespaceDeclHandlerru r r r rS � s �zNamespaces.installc C s | j �||f� dS )z/Push this namespace declaration on our storage.N)r� r� )r rD rB 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 )Nr9 �xmlns:�xmlnsr r; r! )rF r r r ZElementrV r� r rW r� r� r8 r r� r
Z_ensure_attributes�_attrs�_attrsNSr� r= Z ownerElement)r r? r� rB rC rD rE r� r� r� r� r� r& r� r r r r� � sV ��
� z Namespaces.start_element_handlerN)
r1 r2 r3 r� r� rQ rS 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 )rG rN r� r r r r rN ) s
zExpatBuilderNS.resetN)r1 r2 r3 r� rN 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� rN r� r r r r rN 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� rD rB Zdeclnamer r r r� 5 s"
z FragmentBuilderNS._getNSattrsN)r1 r2 r3 r� rN r� r r r r r� . s r� c @ s e Zd ZdZdS )r| zEException raised to short-circuit parsing in InternalSubsetExtractor.N)r1 r2 r3 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 )rG r� r| r� r r r r� ` s z!InternalSubsetExtractor.parseFilec C s( zt �| |� W n ty" Y n0 d S r )rG r� r| )r r� r r r r� f s z#InternalSubsetExtractor.parseStringc C s | j |_| j|_d S r )rZ r[ r� r] ru r r r rS l s z InternalSubsetExtractor.installc C s0 |r&| � � }g | _| jj|_| j|_nt� �d S r )rT r� r� ZDefaultHandlerr� r� r| )r r? r� r� r� rv r r r rZ p s
z2InternalSubsetExtractor.start_doctype_decl_handlerc C s, d� | j��dd��dd�}|| _t� �d S )Nr� z
�
�
)�joinr� �replacer| )r r7 r r r r� z s z0InternalSubsetExtractor.end_doctype_decl_handlerc C s
t � �d S r )r| )r r? r� r r r r� s z-InternalSubsetExtractor.start_element_handler) r1 r2 r3 r� r� r� r� r� rS rZ 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� rG �
isinstance�str�openr� )r} �
namespacesr6 �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� rG r� )r� r� r6 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� r6 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� r6 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� rG )rO 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� ZgetDOMImplementationrU ZTypeInfor$ �objectr r8 rF rG r� rJ r� r� r� r� r� r� r� r� r� � Exceptionr| r� r� r� r� r� r� r r r r � sf
� 3 C
: � ��
u_%,