File manager - Edit - /home/newsbmcs.com/public_html/static/img/logo/xml.tar
Back
parsers/__pycache__/__init__.cpython-310.pyc 0000644 00000000464 15027446000 0014675 0 ustar 00 o }�5h� � @ s d Z dS )z�Python interfaces to XML parsers. This package contains one module: expat -- Python wrapper for James Clark's Expat parser, with namespace support. N)�__doc__� r r �+/usr/lib/python3.10/xml/parsers/__init__.py�<module> s parsers/__pycache__/expat.cpython-310.pyc 0000644 00000000521 15027446000 0014251 0 ustar 00 o }�5h� � @ s, d Z ddlZddlT eejd< eejd< dS )z1Interface to the Expat non-validating XML parser.� N)�*zxml.parsers.expat.modelzxml.parsers.expat.errors)�__doc__�sys�pyexpat�model�modules�errors� r r �(/usr/lib/python3.10/xml/parsers/expat.py�<module> s parsers/expat.py 0000644 00000000370 15027446000 0007714 0 ustar 00 """Interface to the Expat non-validating XML parser.""" import sys from pyexpat import * # provide pyexpat submodules as xml.parsers.expat submodules sys.modules['xml.parsers.expat.model'] = model sys.modules['xml.parsers.expat.errors'] = errors parsers/__init__.py 0000644 00000000247 15027446000 0010335 0 ustar 00 """Python interfaces to XML parsers. This package contains one module: expat -- Python wrapper for James Clark's Expat parser, with namespace support. """ __pycache__/__init__.cpython-310.pyc 0000644 00000001265 15027446000 0013216 0 ustar 00 o }�5h- � @ s d Z g d�ZdS )a� Core XML support for Python. This package contains four sub-packages: dom -- The W3C Document Object Model. This supports DOM Level 1 + Namespaces. parsers -- Python wrappers for XML parsers (currently only supports Expat). sax -- The Simple API for XML, developed by XML-Dev, led by David Megginson and ported to Python by Lars Marius Garshol. This supports the SAX 2 API. etree -- The ElementTree XML library. This is a subset of the full ElementTree XML release. )�dom�parsers�sax�etreeN)�__doc__�__all__� r r �#/usr/lib/python3.10/xml/__init__.py�<module> s dom/__pycache__/expatbuilder.cpython-310.pyc 0000644 00000065255 15027446000 0014737 0 ustar 00 o }�5h�� � @ 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.d;d3d4�Z/d;d5d6�Z0d;d7d8�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)� NodeFilterN�cdata� enumeration�entity�entities�id�idref�idrefs�nmtoken�nmtokens) �CDATA�ENUM�ENTITY�ENTITIES�ID�IDREF�IDREFS�NMTOKEN�NMTOKENSc @ 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& �+/usr/lib/python3.10/xml/dom/expatbuilder.py�__init__? s zElementInfo.__init__c C s | j | j| jfS r# r �r$ r& r& r' � __getstate__D � 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 dkrtd 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 r2 )r$ � namespaceURI� localNamer& r& r' �getAttributeTypeNST � z ElementInfo.getAttributeTypeNSc C s( | j r| j d }|tjjtjjfvS dS �Nr F)r! r r% � XML_CTYPE_ANY�XML_CTYPE_MIXED)r$ �typer& r& r' �isElementContentW s �z ElementInfo.isElementContentc C s | j r | j d tjjkS dS r; )r! r r% �XML_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$ r3 r4 r& r& r' �isIde s �zElementInfo.isIdc C s | � ||f�S r# )rB )r$ �euri�ename�aurir3 r& r& r' �isIdNSk s zElementInfo.isIdNSr# ) �__name__� __module__� __qualname__� __slots__r( r* r- r6 r9 r? rA rB rF r& r& r& r' r < s r c C s | � ||�S r# )�_intern_setdefault)�builder�sr& r& r' �_interno s rN c C s� d|v sJ �|� d�}| j}t|�dkr/|\}}}|||�}d||f }|||�}|||�}nt|�dkrC|\}}t}|||� }}ntd| ��|||�|||fS )N� � z%s:%s� z4Unsupported syntax: spaces in URIs not supported: %r)�splitrK �lenr � ValueError)rL �name�parts�intern�uri� localname�prefix�qnamer& r& r' �_parse_ns_namer s r\ 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 urt| jj�| _nd | _t| _d | _| � � d S r# ) r �Options�_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) rd rh rW � setdefaultrK � buffer_text�ordered_attributes�specified_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)�theDOMImplementation�createDocumentr �document�curNode� _elem_info�_cdatar) r& r& r' re � s � zExpatBuilder.resetc C s� | j |_| j|_| j|_| j|_| jj r| j |_ | 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� pi_handler� ProcessingInstructionHandlerr_ r �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$ �parserr& r& r' rm � s$ zExpatBuilder.installc C s� | � � }d}z% |�d�}|sn|�|d� |r!| jjr!| �|� d}q|�dd� W n ty4 Y nw | j}| �� d| _|S )zIParse a document from a file object, returning the document node.Tr. i @ F� N) rn �read�Parserq �documentElement� _setup_subset� ParseEscapere rd )r$ �filer� � first_buffer�buffer�docr& r& r' � parseFile� s( � �zExpatBuilder.parseFilec C sN | � � }z |�|d� | �|� W n ty Y nw | j}| �� d| _|S )z<Parse a document from a string, returning the document node.TN)rn r� r� r� rq re rd )r$ �stringr� r� r& r& r' � parseString� s �zExpatBuilder.parseStringc C s2 | j jrt� }|�|� |�� }|| j j_dS dS )z/Load the internal subset if there might be one.N)rq �doctype�InternalSubsetExtractorr� � getSubset�internalSubset)r$ r� � extractor�subsetr& r& r' r� � s �zExpatBuilder._setup_subsetc C s� | j j�|||�}| j |_t| j |� || j _| jr5| j�|�tkr5d | j _| j j d= d }d | j _ d | j _ |rR|d urCg |j _g |j_d | j _d | j _| j| j _d S d S �N���)rq �implementation�createDocumentType� ownerDocumentr r� rb � acceptNode� FILTER_REJECT� childNodesrd r~ r� r �_seq� notationsr� r| �end_doctype_decl_handler�EndDoctypeDeclHandler)r$ � doctypeName�systemId�publicId�has_internal_subsetr� r& r& r' ru � s( � �z'ExpatBuilder.start_doctype_decl_handlerc C s: | j jr | j| j_| j| j_| js| jst | _ d S d S d S r# ) r_ r� r� rd r� r{ r| rs rb r �_finish_end_elementr) r& r& r' r� s �z%ExpatBuilder.end_doctype_decl_handlerc C sH | j �||�}t| j|� | jr | j�|�tkr"| j�|� d S d S d S r# )rq �createProcessingInstructionr rr rb r� r� � removeChild)r$ �target�data�noder& r& r' r{ s �zExpatBuilder.pi_handlerc C s� | j j}| jr$| jr|d jtkr|d �|� d S | j�|�}d| _n"|r;|d jt kr;|d }|j | }||_ d S t � � }||_ | j|_ t| j |� d S )Nr� T)rr r� rt �_cdata_continue�nodeType�CDATA_SECTION_NODE� appendDatarq �createCDATASection� TEXT_NODEr� r �Textr� r )r$ r� r� r� �valuer& r& r' r� s" z)ExpatBuilder.character_data_handler_cdatac C s^ | j j}|r|d jtkr|d }|j| |_d S t�� }|j| |_| j|_t | j |� d S r� ) rr r� r� r� r� r r� rq r� r )r$ r� r� r� r& r& r' r� & s z#ExpatBuilder.character_data_handlerc C s� |rd S | j js d S | j�||||�}|d ur#| j�|�} |j�| � | jjjj�|� | j r@| j � |�t krB| jjjjd= d S d S d S r� ) r_ r rq �_create_entity�createTextNoder� �appendr� r� rb r� r� ) r$ � entityName�is_parameter_entityr� �baser� r� � notationNamer� �childr& r& r' r} 1 s � �z ExpatBuilder.entity_decl_handlerc C sR | j �|||�}| j jjj�|� | jr%| j�|�tkr'| j jjjd= d S d S d S r� ) rq �_create_notationr� r� r� r� rb r� � FILTER_ACCEPT)r$ r� r� r� r� r� r& r& r' r C s �z"ExpatBuilder.notation_decl_handlerc C sF | j �|�}t| j|� | jr | j�|�tkr!| j�|� d S d S d S r# )rq � createCommentr rr rb r� r� r� )r$ r� r� r& r& r' r� I s �z ExpatBuilder.comment_handlerc C s d| _ d| _d S )NTF�rt r� r) r& r& r' r� O � z(ExpatBuilder.start_cdata_section_handlerc C s d| _ d| _d S )NFr� r) r& r& r' r� S r� z&ExpatBuilder.end_cdata_section_handlerc C � dS �Nr. r& )r$ �contextr� r� r� r& r& r' r� W � z(ExpatBuilder.external_entity_ref_handlerc C s2 | j d u r | js t| _| j| �� _| �||� d S r# )rb rs r r� �start_element_handlerrn rx )r$ rU � attributesr& r& r' rw Z s z"ExpatBuilder.first_element_handlerc C s� | j �|�}t| j|� || _|r8tdt|�d�D ] }t�|| td t �}||d }||_ | j |_ t ||� q|| j j urE| �|� d S d S )Nr rQ r. )rq � createElementr rr �rangerS r �Attrr r r� r� r r� rc )r$ rU r� r� �i�ar� r& r& r' r� ` s � �z"ExpatBuilder.start_element_handlerc C sn | j r5|| jju r d S | j �|�}|tkrt| � n |tkr#t| � nd S |j| _ |j� |� |� � d S d S r# ) rb rq r� �startContainerr� �Rejecter� FILTER_SKIP�Skipper� parentNoderr r� �unlink)r$ r� �filtr& r& r' rc q s �z"ExpatBuilder._finish_start_elementc C s | j }|j| _ | �|� d S r# )rr r� r� )r$ rU rr r& r& r' ry � s z ExpatBuilder.end_element_handlerc C sd | j �|j�}|r| �||� | jr.|| jju rd S | j�|�tkr0| j � |� |� � d S d S d S r# ) rs �getr" �_handle_white_text_nodesrb rq r� r� r� rr r� r� )r$ rr r4 r& r& r' r� � s �z ExpatBuilder._finish_end_elementc C sZ | j js|�� s d S g }|jD ]}|jtkr |j�� s |�|� q|D ]}|� |� q#d S r# ) r_ � whitespace_in_element_contentr? r� r� r� r� �stripr� r� )r$ r� r4 �Lr� r& r& r' r� � s � � �z%ExpatBuilder._handle_white_text_nodesc C s@ | j �|�}|d u rt||�| j |< d S |jd u sJ �||_d S r# )rs r� r r! )r$ rU r% r4 r& r& r' r� � s z!ExpatBuilder.element_decl_handlerc C sF | j �|�}|d u rt|�}|| j |< |j�d |d d |d||g� d S �Nr )rs r� r r r� )r$ �elemrU r> �default�requiredr4 r& r& r' r� � s �z!ExpatBuilder.attlist_decl_handlerc C s8 || j _|| j _|dkr|rd| j _d S d| j _d S d S )Nr TF)rq �version�encoding� standalone)r$ r� r� r� r& r& r' r� � s �z ExpatBuilder.xml_decl_handlerr# ) rG rH rI �__doc__r( rh rn re rm r� r� r� ru r� r{ r� r� r} r r� r� r� r� rw r� rc ry r� r� r� r� r� r& r& r& r' r] � s< r] 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 ) ra zoWrapper around a DOMBuilderFilter which implements the checks to make the whatToShow filter attribute work.�r` c C s || _ d S r# r� )r$ r` r& r& r' r( � s z#FilterVisibilityController.__init__c C sP | j |j }| jj|@ r&| j�|�}|tkrt�|tvr$tdt |� ��|S t S )Nz)startContainer() returned illegal value: ) �_nodetype_maskr� r` � whatToShowr� �FILTER_INTERRUPTr� �_ALLOWED_FILTER_RETURNSrT �reprr� )r$ r� �mask�valr& r& r' r� � s �z)FilterVisibilityController.startContainerc C s� | j |j }| jj|@ r>| j�|�}|tkrt�|tkr0|j}|j d d � D ]}|� |� q&t S |t vr<t dt|� ��|S tS )Nz%acceptNode() returned illegal value: )r� r� r` r� r� r� r� r� r� r� � appendChildr� r� rT r� r� )r$ r� r� r� �parentr� r& r& r' r� � s �z%FilterVisibilityController.acceptNodeN)#rG rH rI r� rJ r( r� 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� r& r& r& r' ra � s& �ra c @ � e Zd ZdZdd� ZdS )� FilterCrutch)�_builder�_level� _old_start�_old_endc C s6 d| _ || _|j}|j| _|j| _| j|_| j|_d S r� ) r r rd rx r rz r r� ry )r$ rL r� r& r& r' r( s zFilterCrutch.__init__N)rG rH rI rJ r( r& r& r& r' r � r c @ s( e Zd ZdZdd� Zdd� Zdd� ZdS ) r� r& c C s, t �| |� |j}dD ]}t||d � q d S )N)r| r� r� r� r� r� )r r( rd �setattr)r$ rL r� rU r& r& r' r( s �zRejecter.__init__c G s | j d | _ d S r� )r �r$ �argsr& r& r' r� r+ z Rejecter.start_element_handlerc G sB | j dkr| jj}| j�|� | j|_| j|_d S | j d | _ d S �Nr r. )r r rd rm r rx r rz )r$ r r� r& r& r' ry s z Rejecter.end_element_handlerN)rG rH rI rJ r( r� ry r& r& r& r' r� s r� c @ � e Zd ZdZdd� Zdd� ZdS )r� r& c G s2 | j j}| j|� | j j|ur| jd | _d S d S r� )r rr r r )r$ r r� r& r& r' r� - s �z Skipper.start_element_handlerc G sF | j dkr| j| jj_| j| jj_d | _d S | j d | _ | j|� d S r )r r r rd rx r rz r r& r& r' ry 3 s zSkipper.end_element_handlerN)rG rH rI rJ r� ry r& r& r& r' r� * s r� z8http://xml.python.org/entities/fragment-builder/internalz�<!DOCTYPE wrapper %%s [ <!ENTITY fragment-builder-internal SYSTEM "%s"> %%s ]> <wrapper %%s >&fragment-builder-internal;</wrapper>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� r] r( )r$ r� rf r& r& r' r( [ s zFragmentBuilder.__init__c C s t �| � d | _d S r# )r] re �fragmentr) r& r& r' re d s zFragmentBuilder.resetc C s | � |�� �S )zRParse a document fragment from a file object, returning the fragment node.)r� r� �r$ r� r& r& r' r� h s zFragmentBuilder.parseFilec C s� || _ | �� }| jj}d}|r+|jp| �� }|jr"d|j|jf }n |jr*d|j }nd}| �� }t |||f }z|� |d� W n | � � � | j }| � � |S )zMParse a document fragment from a string, returning the fragment node.� zPUBLIC "%s" "%s"z SYSTEM "%s"T) �_sourcern r r� r� �_getDeclarationsr� r� � _getNSattrs�_FRAGMENT_BUILDER_TEMPLATEr� re r! ) r$ r� r� r� �identr� �nsattrsrq r! r& r& r' r� m s0 � �zFragmentBuilder.parseStringc C s | j jj}d}|r�t|jj�D ])}|j�|�}|r |d }d||jf }|jr1d||j|j f }qd||j f }qt|j j�D ]C}|j �|�}|rM|d }d||jf }|jrad||j|j f }n|j rld||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%s<!NOTATION %sz!%s PUBLIC "%s" "%s">z%s SYSTEM "%s">z %s<!ENTITY %sz %s PUBLIC "%s" "%s"z%s SYSTEM "%s"z%s "%s"z%s NOTATION %s�>)r� r� r� r� r� �length�item�nodeNamer� r� r � firstChildr� r� )r$ r� rM r� �notationr r& r& r' r% � s: � � z FragmentBuilder._getDeclarationsc C r� )Nr# r& r) r& r& r' r& � r� zFragmentBuilder._getNSattrsc C s� |t kr<| j}| j}| j�|�}| j| _| j�� | _| j| _z|�| j d� W || _|| _d | _ dS || _|| _d | _ w t � | ||||�S )NTr� ) �$_FRAGMENT_BUILDER_INTERNAL_SYSTEM_IDrq rr rd �ExternalEntityParserCreater �createDocumentFragmentr! r� r$ r] r� )r$ r� r� r� r� � old_document� old_cur_noder� r& r& r' r� � s& � �z+FragmentBuilder.external_entity_ref_handlerr# ) rG rH rI r� r( re r� r� r% r& r� r& r& r& r' r R s $ r c @ sB e Zd ZdZdd� Zdd� Zdd� Zdd � Zd d � Z d 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.rO )�namespace_separatorT)r rg �namespace_prefixesr� r& r& r' rh � s zNamespaces.createParserc C s$ t �| |� | jjr| j|_dS dS )z.Insert the namespace-handlers onto the parser.N)r] rm r_ �namespace_declarations� start_namespace_decl_handler�StartNamespaceDeclHandlerr� r& r& r' rm � s ��zNamespaces.installc C s | j �||f� dS )z/Push this namespace declaration on our storage.N)r6 r� )r$ rZ rX r& r& r' r; � s z'Namespaces.start_namespace_decl_handlerc C s� d|v rt | |�\}}}}nt}|}d }t}t�||||�}| j|_t| j|� || _| j r`| j D ](\}}|rEt� t | d| �t |d�}nt� dt dt�}||_ | j|_t||� q1| j d d �= |r�|�� |j} |j} tdt|�d�D ]J} || } || d } d| v r�t | | �\}}}}t� ||||�}|| |< || ||f< nt� | t| t�}|| | < || t| f< | j|_| |_ ||_qtd S d S )NrO �xmlns:�xmlnsr rQ r. )r\ r r r �Elementrq r� r rr r6 r� rN r r� r �_ensure_attributes�_attrs�_attrsNSr� rS � ownerElement)r$ rU r� rX rY rZ r[ r� r� rA rB r� r3 r� r& r& r' r� � sZ �� � �z Namespaces.start_element_handlerTc C s� | j }d|v r$t| |�\}}}}|j|kr |j|kr |j|ks#J d��n|j|ks-J d��|jtks6J d��|j| _ | �|� d S )NrO z$element stack messed up! (namespace)z&element stack messed up - bad nodeNamez*element stack messed up - bad namespaceURI) rr r\ r7 r8 rZ r- r r� r� )r$ rU rr rX rY rZ r[ r& r& r' ry s � � �z Namespaces.end_element_handlerN) rG rH rI r� r7 rh rm r; r� ry r& r& r& r' r5 � s / r5 c @ r )�ExpatBuilderNSz*Document builder that supports namespaces.c C � t �| � | �� d S r# )r] re r7 r) r& r& r' re ) � zExpatBuilderNS.resetN)rG rH rI r� re r& r& r& r' rD & r rD c @ r )�FragmentBuilderNSz*Fragment builder that supports namespaces.c C rE r# )r re r7 r) r& r& r' re 1 rF zFragmentBuilderNS.resetc C s� d}| j }g }|r@t|d�r;|j�� D ]'\}}||v r q|�|� |r(d| }nd}|r4d|||f }qd||f }q|j}|s |S )zNReturn string of namespace attributes from this element and ancestors.r# �_ns_prefix_urir= r> z%s %s='%s'z %s='%s')r� �hasattrrH �itemsr� r� )r$ �attrsr� r� rZ rX �declnamer& r& r' r& 5 s$ �z FragmentBuilderNS._getNSattrsN)rG rH rI r� re r& r& r& r& r' rG . s rG c @ s e Zd ZdZdS )r� zEException raised to short-circuit parsing in InternalSubsetExtractor.N)rG rH rI 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 �( z t �| |� W d S ty Y d S w r# )r] r� r� r" r& r& r' r� ` � �z!InternalSubsetExtractor.parseFilec C rM r# )r] r� r� )r$ r� r& r& r' r� f rN z#InternalSubsetExtractor.parseStringc C s | j |_| j|_d S r# )ru rv r� rx r� r& r& r' rm l s z InternalSubsetExtractor.installc C s. |r| � � }g | _| jj|_| j|_d S t� �r# )rn r� r� �DefaultHandlerr� r� r� )r$ rU r� r� r� r� r& r& r' ru p s z2InternalSubsetExtractor.start_doctype_decl_handlerc C s( d� | j��dd��dd�}|| _t� �)Nr# z � � )�joinr� �replacer� )r$ rM r& r& r' r� z s z0InternalSubsetExtractor.end_doctype_decl_handlerc C s t � �r# )r� )r$ rU rK r& r& r' r� r: z-InternalSubsetExtractor.start_element_handler) rG rH rI r� r� r� r� r� rm ru r� r� r& r& r& r' r� W s r� Tc C sd |rt � }nt� }t| t�r+t| d��}|�|�}W d � |S 1 s$w Y |S |�| �}|S )z{Parse a document, returning the resulting Document node. 'file' may be either a file name or an open file object. �rbN)rD r] � isinstance�str�openr� )r� � namespacesrL �fp�resultr& r& r' �parse� s �� �r[ c C s |rt � }nt� }|�| �S )zOParse a document from a string, returning the resulting Document node. )rD r] r� )r� rX rL r& r& r' r� � s r� c C sh |rt |�}nt|�}t| t�r-t| d��}|�|�}W d � |S 1 s&w Y |S |�| �}|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. rT N)rG r rU rV rW r� )r� r� rX rL rY rZ 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. )rG r r� )r� r� rX rL r& r& r' �parseFragmentString� s r] c C s | j rt| �S t| �S )z,Create a builder based on an Options object.)rX rD r] )rf r& r& r' � makeBuilder� s r^ )T)3r� �xml.domr r r r r r � xml.parsersr �xml.dom.minidomr r �xml.dom.NodeFilterr r� r� r �DOMBuilderFilterr� r� r� r� �getDOMImplementationro �TypeInfor1 �objectr rN r\ r] r� ra r r� r� r0 r' r r5 rD rG � Exceptionr� r� r[ r� r\ r] r^ r& r& r& r' �<module> sh � 3 C: � �� u_% , dom/__pycache__/__init__.cpython-310.pyc 0000644 00000012235 15027446000 0013774 0 ustar 00 o }�5h� � @ s� d Z G dd� d�ZdZdZdZdZdZdZd Zd Z d Z d Z d Z dZ dZdZdZdZG dd� de�ZG dd� de�ZG dd� de�ZG dd� de�ZG dd � d e�ZG d d � d e�ZG d d � d e�ZG d!d"� d"e�ZG d#d$� d$e�ZG d%d&� d&e�Z G d'd(� d(e�Z G d)d*� d*e�Z G d+d,� d,e�Z G d-d.� d.e�Z G d/d0� d0e�Z!G d1d2� d2e�Z"G d3d4� d4e�Z#G d5d6� d6�Z$d7Z%d8Z&d9Z'd:Z(d:Z)dd;l*m+Z+m,Z, d:S )<a W3C Document Object Model implementation for Python. The Python mapping of the Document Object Model is documented in the Python Library Reference in the section on the xml.dom package. This package contains the following modules: minidom -- A simple implementation of the Level 1 DOM with namespace support added (based on the Level 2 specification) and other minor Level 2 functionality. pulldom -- DOM builder supporting on-demand tree-building for selected subtrees of the document. c @ sD e Zd ZdZdZdZdZdZdZdZ dZ d Z d Z d Z d Zd ZdZdS )�Nodez$Class giving the NodeType constants.� � � � � � � � � � � � � N)�__name__� __module__� __qualname__�__doc__� __slots__� ELEMENT_NODE�ATTRIBUTE_NODE� TEXT_NODE�CDATA_SECTION_NODE�ENTITY_REFERENCE_NODE� ENTITY_NODE�PROCESSING_INSTRUCTION_NODE� COMMENT_NODE� DOCUMENT_NODE�DOCUMENT_TYPE_NODE�DOCUMENT_FRAGMENT_NODE� NOTATION_NODEr r r �'/usr/lib/python3.10/xml/dom/__init__.pyr s r r r r r r r r r r r r r � � � � c @ s e Zd ZdZdd� Zdd� ZdS )� DOMExceptionzmAbstract base class for DOM exceptions. Exceptions with specific codes are specializations of this class.c O s. | j tu r td��tj| g|�R i |�� d S )Nz0DOMException should not be instantiated directly)� __class__r% � RuntimeError� Exception�__init__)�self�args�kwr r r r) B s � zDOMException.__init__c C s | j S )N)�code)r* r r r � _get_codeH s zDOMException._get_codeN)r r r r r) r. r r r r r% > s r% c @ � e Zd ZeZdS )� IndexSizeErrN)r r r �INDEX_SIZE_ERRr- r r r r r0 L � r0 c @ r/ )�DomstringSizeErrN)r r r �DOMSTRING_SIZE_ERRr- r r r r r3 O r2 r3 c @ r/ )�HierarchyRequestErrN)r r r �HIERARCHY_REQUEST_ERRr- r r r r r5 R r2 r5 c @ r/ )�WrongDocumentErrN)r r r �WRONG_DOCUMENT_ERRr- r r r r r7 U r2 r7 c @ r/ )�InvalidCharacterErrN)r r r �INVALID_CHARACTER_ERRr- r r r r r9 X r2 r9 c @ r/ )�NoDataAllowedErrN)r r r �NO_DATA_ALLOWED_ERRr- r r r r r; [ r2 r; c @ r/ )�NoModificationAllowedErrN)r r r �NO_MODIFICATION_ALLOWED_ERRr- r r r r r= ^ r2 r= c @ r/ )� NotFoundErrN)r r r � NOT_FOUND_ERRr- r r r r r? a r2 r? c @ r/ )�NotSupportedErrN)r r r �NOT_SUPPORTED_ERRr- r r r r rA d r2 rA c @ r/ )�InuseAttributeErrN)r r r �INUSE_ATTRIBUTE_ERRr- r r r r rC g r2 rC c @ r/ )�InvalidStateErrN)r r r �INVALID_STATE_ERRr- r r r r rE j r2 rE c @ r/ )� SyntaxErrN)r r r � SYNTAX_ERRr- r r r r rG m r2 rG c @ r/ )�InvalidModificationErrN)r r r �INVALID_MODIFICATION_ERRr- r r r r rI p r2 rI c @ r/ )� NamespaceErrN)r r r � NAMESPACE_ERRr- r r r r rK s r2 rK c @ r/ )�InvalidAccessErrN)r r r �INVALID_ACCESS_ERRr- r r r r rM v r2 rM c @ r/ )� ValidationErrN)r r r �VALIDATION_ERRr- r r r r rO y r2 rO c @ s e Zd ZdZdZdZdZdZdS )�UserDataHandlerzBClass giving the operation constants for UserDataHandler.handle().r r r r N)r r r r � NODE_CLONED� NODE_IMPORTED� NODE_DELETED� NODE_RENAMEDr r r r rQ | s rQ z$http://www.w3.org/XML/1998/namespacez http://www.w3.org/2000/xmlns/z http://www.w3.org/1999/xhtmlN)�getDOMImplementation�registerDOMImplementation)-r r r1 r4 r6 r8 r: r< r> r@ rB rD rF rH rJ rL rN rP r( r% r0 r3 r5 r7 r9 r; r= r? rA rC rE rG rI rK rM rO rQ � XML_NAMESPACE�XMLNS_NAMESPACE�XHTML_NAMESPACE�EMPTY_NAMESPACE� EMPTY_PREFIX�domregrV rW r r r r �<module> sT dom/__pycache__/minidom.cpython-310.pyc 0000644 00000154041 15027446000 0013673 0 ustar 00 o }�5h, � @ s� d Z ddlZddlZddlmZmZmZmZ ddlT ddl m Z m Z ej j jej j jfZG dd� dej j �Z ee dd d � ee d d d � ee d dd � dd� Zdd� Zdd� Zdd� Zdd� ZG dd� de �ZG dd � d e �Zeed d d � eed d d � eed d!d � G d"d#� d#e�Zeed$d%d � eZG d&d'� d'e�Z e dd�Z G d(d)� d)e �Z ee d*d+d � ee d d,d � d-d.� Z G d/d0� d0�Z G d1d2� d2e e �Z!G d3d4� d4e e �Z"ee"d$d5d � G d6d7� d7e"�Z#ee#d8d9d � ee#d:d;d � d<d=� Z$d>d?� Z%G d@dA� dAe"�Z&G dBdC� dCe#�Z'G dDdE� dEe�Z(ee(d$dFd � G dGdH� dH�Z)G dIdJ� dJe)e e �Z*G dKdL� dLe)e �Z+G dMdN� dNe)e e �Z,G dOdP� dPe �Z-G dQdR� dRe�Z.dSdT� Z/G dUdV� dVe e �Z0ee0dWdXd � dYdZ� Z1d[d\� Z2d]d^� Z3ded_d`�Z4dfdadb�Z5dfdcdd�Z6dS )gac Simple implementation of the Level 1 DOM. Namespaces and other minor Level 2 features are also supported. parse("foo.xml") parseString("<foo><bar/></foo>") Todo: ===== * convenience methods for getting elements and text. * more testing * bring some of the writer and linearizer code into conformance with this interface * SAX 2 namespaces � N)�EMPTY_NAMESPACE� EMPTY_PREFIX�XMLNS_NAMESPACE�domreg)�*)�DOMImplementationLS� DocumentLSc @ s� e Zd ZdZdZdZdZdZeZ dd� Z d2dd�Z d3dd �Z d d � Z d d � Zdd� Zdd� Zdd� Zdd� Zdd� Zdd� Zdd� Zd d � Zd d � Zd d!� Zd"d#� Zd$d%� Zd&d'� Zd(d)� Z d*d+� Z d,d-� Z d.d/� Z d0d1� Z dS )4�NodeNc C � dS )NT� ��selfr r �&/usr/lib/python3.10/xml/dom/minidom.py�__bool__+ � z Node.__bool__c C s | � dd||�S �N� )� toprettyxml)r �encoding� standaloner r r �toxml. � z Node.toxml� � c C sv |d u r t �� }n t jt �� |ddd�}| jtjkr%| �|d||||� n| �|d||� |d u r5|�� S |� � �� S )N�xmlcharrefreplacer )r �errors�newliner ) �io�StringIO� TextIOWrapper�BytesIO�nodeTyper � DOCUMENT_NODE�writexml�getvalue�detach)r �indent�newlr r �writerr r r r 1 s � zNode.toprettyxmlc C � t | j�S �N)�bool� childNodesr r r r � hasChildNodesD � zNode.hasChildNodesc C � | j S r* �r, r r r r �_get_childNodesG � zNode._get_childNodesc C � | j r| j d S d S �Nr r0 r r r r �_get_firstChildJ � �zNode._get_firstChildc C r3 �N���r0 r r r r �_get_lastChildN r6 zNode._get_lastChildc C s |j | jkrt|j�D ]}| �||� q |S |j | jvr*tj�dt |�t | �f ��|j d ur5|j � |� |d u r@| � |� |S z| j� |�}W n tyT tj�� �w |j tv r^t| � | j�||� ||_||_|r{| j|d }||_||_nd |_| |_ |S )N�%s cannot be child of %s� )r! �DOCUMENT_FRAGMENT_NODE�tupler, � insertBefore�_child_node_types�xml�dom�HierarchyRequestErr�repr� parentNode� removeChild� appendChild�index� ValueError� NotFoundErr�_nodeTypes_with_children�_clear_id_cache�insert� nextSibling�previousSibling)r �newChild�refChild�crG �noder r r r> R s< � � � zNode.insertBeforec C s� |j | jkrt|j�D ]}| �|� q |S |j | jvr)tj�dt |�t | �f ��|j t v r2t | � |j d ur=|j � |� t| |� d |_|S �Nr: )r! r< r= r, rF r? r@ rA rB rC rJ rK rD rE � _append_childrM )r rR rQ r r r rF r s � zNode.appendChildc C s |j | jkr|j}| �|� | �||�S |j | jvr(tj�dt |�t | �f ��||u r.d S |j d ur9|j �|� z| j � |�}W n t yM tj�� �w || j |< | |_ d |_ |j tv sc|j tv rgt| � |j|_|j|_d |_d |_|jr|||j_|jr�||j_|S rS )r! r< rM rE r> r? r@ rA rB rC rD r, rG rH rI rJ rK rN )r rO �oldChildrP rG r r r � replaceChild� s@ � � zNode.replaceChildc C sz z| j �|� W n ty tj�� �w |jd ur |j|j_|jd ur)|j|j_d |_|_|jt v r8t | � d |_ |S r* ) r, �removerH r@ rA rI rM rN r! rJ rK rD �r rU r r r rE � s � zNode.removeChildc C s� g }| j D ]Z}|jtjkrP|js%|r|j|d _|jr |j|j_|�� q|rJ|d j|jkrJ|d }|j|j |_|j|_|jrE||j_|�� q|�|� q|�|� |jtj kr_|� � q|| j d d �< d S r7 ) r, r! r � TEXT_NODE�datarM rN �unlink�append� ELEMENT_NODE� normalize)r �L�childrR r r r r^ � s, �zNode.normalizec C s t | || jp| �S r* )� _clone_node� ownerDocument)r �deepr r r � cloneNode� � zNode.cloneNodec C s | j j�||�S r* )rb �implementation� hasFeature�r �feature�versionr r r � isSupported� r zNode.isSupportedc C � d S r* r r r r r �_get_localName� � zNode._get_localNamec C s | |u S r* r �r �otherr r r � isSameNode� � zNode.isSameNodec C � | � |d �r| S d S r* )rk �r ri r r r � getInterface� � zNode.getInterfacec C s* z| j | d W S ttfy Y d S w r4 )� _user_data�AttributeError�KeyError�r �keyr r r � getUserData� s �zNode.getUserDatac C sn d }z| j }W n ty i }|| _ Y nw ||v r || d }|d u r/d }|d ur-||= |S ||f||< |S r4 )rw rx )r r{ rZ �handler�old�dr r r � setUserData� s � �zNode.setUserDatac C sH t | d�r t| j�� �D ]\}\}}|d ur |�|||||� q d S d S )Nrw )�hasattr�listrw �items�handle)r � operation�src�dstr{ rZ r} r r r �_call_user_data_handler� s ��z Node._call_user_data_handlerc C s> d | _ | _| jr| jD ]}|�� q t� | _d | _d | _d S r* )rD rb r, r[ �NodeListrN rM )r r` r r r r[ s z Node.unlinkc C s | S r* r r r r r � __enter__ r zNode.__enter__c C s | � � d S r* )r[ )r �et�ev�tbr r r �__exit__ � z Node.__exit__�NN)r r NN)!�__name__� __module__� __qualname__� namespaceURIrD rb rM rN r �prefixr r r r- r1 r5 r9 r> rF rV rE r^ rd rk rm rq ru r| r� r� r[ r� r� r r r r r " s@ � r � firstChildzFirst child node, or None.)�doc� lastChildzLast child node, or None.� localNamez"Namespace-local name of this node.c C s2 | j }|r|d }||_||_|�|� | |_d S r7 )r, rN rM r\ rD )r rR r, �lastr r r rT s rT c C s* | d ur| j tjkr dS | j} | d usdS �NTF)r! r r" rD �rR r r r � _in_document' s �r� c C s: |r|� dd�� dd�� dd�� dd�}| �|� d S d S ) zWrites datachars to writer.�&z&�<z<�"z"�>z>N)�replace�write)r( rZ r r r � _write_data/ s ��r� c C sD | j D ] }|jtjkr|dks|j|kr|�|� t|||� q|S �Nr )r, r! r r] �tagNamer\ � _get_elements_by_tagName_helper)�parent�name�rcrR r r r r� 6 s r� c C sX | j D ]&}|jtjkr)|dks|j|kr"|dks |j|kr"|�|� t||||� q|S r� )r, r! r r] r� r� r\ �"_get_elements_by_tagName_ns_helper)r� �nsURIr� r� rR r r r r� > s �r� c @ sJ e Zd ZejZdZdZdZdZ ej ej ej ej ejejejfZdd� ZdS )�DocumentFragmentz#document-fragmentNc C s t � | _d S r* )r� r, r r r r �__init__U r� zDocumentFragment.__init__)r� r� r� r r< r! �nodeName� nodeValue� attributesrD r] rY �CDATA_SECTION_NODE�ENTITY_REFERENCE_NODE�PROCESSING_INSTRUCTION_NODE� COMMENT_NODE� NOTATION_NODEr? r� r r r r r� G s � r� c @ s� e Zd ZdZejZdZdZdZ ej ej fZ e ddfdd�Zdd� Zdd � Zd d � Zd d � Zeee� ZZdd� Zdd� Zeee� ZZdd� Zdd� Zeee�Z dd� Z dd� Z dd� Z dS ) �Attr)�_name�_valuer� �_prefixr, � _localNamerb � ownerElementNFc C s@ d | _ || _|| _|| _|d ur|| _t� | _| j�t� � d S r* ) r� r� r� r� r� r� r, r\ �Text)r �qNamer� r� r� r r r r� c s z Attr.__init__c C �. z| j W S ty | j�dd�d Y S w �N�:r; r8 )r� rx r� �splitr r r r rm r � �zAttr._get_localNamec C r/ r* )� specifiedr r r r �_get_specifiedx r2 zAttr._get_specifiedc C r/ r* )r� r r r r � _get_name{ r2 zAttr._get_namec C s" || _ | jd urt| j� d S d S r* )r� r� rK �r �valuer r r � _set_name~ s �zAttr._set_namec C r/ r* )r� r r r r � _get_value� r2 zAttr._get_valuec C s6 || _ || jd _| jd urt| j� || jd _d S r4 )r� r, rZ r� rK r� r r r � _set_value� s zAttr._set_valuec C r/ r* )r� r r r r � _get_prefix� r2 zAttr._get_prefixc C sd | j }|dkr|r|tkrtj�d��|| _|d u r | j}nd|| jf }| jr-t| j� || _ d S )N�xmlnsz5illegal use of 'xmlns' prefix for the wrong namespacez%s:%s) r� r r@ rA � NamespaceErrr� r� r� rK r� )r r� �nsuri�newNamer r r � _set_prefix� s � zAttr._set_prefixc C sv | j }|d ur)|j| j= |j| j| jf= | jr)d| _| jd8 _| j j d8 _ | j D ]}|� � q,| j d d �= d S )NFr; ) r� �_attrsr� �_attrsNSr� r� �_is_id�_magic_id_nodesrb �_magic_id_countr, r[ )r �elemr` r r r r[ � s z Attr.unlinkc C sb | j rdS | j}| j}|d u s|d u rdS |�|�}|d u r dS | jr+|�| j| j�S |�| j�S r� ) r� rb r� �_get_elem_infor� �isIdNSr� �isIdr� �r r� r� �infor r r � _get_isId� s zAttr._get_isIdc C sX | j }| j}|d u s|d u rtS |�|�}|d u rtS | jr&|�| j| j�S |�| j�S r* ) rb r� �_no_typer� r� �getAttributeTypeNSr� �getAttributeTyper� r� r r r �_get_schemaType� s zAttr._get_schemaType) r� r� r� � __slots__r �ATTRIBUTE_NODEr! r� r� r� rY r� r? r r� rm r� r� r� �propertyr� r� r� r� r� r� r� r� r� r[ r� r� r r r r r� Y s0 � r� r� z True if this attribute is an ID.z'Namespace-local name of this attribute.� schemaTypez Schema type for this attribute.c @ s� e Zd ZdZdZdd� Zdd� Zdd� Zd d � Zd d � Z d d� Z dd� Z dd� Z dd� Z d:dd�ZeZdd� Zdd� Zd d � Zd d � Zd d!� Zd"d#� Zd$d%� Zd&d'� Zd(d)� Zd*d+� Zd,d-� Zd.d/� Zd0d1� Z d2d3� Z d4d5� Z d6d7� Z d8d9� Z dS );� NamedNodeMapa The attribute list is a transient interface to the underlying dictionaries. Mutations here will change the underlying element's dictionary. Ordering is imposed artificially and does not reflect the order of attributes as found in an input document. �r� r� � _ownerElementc C s || _ || _|| _d S r* r� )r �attrs�attrsNSr� r r r r� � s zNamedNodeMap.__init__c C r) r* )�lenr� r r r r � _get_length� r. zNamedNodeMap._get_lengthc C s. z | t | j�� �| W S ty Y d S w r* )r� r� �keys� IndexError�r rG r r r �item� s �zNamedNodeMap.itemc C s* g }| j �� D ] }|�|j|jf� q|S r* )r� �valuesr\ r� r� �r r_ rR r r r r� � s zNamedNodeMap.itemsc C s0 g }| j �� D ]}|�|j|jf|jf� q|S r* )r� r� r\ r� r� r� r� r r r �itemsNS� s zNamedNodeMap.itemsNSc C s t |t�r || jv S || jv S r* )� isinstance�strr� r� rz r r r � __contains__� � zNamedNodeMap.__contains__c C � | j �� S r* )r� r� r r r r r� r. zNamedNodeMap.keysc C r� r* )r� r� r r r r �keysNS r. zNamedNodeMap.keysNSc C r� r* )r� r� r r r r r� r. zNamedNodeMap.valuesNc C � | j �||�S r* �r� �get)r r� r� r r r r� � zNamedNodeMap.getc C s6 | j t|dd �u r dS t| �t|�kt| �t|�k S )Nr� r )r� �getattr�idro r r r �_cmp s zNamedNodeMap._cmpc C s | � |�dkS r4 �r ro r r r �__eq__ r� zNamedNodeMap.__eq__c C s | � |�dkS r4 r ro r r r �__ge__ r� zNamedNodeMap.__ge__c C s | � |�dkS r4 r ro r r r �__gt__ r� zNamedNodeMap.__gt__c C s | � |�dkS r4 r ro r r r �__le__! r� zNamedNodeMap.__le__c C s | � |�dk S r4 r ro r r r �__lt__$ r� zNamedNodeMap.__lt__c C s t |t�r | j| S | j| S r* )r� r= r� r� )r �attname_or_tupler r r � __getitem__' r� zNamedNodeMap.__getitem__c C sv t |t�r)z| j| }W n ty# t|�}| jj|_| �|� Y nw ||_d S t |t�s2t d��|}| �|� d S )Nz%value must be a string or Attr object) r� r� r� ry r� r� rb � setNamedItemr� � TypeError)r �attnamer� rR r r r � __setitem__. s � zNamedNodeMap.__setitem__c C s" z| j | W S ty Y d S w r* )r� ry �r r� r r r � getNamedItem= s �zNamedNodeMap.getNamedItemc C s& z| j ||f W S ty Y d S w r* )r� ry �r r� r� r r r �getNamedItemNSC s �zNamedNodeMap.getNamedItemNSc C sT | � |�}|d ur%t| j� | j|j= | j|j|jf= t|d�r#d |_ |S t j � � ��Nr� ) r rK r� r� r� r� r� r� r� r� r@ rA rI �r r� �nr r r �removeNamedItemI s z NamedNodeMap.removeNamedItemc C sV | � ||�}|d ur&t| j� | j|j|jf= | j|j= t|d�r$d |_ |S t j � � �r ) r rK r� r� r� r� r� r� r� r� r@ rA rI �r r� r� r r r r �removeNamedItemNSU s z NamedNodeMap.removeNamedItemNSc C st t |t�stj�dt|�t| �f ��| j�|j�}|r |� � || j|j< || j |j |j f< | j |_t|j� |S rS )r� r� r@ rA rB rC r� r� r� r[ r� r� r� r� r� rK )r rR r~ r r r r a s � zNamedNodeMap.setNamedItemc C s | � |�S r* )r �r rR r r r �setNamedItemNSn r. zNamedNodeMap.setNamedItemNSc C s | | }t |j� |�� d S r* )rK r� r[ )r r rR r r r � __delitem__q s zNamedNodeMap.__delitem__c C s | j | j| jfS r* r� r r r r � __getstate__v r zNamedNodeMap.__getstate__c C s |\| _ | _| _d S r* r� �r �stater r r � __setstate__y s zNamedNodeMap.__setstate__r* )!r� r� r� �__doc__r� r� r� r� r� r� r� r� r� r� r� �__len__r r r r r r r r r r r r r r r r r r r r r r� � s> r� �lengthz$Number of nodes in the NamedNodeMap.c @ s0 e Zd ZdZdd� Zdd� Zdd� Zdd � Zd S ) �TypeInfo�� namespacer� c C � || _ || _d S r* r" )r r# r� r r r r� � � zTypeInfo.__init__c C s. | j rd| jj| j| j f S d| jj| jf S )Nz<%s %r (from %r)>z<%s %r>)r# � __class__r� r� r r r r �__repr__� s �zTypeInfo.__repr__c C r/ r* )r� r r r r r� � r2 zTypeInfo._get_namec C r/ r* )r# r r r r �_get_namespace� r2 zTypeInfo._get_namespaceN)r� r� r� r� r� r' r� r( r r r r r! � s r! c @ s e Zd ZdZejZdZeZ dZ ejej ej ej ejejfZeddfdd�Zdd� Zdd � Zd d � Zd d � Zdd� Zdd� Zdd� Zdd� Zdd� Zdd� Z dd� Z e Z d d � Z d d � Z d d!� Z!e!Z"d"d#� Z#d$d%� Z$d&d'� Z%d(d)� Z&d*d+� Z'd9d-d.�Z(d/d0� Z)d1d2� Z*d3d4� Z+d5d6� Z,d7d8� Z-dS ):�Element) rb rD r� r� r� r� r� r, r� r� rM rN Nr c C sB d | _ | | _| _|| _|| _t� | _d | _| _d | _ d | _ d S r* ) rD r� r� r� r� r� r, rM rN r� r� )r r� r� r� r� r r r r� � s zElement.__init__c C s | j d u r i | _ i | _d S d S r* )r� r� r r r r �_ensure_attributes� s �zElement._ensure_attributesc C r� r� )r� rx r� r� r r r r rm � r� zElement._get_localNamec C r/ r* �r� r r r r � _get_tagName� r2 zElement._get_tagNamec C s@ | j d urt| j �� �D ]}|�� q d | _ d | _t�| � d S r* )r� r� r� r[ r� r )r �attrr r r r[ � s zElement.unlinkc C s2 | j du rdS z| j | jW S ty Y dS w )a� Returns the value of the specified attribute. Returns the value of the element's attribute named attname as a string. An empty string is returned if the element does not have such an attribute. Note that an empty string may also be returned as an explicitly given attribute value, use the hasAttribute method to distinguish these two cases. Nr )r� r� ry )r r r r r � getAttribute� s �zElement.getAttributec C s6 | j d u rdS z | j ||f jW S ty Y dS w r )r� r� ry r r r r �getAttributeNS� s �zElement.getAttributeNSc C s` | � |�}|d u rt|�}||_| j|_| �|� d S ||jkr,||_|jr.t| � d S d S d S r* )�getAttributeNoder� r� rb �setAttributeNoder� rK )r r r� r- r r r � setAttribute� s �zElement.setAttributec C s� t |�\}}| �||�}|d u r%t||||�}||_| j|_| �|� d S ||jkr4||_|jr4t| � |j|krA||_||_ d S d S r* ) �_nssplit�getAttributeNodeNSr� r� rb r1 r� rK r� r� )r r� � qualifiedNamer� r� � localnamer- r r r �setAttributeNS� s �zElement.setAttributeNSc C s | j d u rd S | j �|�S r* r� )r �attrnamer r r r0 s zElement.getAttributeNodec C s | j d u rd S | j �||f�S r* )r� r� r r r r r4 s zElement.getAttributeNodeNSc C s� |j d | fvr tj�d��| �� | j�|jd �}|d ur"| �|� | j �|j |j fd �}|d ur:||ur:| �|� t | |� ||urE|S ||urK|S d S )Nz attribute node already owned) r� r@ rA �InuseAttributeErrr* r� r� r� �removeAttributeNoder� r� r� �_set_attribute_node)r r- �old1�old2r r r r1 s �zElement.setAttributeNodec C sJ | j d u r tj�� �z| j| }W n ty tj�� �w | �|� d S r* )r� r@ rA rI r� ry r: )r r� r- r r r �removeAttribute' s �zElement.removeAttributec C sN | j d u r tj�� �z | j ||f }W n ty tj�� �w | �|� d S r* )r� r@ rA rI ry r: )r r� r� r- r r r �removeAttributeNS0 s �zElement.removeAttributeNSc C sX |d u r t j�� �z| j|j W n ty t j�� �w t| � |�� | j|_|S r* ) r@ rA rI r� r� ry rK r[ rb r r r r r: 9 s �zElement.removeAttributeNodec C s | j du rdS || j v S )z�Checks whether the element has an attribute with the specified name. Returns True if the element has an attribute with the specified name. Otherwise, returns False. NF�r� r r r r � hasAttributeI s zElement.hasAttributec C s | j d u rdS ||f| j v S �NF)r� r r r r �hasAttributeNSS s zElement.hasAttributeNSc C � t | |t� �S )z�Returns all descendant elements with the given tag name. Returns the list of all descendant elements (not direct children only) with the specified tag name. �r� r� r r r r �getElementsByTagNameX s z Element.getElementsByTagNamec C � t | ||t� �S r* �r� r� r r r r �getElementsByTagNameNS` � �z Element.getElementsByTagNameNSc C s d| j t| �f S )Nz<DOM Element: %s at %#x>)r� r� r r r r r' d re zElement.__repr__r c C s� |� |d | j � | �� }|�� D ]}|� d| � t||| j� |� d� q| jrv|� d� t| j�dkrP| jd jt j t j fv rP| jd � |ddd� n|� |� | jD ] }|� ||| ||� qX|� |� |� d| j|f � d S |� d | � d S ) z�Write an XML element to a file-like object Write the element to the writer object that must provide a write method (e.g. a file or StringIO object). r� z %s="r� r� r; r r z</%s>%sz/>%sN) r� r� �_get_attributesr� r� r� r, r� r! r rY r� r# )r r( r& � addindentr' r� �a_namerR r r r r# g s& � zElement.writexmlc C s | � � t| j| j| �S r* )r* r� r� r� r r r r rK � s zElement._get_attributesc C s | j rdS dS r� r@ r r r r � hasAttributes� s zElement.hasAttributesc C s | � |�}| �|� d S r* )r0 �setIdAttributeNode)r r� �idAttrr r r �setIdAttribute� s zElement.setIdAttributec C s | � ||�}| �|� d S r* )r4 rO )r r� r� rP r r r �setIdAttributeNS� s zElement.setIdAttributeNSc C sn |d u s | � |j�stj�� �t| �d urtj�� �|js5d|_| jd7 _| j j d7 _ t | � d S d S )NTr; ) rq r� r@ rA rI �_get_containing_entref�NoModificationAllowedErrr� r� rb r� rK )r rP r r r rO � s �zElement.setIdAttributeNode�r r r ).r� r� r� r� r r] r! r� r� r� r� r� r� rY r� r� r? r r� r* rm r, r[ r. r/ r2 r7 r0 r4 r1 �setAttributeNodeNSr> r? r: �removeAttributeNodeNSrA rC rF rI r' r# rK rN rQ rR rO r r r r r) � sV � � r) r� z*NamedNodeMap of attributes on the element.z%Namespace-local name of this element.c C s8 t | � | �� || j|j< || j|j|jf< | |_d S r* )rK r* r� r� r� r� r� r� )�elementr- r r r r; � s r; c @ sf e Zd ZdZdZdZe� ZdZdZ dd� Z dd� Z dd � Z d d � Z d d � Zdd� Zdd� Zdd� ZdS )� Childlessz�Mixin that makes childless-ness easy to implement and avoids the complexity of the Node methods that deal with children. r Nc C rl r* r r r r r r5 � r zChildless._get_firstChildc C rl r* r r r r r r9 � r zChildless._get_lastChildc C � t j�| jd ��)Nz nodes cannot have children�r@ rA rB r� r r r r rF � � �zChildless.appendChildc C r rB r r r r r r- � r zChildless.hasChildNodesc C rZ �Nz nodes do not have childrenr[ �r rO rP r r r r> � r\ zChildless.insertBeforec C rZ r] )r@ rA rI r� rX r r r rE � r\ zChildless.removeChildc C rl r* r r r r r r^ � rn zChildless.normalizec C rZ r] r[ �r rO rU r r r rV � r\ zChildless.replaceChild)r� r� r� r r� r� � EmptyNodeListr, r� r� r5 r9 rF r- r> rE r^ rV r r r r rY � s rY c @ s\ e Zd ZejZdZdd� Zdd� Zdd� Z e ee �Z dd � Z d d � Z e e e �Zdd d�ZdS )�ProcessingInstruction��targetrZ c C r$ r* rb )r rc rZ r r r r� � r% z ProcessingInstruction.__init__c C r/ r* �rZ r r r r �_get_nodeValue� r2 z$ProcessingInstruction._get_nodeValuec C � || _ d S r* rd r� r r r �_set_nodeValue� r. z$ProcessingInstruction._set_nodeValuec C r/ r* �rc r r r r � _get_nodeName� r2 z#ProcessingInstruction._get_nodeNamec C rf r* rh r� r r r � _set_nodeName� r. z#ProcessingInstruction._set_nodeNamer c C s |� d|| j| j|f � d S )Nz %s<?%s %s?>%s)r� rc rZ �r r( r& rL r' r r r r# � s z ProcessingInstruction.writexmlNrU )r� r� r� r r� r! r� r� re rg r� r� ri rj r� r# r r r r ra � s ra c @ sr e Zd ZdZdd� Zdd� ZeZdd� Zdd � Ze ee� Z Z d d � Z d d � Z dd� Zdd� Zdd� Zdd� ZdS )� CharacterData)�_datarb rD rN rM c C s, d | _ | _d | _| _d| _t�| � d S r )rb rD rN rM rm r r� r r r r r� � s zCharacterData.__init__c C r) r* )r� rZ r r r r r� r. zCharacterData._get_lengthc C r/ r* �rm r r r r � _get_data r2 zCharacterData._get_datac C rf r* rn �r rZ r r r � _set_data r. zCharacterData._set_datac C s6 | j }t|�dkr d}nd}d| jj|dd� |f S )N� z...r z<DOM %s node "%r%s">r )rZ r� r& r� )r rZ � dotdotdotr r r r' s �zCharacterData.__repr__c C sT |dk r t j�d��|t| j�krt j�d��|dk r!t j�d��| j||| � S �Nr �offset cannot be negative�#offset cannot be beyond end of data�count cannot be negative�r@ rA � IndexSizeErrr� rZ �r �offset�countr r r � substringData s zCharacterData.substringDatac C s | j | | _ d S r* rd )r �argr r r � appendData r zCharacterData.appendDatac C s^ |dk r t j�d��|t| j�krt j�d��|r-d| jd |� || j|d � f | _d S d S )Nr ru rv �%s%s%srx )r r{ r~ r r r � insertData# s ��zCharacterData.insertDatac C sp |dk r t j�d��|t| j�krt j�d��|dk r!t j�d��|r6| jd |� | j|| d � | _d S d S rt rx rz r r r � deleteData, s &�zCharacterData.deleteDatac C sv |dk r t j�d��|t| j�krt j�d��|dk r!t j�d��|r9d| jd |� || j|| d � f | _d S d S )Nr ru rv rw r� rx )r r{ r| r~ r r r � replaceData6 s ��zCharacterData.replaceDataN)r� r� r� r� r� r� r ro rq r� rZ r� r' r} r r� r� r� r r r r rl � s rl zLength of the string data.c @ sH e Zd ZdZejZdZdZdd� Z ddd�Z d d � Z d d � Z d d� Z dS )r� r z#textNc C s� |dk s |t | j�krtj�d��| �� }| j|d � |_| j|_| j}| jr?| | jj v r?|d u r8| j� |� n| j� ||� | jd |� | _|S )Nr zillegal offset value) r� rZ r@ rA ry r& rb rM rD r, rF r> )r r{ �newText�nextr r r � splitTextK s zText.splitTextr c C s t |d|| j|f � d S )Nr� )r� rZ rk r r r r# Z s z Text.writexmlc C s� | j g}| j}|d ur$|jtjtjfv r |�d|j � |j}nn|d us | j}|d urC|jtjtjfv r>|�|j � |j}nn|d us+d� |�S )Nr r ) rZ rN r! r rY r� rL rM r\ �join)r r_ r r r r �_get_wholeText_ s � � zText._get_wholeTextc C s� | j }| j}|d ur#|jtjtjfv r |j}|�|� |}nn|d us | j}|s-|�| � |d urJ|jtjtjfv rE|j}|�|� |}nn|d us1|rQ|| _| S d S r* ) rD rN r! r rY r� rE rM rZ )r �contentr� r r� r r r �replaceWholeTextq s. � �zText.replaceWholeTextc C sB | j �� rdS t| �}|d u rdS | j�|�}|d u r dS |�� S rB )rZ �strip�_get_containing_elementrb r� �isElementContent)r r� r� r r r �!_get_isWhitespaceInElementContent� s z&Text._get_isWhitespaceInElementContentrU )r� r� r� r� r rY r! r� r� r� r# r� r� r� r r r r r� D s r� � isWhitespaceInElementContentzKTrue iff this text node contains only whitespace and is in element content.� wholeTextz.The text of all logically-adjacent text nodes.c C �0 | j }|d ur|jtjkr|S |j }|d usd S r* )rD r! r r] �rR rQ r r r r� � � �r� c C r� r* )rD r! r r� r� r r r rS � r� rS c @ s( e Zd ZejZdZdd� Zddd�ZdS ) �Commentz#commentc C s t �| � || _d S r* )rl r� rm rp r r r r� � s zComment.__init__r c C s, d| j v r td��|�d|| j |f � d S )Nz--z%'--' is not allowed in a comment nodez %s<!--%s-->%s)rZ rH r� rk r r r r# � s zComment.writexmlNrU ) r� r� r� r r� r! r� r� r# r r r r r� � s r� c @ s$ e Zd ZdZejZdZddd�ZdS )� CDATASectionr z#cdata-sectionr c C s, | j �d�dkr td��|�d| j � d S )Nz]]>r z$']]>' not allowed in a CDATA sectionz<![CDATA[%s]]>)rZ �findrH r� rk r r r r# � s zCDATASection.writexmlNrU ) r� r� r� r� r r� r! r� r# r r r r r� � s r� c @ sz 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 S ) � ReadOnlySequentialNamedNodeMap��_seqr c C rf r* r� )r �seqr r r r� � s z'ReadOnlySequentialNamedNodeMap.__init__c C r) r* �r� r� r r r r r � r. z&ReadOnlySequentialNamedNodeMap.__len__c C r) r* r� r r r r r� � r. z*ReadOnlySequentialNamedNodeMap._get_lengthc C s" | j D ] }|j|kr| S qd S r* )r� r� r r r r r � s ��z+ReadOnlySequentialNamedNodeMap.getNamedItemc C s, | j D ]}|j|kr|j|kr| S qd S r* )r� r� r� r r r r r � s ��z-ReadOnlySequentialNamedNodeMap.getNamedItemNSc C s4 t |t�r | j|� }n| �|�}|d u rt|��|S r* )r� r= r r ry )r � name_or_tuplerR r r r r � s z*ReadOnlySequentialNamedNodeMap.__getitem__c C s. |dk rd S z| j | W S ty Y d S w r4 )r� r� r� r r r r� � s �z#ReadOnlySequentialNamedNodeMap.itemc C � t j�d���Nz"NamedNodeMap instance is read-only�r@ rA rT r r r r r � � �z.ReadOnlySequentialNamedNodeMap.removeNamedItemc C r� r� r� r r r r r � r� z0ReadOnlySequentialNamedNodeMap.removeNamedItemNSc C r� r� r� r r r r r � r� z+ReadOnlySequentialNamedNodeMap.setNamedItemc C r� r� r� r r r r r � r� z-ReadOnlySequentialNamedNodeMap.setNamedItemNSc C s | j gS r* r� r r r r r rr z+ReadOnlySequentialNamedNodeMap.__getstate__c C s |d | _ d S r4 r� r r r r r r� z+ReadOnlySequentialNamedNodeMap.__setstate__N)r )r� r� r� r� r� r r� r r r r� r r r r r r r r r r r� � s r� z&Number of entries in the NamedNodeMap.c @ s, e Zd ZdZdZdd� Zdd� Zdd� Zd S ) � Identifiedz@Mix-in class that supports the publicId and systemId attributes.��publicId�systemIdc C r$ r* r� )r r� r� r r r �_identified_mixin_init r% z!Identified._identified_mixin_initc C r/ r* )r� r r r r � _get_publicId r2 zIdentified._get_publicIdc C r/ r* )r� r r r r � _get_systemId r2 zIdentified._get_systemIdN)r� r� r� r r� r� r� r� r r r r r� s r� c @ sH e Zd ZejZdZdZdZdZ dZ dd� Z dd� Z dd� Z d d d �ZdS ) � DocumentTypeNc C s2 t � | _t � | _|rt|�\}}|| _| j| _d S r* )r� �entities� notationsr3 r� r� )r r5 r� r6 r r r r� $ s zDocumentType.__init__c C r/ r* )�internalSubsetr r r r �_get_internalSubset, r2 z DocumentType._get_internalSubsetc C s� | j d u rstd �}| j|_| j|_tjjj}|rjg |j_ g |j _ | j j D ]}t |j|j |j �}|j j �|� |�|||� q$| jj D ]'}t|j|j |j |j�}|j|_|j|_|j|_|jj �|� |�|||� qB| �|| |� |S d S r* )rb r� r� r� r@ rA �UserDataHandler� NODE_CLONEDr� r� r� �Notationr� r� r\ r� �Entity� notationName�actualEncodingr rj )r rc �cloner� r �notation�e�entityr r r rd / s0 �zDocumentType.cloneNoder c C s� |� d� |� | j� | jr |� d|| j|| jf � n | jr)|� d|| jf � | jd ur>|� d� |� | j� |� d� |� d| � d S )Nz <!DOCTYPE z%s PUBLIC '%s'%s '%s'z%s SYSTEM '%s'z [�]r� )r� r� r� r� r� rk r r r r# J s � zDocumentType.writexmlrU )r� r� r� r �DOCUMENT_TYPE_NODEr! r� r� r� r� r� r� r� rd r# r r r r r� s r� c @ sf e Zd ZdZejZdZdZdZ dZ dd� Z dd� Z dd� Z dd � Zd d � Zd d � Zdd� Zdd� ZdS )r� Nc C s$ || _ || _t� | _| �||� d S r* )r� r� r� r, r� )r r� r� r� r� r r r r� a s zEntity.__init__c C r/ r* �r� r r r r �_get_actualEncodingg r2 zEntity._get_actualEncodingc C r/ r* �r r r r r � _get_encodingj r2 zEntity._get_encodingc C r/ r* �rj r r r r � _get_versionm r2 zEntity._get_versionc C r� )Nz(cannot append children to an entity node�r@ rA rB )r rO r r r rF p r� zEntity.appendChildc C r� )Nz+cannot insert children below an entity noder� r^ r r r r> t r� zEntity.insertBeforec C r� )Nz*cannot remove children from an entity noder� rX r r r rE x r� zEntity.removeChildc C r� )Nz)cannot replace children of an entity noder� r_ r r r rV | r� zEntity.replaceChild)r� r� r� r� r � ENTITY_NODEr! r� r� r rj r� r� r� r� rF r> rE rV r r r r r� X s r� c @ s e Zd ZejZdZdd� ZdS )r� Nc C s || _ | �||� d S r* )r� r� )r r� r� r� r r r r� � s zNotation.__init__)r� r� r� r r� r! r� r� r r r r r� � s r� c @ s< e Zd Zg d�Zdd� Zdd� Zdd� Zdd � Zd d � Zd S ) �DOMImplementation))�core�1.0)r� �2.0)r� N)r@ r� )r@ r� )r@ N)�ls-loadz3.0)r� Nc C s |dkrd }|� � |f| jv S r )�lower� _featuresrh r r r rg � s z DOMImplementation.hasFeaturec C s� |r |j d ur tj�d��| �� }|d u o |d u o |d u }|s(|r(tj�d��|rZt|�\}}|dkr>|dkr>tj�d��|rH|sHtj�d��|�||�}|rU|� |� |� |� |rb| |_ |_ ||_ | |_ |S )Nz(doctype object owned by another DOM treezElement with no namer@ z$http://www.w3.org/XML/1998/namespacezillegal use of 'xml' prefixz(illegal use of prefix without namespaces) rD r@ rA �WrongDocumentErr�_create_document�InvalidCharacterErrr3 r� �createElementNSrF rb �doctyperf ) r r� r5 r� r� �add_root_elementr� r6 rX r r r �createDocument� s< ��� � z DOMImplementation.createDocumentc C s t |�}||_||_|S r* )r� r� r� )r r5 r� r� r� r r r �createDocumentType� � z$DOMImplementation.createDocumentTypec C rs r* )rg rt r r r ru � rv z DOMImplementation.getInterfacec C s t � S r* )�Documentr r r r r� � r2 z"DOMImplementation._create_documentN) r� r� r� r� rg r� r� ru r� r r r r r� � s - r� c @ s\ e Zd ZdZdZdd� Zdd� Zdd� Zd d � Zd d � Z d d� Z dd� Z dd� Z dd� Z dS )� ElementInfoz�Object that represents content-model information for an element. This implementation is not expected to be used in practice; DOM builders should provide implementations which do the right thing using information available to it. r+ c C rf r* r+ r r r r r� � r. zElementInfo.__init__c C � t S r* �r� �r �anamer r r r� � r z ElementInfo.getAttributeTypec C r� r* r� r r r r r� � r z ElementInfo.getAttributeTypeNSc C r rB r r r r r r� � r z ElementInfo.isElementContentc C r )zQReturns true iff this element is declared to have an EMPTY content model.Fr r r r r �isEmpty� s zElementInfo.isEmptyc C r )z7Returns true iff the named attribute is a DTD-style ID.Fr r� r r r r� � rn zElementInfo.isIdc C r )z<Returns true iff the identified attribute is a DTD-style ID.Fr r r r r r� � rn zElementInfo.isIdNSc C r/ r* r+ r r r r r � r2 zElementInfo.__getstate__c C rf r* r+ r r r r r � r. zElementInfo.__setstate__N)r� r� r� r r� r� r� r� r� r� r� r� r r r r r r r� � s r� c C sD | j tjkr| j�� d | _d S t| �r | jj�� d | j_d S d S r* )r! r r" � _id_cache�clear�_id_search_stackr� rb r� r r r rK s �rK c @ sv e Zd ZdZejejejejfZ e � Z ej Z dZdZdZdZd ZZdZdZdZdZdZdZdZdZdd� Z dd � Z d d � Z d d � Z dd� Z dd� Z!dd� Z"dd� Z#dd� Z$dd� Z%dd� Z&d d � Z'd d � Z(d d!� Z)d"d#� Z*d$d%� Z+d&d'� Z,d(d)� Z-d*d+� Z.d,d-� Z/d.d/� Z0d0d1� Z1d2d3� Z2d4d5� Z3d6d7� Z4d8d9� Z5d:d;� Z6d<d=� Z7d>d?� Z8d@dA� Z9dBdC� Z: dIdEdF�Z;dGdH� Z<dS )Jr� )� _elem_infor� r� r, r� z #documentNFr c C s$ d | _ t� | _i | _i | _d | _d S r* )r� r� r, r� r� r� r r r r r� % s zDocument.__init__c C s& |j r |j |jf}n|j}| j�|�S r* )r� r� r� r� r� )r rX r{ r r r r� . s zDocument._get_elem_infoc C r/ r* r� r r r r r� 5 r2 z Document._get_actualEncodingc C r/ r* )r� r r r r � _get_doctype8 r2 zDocument._get_doctypec C r/ r* )� documentURIr r r r �_get_documentURI; r2 zDocument._get_documentURIc C r/ r* r� r r r r r� > r2 zDocument._get_encodingc C r/ r* )� errorHandlerr r r r �_get_errorHandlerA r2 zDocument._get_errorHandlerc C r/ r* )r r r r r �_get_standaloneD r2 zDocument._get_standalonec C r/ r* )�strictErrorCheckingr r r r �_get_strictErrorCheckingG r2 z!Document._get_strictErrorCheckingc C r/ r* r� r r r r r� J r2 zDocument._get_versionc C sj |j | jvrtj�dt|�t| �f ��|jd ur |j�|� |j tj kr/| � � r/tj�d��t� | |�S )Nr: z two document elements disallowed) r! r? r@ rA rB rC rD rE r r] �_get_documentElementrF r r r r rF M s � �� zDocument.appendChildc C sP z| j �|� W n ty tj�� �w d |_|_d |_| j |u r&d | _ |S r* ) r, rW rH r@ rA rI rM rN rD �documentElementrX r r r rE ] s � zDocument.removeChildc C s$ | j D ] }|jtjkr| S qd S r* )r, r! r r] r r r r r� i s ��z Document._get_documentElementc C s( | j d ur | j �� d | _ t�| � d S r* )r� r[ r r r r r r[ n s zDocument.unlinkc C s� |sd S | j �d d d �}| j|_| j|_| j|_| jD ]7}t|||�}|j�|�s+J �|j� |� |j t j kr?|j d u s>J �n|j t jkrO|jd u sLJ �||_||_q| �tjjj| |� |S r* )rf r� r r rj r, ra rb rq r\ r! r r" r� r� r� rD r� r@ rA r� r� )r rc r� r � childcloner r r rd t s( �zDocument.cloneNodec C s t � }| |_|S r* )r� rb )r r r r r �createDocumentFragment� s z Document.createDocumentFragmentc C � t |�}| |_|S r* )r) rb )r r� r� r r r � createElement� � zDocument.createElementc C �( t |t�s td��t� }||_| |_|S �Nz node contents must be a string)r� r� r r� rZ rb )r rZ �tr r r �createTextNode� � zDocument.createTextNodec C r� r� )r� r� r r� rZ rb �r rZ rQ r r r �createCDATASection� r� zDocument.createCDATASectionc C r� r* )r� rb r� r r r � createComment� r� zDocument.createCommentc C s t ||�}| |_|S r* )ra rb )r rc rZ �pr r r �createProcessingInstruction� s z$Document.createProcessingInstructionc C s t |�}| |_d|_|S r )r� rb r� )r r� �ar r r �createAttribute� r� zDocument.createAttributec C s" t |�\}}t|||�}| |_|S r* )r3 r) rb )r r� r5 r� r� r� r r r r� � s zDocument.createElementNSc C s* t |�\}}t||||�}| |_d|_|S r )r3 r� rb r� )r r� r5 r� r� r� r r r �createAttributeNS� s zDocument.createAttributeNSc C s t ||||�}| |_|S r* )r� rb )r r� r� r� r� r� r r r �_create_entity� s zDocument._create_entityc C s t |||�}| |_|S r* )r� rb )r r� r� r� r r r r �_create_notation� s zDocument._create_notationc C s~ || j v r | j | S | js| jsd S | j}|d u r!| jg}|| _n|s%d S d }|r�|�� }|�dd� |jD �� | �|�}|r�|j � � D ]S}|j re|� |j |j �rd|| j |j< |j|kr_|}qD|jsd n4qD|�|j�r|| j |j< |j|kry|}qD|js~ nqD|jr�|| j |j< |j|kr�|}qD|jdkr� nqDn|jr�|j � � D ]}|jr�|| j |j< |j|kr�|}q�|d ur� |S |s)|S )Nc S s g | ] }|j tv r|�qS r )r! rJ )�.0r` r r r � <listcomp>� s �z+Document.getElementById.<locals>.<listcomp>r; )r� r� r� r� r� �pop�extendr, r� r� r� r� r� r� r� r� r� r� r� )r r� �stack�resultrR r� r- r r r �getElementById� sf � � � ��'zDocument.getElementByIdc C rD r* rE r r r r rF r� z Document.getElementsByTagNamec C rG r* rH r r r r rI rJ z Document.getElementsByTagNameNSc C r� r* )rf rg rh r r r rk r� zDocument.isSupportedc C s< |j tjkr tj�d��|j tjkrtj�d��t||| �S )Nz cannot import document nodesz!cannot import document type nodes)r! r r" r@ rA �NotSupportedErrr� ra )r rR rc r r r � importNode s zDocument.importNoder c C sx g }|r |� d|� d�� |d ur |� d|rdnd� d�� |�dd�|�� d|� �� | jD ] }|�||||� q/d S ) Nz encoding="r� z standalone="�yes�noz<?xml version="1.0" � z?>)r\ r� r� r, r# ) r r( r& rL r' r r � declarationsrR r r r r# s �zDocument.writexmlc C sF |j | urtj�d| |j f ��|jtjtjfvr tj�d��|t kr[d|v r@|� dd�\}}|dkr?|tjj kr?tj� d��n |dkrV|tjj krV|jtjkrVtj� d��d }|}nd }d }|jtjkru|j }|d urt|j}|�|� nd }||_||_||_||_|jtjkr�||_|S ||_|d ur�|�|� |r�|�|� |S )Nz?cannot rename nodes from other documents; expected %s, found %sz8renameNode() only applies to element and attribute nodesr� r; r� z illegal use of 'xmlns' prefixz$illegal use of the 'xmlns' attribute)rb r@ rA r� r! r r] r� r r r� r r� r� r� r: r� r� r� r� r� r� r1 rO )r r r� r� r� r� rX �is_idr r r � renameNode( sb ��� �� � � � zDocument.renameNode)r r r NN)=r� r� r� r� r r] r� r� r� r? r� rf r" r! r� r� r� rD rN rM r� r r rj r� r� r� r� r� r� r� r� r� r� r� r� r� r� rF rE r� r[ rd r� r� r� r� r� r� r� r� r� r� r� r rF rI rk r r# r r r r r r� sn � : � r� r� z#Top-level element of this document.c C s� | j �|�r tjjj}ntjjj}| jtj krQ|� | j | j �}| j �� D ]}|�|j |j |j� |�|j |j�}|j|_q$|rP| jD ] }t|||�}|�|� qBn�| jtjkro|�� }|rn| jD ] }t|||�}|�|� q`n�| jtjkr||�| j�}n�| jtj kr�|� | j�}n�| jtj kr�|� | j | j�}n�| jtj!kr�|�"| j�}n�| jtj#kr�|�$| j | j �}d|_| j|_n�| jtj%k�rE| j |us�J �tjjj}|j&�'| j(| j)| j*�}||_ |�rDg |j+_,g |j-_,| j-j,D ]"} t.| j | j)| j*�} || _ |j-j,�/| � t0| d��r | �1|| | � q�| j+j,D ]1} t2| j | j)| j*| j3�} | j4| _4| j5| _5| j6| _6|| _ |j+j,�/| � t0| d��rB| �1|| | � �qn tj�7dt8| � ��t0| d��r\| �1|| |� |S )zo Clone a node and give it the new owner document. Called by Node.cloneNode and Document.importNode Tr� zCannot clone node %s)9rb rq r@ rA r� r� � NODE_IMPORTEDr! r r] r� r� r� r� r� r7 r� r4 r� r� r, ra rF r< r� rY r� rZ r� r� r� r� rc r� r� r� r� r� rf r� r� r� r� r� r� r� r� r\ r� r� r� r� r� r rj r rC ) rR rc �newOwnerDocumentr� r� r- r� r` rQ r r� r� r� r r r ra a s� � � � � � � � � � ra c C s( | � dd�}t|�dkr|S d |d fS )Nr� r; � r )r� r� )r5 �fieldsr r r r3 � s r3 c C s0 | |i |��}|� � \}}|�|� |�� |S r* )�getEvent� expandNoder� )�func�args�kwargs�events�toktype�rootNoder r r �_do_pulldom_parse� s r c C sD |du r|sddl m} |�| �S ddl m} t|j| f||d��S )z3Parse a file into a DOM by filename or file object.Nr �� expatbuilder��pulldom)�parser�bufsize)�xml.domr �parser r )�filer r r r r r r r � s �r c C s> |du rddl m} |�| �S ddl m} t|j| fd|i�S )z&Parse a file into a DOM from a string.Nr r r r )r r � parseStringr r )�stringr r r r r r r � s �r c C s@ | r t | t�r t�| �} | D ]\}}tj�||�s d S qtjS r* )r� r� r �_parse_feature_stringr� rf rg )�features�f�vr r r �getDOMImplementation� s �r% r� r* )7r r r r@ r r r r �xml.dom.minicompat�xml.dom.xmlbuilderr r rA r r] r� rJ � defpropertyrT r� r� r� r� r� r� �objectr� � AttributeListr! r� r) r; rY ra rl r� r� rS r� r� r� r� r� r� r� r� r� rK r� ra r3 r r r r% r r r r �<module> s� � w { $� �� )GU�� >�<( O* U�R dom/__pycache__/xmlbuilder.cpython-310.pyc 0000644 00000030015 15027446000 0014400 0 ustar 00 o }�5hc0 � @ s� d Z ddlZddlZddlmZ g d�ZG dd� d�ZG dd� d�Zd d � Z G d d � d e �Z G d d� de �Z G dd� d�Z [G dd� d�ZG dd� d�ZdS )z4Implementation of the DOM Level 3 'LS-Load' feature.� N)� NodeFilter)� DOMBuilder�DOMEntityResolver�DOMInputSourcec @ s\ e Zd ZdZdZdZdZdZdZdZ dZ dZ dZ dZ dZdZdZdZdZdZdZdZdZdS )�Optionsz�Features object that has variables set for each DOMBuilder feature. The DOMBuilder class uses an instance of this class to pass settings to the ExpatBuilder class. � TFN)�__name__� __module__� __qualname__�__doc__� namespaces�namespace_declarations� validation�external_parameter_entities�external_general_entities�external_dtd_subset�validate_if_schema�validate�datatype_normalization�create_entity_ref_nodes�entities� whitespace_in_element_content�cdata_sections�comments� charset_overrides_xml_encoding�infoset�supported_mediatypes_only� errorHandler�filter� r r �)/usr/lib/python3.10/xml/dom/xmlbuilder.pyr s* r c @ s` e Zd ZdZdZdZdZdZdZdZ eeee fZ dd� Z dd � Z d d � Z d d � Zdd� Zdd� Zdd� Zdd� Zdd� Zdd� Zi ddg�ddg�d d g�d d g�d d g�d d g�d d g�d!d!g�d"d"g�d#d#g�d$d"d$g�d%d%g�d&d&g�d'd'g�d(d(g�d)d)g�d*d*g�d+gd,gd-gg g d.�d/gd0gd1gd2��Zd3d4� Zd5d6� Zd7d8� Zd9d:� Zd;d<� ZdS )=r Nr � � � c C s t � | _d S �N)r �_options��selfr r r �__init__9 s zDOMBuilder.__init__c C � | j S r$ ��entityResolverr& r r r �_get_entityResolver< � z DOMBuilder._get_entityResolverc C � || _ d S r$ r* )r' r+ r r r �_set_entityResolver> � z DOMBuilder._set_entityResolverc C r) r$ �r r& r r r �_get_errorHandlerA r- z DOMBuilder._get_errorHandlerc C r. r$ r1 )r' r r r r �_set_errorHandlerC r0 z DOMBuilder._set_errorHandlerc C r) r$ �r r& r r r � _get_filterF r- zDOMBuilder._get_filterc C r. r$ r4 )r' r r r r � _set_filterH r0 zDOMBuilder._set_filterc C s� | � |�r8|r dp d}z | jt|�|f }W n ty' tj�d|f �d �w |D ] \}}t| j||� q*d S tj� dt |� ��)Nr r zunsupported feature: %rzunknown feature: ) �supportsFeature� _settings� _name_xform�KeyError�xml�dom�NotSupportedErr�setattrr% � NotFoundErr�repr)r' �name�state�settings�valuer r r � setFeatureK s ��� �zDOMBuilder.setFeaturec C s t | jt|��S r$ )�hasattrr% r9 )r' rA r r r r7 Y � zDOMBuilder.supportsFeaturec C s t |�|rdpdf}|| jv S )Nr r )r9 r8 )r' rA rB �keyr r r � canSetFeature\ s zDOMBuilder.canSetFeature�r r )r r )r r )r r )r r )r r )r r �r r �r r )r r �r r )r r )r r �r r �r r )r r )r r �r r �r r �r r ) rJ rK rL rM rO )r r rN rP rR �r r �r r �r r )rP rQ rR )r r )r r rS rT rU c C s� t |�}zt| j|�W S tyA |dkr7| j}|jo4|jo4|jo4|jo4|jp3|j p3|j p3|j p3|j Y S t j�dt|� ��w )Nr zfeature %s not known)r9 �getattrr% �AttributeErrorr r r r r r r r r r; r< r? r@ )r' rA �xname�optionsr r r � getFeature� s2 �������� �zDOMBuilder.getFeaturec C s. | j r | j �d |�}nt� �d |�}| �|�S r$ )r+ � resolveEntityr �parse)r' �uri�inputr r r �parseURI� s zDOMBuilder.parseURIc C sR t � | j�}| j|_| j|_|j}|d u r#|jr#dd l}|j�|j�}| � ||�S �Nr ) �copyr% r r � byteStream�systemId�urllib.request�request�urlopen�_parse_bytestream)r' r^ rY �fp�urllibr r r r\ � s zDOMBuilder.parsec C s || j vr td��td��)Nznot a legal actionzHaven't written this yet...)�_legal_actions� ValueError�NotImplementedError)r' r^ �cnode�actionr r r �parseWithContext� s zDOMBuilder.parseWithContextc C s dd l }|jj�|�}|�|�S r` )�xml.dom.expatbuilderr< � expatbuilder� makeBuilder� parseFile)r' �streamrY r; �builderr r r rg � s z DOMBuilder._parse_bytestream)r r r r+ r r �ACTION_REPLACE�ACTION_APPEND_AS_CHILDREN�ACTION_INSERT_AFTER�ACTION_INSERT_BEFORErj r( r, r/ r2 r3 r5 r6 rE r7 rI r8 rZ r_ r\ ro rg r r r r r , s� � �������� �� �� �������������� �� �� ��"��%��� ����= r c C s | � � �dd�S )N�-�_)�lower�replace)rA r r r r9 � rG r9 c @ s0 e Zd ZdZdd� Zdd� Zdd� Zdd � Zd S ) r )�_openerc C s� |d usJ �t � }||_||_| �� �|�|_| �|�|_dd l}dd l }|j � |�}|\}}} } } } | rP| � d�sP|� | �d } ||| | | | f}|j �|�|_|S )Nr �/)r �publicIdrc � _get_opener�openrb �_guess_media_encoding�encoding� posixpath� urllib.parser\ �urlparse�endswith�dirname� urlunparse�baseURI) r' r� rc �sourcer� ri �parts�scheme�netloc�path�params�query�fragmentr r r r[ � s z DOMEntityResolver.resolveEntityc C s, z| j W S ty | �� | _ | j Y S w r$ )r~ rW �_create_openerr& r r r r� � s �z DOMEntityResolver._get_openerc C s dd l }|j�� S r` )rd re � build_opener)r' ri r r r r� � s z DOMEntityResolver._create_openerc C sJ |j �� }d|v r!|�� D ]}|�d�r |�dd�d �� S q d S d S )Nz Content-Typezcharset=�=r )rb �info�getplist� startswith�splitr| )r' r� r� �paramr r r r� � s ��z'DOMEntityResolver._guess_media_encodingN)r r r � __slots__r[ r� r� r� r r r r r � s r c @ s� e Zd ZdZdd� Zdd� Zdd� Zdd � Zd d � Zd d � Z dd� Z dd� Z dd� Z dd� Z dd� Zdd� Zdd� Zd d � Zd d � Zd S )!r �rb �characterStream� stringDatar� r� rc r� c C s. d | _ d | _d | _d | _d | _d | _d | _d S r$ r� r& r r r r( s zDOMInputSource.__init__c C r) r$ �rb r& r r r �_get_byteStream r- z DOMInputSource._get_byteStreamc C r. r$ r� )r' rb r r r �_set_byteStream r0 z DOMInputSource._set_byteStreamc C r) r$ �r� r& r r r �_get_characterStream r- z#DOMInputSource._get_characterStreamc C r. r$ r� )r' r� r r r �_set_characterStream r0 z#DOMInputSource._set_characterStreamc C r) r$ �r� r& r r r �_get_stringData r- z DOMInputSource._get_stringDatac C r. r$ r� )r' �datar r r �_set_stringData r0 z DOMInputSource._set_stringDatac C r) r$ �r� r& r r r � _get_encoding r- z DOMInputSource._get_encodingc C r. r$ r� )r' r� r r r � _set_encoding r0 z DOMInputSource._set_encodingc C r) r$ �r� r& r r r � _get_publicId! r- z DOMInputSource._get_publicIdc C r. r$ r� )r' r� r r r � _set_publicId# r0 z DOMInputSource._set_publicIdc C r) r$ �rc r& r r r � _get_systemId& r- z DOMInputSource._get_systemIdc C r. r$ r� )r' rc r r r � _set_systemId( r0 z DOMInputSource._set_systemIdc C r) r$ �r� r& r r r � _get_baseURI+ r- zDOMInputSource._get_baseURIc C r. r$ r� �r' r] r r r � _set_baseURI- r0 zDOMInputSource._set_baseURIN)r r r r� r( r� r� r� r� r� r� r� r� r� r� r� r� r� r� r r r r r s" r c @ s> e Zd ZdZdZdZdZdZej Z dd� Z dd � Z d d � Z d S ) �DOMBuilderFilterzSElement filter which can be used to tailor construction of a DOM instance. r r! r" r# c C r) r$ )� whatToShowr& r r r �_get_whatToShowB r- z DOMBuilderFilter._get_whatToShowc C r) r$ �� FILTER_ACCEPT�r' �elementr r r � acceptNodeE r- zDOMBuilderFilter.acceptNodec C r) r$ r� r� r r r �startContainerH r- z DOMBuilderFilter.startContainerN)r r r r r� � FILTER_REJECT� FILTER_SKIP�FILTER_INTERRUPTr �SHOW_ALLr� r� r� r� r r r r r� 1 s r� c @ sD e Zd ZdZdZdd� Zdd� Zdd� Zd d � Zd d � Z d d� Z dS )� DocumentLSz=Mixin to create documents that conform to the load/save spec.Fc C s dS )NFr r& r r r � _get_asyncS s zDocumentLS._get_asyncc C s |rt j�d��d S )Nz.asynchronous document loading is not supported)r; r< r= )r' �flagr r r � _set_asyncV s ��zDocumentLS._set_asyncc C � t d��)Nz'haven't figured out what this means yet�rl r& r r r �abort[ s �zDocumentLS.abortc C r� �Nzhaven't written this yetr� r� r r r �loada � zDocumentLS.loadc C r� r� r� )r' r� r r r �loadXMLd r� zDocumentLS.loadXMLc C s0 |d u r | }|�� S |j | urtj�� �|�� S r$ )� ownerDocumentr; r< �WrongDocumentErr�toxml)r' �snoder r r �saveXMLg s � zDocumentLS.saveXMLN) r r r r �async_r� r� r� r� r� r� r r r r r� N s r� c @ s, e Zd ZdZdZdd� Zdd� Zdd� Zd S ) �DOMImplementationLSr r! c C sB |d ur t j�d��|| jkrt� S || jkr t j�d��td��)Nz schemaType not yet supportedz'asynchronous builders are not supportedzunknown value for mode)r; r< r= �MODE_SYNCHRONOUSr �MODE_ASYNCHRONOUSrk )r' �mode� schemaTyper r r �createDOMBuilders s � �z$DOMImplementationLS.createDOMBuilderc C r� )Nz-the writer interface hasn't been written yet!r� r& r r r �createDOMWriter~ s �z#DOMImplementationLS.createDOMWriterc C s t � S r$ )r r& r r r �createDOMInputSource� r- z(DOMImplementationLS.createDOMInputSourceN)r r r r� r� r� r� r� r r r r r� o s r� )r ra �xml.domr; �xml.dom.NodeFilterr �__all__r r r9 �objectr r r� r� r� r r r r �<module> s %,1! dom/__pycache__/NodeFilter.cpython-310.pyc 0000644 00000001710 15027446000 0014264 0 ustar 00 o }�5h� � @ s G d d� d�Z dS )c @ sX e Zd ZdZdZdZdZdZdZdZ dZ dZ dZ d Z d Zd Zd Zd ZdZdZdd� ZdS )� NodeFilterzL This is the DOM2 NodeFilter interface. It contains only constants. � � � l �� � � � � �@ � � i i i c C s t �)N)�NotImplementedError)�self�node� r �)/usr/lib/python3.10/xml/dom/NodeFilter.py� acceptNode s zNodeFilter.acceptNodeN)�__name__� __module__� __qualname__�__doc__� FILTER_ACCEPT� FILTER_REJECT� FILTER_SKIP�SHOW_ALL� SHOW_ELEMENT�SHOW_ATTRIBUTE� SHOW_TEXT�SHOW_CDATA_SECTION�SHOW_ENTITY_REFERENCE� SHOW_ENTITY�SHOW_PROCESSING_INSTRUCTION� SHOW_COMMENT� SHOW_DOCUMENT�SHOW_DOCUMENT_TYPE�SHOW_DOCUMENT_FRAGMENT� SHOW_NOTATIONr r r r r r s& r N)r r r r r �<module> s dom/__pycache__/pulldom.cpython-310.pyc 0000644 00000024472 15027446000 0013717 0 ustar 00 o }�5h�. � @ s� d dl Zd dlZdZdZdZdZdZdZdZ d Z G d d � d ej j �Z G d d � d �ZG dd� d�ZG dd� de �ZdZddd�Zddd�ZdS )� N� START_ELEMENT� END_ELEMENT�COMMENT�START_DOCUMENT� END_DOCUMENT�PROCESSING_INSTRUCTION�IGNORABLE_WHITESPACE� CHARACTERSc @ s� e Zd ZdZdZd$dd�Zdd� Zdd� Zdd � Zd d � Z d d � Z dd� Z dd� Z dd� Z dd� Zdd� Zdd� Zdd� Zd d � Zd d � Zd d!� Zd"d#� ZdS )%�PullDOMNc C sx ddl m} || _d d g| _| j| _g | _| jj| _z| jj| _W n t y* Y nw |dig| _ | j d | _ g | _ d S )Nr )� XML_NAMESPACE�xml���) �xml.domr �documentFactory� firstEvent� lastEvent� elementStack�append�push�pop�AttributeError� _ns_contexts�_current_context�pending_events)�selfr r � r �&/usr/lib/python3.10/xml/dom/pulldom.py�__init__ s � zPullDOM.__init__c C s | j d }| j d= |S �Nr )r )r �resultr r r r ! s z PullDOM.popc C s || _ d S �N)�_locator)r �locatorr r r �setDocumentLocator& s zPullDOM.setDocumentLocatorc C sH t | d�sg | _| j�|pd|f� | j�| j�� � |p d | j|< d S )N� _xmlns_attrs�xmlns)�hasattrr$ r r r �copy)r �prefix�urir r r �startPrefixMapping) s zPullDOM.startPrefixMappingc C s | j �� | _d S r )r r r )r r( r r r �endPrefixMapping0 s zPullDOM.endPrefixMappingc C s� d}t | dd �}|d ur |D ] \}}||j||f< qg | _|\}} |rI|d u r7| j| } | r5| d | }n| }| jrB| j�||�} n| �||�} n| jrS| j�| �} n| �d | �} |�� D ]Q\}}|\} } | |kr�| dkrp| }nd| }| j� | |�}| � |� n*| r�| j| } | r�| d | }n| }| j� | |�}| � |� n | j� | �}| � |� ||_ q]t| fd g| jd< | jd | _| �| � d S )Nz http://www.w3.org/2000/xmlns/r$ �:r% zxmlns:� )�getattr�_attrsr$ r �document�createElementNS� buildDocument� createElement�items�createAttributeNS�setAttributeNodeNS�createAttribute�setAttributeNode�valuer r r )r �name�tagName�attrs� xmlns_uri� xmlns_attrs�anamer9 r) � localnamer( �node�a_uri� a_localname�qname�attrr r r �startElementNS3 sP zPullDOM.startElementNSc C �& t | �� fd g| jd< | jd | _d S �Nr- �r r r )r r: r; r r r � endElementNSl � zPullDOM.endElementNSc C sz | j r | j �|�}n| �d |�}|�� D ]\}}| j �|�}||_|�|� qt|fd g| jd< | jd | _| � |� d S rH ) r0 r3 r2 r4 r7 r9 r8 r r r )r r: r< rA r? r9 rE r r r � startElementp s zPullDOM.startElementc C rG rH rI )r r: r r r � endElement rK zPullDOM.endElementc C sP | j r| j �|�}t|fd g| jd< | jd | _d S t|fd g}| j�|� d S rH )r0 � createCommentr r r r )r �srA �eventr r r �comment� s zPullDOM.commentc C sT | j r| j �||�}t|fd g| jd< | jd | _d S t||fd g}| j�|� d S rH )r0 �createProcessingInstructionr r r r )r �target�datarA rP r r r �processingInstruction� s z PullDOM.processingInstructionc C �. | j �|�}t|fd g| jd< | jd | _d S rH )r0 �createTextNoder r �r �charsrA r r r �ignorableWhitespace� � zPullDOM.ignorableWhitespacec C rV rH )r0 rW r r rX r r r � characters� r[ zPullDOM.charactersc C s( | j d u rdd l}|jjjj| _ d S d S )Nr )r �xml.dom.minidom�dom�minidom�Document�implementation)r r r r r � startDocument� s �zPullDOM.startDocumentc C s� | j �||d �}|| _t|fd g| jd< | jd | _| �|� | jD ]I}|d d tkrA|d \}}}| j�||�}t|f|d< n"|d d t krZ| j� |d d �}t |f|d< n t d|d d ��|| jd< || _q"d | _|j S )Nr- r zUnknown pending event ) r �createDocumentr0 r r r r r rR r rN �AssertionError� firstChild) r r) �tagnamerA �e�_rS rT �nr r r r2 � s$ zPullDOM.buildDocumentc C s t | jfd g| jd< | �� d S rH )r r0 r r �r r r r � endDocument� s zPullDOM.endDocumentc C s d| _ dS )z.clear(): Explicitly release parsing structuresN)r0 rj r r r �clear� s z PullDOM.clearr )�__name__� __module__� __qualname__r! r0 r r r# r* r+ rF rJ rL rM rQ rU rZ r\ rb r2 rk rl r r r r r s( 9 r c @ s$ e Zd Zdd� Zdd� Zdd� ZdS )� ErrorHandlerc C s t |� d S r )�print�r � exceptionr r r �warning� s zErrorHandler.warningc C � |�r r rr r r r �error� � zErrorHandler.errorc C ru r r rr r r r � fatalError� rw zErrorHandler.fatalErrorN)rm rn ro rt rv rx r r r r rp � s rp c @ s\ e Zd Zdd� Zdd� Zdd� Zdd� Zd d � Zd d � Zd d� Z dd� Z dd� Z dd� Z dS )�DOMEventStreamc C s2 || _ || _|| _t| jd�s| j| _| �� d S )N�feed)�stream�parser�bufsizer& �_slurp�getEvent�reset)r r{ r| r} r r r r � s zDOMEventStream.__init__c C s. t � | _| j�tjjjd� | j�| j� d S rH ) r �pulldomr| � setFeaturer �sax�handler�feature_namespaces�setContentHandlerrj r r r r� � s zDOMEventStream.resetc C s, dd l }|jdtdd� | �� }|r|S t�)Nr z[DOMEventStream's __getitem__ method ignores 'pos' parameter. Use iterator protocol instead.� )� stacklevel)�warnings�warn�DeprecationWarningr � IndexError)r �posr� �rcr r r � __getitem__� s �zDOMEventStream.__getitem__c C s | � � }|r|S t�r )r � StopIteration�r r� r r r �__next__� s zDOMEventStream.__next__c C s | S r r rj r r r �__iter__� rw zDOMEventStream.__iter__c C sr | � � }|g}|r7|\}}||u rd S |tkr |d �|� |tkr(|�|� n|tkr/|d= | � � }|s d S d S r )r r � appendChildr r )r rA rP �parents�token�cur_noder r r � expandNode� s �zDOMEventStream.expandNodec C s� | j jd s | j j| j _| j jd s.| j�| j�}|s"| j�� d S | j�|� | j jd r| j jd d }| j jd d | j jd< |S )Nr- r ) r� r r r{ �readr} r| �closerz )r �bufr� r r r r s �zDOMEventStream.getEventc C s | j �| j� | j| _| �� S )z� Fallback replacement for getEvent() using the standard SAX2 interface, which means we slurp the SAX events into memory (no performance gain, but we are compatible to all SAX parsers). )r| �parser{ �_emitr rj r r r r~ s zDOMEventStream._slurpc C s, | j jd d }| j jd d | j jd< |S )zn Fallback replacement for getEvent() that emits the events that _slurp() read previously. r- r )r� r r� r r r r� s zDOMEventStream._emitc C s | j �� | ` d| _d| _dS )z+clear(): Explicitly release parsing objectsN)r� rl r| r{ rj r r r rl ! s zDOMEventStream.clearN) rm rn ro r r� r� r� r� r� r r~ r� rl r r r r ry � s ry c @ s4 e Zd Zdd� Zdd� Zdd� Zdd� Zd d � Zd S ) �SAX2DOMc C s2 t �| |||� | jd }| jd }|�|� d S �Nr ���)r rF r r� )r r: r; r< �curNode� parentNoder r r rF * s zSAX2DOM.startElementNSc C s0 t �| ||� | jd }| jd }|�|� d S r� )r rL r r� )r r: r< r� r� r r r rL 0 s zSAX2DOM.startElementc C s4 t �| ||� | jd d }| jd }|�|� d S �Nr r- r )r rU r r r� )r rS rT rA r� r r r rU 6 s z SAX2DOM.processingInstructionc C �2 t �| |� | jd d }| jd }|�|� d S r� )r rZ r r r� �r rY rA r� r r r rZ < � zSAX2DOM.ignorableWhitespacec C r� r� )r r\ r r r� r� r r r r\ B r� zSAX2DOM.charactersN)rm rn ro rF rL rU rZ r\ r r r r r� ( s r� i�? c C s@ |d u rt }t| t�rt| d�}n| }|stj�� }t|||�S )N�rb)�default_bufsize� isinstance�str�openr r� � make_parserry )�stream_or_stringr| r} r{ r r r r� K s r� c C s6 ddl m} t| �}|| �}|stj�� }t|||�S )Nr )�StringIO)�ior� �lenr r� r� ry )�stringr| r� r} r� r r r � parseStringV s r� )NNr )�xml.saxr �xml.sax.handlerr r r r r r r r r� �ContentHandlerr rp ry r� r� r� r� r r r r �<module> s$ 8\! dom/__pycache__/domreg.cpython-310.pyc 0000644 00000005453 15027446000 0013516 0 ustar 00 o }�5h{ � @ s@ d Z ddlZddd�Zi Zdd� Zdd � Zdd d �Zd d� ZdS )z�Registration facilities for DOM. This module should not be used directly. Instead, the functions getDOMImplementation and registerDOMImplementation should be imported from xml.dom.� Nzxml.dom.minidomzxml.dom.DOMImplementation)�minidom�4DOMc C s |t | < dS )aI registerDOMImplementation(name, factory) Register the factory function with the name. The factory function should return an object which implements the DOMImplementation interface. The factory function can either return the same object, or a new one (e.g. if that implementation supports some customization).N)� registered)�name�factory� r �%/usr/lib/python3.10/xml/dom/domreg.py�registerDOMImplementation s r c C s$ |D ] \}}| � ||�s dS qdS )zF_good_enough(dom, features) -> Return 1 if the dom offers the featuresr � )� hasFeature)�dom�features�f�vr r r � _good_enough s �r r c C s� ddl }d}t�| �}|rt|i i dg�}|�� S | r t| � S tjjs1d|j v r1t|j d d�S t |t �r:t |�}t� � D ]}|� }t||�rL| S q>t�� D ] }zt|d�}W n tyc Y qQw t||�rm| S qQtd��)aS getDOMImplementation(name = None, features = ()) -> DOM implementation. Return a suitable DOM implementation. The name is either well-known, the module name of a DOM implementation, or None. If it is not None, imports the corresponding module and returns DOMImplementation object if the import succeeds. If name is not given, consider the available implementations to find one with the required feature set. If no implementation can be found, raise an ImportError. The features list must be a sequence of (feature, version) pairs which are passed to hasFeature.r N�getDOMImplementation� PYTHON_DOM)r z$no suitable DOM implementation found)�os�well_known_implementations�get� __import__r r �sys�flags�ignore_environment�environ� isinstance�str�_parse_feature_string�valuesr �keys� Exception� ImportError)r r r �creator�modr r r r r ' s6 � � �r c C s� g }| � � }d}t|�}||k rF|| }|d dv r!td|f ��|d }d }||k r;|| }|d dv r;|d }|}|�||f� ||k st|�S )Nr � 0123456789zbad feature name: %rr )�split�len� ValueError�append�tuple)�sr �parts�i�length�feature�versionr r r r r R s$ � r )Nr )�__doc__r r r r r r r r r r r �<module> s � + dom/__pycache__/minicompat.cpython-310.pyc 0000644 00000005202 15027446000 0014371 0 ustar 00 o }�5h' � @ sF d Z g d�ZddlZefZG dd� de�ZG dd� de�Z dd � Z dS ) z�Python version compatibility support for minidom. This module contains internal implementation details and should not be imported; use xml.dom.minidom instead. )�NodeList� EmptyNodeList� StringTypes� defproperty� Nc @ s> e Zd ZdZdd� Zdd� Zdd� Zeeedd �Zd d � Z d S ) r � c C s( d| krt | �k r| | S d S d S �Nr ��len��self�indexr r �)/usr/lib/python3.10/xml/dom/minicompat.py�item5 s �z NodeList.itemc C s t | �S �Nr �r r r r � _get_length9 s zNodeList._get_lengthc C � t j�d���Nz.attempt to modify read-only attribute 'length'��xml�dom�NoModificationAllowedErr�r �valuer r r � _set_length< � �zNodeList._set_length�$The number of nodes in the NodeList.��docc C s |d u rg }|| d d �< d S r r )r �stater r r � __setstate__D s zNodeList.__setstate__N) �__name__� __module__� __qualname__� __slots__r r r �property�lengthr r r r r r 2 s � r c @ sF e Zd ZdZdd� Zdd� Zdd� Zdd � Zd d � Ze eed d �Z dS )r r c C � t � }|�|� |S r �r �extend�r �other�NLr r r �__add__M � zEmptyNodeList.__add__c C r' r r( r* r r r �__radd__R r. zEmptyNodeList.__radd__c C s d S r r r r r r r W � zEmptyNodeList.itemc C s dS r r r r r r r Z r0 zEmptyNodeList._get_lengthc C r r r r r r r r ] r zEmptyNodeList._set_lengthr r N) r! r" r# r$ r- r/ r r r r% r& r r r r r J s �r c C sR t | d| �}|fdd�}t| d| �rJ d| ��t|||d�}t| ||� d S )N�_get_c S s t j�dt|� ��)Nz&attempt to modify read-only attribute )r r r �repr)r r �namer r r �setg s �zdefproperty.<locals>.set�_set_zexpected not to find _set_r )�getattr�hasattrr% �setattr)�klassr3 r �getr4 �propr r r r e s �r ) �__doc__�__all__�xml.domr �strr �listr �tupler r r r r r �<module> s * dom/pulldom.py 0000644 00000027335 15027446000 0007361 0 ustar 00 import xml.sax import xml.sax.handler START_ELEMENT = "START_ELEMENT" END_ELEMENT = "END_ELEMENT" COMMENT = "COMMENT" START_DOCUMENT = "START_DOCUMENT" END_DOCUMENT = "END_DOCUMENT" PROCESSING_INSTRUCTION = "PROCESSING_INSTRUCTION" IGNORABLE_WHITESPACE = "IGNORABLE_WHITESPACE" CHARACTERS = "CHARACTERS" class PullDOM(xml.sax.ContentHandler): _locator = None document = None def __init__(self, documentFactory=None): from xml.dom import XML_NAMESPACE self.documentFactory = documentFactory self.firstEvent = [None, None] self.lastEvent = self.firstEvent self.elementStack = [] self.push = self.elementStack.append try: self.pop = self.elementStack.pop except AttributeError: # use class' pop instead pass self._ns_contexts = [{XML_NAMESPACE:'xml'}] # contains uri -> prefix dicts self._current_context = self._ns_contexts[-1] self.pending_events = [] def pop(self): result = self.elementStack[-1] del self.elementStack[-1] return result def setDocumentLocator(self, locator): self._locator = locator def startPrefixMapping(self, prefix, uri): if not hasattr(self, '_xmlns_attrs'): self._xmlns_attrs = [] self._xmlns_attrs.append((prefix or 'xmlns', uri)) self._ns_contexts.append(self._current_context.copy()) self._current_context[uri] = prefix or None def endPrefixMapping(self, prefix): self._current_context = self._ns_contexts.pop() def startElementNS(self, name, tagName , attrs): # Retrieve xml namespace declaration attributes. xmlns_uri = 'http://www.w3.org/2000/xmlns/' xmlns_attrs = getattr(self, '_xmlns_attrs', None) if xmlns_attrs is not None: for aname, value in xmlns_attrs: attrs._attrs[(xmlns_uri, aname)] = value self._xmlns_attrs = [] uri, localname = name if uri: # When using namespaces, the reader may or may not # provide us with the original name. If not, create # *a* valid tagName from the current context. if tagName is None: prefix = self._current_context[uri] if prefix: tagName = prefix + ":" + localname else: tagName = localname if self.document: node = self.document.createElementNS(uri, tagName) else: node = self.buildDocument(uri, tagName) else: # When the tagname is not prefixed, it just appears as # localname if self.document: node = self.document.createElement(localname) else: node = self.buildDocument(None, localname) for aname,value in attrs.items(): a_uri, a_localname = aname if a_uri == xmlns_uri: if a_localname == 'xmlns': qname = a_localname else: qname = 'xmlns:' + a_localname attr = self.document.createAttributeNS(a_uri, qname) node.setAttributeNodeNS(attr) elif a_uri: prefix = self._current_context[a_uri] if prefix: qname = prefix + ":" + a_localname else: qname = a_localname attr = self.document.createAttributeNS(a_uri, qname) node.setAttributeNodeNS(attr) else: attr = self.document.createAttribute(a_localname) node.setAttributeNode(attr) attr.value = value self.lastEvent[1] = [(START_ELEMENT, node), None] self.lastEvent = self.lastEvent[1] self.push(node) def endElementNS(self, name, tagName): self.lastEvent[1] = [(END_ELEMENT, self.pop()), None] self.lastEvent = self.lastEvent[1] def startElement(self, name, attrs): if self.document: node = self.document.createElement(name) else: node = self.buildDocument(None, name) for aname,value in attrs.items(): attr = self.document.createAttribute(aname) attr.value = value node.setAttributeNode(attr) self.lastEvent[1] = [(START_ELEMENT, node), None] self.lastEvent = self.lastEvent[1] self.push(node) def endElement(self, name): self.lastEvent[1] = [(END_ELEMENT, self.pop()), None] self.lastEvent = self.lastEvent[1] def comment(self, s): if self.document: node = self.document.createComment(s) self.lastEvent[1] = [(COMMENT, node), None] self.lastEvent = self.lastEvent[1] else: event = [(COMMENT, s), None] self.pending_events.append(event) def processingInstruction(self, target, data): if self.document: node = self.document.createProcessingInstruction(target, data) self.lastEvent[1] = [(PROCESSING_INSTRUCTION, node), None] self.lastEvent = self.lastEvent[1] else: event = [(PROCESSING_INSTRUCTION, target, data), None] self.pending_events.append(event) def ignorableWhitespace(self, chars): node = self.document.createTextNode(chars) self.lastEvent[1] = [(IGNORABLE_WHITESPACE, node), None] self.lastEvent = self.lastEvent[1] def characters(self, chars): node = self.document.createTextNode(chars) self.lastEvent[1] = [(CHARACTERS, node), None] self.lastEvent = self.lastEvent[1] def startDocument(self): if self.documentFactory is None: import xml.dom.minidom self.documentFactory = xml.dom.minidom.Document.implementation def buildDocument(self, uri, tagname): # Can't do that in startDocument, since we need the tagname # XXX: obtain DocumentType node = self.documentFactory.createDocument(uri, tagname, None) self.document = node self.lastEvent[1] = [(START_DOCUMENT, node), None] self.lastEvent = self.lastEvent[1] self.push(node) # Put everything we have seen so far into the document for e in self.pending_events: if e[0][0] == PROCESSING_INSTRUCTION: _,target,data = e[0] n = self.document.createProcessingInstruction(target, data) e[0] = (PROCESSING_INSTRUCTION, n) elif e[0][0] == COMMENT: n = self.document.createComment(e[0][1]) e[0] = (COMMENT, n) else: raise AssertionError("Unknown pending event ",e[0][0]) self.lastEvent[1] = e self.lastEvent = e self.pending_events = None return node.firstChild def endDocument(self): self.lastEvent[1] = [(END_DOCUMENT, self.document), None] self.pop() def clear(self): "clear(): Explicitly release parsing structures" self.document = None class ErrorHandler: def warning(self, exception): print(exception) def error(self, exception): raise exception def fatalError(self, exception): raise exception class DOMEventStream: def __init__(self, stream, parser, bufsize): self.stream = stream self.parser = parser self.bufsize = bufsize if not hasattr(self.parser, 'feed'): self.getEvent = self._slurp self.reset() def reset(self): self.pulldom = PullDOM() # This content handler relies on namespace support self.parser.setFeature(xml.sax.handler.feature_namespaces, 1) self.parser.setContentHandler(self.pulldom) def __getitem__(self, pos): import warnings warnings.warn( "DOMEventStream's __getitem__ method ignores 'pos' parameter. " "Use iterator protocol instead.", DeprecationWarning, stacklevel=2 ) rc = self.getEvent() if rc: return rc raise IndexError def __next__(self): rc = self.getEvent() if rc: return rc raise StopIteration def __iter__(self): return self def expandNode(self, node): event = self.getEvent() parents = [node] while event: token, cur_node = event if cur_node is node: return if token != END_ELEMENT: parents[-1].appendChild(cur_node) if token == START_ELEMENT: parents.append(cur_node) elif token == END_ELEMENT: del parents[-1] event = self.getEvent() def getEvent(self): # use IncrementalParser interface, so we get the desired # pull effect if not self.pulldom.firstEvent[1]: self.pulldom.lastEvent = self.pulldom.firstEvent while not self.pulldom.firstEvent[1]: buf = self.stream.read(self.bufsize) if not buf: self.parser.close() return None self.parser.feed(buf) rc = self.pulldom.firstEvent[1][0] self.pulldom.firstEvent[1] = self.pulldom.firstEvent[1][1] return rc def _slurp(self): """ Fallback replacement for getEvent() using the standard SAX2 interface, which means we slurp the SAX events into memory (no performance gain, but we are compatible to all SAX parsers). """ self.parser.parse(self.stream) self.getEvent = self._emit return self._emit() def _emit(self): """ Fallback replacement for getEvent() that emits the events that _slurp() read previously. """ rc = self.pulldom.firstEvent[1][0] self.pulldom.firstEvent[1] = self.pulldom.firstEvent[1][1] return rc def clear(self): """clear(): Explicitly release parsing objects""" self.pulldom.clear() del self.pulldom self.parser = None self.stream = None class SAX2DOM(PullDOM): def startElementNS(self, name, tagName , attrs): PullDOM.startElementNS(self, name, tagName, attrs) curNode = self.elementStack[-1] parentNode = self.elementStack[-2] parentNode.appendChild(curNode) def startElement(self, name, attrs): PullDOM.startElement(self, name, attrs) curNode = self.elementStack[-1] parentNode = self.elementStack[-2] parentNode.appendChild(curNode) def processingInstruction(self, target, data): PullDOM.processingInstruction(self, target, data) node = self.lastEvent[0][1] parentNode = self.elementStack[-1] parentNode.appendChild(node) def ignorableWhitespace(self, chars): PullDOM.ignorableWhitespace(self, chars) node = self.lastEvent[0][1] parentNode = self.elementStack[-1] parentNode.appendChild(node) def characters(self, chars): PullDOM.characters(self, chars) node = self.lastEvent[0][1] parentNode = self.elementStack[-1] parentNode.appendChild(node) default_bufsize = (2 ** 14) - 20 def parse(stream_or_string, parser=None, bufsize=None): if bufsize is None: bufsize = default_bufsize if isinstance(stream_or_string, str): stream = open(stream_or_string, 'rb') else: stream = stream_or_string if not parser: parser = xml.sax.make_parser() return DOMEventStream(stream, parser, bufsize) def parseString(string, parser=None): from io import StringIO bufsize = len(string) buf = StringIO(string) if not parser: parser = xml.sax.make_parser() return DOMEventStream(buf, parser, bufsize) dom/NodeFilter.py 0000644 00000001650 15027446000 0007730 0 ustar 00 # This is the Python mapping for interface NodeFilter from # DOM2-Traversal-Range. It contains only constants. class NodeFilter: """ This is the DOM2 NodeFilter interface. It contains only constants. """ FILTER_ACCEPT = 1 FILTER_REJECT = 2 FILTER_SKIP = 3 SHOW_ALL = 0xFFFFFFFF SHOW_ELEMENT = 0x00000001 SHOW_ATTRIBUTE = 0x00000002 SHOW_TEXT = 0x00000004 SHOW_CDATA_SECTION = 0x00000008 SHOW_ENTITY_REFERENCE = 0x00000010 SHOW_ENTITY = 0x00000020 SHOW_PROCESSING_INSTRUCTION = 0x00000040 SHOW_COMMENT = 0x00000080 SHOW_DOCUMENT = 0x00000100 SHOW_DOCUMENT_TYPE = 0x00000200 SHOW_DOCUMENT_FRAGMENT = 0x00000400 SHOW_NOTATION = 0x00000800 def acceptNode(self, node): raise NotImplementedError dom/minidom.py 0000644 00000205054 15027446000 0007335 0 ustar 00 """Simple implementation of the Level 1 DOM. Namespaces and other minor Level 2 features are also supported. parse("foo.xml") parseString("<foo><bar/></foo>") Todo: ===== * convenience methods for getting elements and text. * more testing * bring some of the writer and linearizer code into conformance with this interface * SAX 2 namespaces """ import io import xml.dom from xml.dom import EMPTY_NAMESPACE, EMPTY_PREFIX, XMLNS_NAMESPACE, domreg from xml.dom.minicompat import * from xml.dom.xmlbuilder import DOMImplementationLS, DocumentLS # This is used by the ID-cache invalidation checks; the list isn't # actually complete, since the nodes being checked will never be the # DOCUMENT_NODE or DOCUMENT_FRAGMENT_NODE. (The node being checked is # the node being added or removed, not the node being modified.) # _nodeTypes_with_children = (xml.dom.Node.ELEMENT_NODE, xml.dom.Node.ENTITY_REFERENCE_NODE) class Node(xml.dom.Node): namespaceURI = None # this is non-null only for elements and attributes parentNode = None ownerDocument = None nextSibling = None previousSibling = None prefix = EMPTY_PREFIX # non-null only for NS elements and attributes def __bool__(self): return True def toxml(self, encoding=None, standalone=None): return self.toprettyxml("", "", encoding, standalone) def toprettyxml(self, indent="\t", newl="\n", encoding=None, standalone=None): if encoding is None: writer = io.StringIO() else: writer = io.TextIOWrapper(io.BytesIO(), encoding=encoding, errors="xmlcharrefreplace", newline='\n') if self.nodeType == Node.DOCUMENT_NODE: # Can pass encoding only to document, to put it into XML header self.writexml(writer, "", indent, newl, encoding, standalone) else: self.writexml(writer, "", indent, newl) if encoding is None: return writer.getvalue() else: return writer.detach().getvalue() def hasChildNodes(self): return bool(self.childNodes) def _get_childNodes(self): return self.childNodes def _get_firstChild(self): if self.childNodes: return self.childNodes[0] def _get_lastChild(self): if self.childNodes: return self.childNodes[-1] def insertBefore(self, newChild, refChild): if newChild.nodeType == self.DOCUMENT_FRAGMENT_NODE: for c in tuple(newChild.childNodes): self.insertBefore(c, refChild) ### The DOM does not clearly specify what to return in this case return newChild if newChild.nodeType not in self._child_node_types: raise xml.dom.HierarchyRequestErr( "%s cannot be child of %s" % (repr(newChild), repr(self))) if newChild.parentNode is not None: newChild.parentNode.removeChild(newChild) if refChild is None: self.appendChild(newChild) else: try: index = self.childNodes.index(refChild) except ValueError: raise xml.dom.NotFoundErr() if newChild.nodeType in _nodeTypes_with_children: _clear_id_cache(self) self.childNodes.insert(index, newChild) newChild.nextSibling = refChild refChild.previousSibling = newChild if index: node = self.childNodes[index-1] node.nextSibling = newChild newChild.previousSibling = node else: newChild.previousSibling = None newChild.parentNode = self return newChild def appendChild(self, node): if node.nodeType == self.DOCUMENT_FRAGMENT_NODE: for c in tuple(node.childNodes): self.appendChild(c) ### The DOM does not clearly specify what to return in this case return node if node.nodeType not in self._child_node_types: raise xml.dom.HierarchyRequestErr( "%s cannot be child of %s" % (repr(node), repr(self))) elif node.nodeType in _nodeTypes_with_children: _clear_id_cache(self) if node.parentNode is not None: node.parentNode.removeChild(node) _append_child(self, node) node.nextSibling = None return node def replaceChild(self, newChild, oldChild): if newChild.nodeType == self.DOCUMENT_FRAGMENT_NODE: refChild = oldChild.nextSibling self.removeChild(oldChild) return self.insertBefore(newChild, refChild) if newChild.nodeType not in self._child_node_types: raise xml.dom.HierarchyRequestErr( "%s cannot be child of %s" % (repr(newChild), repr(self))) if newChild is oldChild: return if newChild.parentNode is not None: newChild.parentNode.removeChild(newChild) try: index = self.childNodes.index(oldChild) except ValueError: raise xml.dom.NotFoundErr() self.childNodes[index] = newChild newChild.parentNode = self oldChild.parentNode = None if (newChild.nodeType in _nodeTypes_with_children or oldChild.nodeType in _nodeTypes_with_children): _clear_id_cache(self) newChild.nextSibling = oldChild.nextSibling newChild.previousSibling = oldChild.previousSibling oldChild.nextSibling = None oldChild.previousSibling = None if newChild.previousSibling: newChild.previousSibling.nextSibling = newChild if newChild.nextSibling: newChild.nextSibling.previousSibling = newChild return oldChild def removeChild(self, oldChild): try: self.childNodes.remove(oldChild) except ValueError: raise xml.dom.NotFoundErr() if oldChild.nextSibling is not None: oldChild.nextSibling.previousSibling = oldChild.previousSibling if oldChild.previousSibling is not None: oldChild.previousSibling.nextSibling = oldChild.nextSibling oldChild.nextSibling = oldChild.previousSibling = None if oldChild.nodeType in _nodeTypes_with_children: _clear_id_cache(self) oldChild.parentNode = None return oldChild def normalize(self): L = [] for child in self.childNodes: if child.nodeType == Node.TEXT_NODE: if not child.data: # empty text node; discard if L: L[-1].nextSibling = child.nextSibling if child.nextSibling: child.nextSibling.previousSibling = child.previousSibling child.unlink() elif L and L[-1].nodeType == child.nodeType: # collapse text node node = L[-1] node.data = node.data + child.data node.nextSibling = child.nextSibling if child.nextSibling: child.nextSibling.previousSibling = node child.unlink() else: L.append(child) else: L.append(child) if child.nodeType == Node.ELEMENT_NODE: child.normalize() self.childNodes[:] = L def cloneNode(self, deep): return _clone_node(self, deep, self.ownerDocument or self) def isSupported(self, feature, version): return self.ownerDocument.implementation.hasFeature(feature, version) def _get_localName(self): # Overridden in Element and Attr where localName can be Non-Null return None # Node interfaces from Level 3 (WD 9 April 2002) def isSameNode(self, other): return self is other def getInterface(self, feature): if self.isSupported(feature, None): return self else: return None # The "user data" functions use a dictionary that is only present # if some user data has been set, so be careful not to assume it # exists. def getUserData(self, key): try: return self._user_data[key][0] except (AttributeError, KeyError): return None def setUserData(self, key, data, handler): old = None try: d = self._user_data except AttributeError: d = {} self._user_data = d if key in d: old = d[key][0] if data is None: # ignore handlers passed for None handler = None if old is not None: del d[key] else: d[key] = (data, handler) return old def _call_user_data_handler(self, operation, src, dst): if hasattr(self, "_user_data"): for key, (data, handler) in list(self._user_data.items()): if handler is not None: handler.handle(operation, key, data, src, dst) # minidom-specific API: def unlink(self): self.parentNode = self.ownerDocument = None if self.childNodes: for child in self.childNodes: child.unlink() self.childNodes = NodeList() self.previousSibling = None self.nextSibling = None # A Node is its own context manager, to ensure that an unlink() call occurs. # This is similar to how a file object works. def __enter__(self): return self def __exit__(self, et, ev, tb): self.unlink() defproperty(Node, "firstChild", doc="First child node, or None.") defproperty(Node, "lastChild", doc="Last child node, or None.") defproperty(Node, "localName", doc="Namespace-local name of this node.") def _append_child(self, node): # fast path with less checks; usable by DOM builders if careful childNodes = self.childNodes if childNodes: last = childNodes[-1] node.previousSibling = last last.nextSibling = node childNodes.append(node) node.parentNode = self def _in_document(node): # return True iff node is part of a document tree while node is not None: if node.nodeType == Node.DOCUMENT_NODE: return True node = node.parentNode return False def _write_data(writer, data): "Writes datachars to writer." if data: data = data.replace("&", "&").replace("<", "<"). \ replace("\"", """).replace(">", ">") writer.write(data) def _get_elements_by_tagName_helper(parent, name, rc): for node in parent.childNodes: if node.nodeType == Node.ELEMENT_NODE and \ (name == "*" or node.tagName == name): rc.append(node) _get_elements_by_tagName_helper(node, name, rc) return rc def _get_elements_by_tagName_ns_helper(parent, nsURI, localName, rc): for node in parent.childNodes: if node.nodeType == Node.ELEMENT_NODE: if ((localName == "*" or node.localName == localName) and (nsURI == "*" or node.namespaceURI == nsURI)): rc.append(node) _get_elements_by_tagName_ns_helper(node, nsURI, localName, rc) return rc class DocumentFragment(Node): nodeType = Node.DOCUMENT_FRAGMENT_NODE nodeName = "#document-fragment" nodeValue = None attributes = None parentNode = None _child_node_types = (Node.ELEMENT_NODE, Node.TEXT_NODE, Node.CDATA_SECTION_NODE, Node.ENTITY_REFERENCE_NODE, Node.PROCESSING_INSTRUCTION_NODE, Node.COMMENT_NODE, Node.NOTATION_NODE) def __init__(self): self.childNodes = NodeList() class Attr(Node): __slots__=('_name', '_value', 'namespaceURI', '_prefix', 'childNodes', '_localName', 'ownerDocument', 'ownerElement') nodeType = Node.ATTRIBUTE_NODE attributes = None specified = False _is_id = False _child_node_types = (Node.TEXT_NODE, Node.ENTITY_REFERENCE_NODE) def __init__(self, qName, namespaceURI=EMPTY_NAMESPACE, localName=None, prefix=None): self.ownerElement = None self._name = qName self.namespaceURI = namespaceURI self._prefix = prefix if localName is not None: self._localName = localName self.childNodes = NodeList() # Add the single child node that represents the value of the attr self.childNodes.append(Text()) # nodeValue and value are set elsewhere def _get_localName(self): try: return self._localName except AttributeError: return self.nodeName.split(":", 1)[-1] def _get_specified(self): return self.specified def _get_name(self): return self._name def _set_name(self, value): self._name = value if self.ownerElement is not None: _clear_id_cache(self.ownerElement) nodeName = name = property(_get_name, _set_name) def _get_value(self): return self._value def _set_value(self, value): self._value = value self.childNodes[0].data = value if self.ownerElement is not None: _clear_id_cache(self.ownerElement) self.childNodes[0].data = value nodeValue = value = property(_get_value, _set_value) def _get_prefix(self): return self._prefix def _set_prefix(self, prefix): nsuri = self.namespaceURI if prefix == "xmlns": if nsuri and nsuri != XMLNS_NAMESPACE: raise xml.dom.NamespaceErr( "illegal use of 'xmlns' prefix for the wrong namespace") self._prefix = prefix if prefix is None: newName = self.localName else: newName = "%s:%s" % (prefix, self.localName) if self.ownerElement: _clear_id_cache(self.ownerElement) self.name = newName prefix = property(_get_prefix, _set_prefix) def unlink(self): # This implementation does not call the base implementation # since most of that is not needed, and the expense of the # method call is not warranted. We duplicate the removal of # children, but that's all we needed from the base class. elem = self.ownerElement if elem is not None: del elem._attrs[self.nodeName] del elem._attrsNS[(self.namespaceURI, self.localName)] if self._is_id: self._is_id = False elem._magic_id_nodes -= 1 self.ownerDocument._magic_id_count -= 1 for child in self.childNodes: child.unlink() del self.childNodes[:] def _get_isId(self): if self._is_id: return True doc = self.ownerDocument elem = self.ownerElement if doc is None or elem is None: return False info = doc._get_elem_info(elem) if info is None: return False if self.namespaceURI: return info.isIdNS(self.namespaceURI, self.localName) else: return info.isId(self.nodeName) def _get_schemaType(self): doc = self.ownerDocument elem = self.ownerElement if doc is None or elem is None: return _no_type info = doc._get_elem_info(elem) if info is None: return _no_type if self.namespaceURI: return info.getAttributeTypeNS(self.namespaceURI, self.localName) else: return info.getAttributeType(self.nodeName) defproperty(Attr, "isId", doc="True if this attribute is an ID.") defproperty(Attr, "localName", doc="Namespace-local name of this attribute.") defproperty(Attr, "schemaType", doc="Schema type for this attribute.") class NamedNodeMap(object): """The attribute list is a transient interface to the underlying dictionaries. Mutations here will change the underlying element's dictionary. Ordering is imposed artificially and does not reflect the order of attributes as found in an input document. """ __slots__ = ('_attrs', '_attrsNS', '_ownerElement') def __init__(self, attrs, attrsNS, ownerElement): self._attrs = attrs self._attrsNS = attrsNS self._ownerElement = ownerElement def _get_length(self): return len(self._attrs) def item(self, index): try: return self[list(self._attrs.keys())[index]] except IndexError: return None def items(self): L = [] for node in self._attrs.values(): L.append((node.nodeName, node.value)) return L def itemsNS(self): L = [] for node in self._attrs.values(): L.append(((node.namespaceURI, node.localName), node.value)) return L def __contains__(self, key): if isinstance(key, str): return key in self._attrs else: return key in self._attrsNS def keys(self): return self._attrs.keys() def keysNS(self): return self._attrsNS.keys() def values(self): return self._attrs.values() def get(self, name, value=None): return self._attrs.get(name, value) __len__ = _get_length def _cmp(self, other): if self._attrs is getattr(other, "_attrs", None): return 0 else: return (id(self) > id(other)) - (id(self) < id(other)) def __eq__(self, other): return self._cmp(other) == 0 def __ge__(self, other): return self._cmp(other) >= 0 def __gt__(self, other): return self._cmp(other) > 0 def __le__(self, other): return self._cmp(other) <= 0 def __lt__(self, other): return self._cmp(other) < 0 def __getitem__(self, attname_or_tuple): if isinstance(attname_or_tuple, tuple): return self._attrsNS[attname_or_tuple] else: return self._attrs[attname_or_tuple] # same as set def __setitem__(self, attname, value): if isinstance(value, str): try: node = self._attrs[attname] except KeyError: node = Attr(attname) node.ownerDocument = self._ownerElement.ownerDocument self.setNamedItem(node) node.value = value else: if not isinstance(value, Attr): raise TypeError("value must be a string or Attr object") node = value self.setNamedItem(node) def getNamedItem(self, name): try: return self._attrs[name] except KeyError: return None def getNamedItemNS(self, namespaceURI, localName): try: return self._attrsNS[(namespaceURI, localName)] except KeyError: return None def removeNamedItem(self, name): n = self.getNamedItem(name) if n is not None: _clear_id_cache(self._ownerElement) del self._attrs[n.nodeName] del self._attrsNS[(n.namespaceURI, n.localName)] if hasattr(n, 'ownerElement'): n.ownerElement = None return n else: raise xml.dom.NotFoundErr() def removeNamedItemNS(self, namespaceURI, localName): n = self.getNamedItemNS(namespaceURI, localName) if n is not None: _clear_id_cache(self._ownerElement) del self._attrsNS[(n.namespaceURI, n.localName)] del self._attrs[n.nodeName] if hasattr(n, 'ownerElement'): n.ownerElement = None return n else: raise xml.dom.NotFoundErr() def setNamedItem(self, node): if not isinstance(node, Attr): raise xml.dom.HierarchyRequestErr( "%s cannot be child of %s" % (repr(node), repr(self))) old = self._attrs.get(node.name) if old: old.unlink() self._attrs[node.name] = node self._attrsNS[(node.namespaceURI, node.localName)] = node node.ownerElement = self._ownerElement _clear_id_cache(node.ownerElement) return old def setNamedItemNS(self, node): return self.setNamedItem(node) def __delitem__(self, attname_or_tuple): node = self[attname_or_tuple] _clear_id_cache(node.ownerElement) node.unlink() def __getstate__(self): return self._attrs, self._attrsNS, self._ownerElement def __setstate__(self, state): self._attrs, self._attrsNS, self._ownerElement = state defproperty(NamedNodeMap, "length", doc="Number of nodes in the NamedNodeMap.") AttributeList = NamedNodeMap class TypeInfo(object): __slots__ = 'namespace', 'name' def __init__(self, namespace, name): self.namespace = namespace self.name = name def __repr__(self): if self.namespace: return "<%s %r (from %r)>" % (self.__class__.__name__, self.name, self.namespace) else: return "<%s %r>" % (self.__class__.__name__, self.name) def _get_name(self): return self.name def _get_namespace(self): return self.namespace _no_type = TypeInfo(None, None) class Element(Node): __slots__=('ownerDocument', 'parentNode', 'tagName', 'nodeName', 'prefix', 'namespaceURI', '_localName', 'childNodes', '_attrs', '_attrsNS', 'nextSibling', 'previousSibling') nodeType = Node.ELEMENT_NODE nodeValue = None schemaType = _no_type _magic_id_nodes = 0 _child_node_types = (Node.ELEMENT_NODE, Node.PROCESSING_INSTRUCTION_NODE, Node.COMMENT_NODE, Node.TEXT_NODE, Node.CDATA_SECTION_NODE, Node.ENTITY_REFERENCE_NODE) def __init__(self, tagName, namespaceURI=EMPTY_NAMESPACE, prefix=None, localName=None): self.parentNode = None self.tagName = self.nodeName = tagName self.prefix = prefix self.namespaceURI = namespaceURI self.childNodes = NodeList() self.nextSibling = self.previousSibling = None # Attribute dictionaries are lazily created # attributes are double-indexed: # tagName -> Attribute # URI,localName -> Attribute # in the future: consider lazy generation # of attribute objects this is too tricky # for now because of headaches with # namespaces. self._attrs = None self._attrsNS = None def _ensure_attributes(self): if self._attrs is None: self._attrs = {} self._attrsNS = {} def _get_localName(self): try: return self._localName except AttributeError: return self.tagName.split(":", 1)[-1] def _get_tagName(self): return self.tagName def unlink(self): if self._attrs is not None: for attr in list(self._attrs.values()): attr.unlink() self._attrs = None self._attrsNS = None Node.unlink(self) def getAttribute(self, attname): """Returns the value of the specified attribute. Returns the value of the element's attribute named attname as a string. An empty string is returned if the element does not have such an attribute. Note that an empty string may also be returned as an explicitly given attribute value, use the hasAttribute method to distinguish these two cases. """ if self._attrs is None: return "" try: return self._attrs[attname].value except KeyError: return "" def getAttributeNS(self, namespaceURI, localName): if self._attrsNS is None: return "" try: return self._attrsNS[(namespaceURI, localName)].value except KeyError: return "" def setAttribute(self, attname, value): attr = self.getAttributeNode(attname) if attr is None: attr = Attr(attname) attr.value = value # also sets nodeValue attr.ownerDocument = self.ownerDocument self.setAttributeNode(attr) elif value != attr.value: attr.value = value if attr.isId: _clear_id_cache(self) def setAttributeNS(self, namespaceURI, qualifiedName, value): prefix, localname = _nssplit(qualifiedName) attr = self.getAttributeNodeNS(namespaceURI, localname) if attr is None: attr = Attr(qualifiedName, namespaceURI, localname, prefix) attr.value = value attr.ownerDocument = self.ownerDocument self.setAttributeNode(attr) else: if value != attr.value: attr.value = value if attr.isId: _clear_id_cache(self) if attr.prefix != prefix: attr.prefix = prefix attr.nodeName = qualifiedName def getAttributeNode(self, attrname): if self._attrs is None: return None return self._attrs.get(attrname) def getAttributeNodeNS(self, namespaceURI, localName): if self._attrsNS is None: return None return self._attrsNS.get((namespaceURI, localName)) def setAttributeNode(self, attr): if attr.ownerElement not in (None, self): raise xml.dom.InuseAttributeErr("attribute node already owned") self._ensure_attributes() old1 = self._attrs.get(attr.name, None) if old1 is not None: self.removeAttributeNode(old1) old2 = self._attrsNS.get((attr.namespaceURI, attr.localName), None) if old2 is not None and old2 is not old1: self.removeAttributeNode(old2) _set_attribute_node(self, attr) if old1 is not attr: # It might have already been part of this node, in which case # it doesn't represent a change, and should not be returned. return old1 if old2 is not attr: return old2 setAttributeNodeNS = setAttributeNode def removeAttribute(self, name): if self._attrsNS is None: raise xml.dom.NotFoundErr() try: attr = self._attrs[name] except KeyError: raise xml.dom.NotFoundErr() self.removeAttributeNode(attr) def removeAttributeNS(self, namespaceURI, localName): if self._attrsNS is None: raise xml.dom.NotFoundErr() try: attr = self._attrsNS[(namespaceURI, localName)] except KeyError: raise xml.dom.NotFoundErr() self.removeAttributeNode(attr) def removeAttributeNode(self, node): if node is None: raise xml.dom.NotFoundErr() try: self._attrs[node.name] except KeyError: raise xml.dom.NotFoundErr() _clear_id_cache(self) node.unlink() # Restore this since the node is still useful and otherwise # unlinked node.ownerDocument = self.ownerDocument return node removeAttributeNodeNS = removeAttributeNode def hasAttribute(self, name): """Checks whether the element has an attribute with the specified name. Returns True if the element has an attribute with the specified name. Otherwise, returns False. """ if self._attrs is None: return False return name in self._attrs def hasAttributeNS(self, namespaceURI, localName): if self._attrsNS is None: return False return (namespaceURI, localName) in self._attrsNS def getElementsByTagName(self, name): """Returns all descendant elements with the given tag name. Returns the list of all descendant elements (not direct children only) with the specified tag name. """ return _get_elements_by_tagName_helper(self, name, NodeList()) def getElementsByTagNameNS(self, namespaceURI, localName): return _get_elements_by_tagName_ns_helper( self, namespaceURI, localName, NodeList()) def __repr__(self): return "<DOM Element: %s at %#x>" % (self.tagName, id(self)) def writexml(self, writer, indent="", addindent="", newl=""): """Write an XML element to a file-like object Write the element to the writer object that must provide a write method (e.g. a file or StringIO object). """ # indent = current indentation # addindent = indentation to add to higher levels # newl = newline string writer.write(indent+"<" + self.tagName) attrs = self._get_attributes() for a_name in attrs.keys(): writer.write(" %s=\"" % a_name) _write_data(writer, attrs[a_name].value) writer.write("\"") if self.childNodes: writer.write(">") if (len(self.childNodes) == 1 and self.childNodes[0].nodeType in ( Node.TEXT_NODE, Node.CDATA_SECTION_NODE)): self.childNodes[0].writexml(writer, '', '', '') else: writer.write(newl) for node in self.childNodes: node.writexml(writer, indent+addindent, addindent, newl) writer.write(indent) writer.write("</%s>%s" % (self.tagName, newl)) else: writer.write("/>%s"%(newl)) def _get_attributes(self): self._ensure_attributes() return NamedNodeMap(self._attrs, self._attrsNS, self) def hasAttributes(self): if self._attrs: return True else: return False # DOM Level 3 attributes, based on the 22 Oct 2002 draft def setIdAttribute(self, name): idAttr = self.getAttributeNode(name) self.setIdAttributeNode(idAttr) def setIdAttributeNS(self, namespaceURI, localName): idAttr = self.getAttributeNodeNS(namespaceURI, localName) self.setIdAttributeNode(idAttr) def setIdAttributeNode(self, idAttr): if idAttr is None or not self.isSameNode(idAttr.ownerElement): raise xml.dom.NotFoundErr() if _get_containing_entref(self) is not None: raise xml.dom.NoModificationAllowedErr() if not idAttr._is_id: idAttr._is_id = True self._magic_id_nodes += 1 self.ownerDocument._magic_id_count += 1 _clear_id_cache(self) defproperty(Element, "attributes", doc="NamedNodeMap of attributes on the element.") defproperty(Element, "localName", doc="Namespace-local name of this element.") def _set_attribute_node(element, attr): _clear_id_cache(element) element._ensure_attributes() element._attrs[attr.name] = attr element._attrsNS[(attr.namespaceURI, attr.localName)] = attr # This creates a circular reference, but Element.unlink() # breaks the cycle since the references to the attribute # dictionaries are tossed. attr.ownerElement = element class Childless: """Mixin that makes childless-ness easy to implement and avoids the complexity of the Node methods that deal with children. """ __slots__ = () attributes = None childNodes = EmptyNodeList() firstChild = None lastChild = None def _get_firstChild(self): return None def _get_lastChild(self): return None def appendChild(self, node): raise xml.dom.HierarchyRequestErr( self.nodeName + " nodes cannot have children") def hasChildNodes(self): return False def insertBefore(self, newChild, refChild): raise xml.dom.HierarchyRequestErr( self.nodeName + " nodes do not have children") def removeChild(self, oldChild): raise xml.dom.NotFoundErr( self.nodeName + " nodes do not have children") def normalize(self): # For childless nodes, normalize() has nothing to do. pass def replaceChild(self, newChild, oldChild): raise xml.dom.HierarchyRequestErr( self.nodeName + " nodes do not have children") class ProcessingInstruction(Childless, Node): nodeType = Node.PROCESSING_INSTRUCTION_NODE __slots__ = ('target', 'data') def __init__(self, target, data): self.target = target self.data = data # nodeValue is an alias for data def _get_nodeValue(self): return self.data def _set_nodeValue(self, value): self.data = value nodeValue = property(_get_nodeValue, _set_nodeValue) # nodeName is an alias for target def _get_nodeName(self): return self.target def _set_nodeName(self, value): self.target = value nodeName = property(_get_nodeName, _set_nodeName) def writexml(self, writer, indent="", addindent="", newl=""): writer.write("%s<?%s %s?>%s" % (indent,self.target, self.data, newl)) class CharacterData(Childless, Node): __slots__=('_data', 'ownerDocument','parentNode', 'previousSibling', 'nextSibling') def __init__(self): self.ownerDocument = self.parentNode = None self.previousSibling = self.nextSibling = None self._data = '' Node.__init__(self) def _get_length(self): return len(self.data) __len__ = _get_length def _get_data(self): return self._data def _set_data(self, data): self._data = data data = nodeValue = property(_get_data, _set_data) def __repr__(self): data = self.data if len(data) > 10: dotdotdot = "..." else: dotdotdot = "" return '<DOM %s node "%r%s">' % ( self.__class__.__name__, data[0:10], dotdotdot) def substringData(self, offset, count): if offset < 0: raise xml.dom.IndexSizeErr("offset cannot be negative") if offset >= len(self.data): raise xml.dom.IndexSizeErr("offset cannot be beyond end of data") if count < 0: raise xml.dom.IndexSizeErr("count cannot be negative") return self.data[offset:offset+count] def appendData(self, arg): self.data = self.data + arg def insertData(self, offset, arg): if offset < 0: raise xml.dom.IndexSizeErr("offset cannot be negative") if offset >= len(self.data): raise xml.dom.IndexSizeErr("offset cannot be beyond end of data") if arg: self.data = "%s%s%s" % ( self.data[:offset], arg, self.data[offset:]) def deleteData(self, offset, count): if offset < 0: raise xml.dom.IndexSizeErr("offset cannot be negative") if offset >= len(self.data): raise xml.dom.IndexSizeErr("offset cannot be beyond end of data") if count < 0: raise xml.dom.IndexSizeErr("count cannot be negative") if count: self.data = self.data[:offset] + self.data[offset+count:] def replaceData(self, offset, count, arg): if offset < 0: raise xml.dom.IndexSizeErr("offset cannot be negative") if offset >= len(self.data): raise xml.dom.IndexSizeErr("offset cannot be beyond end of data") if count < 0: raise xml.dom.IndexSizeErr("count cannot be negative") if count: self.data = "%s%s%s" % ( self.data[:offset], arg, self.data[offset+count:]) defproperty(CharacterData, "length", doc="Length of the string data.") class Text(CharacterData): __slots__ = () nodeType = Node.TEXT_NODE nodeName = "#text" attributes = None def splitText(self, offset): if offset < 0 or offset > len(self.data): raise xml.dom.IndexSizeErr("illegal offset value") newText = self.__class__() newText.data = self.data[offset:] newText.ownerDocument = self.ownerDocument next = self.nextSibling if self.parentNode and self in self.parentNode.childNodes: if next is None: self.parentNode.appendChild(newText) else: self.parentNode.insertBefore(newText, next) self.data = self.data[:offset] return newText def writexml(self, writer, indent="", addindent="", newl=""): _write_data(writer, "%s%s%s" % (indent, self.data, newl)) # DOM Level 3 (WD 9 April 2002) def _get_wholeText(self): L = [self.data] n = self.previousSibling while n is not None: if n.nodeType in (Node.TEXT_NODE, Node.CDATA_SECTION_NODE): L.insert(0, n.data) n = n.previousSibling else: break n = self.nextSibling while n is not None: if n.nodeType in (Node.TEXT_NODE, Node.CDATA_SECTION_NODE): L.append(n.data) n = n.nextSibling else: break return ''.join(L) def replaceWholeText(self, content): # XXX This needs to be seriously changed if minidom ever # supports EntityReference nodes. parent = self.parentNode n = self.previousSibling while n is not None: if n.nodeType in (Node.TEXT_NODE, Node.CDATA_SECTION_NODE): next = n.previousSibling parent.removeChild(n) n = next else: break n = self.nextSibling if not content: parent.removeChild(self) while n is not None: if n.nodeType in (Node.TEXT_NODE, Node.CDATA_SECTION_NODE): next = n.nextSibling parent.removeChild(n) n = next else: break if content: self.data = content return self else: return None def _get_isWhitespaceInElementContent(self): if self.data.strip(): return False elem = _get_containing_element(self) if elem is None: return False info = self.ownerDocument._get_elem_info(elem) if info is None: return False else: return info.isElementContent() defproperty(Text, "isWhitespaceInElementContent", doc="True iff this text node contains only whitespace" " and is in element content.") defproperty(Text, "wholeText", doc="The text of all logically-adjacent text nodes.") def _get_containing_element(node): c = node.parentNode while c is not None: if c.nodeType == Node.ELEMENT_NODE: return c c = c.parentNode return None def _get_containing_entref(node): c = node.parentNode while c is not None: if c.nodeType == Node.ENTITY_REFERENCE_NODE: return c c = c.parentNode return None class Comment(CharacterData): nodeType = Node.COMMENT_NODE nodeName = "#comment" def __init__(self, data): CharacterData.__init__(self) self._data = data def writexml(self, writer, indent="", addindent="", newl=""): if "--" in self.data: raise ValueError("'--' is not allowed in a comment node") writer.write("%s<!--%s-->%s" % (indent, self.data, newl)) class CDATASection(Text): __slots__ = () nodeType = Node.CDATA_SECTION_NODE nodeName = "#cdata-section" def writexml(self, writer, indent="", addindent="", newl=""): if self.data.find("]]>") >= 0: raise ValueError("']]>' not allowed in a CDATA section") writer.write("<![CDATA[%s]]>" % self.data) class ReadOnlySequentialNamedNodeMap(object): __slots__ = '_seq', def __init__(self, seq=()): # seq should be a list or tuple self._seq = seq def __len__(self): return len(self._seq) def _get_length(self): return len(self._seq) def getNamedItem(self, name): for n in self._seq: if n.nodeName == name: return n def getNamedItemNS(self, namespaceURI, localName): for n in self._seq: if n.namespaceURI == namespaceURI and n.localName == localName: return n def __getitem__(self, name_or_tuple): if isinstance(name_or_tuple, tuple): node = self.getNamedItemNS(*name_or_tuple) else: node = self.getNamedItem(name_or_tuple) if node is None: raise KeyError(name_or_tuple) return node def item(self, index): if index < 0: return None try: return self._seq[index] except IndexError: return None def removeNamedItem(self, name): raise xml.dom.NoModificationAllowedErr( "NamedNodeMap instance is read-only") def removeNamedItemNS(self, namespaceURI, localName): raise xml.dom.NoModificationAllowedErr( "NamedNodeMap instance is read-only") def setNamedItem(self, node): raise xml.dom.NoModificationAllowedErr( "NamedNodeMap instance is read-only") def setNamedItemNS(self, node): raise xml.dom.NoModificationAllowedErr( "NamedNodeMap instance is read-only") def __getstate__(self): return [self._seq] def __setstate__(self, state): self._seq = state[0] defproperty(ReadOnlySequentialNamedNodeMap, "length", doc="Number of entries in the NamedNodeMap.") class Identified: """Mix-in class that supports the publicId and systemId attributes.""" __slots__ = 'publicId', 'systemId' def _identified_mixin_init(self, publicId, systemId): self.publicId = publicId self.systemId = systemId def _get_publicId(self): return self.publicId def _get_systemId(self): return self.systemId class DocumentType(Identified, Childless, Node): nodeType = Node.DOCUMENT_TYPE_NODE nodeValue = None name = None publicId = None systemId = None internalSubset = None def __init__(self, qualifiedName): self.entities = ReadOnlySequentialNamedNodeMap() self.notations = ReadOnlySequentialNamedNodeMap() if qualifiedName: prefix, localname = _nssplit(qualifiedName) self.name = localname self.nodeName = self.name def _get_internalSubset(self): return self.internalSubset def cloneNode(self, deep): if self.ownerDocument is None: # it's ok clone = DocumentType(None) clone.name = self.name clone.nodeName = self.name operation = xml.dom.UserDataHandler.NODE_CLONED if deep: clone.entities._seq = [] clone.notations._seq = [] for n in self.notations._seq: notation = Notation(n.nodeName, n.publicId, n.systemId) clone.notations._seq.append(notation) n._call_user_data_handler(operation, n, notation) for e in self.entities._seq: entity = Entity(e.nodeName, e.publicId, e.systemId, e.notationName) entity.actualEncoding = e.actualEncoding entity.encoding = e.encoding entity.version = e.version clone.entities._seq.append(entity) e._call_user_data_handler(operation, e, entity) self._call_user_data_handler(operation, self, clone) return clone else: return None def writexml(self, writer, indent="", addindent="", newl=""): writer.write("<!DOCTYPE ") writer.write(self.name) if self.publicId: writer.write("%s PUBLIC '%s'%s '%s'" % (newl, self.publicId, newl, self.systemId)) elif self.systemId: writer.write("%s SYSTEM '%s'" % (newl, self.systemId)) if self.internalSubset is not None: writer.write(" [") writer.write(self.internalSubset) writer.write("]") writer.write(">"+newl) class Entity(Identified, Node): attributes = None nodeType = Node.ENTITY_NODE nodeValue = None actualEncoding = None encoding = None version = None def __init__(self, name, publicId, systemId, notation): self.nodeName = name self.notationName = notation self.childNodes = NodeList() self._identified_mixin_init(publicId, systemId) def _get_actualEncoding(self): return self.actualEncoding def _get_encoding(self): return self.encoding def _get_version(self): return self.version def appendChild(self, newChild): raise xml.dom.HierarchyRequestErr( "cannot append children to an entity node") def insertBefore(self, newChild, refChild): raise xml.dom.HierarchyRequestErr( "cannot insert children below an entity node") def removeChild(self, oldChild): raise xml.dom.HierarchyRequestErr( "cannot remove children from an entity node") def replaceChild(self, newChild, oldChild): raise xml.dom.HierarchyRequestErr( "cannot replace children of an entity node") class Notation(Identified, Childless, Node): nodeType = Node.NOTATION_NODE nodeValue = None def __init__(self, name, publicId, systemId): self.nodeName = name self._identified_mixin_init(publicId, systemId) class DOMImplementation(DOMImplementationLS): _features = [("core", "1.0"), ("core", "2.0"), ("core", None), ("xml", "1.0"), ("xml", "2.0"), ("xml", None), ("ls-load", "3.0"), ("ls-load", None), ] def hasFeature(self, feature, version): if version == "": version = None return (feature.lower(), version) in self._features def createDocument(self, namespaceURI, qualifiedName, doctype): if doctype and doctype.parentNode is not None: raise xml.dom.WrongDocumentErr( "doctype object owned by another DOM tree") doc = self._create_document() add_root_element = not (namespaceURI is None and qualifiedName is None and doctype is None) if not qualifiedName and add_root_element: # The spec is unclear what to raise here; SyntaxErr # would be the other obvious candidate. Since Xerces raises # InvalidCharacterErr, and since SyntaxErr is not listed # for createDocument, that seems to be the better choice. # XXX: need to check for illegal characters here and in # createElement. # DOM Level III clears this up when talking about the return value # of this function. If namespaceURI, qName and DocType are # Null the document is returned without a document element # Otherwise if doctype or namespaceURI are not None # Then we go back to the above problem raise xml.dom.InvalidCharacterErr("Element with no name") if add_root_element: prefix, localname = _nssplit(qualifiedName) if prefix == "xml" \ and namespaceURI != "http://www.w3.org/XML/1998/namespace": raise xml.dom.NamespaceErr("illegal use of 'xml' prefix") if prefix and not namespaceURI: raise xml.dom.NamespaceErr( "illegal use of prefix without namespaces") element = doc.createElementNS(namespaceURI, qualifiedName) if doctype: doc.appendChild(doctype) doc.appendChild(element) if doctype: doctype.parentNode = doctype.ownerDocument = doc doc.doctype = doctype doc.implementation = self return doc def createDocumentType(self, qualifiedName, publicId, systemId): doctype = DocumentType(qualifiedName) doctype.publicId = publicId doctype.systemId = systemId return doctype # DOM Level 3 (WD 9 April 2002) def getInterface(self, feature): if self.hasFeature(feature, None): return self else: return None # internal def _create_document(self): return Document() class ElementInfo(object): """Object that represents content-model information for an element. This implementation is not expected to be used in practice; DOM builders should provide implementations which do the right thing using information available to it. """ __slots__ = 'tagName', def __init__(self, name): self.tagName = name def getAttributeType(self, aname): return _no_type def getAttributeTypeNS(self, namespaceURI, localName): return _no_type def isElementContent(self): return False def isEmpty(self): """Returns true iff this element is declared to have an EMPTY content model.""" return False def isId(self, aname): """Returns true iff the named attribute is a DTD-style ID.""" return False def isIdNS(self, namespaceURI, localName): """Returns true iff the identified attribute is a DTD-style ID.""" return False def __getstate__(self): return self.tagName def __setstate__(self, state): self.tagName = state def _clear_id_cache(node): if node.nodeType == Node.DOCUMENT_NODE: node._id_cache.clear() node._id_search_stack = None elif _in_document(node): node.ownerDocument._id_cache.clear() node.ownerDocument._id_search_stack= None class Document(Node, DocumentLS): __slots__ = ('_elem_info', 'doctype', '_id_search_stack', 'childNodes', '_id_cache') _child_node_types = (Node.ELEMENT_NODE, Node.PROCESSING_INSTRUCTION_NODE, Node.COMMENT_NODE, Node.DOCUMENT_TYPE_NODE) implementation = DOMImplementation() nodeType = Node.DOCUMENT_NODE nodeName = "#document" nodeValue = None attributes = None parentNode = None previousSibling = nextSibling = None # Document attributes from Level 3 (WD 9 April 2002) actualEncoding = None encoding = None standalone = None version = None strictErrorChecking = False errorHandler = None documentURI = None _magic_id_count = 0 def __init__(self): self.doctype = None self.childNodes = NodeList() # mapping of (namespaceURI, localName) -> ElementInfo # and tagName -> ElementInfo self._elem_info = {} self._id_cache = {} self._id_search_stack = None def _get_elem_info(self, element): if element.namespaceURI: key = element.namespaceURI, element.localName else: key = element.tagName return self._elem_info.get(key) def _get_actualEncoding(self): return self.actualEncoding def _get_doctype(self): return self.doctype def _get_documentURI(self): return self.documentURI def _get_encoding(self): return self.encoding def _get_errorHandler(self): return self.errorHandler def _get_standalone(self): return self.standalone def _get_strictErrorChecking(self): return self.strictErrorChecking def _get_version(self): return self.version def appendChild(self, node): if node.nodeType not in self._child_node_types: raise xml.dom.HierarchyRequestErr( "%s cannot be child of %s" % (repr(node), repr(self))) if node.parentNode is not None: # This needs to be done before the next test since this # may *be* the document element, in which case it should # end up re-ordered to the end. node.parentNode.removeChild(node) if node.nodeType == Node.ELEMENT_NODE \ and self._get_documentElement(): raise xml.dom.HierarchyRequestErr( "two document elements disallowed") return Node.appendChild(self, node) def removeChild(self, oldChild): try: self.childNodes.remove(oldChild) except ValueError: raise xml.dom.NotFoundErr() oldChild.nextSibling = oldChild.previousSibling = None oldChild.parentNode = None if self.documentElement is oldChild: self.documentElement = None return oldChild def _get_documentElement(self): for node in self.childNodes: if node.nodeType == Node.ELEMENT_NODE: return node def unlink(self): if self.doctype is not None: self.doctype.unlink() self.doctype = None Node.unlink(self) def cloneNode(self, deep): if not deep: return None clone = self.implementation.createDocument(None, None, None) clone.encoding = self.encoding clone.standalone = self.standalone clone.version = self.version for n in self.childNodes: childclone = _clone_node(n, deep, clone) assert childclone.ownerDocument.isSameNode(clone) clone.childNodes.append(childclone) if childclone.nodeType == Node.DOCUMENT_NODE: assert clone.documentElement is None elif childclone.nodeType == Node.DOCUMENT_TYPE_NODE: assert clone.doctype is None clone.doctype = childclone childclone.parentNode = clone self._call_user_data_handler(xml.dom.UserDataHandler.NODE_CLONED, self, clone) return clone def createDocumentFragment(self): d = DocumentFragment() d.ownerDocument = self return d def createElement(self, tagName): e = Element(tagName) e.ownerDocument = self return e def createTextNode(self, data): if not isinstance(data, str): raise TypeError("node contents must be a string") t = Text() t.data = data t.ownerDocument = self return t def createCDATASection(self, data): if not isinstance(data, str): raise TypeError("node contents must be a string") c = CDATASection() c.data = data c.ownerDocument = self return c def createComment(self, data): c = Comment(data) c.ownerDocument = self return c def createProcessingInstruction(self, target, data): p = ProcessingInstruction(target, data) p.ownerDocument = self return p def createAttribute(self, qName): a = Attr(qName) a.ownerDocument = self a.value = "" return a def createElementNS(self, namespaceURI, qualifiedName): prefix, localName = _nssplit(qualifiedName) e = Element(qualifiedName, namespaceURI, prefix) e.ownerDocument = self return e def createAttributeNS(self, namespaceURI, qualifiedName): prefix, localName = _nssplit(qualifiedName) a = Attr(qualifiedName, namespaceURI, localName, prefix) a.ownerDocument = self a.value = "" return a # A couple of implementation-specific helpers to create node types # not supported by the W3C DOM specs: def _create_entity(self, name, publicId, systemId, notationName): e = Entity(name, publicId, systemId, notationName) e.ownerDocument = self return e def _create_notation(self, name, publicId, systemId): n = Notation(name, publicId, systemId) n.ownerDocument = self return n def getElementById(self, id): if id in self._id_cache: return self._id_cache[id] if not (self._elem_info or self._magic_id_count): return None stack = self._id_search_stack if stack is None: # we never searched before, or the cache has been cleared stack = [self.documentElement] self._id_search_stack = stack elif not stack: # Previous search was completed and cache is still valid; # no matching node. return None result = None while stack: node = stack.pop() # add child elements to stack for continued searching stack.extend([child for child in node.childNodes if child.nodeType in _nodeTypes_with_children]) # check this node info = self._get_elem_info(node) if info: # We have to process all ID attributes before # returning in order to get all the attributes set to # be IDs using Element.setIdAttribute*(). for attr in node.attributes.values(): if attr.namespaceURI: if info.isIdNS(attr.namespaceURI, attr.localName): self._id_cache[attr.value] = node if attr.value == id: result = node elif not node._magic_id_nodes: break elif info.isId(attr.name): self._id_cache[attr.value] = node if attr.value == id: result = node elif not node._magic_id_nodes: break elif attr._is_id: self._id_cache[attr.value] = node if attr.value == id: result = node elif node._magic_id_nodes == 1: break elif node._magic_id_nodes: for attr in node.attributes.values(): if attr._is_id: self._id_cache[attr.value] = node if attr.value == id: result = node if result is not None: break return result def getElementsByTagName(self, name): return _get_elements_by_tagName_helper(self, name, NodeList()) def getElementsByTagNameNS(self, namespaceURI, localName): return _get_elements_by_tagName_ns_helper( self, namespaceURI, localName, NodeList()) def isSupported(self, feature, version): return self.implementation.hasFeature(feature, version) def importNode(self, node, deep): if node.nodeType == Node.DOCUMENT_NODE: raise xml.dom.NotSupportedErr("cannot import document nodes") elif node.nodeType == Node.DOCUMENT_TYPE_NODE: raise xml.dom.NotSupportedErr("cannot import document type nodes") return _clone_node(node, deep, self) def writexml(self, writer, indent="", addindent="", newl="", encoding=None, standalone=None): declarations = [] if encoding: declarations.append(f'encoding="{encoding}"') if standalone is not None: declarations.append(f'standalone="{"yes" if standalone else "no"}"') writer.write(f'<?xml version="1.0" {" ".join(declarations)}?>{newl}') for node in self.childNodes: node.writexml(writer, indent, addindent, newl) # DOM Level 3 (WD 9 April 2002) def renameNode(self, n, namespaceURI, name): if n.ownerDocument is not self: raise xml.dom.WrongDocumentErr( "cannot rename nodes from other documents;\n" "expected %s,\nfound %s" % (self, n.ownerDocument)) if n.nodeType not in (Node.ELEMENT_NODE, Node.ATTRIBUTE_NODE): raise xml.dom.NotSupportedErr( "renameNode() only applies to element and attribute nodes") if namespaceURI != EMPTY_NAMESPACE: if ':' in name: prefix, localName = name.split(':', 1) if ( prefix == "xmlns" and namespaceURI != xml.dom.XMLNS_NAMESPACE): raise xml.dom.NamespaceErr( "illegal use of 'xmlns' prefix") else: if ( name == "xmlns" and namespaceURI != xml.dom.XMLNS_NAMESPACE and n.nodeType == Node.ATTRIBUTE_NODE): raise xml.dom.NamespaceErr( "illegal use of the 'xmlns' attribute") prefix = None localName = name else: prefix = None localName = None if n.nodeType == Node.ATTRIBUTE_NODE: element = n.ownerElement if element is not None: is_id = n._is_id element.removeAttributeNode(n) else: element = None n.prefix = prefix n._localName = localName n.namespaceURI = namespaceURI n.nodeName = name if n.nodeType == Node.ELEMENT_NODE: n.tagName = name else: # attribute node n.name = name if element is not None: element.setAttributeNode(n) if is_id: element.setIdAttributeNode(n) # It's not clear from a semantic perspective whether we should # call the user data handlers for the NODE_RENAMED event since # we're re-using the existing node. The draft spec has been # interpreted as meaning "no, don't call the handler unless a # new node is created." return n defproperty(Document, "documentElement", doc="Top-level element of this document.") def _clone_node(node, deep, newOwnerDocument): """ Clone a node and give it the new owner document. Called by Node.cloneNode and Document.importNode """ if node.ownerDocument.isSameNode(newOwnerDocument): operation = xml.dom.UserDataHandler.NODE_CLONED else: operation = xml.dom.UserDataHandler.NODE_IMPORTED if node.nodeType == Node.ELEMENT_NODE: clone = newOwnerDocument.createElementNS(node.namespaceURI, node.nodeName) for attr in node.attributes.values(): clone.setAttributeNS(attr.namespaceURI, attr.nodeName, attr.value) a = clone.getAttributeNodeNS(attr.namespaceURI, attr.localName) a.specified = attr.specified if deep: for child in node.childNodes: c = _clone_node(child, deep, newOwnerDocument) clone.appendChild(c) elif node.nodeType == Node.DOCUMENT_FRAGMENT_NODE: clone = newOwnerDocument.createDocumentFragment() if deep: for child in node.childNodes: c = _clone_node(child, deep, newOwnerDocument) clone.appendChild(c) elif node.nodeType == Node.TEXT_NODE: clone = newOwnerDocument.createTextNode(node.data) elif node.nodeType == Node.CDATA_SECTION_NODE: clone = newOwnerDocument.createCDATASection(node.data) elif node.nodeType == Node.PROCESSING_INSTRUCTION_NODE: clone = newOwnerDocument.createProcessingInstruction(node.target, node.data) elif node.nodeType == Node.COMMENT_NODE: clone = newOwnerDocument.createComment(node.data) elif node.nodeType == Node.ATTRIBUTE_NODE: clone = newOwnerDocument.createAttributeNS(node.namespaceURI, node.nodeName) clone.specified = True clone.value = node.value elif node.nodeType == Node.DOCUMENT_TYPE_NODE: assert node.ownerDocument is not newOwnerDocument operation = xml.dom.UserDataHandler.NODE_IMPORTED clone = newOwnerDocument.implementation.createDocumentType( node.name, node.publicId, node.systemId) clone.ownerDocument = newOwnerDocument if deep: clone.entities._seq = [] clone.notations._seq = [] for n in node.notations._seq: notation = Notation(n.nodeName, n.publicId, n.systemId) notation.ownerDocument = newOwnerDocument clone.notations._seq.append(notation) if hasattr(n, '_call_user_data_handler'): n._call_user_data_handler(operation, n, notation) for e in node.entities._seq: entity = Entity(e.nodeName, e.publicId, e.systemId, e.notationName) entity.actualEncoding = e.actualEncoding entity.encoding = e.encoding entity.version = e.version entity.ownerDocument = newOwnerDocument clone.entities._seq.append(entity) if hasattr(e, '_call_user_data_handler'): e._call_user_data_handler(operation, e, entity) else: # Note the cloning of Document and DocumentType nodes is # implementation specific. minidom handles those cases # directly in the cloneNode() methods. raise xml.dom.NotSupportedErr("Cannot clone node %s" % repr(node)) # Check for _call_user_data_handler() since this could conceivably # used with other DOM implementations (one of the FourThought # DOMs, perhaps?). if hasattr(node, '_call_user_data_handler'): node._call_user_data_handler(operation, node, clone) return clone def _nssplit(qualifiedName): fields = qualifiedName.split(':', 1) if len(fields) == 2: return fields else: return (None, fields[0]) def _do_pulldom_parse(func, args, kwargs): events = func(*args, **kwargs) toktype, rootNode = events.getEvent() events.expandNode(rootNode) events.clear() return rootNode def parse(file, parser=None, bufsize=None): """Parse a file into a DOM by filename or file object.""" if parser is None and not bufsize: from xml.dom import expatbuilder return expatbuilder.parse(file) else: from xml.dom import pulldom return _do_pulldom_parse(pulldom.parse, (file,), {'parser': parser, 'bufsize': bufsize}) def parseString(string, parser=None): """Parse a file into a DOM from a string.""" if parser is None: from xml.dom import expatbuilder return expatbuilder.parseString(string) else: from xml.dom import pulldom return _do_pulldom_parse(pulldom.parseString, (string,), {'parser': parser}) def getDOMImplementation(features=None): if features: if isinstance(features, str): features = domreg._parse_feature_string(features) for f, v in features: if not Document.implementation.hasFeature(f, v): return None return Document.implementation dom/minicompat.py 0000644 00000006447 15027446000 0010046 0 ustar 00 """Python version compatibility support for minidom. This module contains internal implementation details and should not be imported; use xml.dom.minidom instead. """ # This module should only be imported using "import *". # # The following names are defined: # # NodeList -- lightest possible NodeList implementation # # EmptyNodeList -- lightest possible NodeList that is guaranteed to # remain empty (immutable) # # StringTypes -- tuple of defined string types # # defproperty -- function used in conjunction with GetattrMagic; # using these together is needed to make them work # as efficiently as possible in both Python 2.2+ # and older versions. For example: # # class MyClass(GetattrMagic): # def _get_myattr(self): # return something # # defproperty(MyClass, "myattr", # "return some value") # # For Python 2.2 and newer, this will construct a # property object on the class, which avoids # needing to override __getattr__(). It will only # work for read-only attributes. # # For older versions of Python, inheriting from # GetattrMagic will use the traditional # __getattr__() hackery to achieve the same effect, # but less efficiently. # # defproperty() should be used for each version of # the relevant _get_<property>() function. __all__ = ["NodeList", "EmptyNodeList", "StringTypes", "defproperty"] import xml.dom StringTypes = (str,) class NodeList(list): __slots__ = () def item(self, index): if 0 <= index < len(self): return self[index] def _get_length(self): return len(self) def _set_length(self, value): raise xml.dom.NoModificationAllowedErr( "attempt to modify read-only attribute 'length'") length = property(_get_length, _set_length, doc="The number of nodes in the NodeList.") # For backward compatibility def __setstate__(self, state): if state is None: state = [] self[:] = state class EmptyNodeList(tuple): __slots__ = () def __add__(self, other): NL = NodeList() NL.extend(other) return NL def __radd__(self, other): NL = NodeList() NL.extend(other) return NL def item(self, index): return None def _get_length(self): return 0 def _set_length(self, value): raise xml.dom.NoModificationAllowedErr( "attempt to modify read-only attribute 'length'") length = property(_get_length, _set_length, doc="The number of nodes in the NodeList.") def defproperty(klass, name, doc): get = getattr(klass, ("_get_" + name)) def set(self, value, name=name): raise xml.dom.NoModificationAllowedErr( "attempt to modify read-only attribute " + repr(name)) assert not hasattr(klass, "_set_" + name), \ "expected not to find _set_" + name prop = property(get, set, doc=doc) setattr(klass, name, prop) dom/xmlbuilder.py 0000644 00000030143 15027446000 0010043 0 ustar 00 """Implementation of the DOM Level 3 'LS-Load' feature.""" import copy import xml.dom from xml.dom.NodeFilter import NodeFilter __all__ = ["DOMBuilder", "DOMEntityResolver", "DOMInputSource"] class Options: """Features object that has variables set for each DOMBuilder feature. The DOMBuilder class uses an instance of this class to pass settings to the ExpatBuilder class. """ # Note that the DOMBuilder class in LoadSave constrains which of these # values can be set using the DOM Level 3 LoadSave feature. namespaces = 1 namespace_declarations = True validation = False external_parameter_entities = True external_general_entities = True external_dtd_subset = True validate_if_schema = False validate = False datatype_normalization = False create_entity_ref_nodes = True entities = True whitespace_in_element_content = True cdata_sections = True comments = True charset_overrides_xml_encoding = True infoset = False supported_mediatypes_only = False errorHandler = None filter = None class DOMBuilder: entityResolver = None errorHandler = None filter = None ACTION_REPLACE = 1 ACTION_APPEND_AS_CHILDREN = 2 ACTION_INSERT_AFTER = 3 ACTION_INSERT_BEFORE = 4 _legal_actions = (ACTION_REPLACE, ACTION_APPEND_AS_CHILDREN, ACTION_INSERT_AFTER, ACTION_INSERT_BEFORE) def __init__(self): self._options = Options() def _get_entityResolver(self): return self.entityResolver def _set_entityResolver(self, entityResolver): self.entityResolver = entityResolver def _get_errorHandler(self): return self.errorHandler def _set_errorHandler(self, errorHandler): self.errorHandler = errorHandler def _get_filter(self): return self.filter def _set_filter(self, filter): self.filter = filter def setFeature(self, name, state): if self.supportsFeature(name): state = state and 1 or 0 try: settings = self._settings[(_name_xform(name), state)] except KeyError: raise xml.dom.NotSupportedErr( "unsupported feature: %r" % (name,)) from None else: for name, value in settings: setattr(self._options, name, value) else: raise xml.dom.NotFoundErr("unknown feature: " + repr(name)) def supportsFeature(self, name): return hasattr(self._options, _name_xform(name)) def canSetFeature(self, name, state): key = (_name_xform(name), state and 1 or 0) return key in self._settings # This dictionary maps from (feature,value) to a list of # (option,value) pairs that should be set on the Options object. # If a (feature,value) setting is not in this dictionary, it is # not supported by the DOMBuilder. # _settings = { ("namespace_declarations", 0): [ ("namespace_declarations", 0)], ("namespace_declarations", 1): [ ("namespace_declarations", 1)], ("validation", 0): [ ("validation", 0)], ("external_general_entities", 0): [ ("external_general_entities", 0)], ("external_general_entities", 1): [ ("external_general_entities", 1)], ("external_parameter_entities", 0): [ ("external_parameter_entities", 0)], ("external_parameter_entities", 1): [ ("external_parameter_entities", 1)], ("validate_if_schema", 0): [ ("validate_if_schema", 0)], ("create_entity_ref_nodes", 0): [ ("create_entity_ref_nodes", 0)], ("create_entity_ref_nodes", 1): [ ("create_entity_ref_nodes", 1)], ("entities", 0): [ ("create_entity_ref_nodes", 0), ("entities", 0)], ("entities", 1): [ ("entities", 1)], ("whitespace_in_element_content", 0): [ ("whitespace_in_element_content", 0)], ("whitespace_in_element_content", 1): [ ("whitespace_in_element_content", 1)], ("cdata_sections", 0): [ ("cdata_sections", 0)], ("cdata_sections", 1): [ ("cdata_sections", 1)], ("comments", 0): [ ("comments", 0)], ("comments", 1): [ ("comments", 1)], ("charset_overrides_xml_encoding", 0): [ ("charset_overrides_xml_encoding", 0)], ("charset_overrides_xml_encoding", 1): [ ("charset_overrides_xml_encoding", 1)], ("infoset", 0): [], ("infoset", 1): [ ("namespace_declarations", 0), ("validate_if_schema", 0), ("create_entity_ref_nodes", 0), ("entities", 0), ("cdata_sections", 0), ("datatype_normalization", 1), ("whitespace_in_element_content", 1), ("comments", 1), ("charset_overrides_xml_encoding", 1)], ("supported_mediatypes_only", 0): [ ("supported_mediatypes_only", 0)], ("namespaces", 0): [ ("namespaces", 0)], ("namespaces", 1): [ ("namespaces", 1)], } def getFeature(self, name): xname = _name_xform(name) try: return getattr(self._options, xname) except AttributeError: if name == "infoset": options = self._options return (options.datatype_normalization and options.whitespace_in_element_content and options.comments and options.charset_overrides_xml_encoding and not (options.namespace_declarations or options.validate_if_schema or options.create_entity_ref_nodes or options.entities or options.cdata_sections)) raise xml.dom.NotFoundErr("feature %s not known" % repr(name)) def parseURI(self, uri): if self.entityResolver: input = self.entityResolver.resolveEntity(None, uri) else: input = DOMEntityResolver().resolveEntity(None, uri) return self.parse(input) def parse(self, input): options = copy.copy(self._options) options.filter = self.filter options.errorHandler = self.errorHandler fp = input.byteStream if fp is None and options.systemId: import urllib.request fp = urllib.request.urlopen(input.systemId) return self._parse_bytestream(fp, options) def parseWithContext(self, input, cnode, action): if action not in self._legal_actions: raise ValueError("not a legal action") raise NotImplementedError("Haven't written this yet...") def _parse_bytestream(self, stream, options): import xml.dom.expatbuilder builder = xml.dom.expatbuilder.makeBuilder(options) return builder.parseFile(stream) def _name_xform(name): return name.lower().replace('-', '_') class DOMEntityResolver(object): __slots__ = '_opener', def resolveEntity(self, publicId, systemId): assert systemId is not None source = DOMInputSource() source.publicId = publicId source.systemId = systemId source.byteStream = self._get_opener().open(systemId) # determine the encoding if the transport provided it source.encoding = self._guess_media_encoding(source) # determine the base URI is we can import posixpath, urllib.parse parts = urllib.parse.urlparse(systemId) scheme, netloc, path, params, query, fragment = parts # XXX should we check the scheme here as well? if path and not path.endswith("/"): path = posixpath.dirname(path) + "/" parts = scheme, netloc, path, params, query, fragment source.baseURI = urllib.parse.urlunparse(parts) return source def _get_opener(self): try: return self._opener except AttributeError: self._opener = self._create_opener() return self._opener def _create_opener(self): import urllib.request return urllib.request.build_opener() def _guess_media_encoding(self, source): info = source.byteStream.info() if "Content-Type" in info: for param in info.getplist(): if param.startswith("charset="): return param.split("=", 1)[1].lower() class DOMInputSource(object): __slots__ = ('byteStream', 'characterStream', 'stringData', 'encoding', 'publicId', 'systemId', 'baseURI') def __init__(self): self.byteStream = None self.characterStream = None self.stringData = None self.encoding = None self.publicId = None self.systemId = None self.baseURI = None def _get_byteStream(self): return self.byteStream def _set_byteStream(self, byteStream): self.byteStream = byteStream def _get_characterStream(self): return self.characterStream def _set_characterStream(self, characterStream): self.characterStream = characterStream def _get_stringData(self): return self.stringData def _set_stringData(self, data): self.stringData = data def _get_encoding(self): return self.encoding def _set_encoding(self, encoding): self.encoding = encoding def _get_publicId(self): return self.publicId def _set_publicId(self, publicId): self.publicId = publicId def _get_systemId(self): return self.systemId def _set_systemId(self, systemId): self.systemId = systemId def _get_baseURI(self): return self.baseURI def _set_baseURI(self, uri): self.baseURI = uri class DOMBuilderFilter: """Element filter which can be used to tailor construction of a DOM instance. """ # There's really no need for this class; concrete implementations # should just implement the endElement() and startElement() # methods as appropriate. Using this makes it easy to only # implement one of them. FILTER_ACCEPT = 1 FILTER_REJECT = 2 FILTER_SKIP = 3 FILTER_INTERRUPT = 4 whatToShow = NodeFilter.SHOW_ALL def _get_whatToShow(self): return self.whatToShow def acceptNode(self, element): return self.FILTER_ACCEPT def startContainer(self, element): return self.FILTER_ACCEPT del NodeFilter class DocumentLS: """Mixin to create documents that conform to the load/save spec.""" async_ = False def _get_async(self): return False def _set_async(self, flag): if flag: raise xml.dom.NotSupportedErr( "asynchronous document loading is not supported") def abort(self): # What does it mean to "clear" a document? Does the # documentElement disappear? raise NotImplementedError( "haven't figured out what this means yet") def load(self, uri): raise NotImplementedError("haven't written this yet") def loadXML(self, source): raise NotImplementedError("haven't written this yet") def saveXML(self, snode): if snode is None: snode = self elif snode.ownerDocument is not self: raise xml.dom.WrongDocumentErr() return snode.toxml() class DOMImplementationLS: MODE_SYNCHRONOUS = 1 MODE_ASYNCHRONOUS = 2 def createDOMBuilder(self, mode, schemaType): if schemaType is not None: raise xml.dom.NotSupportedErr( "schemaType not yet supported") if mode == self.MODE_SYNCHRONOUS: return DOMBuilder() if mode == self.MODE_ASYNCHRONOUS: raise xml.dom.NotSupportedErr( "asynchronous builders are not supported") raise ValueError("unknown value for mode") def createDOMWriter(self): raise NotImplementedError( "the writer interface hasn't been written yet!") def createDOMInputSource(self): return DOMInputSource() dom/domreg.py 0000644 00000006573 15027446000 0007163 0 ustar 00 """Registration facilities for DOM. This module should not be used directly. Instead, the functions getDOMImplementation and registerDOMImplementation should be imported from xml.dom.""" # This is a list of well-known implementations. Well-known names # should be published by posting to xml-sig@python.org, and are # subsequently recorded in this file. import sys well_known_implementations = { 'minidom':'xml.dom.minidom', '4DOM': 'xml.dom.DOMImplementation', } # DOM implementations not officially registered should register # themselves with their registered = {} def registerDOMImplementation(name, factory): """registerDOMImplementation(name, factory) Register the factory function with the name. The factory function should return an object which implements the DOMImplementation interface. The factory function can either return the same object, or a new one (e.g. if that implementation supports some customization).""" registered[name] = factory def _good_enough(dom, features): "_good_enough(dom, features) -> Return 1 if the dom offers the features" for f,v in features: if not dom.hasFeature(f,v): return 0 return 1 def getDOMImplementation(name=None, features=()): """getDOMImplementation(name = None, features = ()) -> DOM implementation. Return a suitable DOM implementation. The name is either well-known, the module name of a DOM implementation, or None. If it is not None, imports the corresponding module and returns DOMImplementation object if the import succeeds. If name is not given, consider the available implementations to find one with the required feature set. If no implementation can be found, raise an ImportError. The features list must be a sequence of (feature, version) pairs which are passed to hasFeature.""" import os creator = None mod = well_known_implementations.get(name) if mod: mod = __import__(mod, {}, {}, ['getDOMImplementation']) return mod.getDOMImplementation() elif name: return registered[name]() elif not sys.flags.ignore_environment and "PYTHON_DOM" in os.environ: return getDOMImplementation(name = os.environ["PYTHON_DOM"]) # User did not specify a name, try implementations in arbitrary # order, returning the one that has the required features if isinstance(features, str): features = _parse_feature_string(features) for creator in registered.values(): dom = creator() if _good_enough(dom, features): return dom for creator in well_known_implementations.keys(): try: dom = getDOMImplementation(name = creator) except Exception: # typically ImportError, or AttributeError continue if _good_enough(dom, features): return dom raise ImportError("no suitable DOM implementation found") def _parse_feature_string(s): features = [] parts = s.split() i = 0 length = len(parts) while i < length: feature = parts[i] if feature[0] in "0123456789": raise ValueError("bad feature name: %r" % (feature,)) i = i + 1 version = None if i < length: v = parts[i] if v[0] in "0123456789": i = i + 1 version = v features.append((feature, version)) return tuple(features) dom/expatbuilder.py 0000644 00000105667 15027446000 0010402 0 ustar 00 """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. """ # Warning! # # This module is tightly bound to the implementation details of the # minidom DOM and can't be used with other DOM implementations. This # is due, in part, to a lack of appropriate methods in the DOM (there is # no way to create Entity and Notation nodes via the DOM Level 2 # interface), and for performance. The latter is the cause of some fairly # cryptic code. # # Performance hacks: # # - .character_data_handler() has an extra case in which continuing # data is appended to an existing Text node; this can be a # speedup since pyexpat can break up character data into multiple # callbacks even though we set the buffer_text attribute on the # parser. This also gives us the advantage that we don't need a # separate normalization pass. # # - Determining that a node exists is done using an identity comparison # with None rather than a truth test; this avoids searching for and # calling any methods on the node object if it exists. (A rather # nice speedup is achieved this way as well!) from xml.dom import xmlbuilder, minidom, Node from xml.dom import EMPTY_NAMESPACE, EMPTY_PREFIX, XMLNS_NAMESPACE from xml.parsers import expat from xml.dom.minidom import _append_child, _set_attribute_node from xml.dom.NodeFilter import NodeFilter TEXT_NODE = Node.TEXT_NODE CDATA_SECTION_NODE = Node.CDATA_SECTION_NODE DOCUMENT_NODE = Node.DOCUMENT_NODE FILTER_ACCEPT = xmlbuilder.DOMBuilderFilter.FILTER_ACCEPT FILTER_REJECT = xmlbuilder.DOMBuilderFilter.FILTER_REJECT FILTER_SKIP = xmlbuilder.DOMBuilderFilter.FILTER_SKIP FILTER_INTERRUPT = xmlbuilder.DOMBuilderFilter.FILTER_INTERRUPT theDOMImplementation = minidom.getDOMImplementation() # Expat typename -> TypeInfo _typeinfo_map = { "CDATA": minidom.TypeInfo(None, "cdata"), "ENUM": minidom.TypeInfo(None, "enumeration"), "ENTITY": minidom.TypeInfo(None, "entity"), "ENTITIES": minidom.TypeInfo(None, "entities"), "ID": minidom.TypeInfo(None, "id"), "IDREF": minidom.TypeInfo(None, "idref"), "IDREFS": minidom.TypeInfo(None, "idrefs"), "NMTOKEN": minidom.TypeInfo(None, "nmtoken"), "NMTOKENS": minidom.TypeInfo(None, "nmtokens"), } class ElementInfo(object): __slots__ = '_attr_info', '_model', 'tagName' def __init__(self, tagName, model=None): self.tagName = tagName self._attr_info = [] self._model = model def __getstate__(self): return self._attr_info, self._model, self.tagName def __setstate__(self, state): self._attr_info, self._model, self.tagName = state def getAttributeType(self, aname): for info in self._attr_info: if info[1] == aname: t = info[-2] if t[0] == "(": return _typeinfo_map["ENUM"] else: return _typeinfo_map[info[-2]] return minidom._no_type def getAttributeTypeNS(self, namespaceURI, localName): return minidom._no_type def isElementContent(self): if self._model: type = self._model[0] return type not in (expat.model.XML_CTYPE_ANY, expat.model.XML_CTYPE_MIXED) else: return False def isEmpty(self): if self._model: return self._model[0] == expat.model.XML_CTYPE_EMPTY else: return False def isId(self, aname): for info in self._attr_info: if info[1] == aname: return info[-2] == "ID" return False def isIdNS(self, euri, ename, auri, aname): # not sure this is meaningful return self.isId((auri, aname)) def _intern(builder, s): return builder._intern_setdefault(s, s) def _parse_ns_name(builder, name): assert ' ' in name parts = name.split(' ') intern = builder._intern_setdefault if len(parts) == 3: uri, localname, prefix = parts prefix = intern(prefix, prefix) qname = "%s:%s" % (prefix, localname) qname = intern(qname, qname) localname = intern(localname, localname) elif len(parts) == 2: uri, localname = parts prefix = EMPTY_PREFIX qname = localname = intern(localname, localname) else: raise ValueError("Unsupported syntax: spaces in URIs not supported: %r" % name) return intern(uri, uri), localname, prefix, qname class ExpatBuilder: """Document builder that uses Expat to build a ParsedXML.DOM document instance.""" def __init__(self, options=None): if options is None: options = xmlbuilder.Options() self._options = options if self._options.filter is not None: self._filter = FilterVisibilityController(self._options.filter) else: self._filter = None # This *really* doesn't do anything in this case, so # override it with something fast & minimal. self._finish_start_element = id self._parser = None self.reset() def createParser(self): """Create a new parser object.""" return expat.ParserCreate() def getParser(self): """Return the parser object, creating a new one if needed.""" if not self._parser: self._parser = self.createParser() self._intern_setdefault = self._parser.intern.setdefault self._parser.buffer_text = True self._parser.ordered_attributes = True self._parser.specified_attributes = True self.install(self._parser) return self._parser def reset(self): """Free all data structures used during DOM construction.""" self.document = theDOMImplementation.createDocument( EMPTY_NAMESPACE, None, None) self.curNode = self.document self._elem_info = self.document._elem_info self._cdata = False def install(self, parser): """Install the callbacks needed to build the DOM into the parser.""" # This creates circular references! parser.StartDoctypeDeclHandler = self.start_doctype_decl_handler parser.StartElementHandler = self.first_element_handler parser.EndElementHandler = self.end_element_handler parser.ProcessingInstructionHandler = self.pi_handler if self._options.entities: parser.EntityDeclHandler = self.entity_decl_handler parser.NotationDeclHandler = self.notation_decl_handler if self._options.comments: parser.CommentHandler = self.comment_handler if self._options.cdata_sections: parser.StartCdataSectionHandler = self.start_cdata_section_handler parser.EndCdataSectionHandler = self.end_cdata_section_handler parser.CharacterDataHandler = self.character_data_handler_cdata else: parser.CharacterDataHandler = self.character_data_handler parser.ExternalEntityRefHandler = self.external_entity_ref_handler parser.XmlDeclHandler = self.xml_decl_handler parser.ElementDeclHandler = self.element_decl_handler parser.AttlistDeclHandler = self.attlist_decl_handler def parseFile(self, file): """Parse a document from a file object, returning the document node.""" parser = self.getParser() first_buffer = True try: while 1: buffer = file.read(16*1024) if not buffer: break parser.Parse(buffer, False) if first_buffer and self.document.documentElement: self._setup_subset(buffer) first_buffer = False parser.Parse(b"", True) except ParseEscape: pass doc = self.document self.reset() self._parser = None return doc def parseString(self, string): """Parse a document from a string, returning the document node.""" parser = self.getParser() try: parser.Parse(string, True) self._setup_subset(string) except ParseEscape: pass doc = self.document self.reset() self._parser = None return doc def _setup_subset(self, buffer): """Load the internal subset if there might be one.""" if self.document.doctype: extractor = InternalSubsetExtractor() extractor.parseString(buffer) subset = extractor.getSubset() self.document.doctype.internalSubset = subset def start_doctype_decl_handler(self, doctypeName, systemId, publicId, has_internal_subset): doctype = self.document.implementation.createDocumentType( doctypeName, publicId, systemId) doctype.ownerDocument = self.document _append_child(self.document, doctype) self.document.doctype = doctype if self._filter and self._filter.acceptNode(doctype) == FILTER_REJECT: self.document.doctype = None del self.document.childNodes[-1] doctype = None self._parser.EntityDeclHandler = None self._parser.NotationDeclHandler = None if has_internal_subset: if doctype is not None: doctype.entities._seq = [] doctype.notations._seq = [] self._parser.CommentHandler = None self._parser.ProcessingInstructionHandler = None self._parser.EndDoctypeDeclHandler = self.end_doctype_decl_handler def end_doctype_decl_handler(self): if self._options.comments: self._parser.CommentHandler = self.comment_handler self._parser.ProcessingInstructionHandler = self.pi_handler if not (self._elem_info or self._filter): self._finish_end_element = id def pi_handler(self, target, data): node = self.document.createProcessingInstruction(target, data) _append_child(self.curNode, node) if self._filter and self._filter.acceptNode(node) == FILTER_REJECT: self.curNode.removeChild(node) def character_data_handler_cdata(self, data): childNodes = self.curNode.childNodes if self._cdata: if ( self._cdata_continue and childNodes[-1].nodeType == CDATA_SECTION_NODE): childNodes[-1].appendData(data) return node = self.document.createCDATASection(data) self._cdata_continue = True elif childNodes and childNodes[-1].nodeType == TEXT_NODE: node = childNodes[-1] value = node.data + data node.data = value return else: node = minidom.Text() node.data = data node.ownerDocument = self.document _append_child(self.curNode, node) def character_data_handler(self, data): childNodes = self.curNode.childNodes if childNodes and childNodes[-1].nodeType == TEXT_NODE: node = childNodes[-1] node.data = node.data + data return node = minidom.Text() node.data = node.data + data node.ownerDocument = self.document _append_child(self.curNode, node) def entity_decl_handler(self, entityName, is_parameter_entity, value, base, systemId, publicId, notationName): if is_parameter_entity: # we don't care about parameter entities for the DOM return if not self._options.entities: return node = self.document._create_entity(entityName, publicId, systemId, notationName) if value is not None: # internal entity # node *should* be readonly, but we'll cheat child = self.document.createTextNode(value) node.childNodes.append(child) self.document.doctype.entities._seq.append(node) if self._filter and self._filter.acceptNode(node) == FILTER_REJECT: del self.document.doctype.entities._seq[-1] def notation_decl_handler(self, notationName, base, systemId, publicId): node = self.document._create_notation(notationName, publicId, systemId) self.document.doctype.notations._seq.append(node) if self._filter and self._filter.acceptNode(node) == FILTER_ACCEPT: del self.document.doctype.notations._seq[-1] def comment_handler(self, data): node = self.document.createComment(data) _append_child(self.curNode, node) if self._filter and self._filter.acceptNode(node) == FILTER_REJECT: self.curNode.removeChild(node) def start_cdata_section_handler(self): self._cdata = True self._cdata_continue = False def end_cdata_section_handler(self): self._cdata = False self._cdata_continue = False def external_entity_ref_handler(self, context, base, systemId, publicId): return 1 def first_element_handler(self, name, attributes): if self._filter is None and not self._elem_info: self._finish_end_element = id self.getParser().StartElementHandler = self.start_element_handler self.start_element_handler(name, attributes) def start_element_handler(self, name, attributes): node = self.document.createElement(name) _append_child(self.curNode, node) self.curNode = node if attributes: for i in range(0, len(attributes), 2): a = minidom.Attr(attributes[i], EMPTY_NAMESPACE, None, EMPTY_PREFIX) value = attributes[i+1] a.value = value a.ownerDocument = self.document _set_attribute_node(node, a) if node is not self.document.documentElement: self._finish_start_element(node) def _finish_start_element(self, node): if self._filter: # To be general, we'd have to call isSameNode(), but this # is sufficient for minidom: if node is self.document.documentElement: return filt = self._filter.startContainer(node) if filt == FILTER_REJECT: # ignore this node & all descendents Rejecter(self) elif filt == FILTER_SKIP: # ignore this node, but make it's children become # children of the parent node Skipper(self) else: return self.curNode = node.parentNode node.parentNode.removeChild(node) node.unlink() # If this ever changes, Namespaces.end_element_handler() needs to # be changed to match. # def end_element_handler(self, name): curNode = self.curNode self.curNode = curNode.parentNode self._finish_end_element(curNode) def _finish_end_element(self, curNode): info = self._elem_info.get(curNode.tagName) if info: self._handle_white_text_nodes(curNode, info) if self._filter: if curNode is self.document.documentElement: return if self._filter.acceptNode(curNode) == FILTER_REJECT: self.curNode.removeChild(curNode) curNode.unlink() def _handle_white_text_nodes(self, node, info): if (self._options.whitespace_in_element_content or not info.isElementContent()): return # We have element type information and should remove ignorable # whitespace; identify for text nodes which contain only # whitespace. L = [] for child in node.childNodes: if child.nodeType == TEXT_NODE and not child.data.strip(): L.append(child) # Remove ignorable whitespace from the tree. for child in L: node.removeChild(child) def element_decl_handler(self, name, model): info = self._elem_info.get(name) if info is None: self._elem_info[name] = ElementInfo(name, model) else: assert info._model is None info._model = model def attlist_decl_handler(self, elem, name, type, default, required): info = self._elem_info.get(elem) if info is None: info = ElementInfo(elem) self._elem_info[elem] = info info._attr_info.append( [None, name, None, None, default, 0, type, required]) def xml_decl_handler(self, version, encoding, standalone): self.document.version = version self.document.encoding = encoding # This is still a little ugly, thanks to the pyexpat API. ;-( if standalone >= 0: if standalone: self.document.standalone = True else: self.document.standalone = False # Don't include FILTER_INTERRUPT, since that's checked separately # where allowed. _ALLOWED_FILTER_RETURNS = (FILTER_ACCEPT, FILTER_REJECT, FILTER_SKIP) class FilterVisibilityController(object): """Wrapper around a DOMBuilderFilter which implements the checks to make the whatToShow filter attribute work.""" __slots__ = 'filter', def __init__(self, filter): self.filter = filter def startContainer(self, node): mask = self._nodetype_mask[node.nodeType] if self.filter.whatToShow & mask: val = self.filter.startContainer(node) if val == FILTER_INTERRUPT: raise ParseEscape if val not in _ALLOWED_FILTER_RETURNS: raise ValueError( "startContainer() returned illegal value: " + repr(val)) return val else: return FILTER_ACCEPT def acceptNode(self, node): mask = self._nodetype_mask[node.nodeType] if self.filter.whatToShow & mask: val = self.filter.acceptNode(node) if val == FILTER_INTERRUPT: raise ParseEscape if val == FILTER_SKIP: # move all child nodes to the parent, and remove this node parent = node.parentNode for child in node.childNodes[:]: parent.appendChild(child) # node is handled by the caller return FILTER_REJECT if val not in _ALLOWED_FILTER_RETURNS: raise ValueError( "acceptNode() returned illegal value: " + repr(val)) return val else: return FILTER_ACCEPT _nodetype_mask = { Node.ELEMENT_NODE: NodeFilter.SHOW_ELEMENT, Node.ATTRIBUTE_NODE: NodeFilter.SHOW_ATTRIBUTE, Node.TEXT_NODE: NodeFilter.SHOW_TEXT, Node.CDATA_SECTION_NODE: NodeFilter.SHOW_CDATA_SECTION, Node.ENTITY_REFERENCE_NODE: NodeFilter.SHOW_ENTITY_REFERENCE, Node.ENTITY_NODE: NodeFilter.SHOW_ENTITY, Node.PROCESSING_INSTRUCTION_NODE: NodeFilter.SHOW_PROCESSING_INSTRUCTION, Node.COMMENT_NODE: NodeFilter.SHOW_COMMENT, Node.DOCUMENT_NODE: NodeFilter.SHOW_DOCUMENT, Node.DOCUMENT_TYPE_NODE: NodeFilter.SHOW_DOCUMENT_TYPE, Node.DOCUMENT_FRAGMENT_NODE: NodeFilter.SHOW_DOCUMENT_FRAGMENT, Node.NOTATION_NODE: NodeFilter.SHOW_NOTATION, } class FilterCrutch(object): __slots__ = '_builder', '_level', '_old_start', '_old_end' def __init__(self, builder): self._level = 0 self._builder = builder parser = builder._parser self._old_start = parser.StartElementHandler self._old_end = parser.EndElementHandler parser.StartElementHandler = self.start_element_handler parser.EndElementHandler = self.end_element_handler class Rejecter(FilterCrutch): __slots__ = () def __init__(self, builder): FilterCrutch.__init__(self, builder) parser = builder._parser for name in ("ProcessingInstructionHandler", "CommentHandler", "CharacterDataHandler", "StartCdataSectionHandler", "EndCdataSectionHandler", "ExternalEntityRefHandler", ): setattr(parser, name, None) def start_element_handler(self, *args): self._level = self._level + 1 def end_element_handler(self, *args): if self._level == 0: # restore the old handlers parser = self._builder._parser self._builder.install(parser) parser.StartElementHandler = self._old_start parser.EndElementHandler = self._old_end else: self._level = self._level - 1 class Skipper(FilterCrutch): __slots__ = () def start_element_handler(self, *args): node = self._builder.curNode self._old_start(*args) if self._builder.curNode is not node: self._level = self._level + 1 def end_element_handler(self, *args): if self._level == 0: # We're popping back out of the node we're skipping, so we # shouldn't need to do anything but reset the handlers. self._builder._parser.StartElementHandler = self._old_start self._builder._parser.EndElementHandler = self._old_end self._builder = None else: self._level = self._level - 1 self._old_end(*args) # framework document used by the fragment builder. # Takes a string for the doctype, subset string, and namespace attrs string. _FRAGMENT_BUILDER_INTERNAL_SYSTEM_ID = \ "http://xml.python.org/entities/fragment-builder/internal" _FRAGMENT_BUILDER_TEMPLATE = ( '''\ <!DOCTYPE wrapper %%s [ <!ENTITY fragment-builder-internal SYSTEM "%s"> %%s ]> <wrapper %%s >&fragment-builder-internal;</wrapper>''' % _FRAGMENT_BUILDER_INTERNAL_SYSTEM_ID) class FragmentBuilder(ExpatBuilder): """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. """ def __init__(self, context, options=None): if context.nodeType == DOCUMENT_NODE: self.originalDocument = context self.context = context else: self.originalDocument = context.ownerDocument self.context = context ExpatBuilder.__init__(self, options) def reset(self): ExpatBuilder.reset(self) self.fragment = None def parseFile(self, file): """Parse a document fragment from a file object, returning the fragment node.""" return self.parseString(file.read()) def parseString(self, string): """Parse a document fragment from a string, returning the fragment node.""" self._source = string parser = self.getParser() doctype = self.originalDocument.doctype ident = "" if doctype: subset = doctype.internalSubset or self._getDeclarations() if doctype.publicId: ident = ('PUBLIC "%s" "%s"' % (doctype.publicId, doctype.systemId)) elif doctype.systemId: ident = 'SYSTEM "%s"' % doctype.systemId else: subset = "" nsattrs = self._getNSattrs() # get ns decls from node's ancestors document = _FRAGMENT_BUILDER_TEMPLATE % (ident, subset, nsattrs) try: parser.Parse(document, True) except: self.reset() raise fragment = self.fragment self.reset() ## self._parser = None return fragment def _getDeclarations(self): """Re-create the internal subset from the DocumentType node. This is only needed if we don't already have the internalSubset as a string. """ doctype = self.context.ownerDocument.doctype s = "" if doctype: for i in range(doctype.notations.length): notation = doctype.notations.item(i) if s: s = s + "\n " s = "%s<!NOTATION %s" % (s, notation.nodeName) if notation.publicId: s = '%s PUBLIC "%s"\n "%s">' \ % (s, notation.publicId, notation.systemId) else: s = '%s SYSTEM "%s">' % (s, notation.systemId) for i in range(doctype.entities.length): entity = doctype.entities.item(i) if s: s = s + "\n " s = "%s<!ENTITY %s" % (s, entity.nodeName) if entity.publicId: s = '%s PUBLIC "%s"\n "%s"' \ % (s, entity.publicId, entity.systemId) elif entity.systemId: s = '%s SYSTEM "%s"' % (s, entity.systemId) else: s = '%s "%s"' % (s, entity.firstChild.data) if entity.notationName: s = "%s NOTATION %s" % (s, entity.notationName) s = s + ">" return s def _getNSattrs(self): return "" def external_entity_ref_handler(self, context, base, systemId, publicId): if systemId == _FRAGMENT_BUILDER_INTERNAL_SYSTEM_ID: # this entref is the one that we made to put the subtree # in; all of our given input is parsed in here. old_document = self.document old_cur_node = self.curNode parser = self._parser.ExternalEntityParserCreate(context) # put the real document back, parse into the fragment to return self.document = self.originalDocument self.fragment = self.document.createDocumentFragment() self.curNode = self.fragment try: parser.Parse(self._source, True) finally: self.curNode = old_cur_node self.document = old_document self._source = None return -1 else: return ExpatBuilder.external_entity_ref_handler( self, context, base, systemId, publicId) class Namespaces: """Mix-in class for builders; adds support for namespaces.""" def _initNamespaces(self): # list of (prefix, uri) ns declarations. Namespace attrs are # constructed from this and added to the element's attrs. self._ns_ordered_prefixes = [] def createParser(self): """Create a new namespace-handling parser.""" parser = expat.ParserCreate(namespace_separator=" ") parser.namespace_prefixes = True return parser def install(self, parser): """Insert the namespace-handlers onto the parser.""" ExpatBuilder.install(self, parser) if self._options.namespace_declarations: parser.StartNamespaceDeclHandler = ( self.start_namespace_decl_handler) def start_namespace_decl_handler(self, prefix, uri): """Push this namespace declaration on our storage.""" self._ns_ordered_prefixes.append((prefix, uri)) def start_element_handler(self, name, attributes): if ' ' in name: uri, localname, prefix, qname = _parse_ns_name(self, name) else: uri = EMPTY_NAMESPACE qname = name localname = None prefix = EMPTY_PREFIX node = minidom.Element(qname, uri, prefix, localname) node.ownerDocument = self.document _append_child(self.curNode, node) self.curNode = node if self._ns_ordered_prefixes: for prefix, uri in self._ns_ordered_prefixes: if prefix: a = minidom.Attr(_intern(self, 'xmlns:' + prefix), XMLNS_NAMESPACE, prefix, "xmlns") else: a = minidom.Attr("xmlns", XMLNS_NAMESPACE, "xmlns", EMPTY_PREFIX) a.value = uri a.ownerDocument = self.document _set_attribute_node(node, a) del self._ns_ordered_prefixes[:] if attributes: node._ensure_attributes() _attrs = node._attrs _attrsNS = node._attrsNS for i in range(0, len(attributes), 2): aname = attributes[i] value = attributes[i+1] if ' ' in aname: uri, localname, prefix, qname = _parse_ns_name(self, aname) a = minidom.Attr(qname, uri, localname, prefix) _attrs[qname] = a _attrsNS[(uri, localname)] = a else: a = minidom.Attr(aname, EMPTY_NAMESPACE, aname, EMPTY_PREFIX) _attrs[aname] = a _attrsNS[(EMPTY_NAMESPACE, aname)] = a a.ownerDocument = self.document a.value = value a.ownerElement = node if __debug__: # This only adds some asserts to the original # end_element_handler(), so we only define this when -O is not # used. If changing one, be sure to check the other to see if # it needs to be changed as well. # def end_element_handler(self, name): curNode = self.curNode if ' ' in name: uri, localname, prefix, qname = _parse_ns_name(self, name) assert (curNode.namespaceURI == uri and curNode.localName == localname and curNode.prefix == prefix), \ "element stack messed up! (namespace)" else: assert curNode.nodeName == name, \ "element stack messed up - bad nodeName" assert curNode.namespaceURI == EMPTY_NAMESPACE, \ "element stack messed up - bad namespaceURI" self.curNode = curNode.parentNode self._finish_end_element(curNode) class ExpatBuilderNS(Namespaces, ExpatBuilder): """Document builder that supports namespaces.""" def reset(self): ExpatBuilder.reset(self) self._initNamespaces() class FragmentBuilderNS(Namespaces, FragmentBuilder): """Fragment builder that supports namespaces.""" def reset(self): FragmentBuilder.reset(self) self._initNamespaces() def _getNSattrs(self): """Return string of namespace attributes from this element and ancestors.""" # XXX This needs to be re-written to walk the ancestors of the # context to build up the namespace information from # declarations, elements, and attributes found in context. # Otherwise we have to store a bunch more data on the DOM # (though that *might* be more reliable -- not clear). attrs = "" context = self.context L = [] while context: if hasattr(context, '_ns_prefix_uri'): for prefix, uri in context._ns_prefix_uri.items(): # add every new NS decl from context to L and attrs string if prefix in L: continue L.append(prefix) if prefix: declname = "xmlns:" + prefix else: declname = "xmlns" if attrs: attrs = "%s\n %s='%s'" % (attrs, declname, uri) else: attrs = " %s='%s'" % (declname, uri) context = context.parentNode return attrs class ParseEscape(Exception): """Exception raised to short-circuit parsing in InternalSubsetExtractor.""" pass class InternalSubsetExtractor(ExpatBuilder): """XML processor which can rip out the internal document type subset.""" subset = None def getSubset(self): """Return the internal subset as a string.""" return self.subset def parseFile(self, file): try: ExpatBuilder.parseFile(self, file) except ParseEscape: pass def parseString(self, string): try: ExpatBuilder.parseString(self, string) except ParseEscape: pass def install(self, parser): parser.StartDoctypeDeclHandler = self.start_doctype_decl_handler parser.StartElementHandler = self.start_element_handler def start_doctype_decl_handler(self, name, publicId, systemId, has_internal_subset): if has_internal_subset: parser = self.getParser() self.subset = [] parser.DefaultHandler = self.subset.append parser.EndDoctypeDeclHandler = self.end_doctype_decl_handler else: raise ParseEscape() def end_doctype_decl_handler(self): s = ''.join(self.subset).replace('\r\n', '\n').replace('\r', '\n') self.subset = s raise ParseEscape() def start_element_handler(self, name, attrs): raise ParseEscape() def parse(file, namespaces=True): """Parse a document, returning the resulting Document node. 'file' may be either a file name or an open file object. """ if namespaces: builder = ExpatBuilderNS() else: builder = ExpatBuilder() if isinstance(file, str): with open(file, 'rb') as fp: result = builder.parseFile(fp) else: result = builder.parseFile(file) return result def parseString(string, namespaces=True): """Parse a document from a string, returning the resulting Document node. """ if namespaces: builder = ExpatBuilderNS() else: builder = ExpatBuilder() return builder.parseString(string) def parseFragment(file, context, namespaces=True): """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. """ if namespaces: builder = FragmentBuilderNS(context) else: builder = FragmentBuilder(context) if isinstance(file, str): with open(file, 'rb') as fp: result = builder.parseFile(fp) else: result = builder.parseFile(file) return result def parseFragmentString(string, context, namespaces=True): """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. """ if namespaces: builder = FragmentBuilderNS(context) else: builder = FragmentBuilder(context) return builder.parseString(string) def makeBuilder(options): """Create a builder based on an Options object.""" if options.namespaces: return ExpatBuilderNS(options) else: return ExpatBuilder(options) dom/__init__.py 0000644 00000007663 15027446000 0007446 0 ustar 00 """W3C Document Object Model implementation for Python. The Python mapping of the Document Object Model is documented in the Python Library Reference in the section on the xml.dom package. This package contains the following modules: minidom -- A simple implementation of the Level 1 DOM with namespace support added (based on the Level 2 specification) and other minor Level 2 functionality. pulldom -- DOM builder supporting on-demand tree-building for selected subtrees of the document. """ class Node: """Class giving the NodeType constants.""" __slots__ = () # DOM implementations may use this as a base class for their own # Node implementations. If they don't, the constants defined here # should still be used as the canonical definitions as they match # the values given in the W3C recommendation. Client code can # safely refer to these values in all tests of Node.nodeType # values. ELEMENT_NODE = 1 ATTRIBUTE_NODE = 2 TEXT_NODE = 3 CDATA_SECTION_NODE = 4 ENTITY_REFERENCE_NODE = 5 ENTITY_NODE = 6 PROCESSING_INSTRUCTION_NODE = 7 COMMENT_NODE = 8 DOCUMENT_NODE = 9 DOCUMENT_TYPE_NODE = 10 DOCUMENT_FRAGMENT_NODE = 11 NOTATION_NODE = 12 #ExceptionCode INDEX_SIZE_ERR = 1 DOMSTRING_SIZE_ERR = 2 HIERARCHY_REQUEST_ERR = 3 WRONG_DOCUMENT_ERR = 4 INVALID_CHARACTER_ERR = 5 NO_DATA_ALLOWED_ERR = 6 NO_MODIFICATION_ALLOWED_ERR = 7 NOT_FOUND_ERR = 8 NOT_SUPPORTED_ERR = 9 INUSE_ATTRIBUTE_ERR = 10 INVALID_STATE_ERR = 11 SYNTAX_ERR = 12 INVALID_MODIFICATION_ERR = 13 NAMESPACE_ERR = 14 INVALID_ACCESS_ERR = 15 VALIDATION_ERR = 16 class DOMException(Exception): """Abstract base class for DOM exceptions. Exceptions with specific codes are specializations of this class.""" def __init__(self, *args, **kw): if self.__class__ is DOMException: raise RuntimeError( "DOMException should not be instantiated directly") Exception.__init__(self, *args, **kw) def _get_code(self): return self.code class IndexSizeErr(DOMException): code = INDEX_SIZE_ERR class DomstringSizeErr(DOMException): code = DOMSTRING_SIZE_ERR class HierarchyRequestErr(DOMException): code = HIERARCHY_REQUEST_ERR class WrongDocumentErr(DOMException): code = WRONG_DOCUMENT_ERR class InvalidCharacterErr(DOMException): code = INVALID_CHARACTER_ERR class NoDataAllowedErr(DOMException): code = NO_DATA_ALLOWED_ERR class NoModificationAllowedErr(DOMException): code = NO_MODIFICATION_ALLOWED_ERR class NotFoundErr(DOMException): code = NOT_FOUND_ERR class NotSupportedErr(DOMException): code = NOT_SUPPORTED_ERR class InuseAttributeErr(DOMException): code = INUSE_ATTRIBUTE_ERR class InvalidStateErr(DOMException): code = INVALID_STATE_ERR class SyntaxErr(DOMException): code = SYNTAX_ERR class InvalidModificationErr(DOMException): code = INVALID_MODIFICATION_ERR class NamespaceErr(DOMException): code = NAMESPACE_ERR class InvalidAccessErr(DOMException): code = INVALID_ACCESS_ERR class ValidationErr(DOMException): code = VALIDATION_ERR class UserDataHandler: """Class giving the operation constants for UserDataHandler.handle().""" # Based on DOM Level 3 (WD 9 April 2002) NODE_CLONED = 1 NODE_IMPORTED = 2 NODE_DELETED = 3 NODE_RENAMED = 4 XML_NAMESPACE = "http://www.w3.org/XML/1998/namespace" XMLNS_NAMESPACE = "http://www.w3.org/2000/xmlns/" XHTML_NAMESPACE = "http://www.w3.org/1999/xhtml" EMPTY_NAMESPACE = None EMPTY_PREFIX = None from .domreg import getDOMImplementation, registerDOMImplementation etree/__pycache__/__init__.cpython-310.pyc 0000644 00000000206 15027446000 0014314 0 ustar 00 o }�5hE � @ s d S )N� r r r �)/usr/lib/python3.10/xml/etree/__init__.py�<module> s etree/__pycache__/ElementPath.cpython-310.pyc 0000644 00000021510 15027446000 0014764 0 ustar 00 o }�5h6 � @ s� d dl Z e �d�Zd"dd�Zdd� Zdd� Zd d � Zd d � Zd d� Zdd� Z dd� Z dd� Z dd� Z eee e e e d�Z i ZG dd� d�Zd"dd�Zd"d d �Zd"d d �Zd#d d!�ZdS )$� Nz`('[^']*'|\"[^\"]*\"|::|//?|\.\.|\(\)|!=|[/.*:\[\]\(\)@=])|((?:\{[^}]+\})?[^/\[\]\(\)@!=\s]+)|\s+c c s� � |r|� d�nd }d}t�| �D ]U}|\}}|r_|d dkr_d|v rK|�dd�\}}z|s0t�|d|| |f fV W n tyJ td| �d �w |rY|sY|d||f fV n|V d}q|V |d k}qd S ) N� Fr �{�:� z{%s}%sz!prefix %r not found in prefix map�@)�get�xpath_tokenizer_re�findall�split�KeyError� SyntaxError) �pattern� namespaces�default_namespace�parsing_attribute�token�ttype�tag�prefix�uri� r �,/usr/lib/python3.10/xml/etree/ElementPath.py�xpath_tokenizerJ s, � � �r c C s> | j }|d u r i | _ }| j�� D ] }|D ]}|||< qq|S �N)� parent_map�root�iter)�contextr �p�er r r �get_parent_mapb s �r c C s | d d� dkp| dd � dkS )N� �{*}����}*r �r r r r �_is_wildcard_tagl s r& c s� t t� ��dkr� �fdd�}|S �dkr � �fdd�}|S �d d� dkrG�dd � �tt�� d ���dd � �� ����fd d�}|S �d d � d krg�d d � �td t����� ���fd d�}|S td�� ���)Nz{*}*c 3 s" � |D ] }� |j ��r|V qd S r r% �r �result�elem�� _isinstance�_strr r �selectv s � ��z _prepare_tag.<locals>.selectz{}*c 3 s2 � |D ]}|j }� |��r|d dkr|V qd S )Nr r r% �r r( r) �el_tagr* r r r- | � ���r! r" � c 3 s: � |D ]}|j }|�ks� |��r|� �kr|V qd S r r% r. )r+ r, �no_ns�suffixr r r r- � s � ��r# r$ ���c 3 s2 � |D ]}|j }� |��r|� �kr|V qd S r r% r. )r+ r, �ns�ns_onlyr r r- � r0 zinternal parser error, got )� isinstance�str�slice�len� RuntimeError)r r- r )r+ r, r2 r5 r6 r3 r r � _prepare_tagp s& �� � �r< c sT |d �t ��rt��� � fdd�}|S �d d� dkr"�dd � ��fdd�}|S )Nr c � dd� }� | ||��S )Nc s s � | D ]}|E d H qd S r r )r( r) r r r � select_child� � � �z3prepare_child.<locals>.select.<locals>.select_childr �r r( r> �� select_tagr r r- � s z prepare_child.<locals>.selectr1 �{}c 3 s* � |D ]}|D ] }|j � kr|V qqd S r r% �r r( r) r r% r r r- � s � ���)r& r< ��nextr r- r �rB r r � prepare_child� s � rH c C � dd� }|S )Nc s s � |D ]}|E d H qd S r r r' r r r r- � r? z prepare_star.<locals>.selectr rE r r r � prepare_star� s rJ c C rI )Nc s s � |E d H d S r r )r r( r r r r- � s �z prepare_self.<locals>.selectr rE r r r � prepare_self� s rK c s� z| � }W n t y Y d S w |d dkrd�n |d s"|d �ntd��t��r6t��� � fdd�}|S �d d� dkrD�dd � ��fd d�}|S ) Nr �*r zinvalid descendantc r= )Nc s s, � | D ]}|� � D ] }||ur|V q qd S r �r )r( r) r r r r r> � s � ���z8prepare_descendant.<locals>.select.<locals>.select_childr r@ rA r r r- � s z"prepare_descendant.<locals>.selectr1 rC c 3 s. � |D ]}|� � �D ] }||ur|V q qd S r rM rD r% r r r- � s ����)� StopIterationr r& r< rE r rG r �prepare_descendant� s$ � � rO c C rI )Nc s sB � t | �}i }|D ]}||v r || }||vr d ||< |V q d S r )r )r r( r � result_mapr) �parentr r r r- � s ���z prepare_parent.<locals>.selectr rE r r r �prepare_parent� s rR c s� g }g } z| � }W n t y Y d S w |d dkr n.|dkr!q|d r9|d d d� dv r9d|d dd� f}|�|d p@d� |�|d � qd �|�}|d kr_|d ��fd d �}|S |d ksg|dkr�|d �|d ���fdd �}��fdd�}d|v r�|S |S |dkr�t�d|d �s�|d ��fdd �}|S |dks�|dks�|dks�|dkr�t�d|d �s�|d �|d ��r·�fdd �}��fdd�}n �fdd �}�fd d�}d|v r�|S |S |dks�|d ks�|d k�rA|dk�rt|d �d � � dk �rtd ��n3|d d k�rtd!��|d k�r7z t|d" �d � W n t�y, td#��w � d$k�r6td%��nd� � fd&d �}|S td'��)(Nr r �])r r z'"�'r4 �-r z@-c 3 �$ � |D ] }|� � �d ur|V qd S r �r r' )�keyr r r- � � ���z!prepare_predicate.<locals>.selectz@-='z@-!='c 3 s$ � |D ] }|� � ��kr|V qd S r rW r' �rX �valuer r r- rY c 3 s0 � |D ]}|� � � }d ur|�kr|V qd S r rW )r r( r) � attr_valuerZ r r �select_negated s ���z)prepare_predicate.<locals>.select_negatedz!=z\-?\d+$c 3 rV r )�findr' r% r r r- rY z.='z.!='z-='z-!='c 3 s< � |D ]}|� � �D ]}d�|�� ��kr|V nq qd S �Nr )r �join�itertextrD �r r[ r r r- � ����c 3 s< � |D ]}|� � �D ]}d�|�� ��kr|V nq qd S r_ )�iterfindr` ra rD rb r r r] " rc c 3 s( � |D ]}d� |�� �� kr|V qd S r_ �r` ra r' �r[ r r r- ) � ���c 3 s( � |D ]}d� |�� �� kr|V qd S r_ re r' rf r r r] - rg z-()z-()-z XPath position >= 1 expected�lastzunsupported functionr1 zunsupported expressionr# z)XPath offset from last() must be negativec 3 s\ � t | �}|D ]$}z|| }t|�|j��}|� |u r |V W q ttfy+ Y qw d S r )r �listr r � IndexErrorr )r r( r r) rQ �elems)�indexr r r- E s � ���zinvalid predicate)rN �appendr` �re�match�intr � ValueError)rF r � signature� predicater- r] r )rl rX r r[ r �prepare_predicate� s� � � � � � � rt )r rL �.z..z//�[c @ s e Zd ZdZdd� ZdS )�_SelectorContextNc C s || _ d S r )r )�selfr r r r �__init__` s z_SelectorContext.__init__)�__name__� __module__� __qualname__r ry r r r r rw ^ s rw c C sP |dd � dkr |d }|f}|r|t t|�� ��7 }zt| }W ns ty� tt�dkr2t�� |d d� dkr>td��tt ||��j }z|� }W n t yV Y Y d S w g } z|� t |d ||�� W n t yt td�d �w z|� }|d dkr�|� }W n t y� Y nw qZ|t|< Y nw | g}t| �}|D ]} | ||�}q�|S ) Nr4 �/rL �d r z#cannot use absolute path on elementr z invalid path)�tuple�sorted�items�_cacher r: �clearr r r �__next__rN rm �opsrw ) r) �pathr � cache_key�selectorrF r r( r r- r r r rd h sR � � � �� � rd c C s t t| ||�d �S r )rF rd �r) r� r r r r r^ � s r^ c C s t t| ||��S r )ri rd r� r r r r � s r c C s4 zt t| ||��} | jp dW S ty | Y S w r_ )rF rd �textrN )r) r� �defaultr r r r �findtext� s �r� r )NN)rn �compiler r r r& r< rH rJ rK rO rR rt r� r� rw rd r^ r r� r r r r �<module> s6 :� ) q� , etree/__pycache__/ElementInclude.cpython-310.pyc 0000644 00000004603 15027446000 0015457 0 ustar 00 o }�5h� � @ s~ d dl Z ddlmZ d dlmZ dZed Zed ZdZG d d � d e �Z G d d � d e �Z dd d�Z ddefdd�Z dd� ZdS )� N� )� ElementTree)�urljoinz!{http://www.w3.org/2001/XInclude}�include�fallback� c @ � e Zd ZdS )�FatalIncludeErrorN��__name__� __module__� __qualname__� r r �//usr/lib/python3.10/xml/etree/ElementInclude.pyr C � r c @ r )� LimitedRecursiveIncludeErrorNr r r r r r G r r c C s� |dkr#t | d��}t�|��� }W d � |S 1 s w Y |S |s'd}t | d|d�� }|�� }W d � |S 1 s>w Y |S )N�xml�rbzUTF-8�r)�encoding)�openr �parse�getroot�read)�hrefr r �file�datar r r �default_loaderW s ��� ��r c C sV |d u rd}n |dk rt d| ��t| d�r| �� } |d u r t}t| |||t� � d S )N���r z;expected non-negative depth or None for 'max_depth', got %rr )� ValueError�hasattrr r �_include�set)�elem�loader�base_url� max_depthr r r r t s c C s� d}|t | �k r�| | }|jtkr�|�d�}|r t||�}|�dd�}|dkrv||v r1td| ��|dkr;td| ��|�|� |||�} | d u rQtd||f ��t�| �} t | |||d |� |� |� |j rq| j pld |j | _ | | |< nX|d kr�||||�d ��} | d u r�td||f ��|j r�| |j 7 } |r�| |d } | j p�d | | _ n| j p�d | | _ | |= qtd | ��|jt kr�td |j ��t |||||� |d7 }|t | �k sd S d S )Nr r r r zrecursive include of %sz5maximum xinclude depth reached when including file %szcannot load %r as %rr � �textr z)unknown parse type in xi:include tag (%r)z0xi:fallback tag must be child of xi:include (%r))�len�tag�XINCLUDE_INCLUDE�getr r r �add�copyr! �remove�tailr( �XINCLUDE_FALLBACK) r# r$ r% r& � _parent_hrefs�i�er r �noder( r r r r! � sf � � � � ��r! )N)r. r' r � urllib.parser �XINCLUDEr+ r1 �DEFAULT_MAX_INCLUSION_DEPTH� SyntaxErrorr r r r r! r r r r �<module> s 2 � etree/__pycache__/ElementTree.cpython-310.pyc 0000644 00000155107 15027446000 0015001 0 ustar 00 o }�5ha � @ s� d Z g d�ZdZddlZddlZddlZddlZddlZddlZddl Z ddl m Z G dd� de �Z d d � ZG d d � d �Zi fd d�Zd^dd�Zd^dd�ZeZG dd� d�ZG dd� d�Ze jdd� �Zd^dd�Zdd � Zd Zzee�ZW n e y~ Y nw d d � Z d d!� Z ee e d"�Z d#d$� Z d%d&d'd(d)d*d+d,�Z!e!e _!d-d.� Z"d/d0� Z#d1d2� Z$d3d4� Z%d_ddd5d6�d7d8�Z&G d9d:� d:ej'�Z(d_ddd5d6�d;d<�Z)d=d>� Z*d`d@dA�Z+d^dBdC�Z,d_dDdE�Z-G dFdG� dG�Z.d^dHdI�Z/d^dJdK�Z0e/Z1d^dLdM�Z2G dNdO� dO�Z3G dPdQ� dQ�Z4d^dddR�dSdT�Z5e�6dUej7�j8Z9G dVdW� dW�Z:dXdY� Z;dZd[� Z<zeZ=dd\l>T dd]l>m?Z? W n e@�y= Y dS w e?ee� dS )aa Lightweight XML support for Python. XML is an inherently hierarchical data format, and the most natural way to represent it is with a tree. This module has two classes for this purpose: 1. ElementTree represents the whole XML document as a tree and 2. Element represents a single node in this tree. Interactions with the whole document (reading and writing to/from files) are usually done on the ElementTree level. Interactions with a single XML element and its sub-elements are done on the Element level. Element is a flexible container object designed to store hierarchical data structures in memory. It can be described as a cross between a list and a dictionary. Each Element has a number of properties associated with it: 'tag' - a string containing the element's name. 'attributes' - a Python dictionary storing the element's attributes. 'text' - a string containing the element's text content. 'tail' - an optional string containing text after the element's end tag. And a number of child elements stored in a Python sequence. To create an element instance, use the Element constructor, or the SubElement factory function. You can also use the ElementTree class to wrap an element structure and convert it to and from XML. )�Comment�dump�Element� ElementTree� fromstring�fromstringlist�indent� iselement� iterparse�parse� ParseError�PI�ProcessingInstruction�QName� SubElement�tostring� tostringlist� TreeBuilder�VERSION�XML�XMLID� XMLParser� XMLPullParser�register_namespace� canonicalize�C14NWriterTargetz1.3.0� N� )� ElementPathc @ s e Zd ZdZdS )r z�An error when parsing an XML document. In addition to its exception value, a ParseError contains two extra attributes: 'code' - the specific exception code 'position' - the line and column of the error N)�__name__� __module__� __qualname__�__doc__� r" r" �,/usr/lib/python3.10/xml/etree/ElementTree.pyr j s r c C s t | d�S )z2Return True if *element* appears to be an Element.�tag)�hasattr)�elementr" r" r# r x s r c @ s e Zd ZdZdZ dZ dZ dZ i fdd�Zdd� Z dd� Z d d � Z d d � Z d d� Z dd� Zdd� Zdd� Zdd� Zdd� Zdd� Zdd � Zd d � Zd d � Zd7d!d"�Zd8d#d$�Zd7d%d&�Zd7d'd(�Zd)d*� Zd7d+d,�Z d-d.� Z d/d0� Z d1d2� Z d7d3d4�Z d5d6� Z!dS )9r ah An XML element. This class is the reference implementation of the Element interface. An element's length is its number of subelements. That means if you want to check if an element is truly empty, you should check BOTH its length AND its text attribute. The element tag, attribute names, and attribute values can be either bytes or strings. *tag* is the element name. *attrib* is an optional dictionary containing element attributes. *extra* are additional element attributes given as keyword arguments. Example form: <tag attrib>text<child/>...</tag>tail Nc K s: t |t�std|jjf ��|| _i |�|�| _g | _d S )Nzattrib must be dict, not %s)� isinstance�dict� TypeError� __class__r r$ �attrib� _children)�selfr$ r+ �extrar" r" r# �__init__� s � zElement.__init__c C s d| j j| jt| �f S )Nz<%s %r at %#x>)r* r r$ �id�r- r" r" r# �__repr__� � zElement.__repr__c C s | � ||�S )z�Create a new element with the same type. *tag* is a string containing the element name. *attrib* is a dictionary containing the element attributes. Do not call this method, use the SubElement factory function instead. )r* )r- r$ r+ r" r" r# � makeelement� s zElement.makeelementc C s t �dt� | �� S )z�Return copy of current element. This creates a shallow copy. Subelements will be shared with the original tree. z7elem.copy() is deprecated. Use copy.copy(elem) instead.)�warnings�warn�DeprecationWarning�__copy__r1 r" r" r# �copy� s �z Element.copyc C s0 | � | j| j�}| j|_| j|_| |d d �< |S �N)r4 r$ r+ �text�tail)r- �elemr" r" r# r8 � s zElement.__copy__c C � t | j�S r: )�lenr, r1 r" r" r# �__len__� � zElement.__len__c C s t jdtdd� t| j�dkS )NzyThe behavior of this method will change in future versions. Use specific 'len(elem)' or 'elem is not None' test instead.� �� stacklevelr )r5 r6 � FutureWarningr? r, r1 r" r" r# �__bool__� s �zElement.__bool__c C s | j | S r: �r, �r- �indexr" r" r# � __getitem__� rA zElement.__getitem__c C s8 t |t�r|D ]}| �|� qn| �|� || j|< d S r: )r' �slice�_assert_is_elementr, )r- rI r& �eltr" r" r# � __setitem__� s � zElement.__setitem__c C s | j |= d S r: rG rH r" r" r# � __delitem__� s zElement.__delitem__c C s | � |� | j�|� dS )a Add *subelement* to the end of this element. The new element will appear in document order after the last existing subelement (or directly after the text, if it's the first subelement), but before the end tag for this element. N�rL r, �append�r- � subelementr" r" r# rQ � s zElement.appendc C s$ |D ] }| � |� | j�|� qdS )zkAppend subelements from a sequence. *elements* is a sequence with zero or more elements. NrP )r- �elementsr& r" r" r# �extend� s �zElement.extendc C s | � |� | j�||� dS )z(Insert *subelement* at position *index*.N)rL r, �insert)r- rI rS r" r" r# rV s zElement.insertc C s t |t�stdt|�j ��d S )Nzexpected an Element, not %s)r' � _Element_Pyr) �typer )r- �er" r" r# rL s �zElement._assert_is_elementc C � | j �|� dS )a� Remove matching subelement. Unlike the find methods, this method compares elements based on identity, NOT ON tag value or contents. To remove subelements by other means, the easiest way is to use a list comprehension to select what elements to keep, and then use slice assignment to update the parent element. ValueError is raised if a matching element could not be found. N)r, �removerR r" r" r# r[ s zElement.removec C � t �| ||�S )a Find first matching element by tag name or path. *path* is a string having either an element tag or an XPath, *namespaces* is an optional mapping from namespace prefix to full name. Return the first matching element, or None if no element was found. )r �find�r- �path� namespacesr" r" r# r] � z Element.findc C s t �| |||�S )a� Find text for first matching element by tag name or path. *path* is a string having either an element tag or an XPath, *default* is the value to return if the element was not found, *namespaces* is an optional mapping from namespace prefix to full name. Return text content of first matching element, or default value if none was found. Note that if an element is found having no text content, the empty string is returned. )r �findtext�r- r_ �defaultr` r" r" r# rb & s zElement.findtextc C r\ )a Find all matching subelements by tag name or path. *path* is a string having either an element tag or an XPath, *namespaces* is an optional mapping from namespace prefix to full name. Returns list containing all matching elements in document order. )r �findallr^ r" r" r# re 4 ra zElement.findallc C r\ )a Find all matching subelements by tag name or path. *path* is a string having either an element tag or an XPath, *namespaces* is an optional mapping from namespace prefix to full name. Return an iterable yielding all matching elements in document order. )r �iterfindr^ r" r" r# rf ? ra zElement.iterfindc C s | j �� g | _d | _| _dS )z�Reset element. This function removes all subelements, clears all attributes, and sets the text and tail attributes to None. N)r+ �clearr, r; r< r1 r" r" r# rg J s z Element.clearc C s | j �||�S )ag Get element attribute. Equivalent to attrib.get, but some implementations may handle this a bit more efficiently. *key* is what attribute to look for, and *default* is what to return if the attribute was not found. Returns a string containing the attribute value, or the default if attribute was not found. )r+ �get)r- �keyrd r" r" r# rh U s z Element.getc C s || j |< dS )z�Set element attribute. Equivalent to attrib[key] = value, but some implementations may handle this a bit more efficiently. *key* is what attribute to set, and *value* is the attribute value to set it to. N)r+ )r- ri �valuer" r" r# �setb s z Element.setc C � | j �� S )z�Get list of attribute names. Names are returned in an arbitrary order, just like an ordinary Python dict. Equivalent to attrib.keys() )r+ �keysr1 r" r" r# rm l s z Element.keysc C rl )z�Get element attributes as a sequence. The attributes are returned in arbitrary order. Equivalent to attrib.items(). Return a list of (name, value) tuples. )r+ �itemsr1 r" r" r# rn u s z Element.itemsc c sF � |dkrd}|du s| j |kr| V | jD ] }|�|�E dH qdS )a Create tree iterator. The iterator loops over the element and all subelements in document order, returning all elements with a matching tag. If the tree structure is modified during iteration, new or removed elements may or may not be included. To get a stable set, use the list() function on the iterator, and loop over the resulting list. *tag* is what tags to look for (default is to return all elements) Return an iterator containing all the matching elements. �*N)r$ r, �iter)r- r$ rY r" r" r# rp � s � �z Element.iterc c sZ � | j }t|t�s|durdS | j}|r|V | D ]}|�� E dH |j}|r*|V qdS )z�Create text iterator. The iterator loops over the element and all subelements in document order, returning all inner text. N)r$ r' �strr; �itertextr< )r- r$ �trY r" r" r# rr � s ���zElement.itertextr: �NN)"r r r r! r$ r+ r; r< r/ r2 r4 r9 r8 r@ rF rJ rN rO rQ rU rV rL r[ r] rb re rf rg rh rk rm rn rp rr r" r" r" r# r } sH r c K s& i |�|�}| � ||�}| �|� |S )a� Subelement factory which creates an element instance, and appends it to an existing parent. The element tag, attribute names, and attribute values can be either bytes or Unicode strings. *parent* is the parent element, *tag* is the subelements name, *attrib* is an optional directory containing element attributes, *extra* are additional attributes given as keyword arguments. )r4 rQ )�parentr$ r+ r. r& r" r" r# r � s r c C s t t�}| |_|S )z�Comment element factory. This function creates a special element which the standard serializer serializes as an XML comment. *text* is a string containing the comment string. )r r r; )r; r& r" r" r# r � s r c C s& t t�}| |_|r|jd | |_|S )a* Processing Instruction element factory. This function creates a special element which the standard serializer serializes as an XML comment. *target* is a string containing the processing instruction, *text* is a string containing the processing instruction contents, if any. � )r r r; )�targetr; r& r" r" r# r � s r c @ sZ e Zd ZdZddd�Zdd� Zdd� Zd d � Zd d � Zd d� Z dd� Z dd� Z dd� Z dS )r a� Qualified name wrapper. This class can be used to wrap a QName attribute value in order to get proper namespace handing on output. *text_or_uri* is a string containing the QName value either in the form {uri}local, or if the tag argument is given, the URI part of a QName. *tag* is an optional argument which if given, will make the first argument (text_or_uri) be interpreted as a URI, and this argument (tag) be interpreted as a local name. Nc C s |rd||f }|| _ d S )Nz{%s}%s�r; )r- � text_or_urir$ r" r" r# r/ � s zQName.__init__c C � | j S r: rx r1 r" r" r# �__str__� s z QName.__str__c C s d| j j| jf S )Nz<%s %r>)r* r r; r1 r" r" r# r2 � � zQName.__repr__c C r> r: )�hashr; r1 r" r" r# �__hash__� rA zQName.__hash__c C s t |t�r | j|jkS | j|kS r: �r' r r; �r- �otherr" r" r# �__le__� � z QName.__le__c C s t |t�r | j|jk S | j|k S r: r r� r" r" r# �__lt__� r� z QName.__lt__c C s t |t�r | j|jkS | j|kS r: r r� r" r" r# �__ge__� r� z QName.__ge__c C s t |t�r | j|jkS | j|kS r: r r� r" r" r# �__gt__ r� z QName.__gt__c C s t |t�r | j|jkS | j|kS r: r r� r" r" r# �__eq__ r� z QName.__eq__r: ) r r r r! r/ r{ r2 r~ r� r� r� r� r� r" r" r" r# r � s r c @ s� e Zd ZdZddd�Zdd� Zdd� Zd d d �Zd d d �Zd d d�Z ddd�Z d dd�Z d dd�Z d dd�dd�Z dd� ZdS ) r a% An XML element hierarchy. This class also provides support for serialization to and from standard XML. *element* is an optional root element node, *file* is an optional file handle or file name of an XML file whose contents will be used to initialize the tree with. Nc C s || _ |r | �|� d S d S r: )�_rootr )r- r& �filer" r" r# r/ s �zElementTree.__init__c C rz )z!Return root element of this tree.�r� r1 r" r" r# �getroot s zElementTree.getrootc C s || _ dS )z�Replace root element of this tree. This will discard the current contents of the tree and replace it with the given element. Use with care! Nr� )r- r& r" r" r# �_setroot" s zElementTree._setrootc C s� d}t |d�st|d�}d}z<|du r,t� }t |d�r,|�|�| _| jW |r+|�� S S |�d�}|s5n|�|� q-|�� | _| jW |rJ|�� S S |rR|�� w w )a= Load external XML document into element tree. *source* is a file name or file object, *parser* is an optional parser instance that defaults to XMLParser. ParseError is raised if the parser fails to parse the document. Returns the root element of the given source document. F�read�rbTN� _parse_wholei )r% �openr r� r� �closer� �feed)r- �source�parser� close_source�datar" r" r# r , s4 �� � � �zElementTree.parsec C s | j �|�S )z�Create and return tree iterator for the root element. The iterator loops over all elements in this tree, in document order. *tag* is a string with the tag name to iterate over (default is to return all elements). )r� rp �r- r$ r" r" r# rp Q s zElementTree.iterc C �: |dd� dkrd| }t jd| tdd� | j�||�S )a\ Find first matching element by tag name or path. Same as getroot().find(path), which is Element.find() *path* is a string having either an element tag or an XPath, *namespaces* is an optional mapping from namespace prefix to full name. Return the first matching element, or None if no element was found. Nr �/�.��This search is broken in 1.3 and earlier, and will be fixed in a future version. If you rely on the current behaviour, change it to %rrB rC )r5 r6 rE r� r] r^ r" r" r# r] ] � ��zElementTree.findc C s< |dd� dkrd| }t jd| tdd� | j�|||�S )ae Find first matching element by tag name or path. Same as getroot().findtext(path), which is Element.findtext() *path* is a string having either an element tag or an XPath, *namespaces* is an optional mapping from namespace prefix to full name. Return the first matching element, or None if no element was found. Nr r� r� r� rB rC )r5 r6 rE r� rb rc r" r" r# rb s s ��zElementTree.findtextc C r� )aa Find all matching subelements by tag name or path. Same as getroot().findall(path), which is Element.findall(). *path* is a string having either an element tag or an XPath, *namespaces* is an optional mapping from namespace prefix to full name. Return list containing all matching elements in document order. Nr r� r� r� rB rC )r5 r6 rE r� re r^ r" r" r# re � r� zElementTree.findallc C r� )ag Find all matching subelements by tag name or path. Same as getroot().iterfind(path), which is element.iterfind() *path* is a string having either an element tag or an XPath, *namespaces* is an optional mapping from namespace prefix to full name. Return an iterable yielding all matching elements in document order. Nr r� r� r� rB rC )r5 r6 rE r� rf r^ r" r" r# rf � r� zElementTree.iterfindT��short_empty_elementsc C s� |sd}n |t vrtd| ��|s|dkrd}nd}t||��Q\}}|dkr?|s8|du r?|�� dkr?|�� dvr?|d |f � |d krJt|| j� n t| j|�\} } t | } | || j| | |d � W d � dS W d � dS 1 ssw Y dS ) a� Write element tree to a file as XML. Arguments: *file_or_filename* -- file name or a file object opened for writing *encoding* -- the output encoding (default: US-ASCII) *xml_declaration* -- bool indicating if an XML declaration should be added to the output. If None, an XML declaration is added if encoding IS NOT either of: US-ASCII, UTF-8, or Unicode *default_namespace* -- sets the default XML namespace (for "xmlns") *method* -- either "xml" (default), "html, "text", or "c14n" *short_empty_elements* -- controls the formatting of elements that contain no content. If True (default) they are emitted as a single self-closed tag, otherwise they are emitted as a pair of start/end tags �xmlzunknown method %r�c14n�utf-8�us-asciiN�unicode)r� r� z$<?xml version='1.0' encoding='%s'?> r; r� )� _serialize� ValueError� _get_writer�lower�_serialize_textr� � _namespaces) r- �file_or_filename�encoding�xml_declaration�default_namespace�methodr� �write�declared_encoding�qnamesr` � serializer" r" r# r� � s4 � ��"�zElementTree.writec C s | j |dd�S )Nr� )r� )r� )r- r� r" r" r# � write_c14n� s zElementTree.write_c14nrt r: )NNNN)r r r r! r/ r� r� r rp r] rb re rf r� r� r" r" r" r# r s& % � � 5r c c sf � z| j }W n2 ty8 |�� dkrd}t| d|dd��}|j |fV W d � Y d S 1 s0w Y Y d S w |�� dkrL|t| dd �pGdfV d S t�� �Y}t| tj �rZ| }n2t| tj �rlt� | �}|� |j � n t� � }dd� |_||_ z | j|_| j|_W n ty� Y nw tj||dd d �}|� |j � |j |fV W d � d S 1 s�w Y d S ) Nr� r� �w�xmlcharrefreplace)r� �errorsr� c S � dS �NTr" r" r" r" r# �<lambda> s z _get_writer.<locals>.<lambda>� )r� r� �newline)r� �AttributeErrorr� r� �getattr� contextlib� ExitStackr' �io�BufferedIOBase� RawIOBase�BufferedWriter�callback�detach�writable�seekable�tell� TextIOWrapper)r� r� r� r� �stackr" r" r# r� � sL � �&�� �� "�r� c s d d i�i �� r d�� < � ��fdd�}| � � D ]m} | j}t|t�r-|j�vr,||j� n t|t�r;|�vr:||� n|d urK|turK|turKt|� | � � D ]#\}}t|t�r[|j}|�vrc||� t|t�rr|j�vrr||j� qO| j}t|t�r�|j�vr�||j� q��fS )N� c s� zU| d d� dkrI| dd � � dd�\}}��|�}|d u r5t�|�}|d u r-dt�� }|dkr5|�|< |rBd||f �| < W d S |�| < W d S � rOtd��| �| < W d S tyc t| � Y d S w )Nr �{�}zns%dr� z%s:%sz<cannot use non-qualified names with default_namespace option)�rsplitrh �_namespace_mapr? r� r) �_raise_serialization_error)�qname�urir$ �prefix�r� r` r� r" r# � add_qname. s* � �z _namespaces.<locals>.add_qname) rp r$ r' r r; rq r r r� rn )r= r� r� r$ ri rj r; r" r� r# r� # s< � � � �r� c K s� |j }|j}|tu r| d| � n�|tu r | d| � n�|| }|d u r;|r,| t|�� |D ] }t| ||d |d� q.n�| d| � t|�� �} | sK|r�|rlt|�� dd� d�D ]\} } | rad| } | d | t | �f � qW| D ]%\} } t | t �rz| j} t | t �r�|| j } nt | �} | d || | f � qn|s�t |�s�|s�| d � |r�| t|�� |D ] }t| ||d |d� q�| d | d � n| d � |j r�| t|j �� d S d S )N� <!--%s-->�<?%s?>r� �<c S � | d S �Nr r" ��xr" r" r# r� v � z _serialize_xml.<locals>.<lambda>�ri �:� xmlns%s="%s"� %s="%s"�>�</z />)r$ r; r r � _escape_cdata�_serialize_xml�listrn �sorted�_escape_attribr' r r? r< ) r� r= r� r` r� �kwargsr$ r; rY rn �v�kr" r" r# r� ` s` �� � � ��r� ) �area�base�basefont�br�col�frame�hr�img�input�isindex�link�meta�paramc K s� |j }|j}|tu r| dt|� � n�|tu r | dt|� � n�|| }|d u r=|r0| t|�� |D ] }t| ||d � q2n�| d| � t|�� �}|sM|r�|rnt|�� dd� d�D ]\} } | rcd| } | d| t | �f � qY|D ]%\} } t | t �r|| j} t | t �r�|| j } nt | �} | d || | f � qp| d � |� � } |r�| d ks�| d kr�| |� n| t|�� |D ] }t| ||d � q�| tvr�| d | d � |jr�| t|j�� d S d S )Nr� r� r� c S r� r� r" r� r" r" r# r� � r� z!_serialize_html.<locals>.<lambda>r� r� r� r� r� �script�styler� )r$ r; r r� r �_serialize_htmlr� rn r� r� r' r �_escape_attrib_htmlr� � HTML_EMPTYr< ) r� r= r� r` r� r$ r; rY rn r� r� �ltagr" r" r# r� � s\ � � � �r� c C s. |� � D ]}| |� q|jr| |j� d S d S r: )rr r< )r� r= �partr" r" r# r� � s �r� )r� �htmlr; c C sL t �d| �r td��tt�� �D ]\}}||ks || kr t|= q| t|< dS )at Register a namespace prefix. The registry is global, and any existing mapping for either the given prefix or the namespace URI will be removed. *prefix* is the namespace prefix, *uri* is a namespace uri. Tags and attributes in this namespace will be serialized with prefix if possible. ValueError is raised if prefix is reserved or is invalid. zns\d+$z'Prefix format reserved for internal useN)�re�matchr� r� r� rn )r� r� r� r� r" r" r# r � s � r r� r �rdf�wsdl�xs�xsi�dc)�$http://www.w3.org/XML/1998/namespacez http://www.w3.org/1999/xhtmlz+http://www.w3.org/1999/02/22-rdf-syntax-ns#z http://schemas.xmlsoap.org/wsdl/z http://www.w3.org/2001/XMLSchemaz)http://www.w3.org/2001/XMLSchema-instancez http://purl.org/dc/elements/1.1/c C s t d| t| �jf ��)Nz cannot serialize %r (type %s))r) rX r rx r" r" r# r� � s �r� c C �d z!d| v r | � dd�} d| v r| � dd�} d| v r | � dd�} | W S ttfy1 t| � Y d S w )N�&�&r� �<r� �>��replacer) r� r� rx r" r" r# r� s �r� c C s� zId| v r | � dd�} d| v r| � dd�} d| v r | � dd�} d| v r)| � dd�} d | v r3| � d d �} d | v r=| � d d �} d | v rG| � d d�} | W S ttfyY t| � Y d S w )Nr r r� r r� r �"�"� z r� z � z	r rx r" r" r# r� s& �r� c C r )Nr r r� r r r r rx r" r" r# r� . s �r� T)r� r� r� c C s: |dkrt �� nt �� }t| �j||||||d� |�� S )a Generate string representation of XML element. All subelements are included. If encoding is "unicode", a string is returned. Otherwise a bytestring is returned. *element* is an Element instance, *encoding* is an optional output encoding defaulting to US-ASCII, *method* is an optional output which can be one of "xml" (default), "html", "text" or "c14n", *default_namespace* sets the default XML namespace (for "xmlns"). Returns an (optionally) encoded string containing the XML data. r� �r� r� r� r� )r� �StringIO�BytesIOr r� �getvalue)r& r� r� r� r� r� �streamr" r" r# r = s �r c @ s8 e Zd ZdZdd� Zdd� Zdd� Zdd � Zd d � Zd S ) �_ListDataStreamz7An auxiliary stream accumulating into a list reference.c C s || _ d S r: )�lst)r- r r" r" r# r/ W rA z_ListDataStream.__init__c C r� r� r" r1 r" r" r# r� Z � z_ListDataStream.writablec C r� r� r" r1 r" r" r# r� ] r z_ListDataStream.seekablec C s | j �|� d S r: )r rQ )r- �br" r" r# r� ` � z_ListDataStream.writec C r> r: )r? r r1 r" r" r# r� c rA z_ListDataStream.tellN) r r r r! r/ r� r� r� r� r" r" r" r# r U s r c C s* g }t |�}t| �j||||||d� |S )Nr )r r r� )r& r� r� r� r� r� r r r" r" r# r f s �r c C sP t | t�s t| �} | jtjdd� | �� j}|r |d dkr&tj�d� dS dS )a# Write element tree or element structure to sys.stdout. This function should be used for debugging only. *elem* is either an ElementTree, or a single Element. The exact output format is implementation dependent. In this version, it's written as an ordinary XML file. r� )r� ���r� N)r' r r� �sys�stdoutr� r< )r= r< r" r" r# r s s �r � c s` t | t�r | �� } |dk rtd|� ���t| �sdS d|� g�� ��fdd�� � | d� dS )a& Indent an XML document by inserting newlines and indentation space after elements. *tree* is the ElementTree or Element to modify. The (root) element itself will not be changed, but the tail text of all elements in its subtree will be adapted. *space* is the whitespace to insert for each indentation level, two space characters by default. *level* is the initial indentation level. Setting this to a higher value than 0 can be used for indenting subtrees that are more deeply nested inside of a document. r z,Initial indentation level must be >= 0, got Nr� c s� |d }z�| }W n t y �| � }��|� Y nw | jr'| j�� s*|| _| D ]}t|�r7� ||� |jr?|j�� sB||_q,|j�� sO�| |_d S d S r� )� IndexErrorrQ r; �stripr? r< )r= �level� child_level�child_indentation�child��_indent_children� indentations�spacer" r# r) � s$ � � �z indent.<locals>._indent_children)r' r r� r� r? )�treer+ r$ r" r( r# r � s r c C s t � }|�| |� |S )z�Parse XML document into element tree. *source* is a filename or file object containing XML data, *parser* is an optional parser instance defaulting to XMLParser. Return an ElementTree instance. )r r )r� r� r, r" r" r# r � s r c sP t ||d��� �fdd��G ��fdd�dtjj�}|� � d� _�~t� � � S )aJ Incrementally parse XML document into ElementTree. This class also reports what's going on to the user based on the *events* it is initialized with. The supported events are the strings "start", "end", "start-ns" and "end-ns" (the "ns" events are used to get detailed namespace information). If *events* is omitted, only "end" events are reported. *source* is a filename or file object containing XML data, *events* is a list of events to report back, *parser* is an optional parser instance. Returns an iterator providing (event, elem) pairs. )�events�_parserc 3 s� � d}z>t | d�st| d�} d}d V ��� E d H | �d�}|s#n��|� q��� }��� E d H |� _W |r@| �� d S d S |rI| �� w w )NFr� r� Ti @ )r% r� � read_eventsr� r� �_close_and_return_root�rootr� )r� r� r� r1 )�it� pullparserr" r# �iterator� s, � � � �ziterparse.<locals>.iteratorc s e Zd Z� ��jZdS )z$iterparse.<locals>.IterParseIteratorN)r r r �__next__r" )r4 r� r" r# �IterParseIterator� s r6 N)r � collections�abc�Iteratorr1 �next)r� r- r� r6 r" )r2 r4 r3 r� r# r � s r c @ s< e Zd Zd dd�dd�Zdd� Zdd� Zd d � Zd d � ZdS )r N)r. c C s< t �� | _|p tt� d�| _|d u rd}| j�| j|� d S )N�rw )�end)r7 �deque� _events_queuer r r. � _setevents)r- r- r. r" r" r# r/ � s zXMLPullParser.__init__c C s` | j du r td��|r.z | j �|� W dS ty- } z | j�|� W Y d}~dS d}~ww dS )� Feed encoded data to parser.Nz!feed() called after end of stream)r. r� r� � SyntaxErrorr> rQ )r- r� �excr" r" r# r� s ���zXMLPullParser.feedc C s | j �� }d | _ |S r: )r. r� )r- r1 r" r" r# r0 s z$XMLPullParser._close_and_return_rootc C s | � � dS )z�Finish feeding data to parser. Unlike XMLParser, does not return the root element. Use read_events() to consume elements from XMLPullParser. N)r0 r1 r" r" r# r� s zXMLPullParser.closec c s4 � | j }|r|�� }t|t�r|�|V |sdS dS )z�Return an iterator over currently available (event, elem) pairs. Events are consumed from the internal event queue as they are retrieved from the iterator. N)r> �popleftr' � Exception)r- r- �eventr" r" r# r/ " s � �zXMLPullParser.read_eventsr: )r r r r/ r� r0 r� r/ r" r" r" r# r � s r c C s" |st t� d�}|�| � |�� S )a Parse XML document from string constant. This function can be used to embed "XML Literals" in Python code. *text* is a string containing XML data, *parser* is an optional parser instance, defaulting to the standard XMLParser. Returns an Element instance. r; �r r r� r� )r; r� r" r" r# r 1 s r c C sR |st t� d�}|�| � |�� }i }|�� D ] }|�d�}|r$|||< q||fS )a Parse XML document from string constant for its IDs. *text* is a string containing XML data, *parser* is an optional parser instance, defaulting to the standard XMLParser. Returns an (Element, dict) tuple, in which the dict maps element id:s to elements. r; r0 )r r r� r� rp rh )r; r� r, �idsr= r0 r" r" r# r B s �r c C s, |st t� d�}| D ]}|�|� q |�� S )z�Parse XML document from sequence of string fragments. *sequence* is a list of other sequence, *parser* is an optional parser instance, defaulting to the standard XMLParser. Returns an Element instance. r; rF )�sequencer� r; r" r" r# r Z s r c @ sh e Zd ZdZdddddd�dd�Zdd� Zd d � Zd d � Zd d� Zdd� Z dd� Z ddd�Z dd� Z dS )r a8 Generic element structure builder. This builder converts a sequence of start, data, and end method calls to a well-formed element structure. You can use this class to build an element structure using a custom XML parser, or a parser for some other XML-like format. *element_factory* is an optional element factory which is called to create new Element instances, as necessary. *comment_factory* is a factory to create comments to be used instead of the standard factory. If *insert_comments* is false (the default), comments will not be inserted into the tree. *pi_factory* is a factory to create processing instructions to be used instead of the standard factory. If *insert_pis* is false (the default), processing instructions will not be inserted into the tree. NF)�comment_factory� pi_factory�insert_comments� insert_pisc C sd g | _ g | _d | _d | _d | _|d u rt}|| _|| _|d u r!t}|| _ || _ |d u r-t }|| _ d S r: ) �_data�_elem�_lastr� �_tailr �_comment_factoryrK r � _pi_factoryrL r �_factory)r- �element_factoryrI rJ rK rL r" r" r# r/ � s zTreeBuilder.__init__c C s. t | j�dks J d��| jdusJ d��| jS )z;Flush builder buffers and return toplevel document Element.r zmissing end tagsNzmissing toplevel element)r? rN r� r1 r" r" r# r� � s zTreeBuilder.closec C sj | j r3| jd ur.d�| j �}| jr | jjd u sJ d��|| j_n| jjd u s*J d��|| j_g | _ d S d S )Nr� zinternal error (tail)zinternal error (text))rM rO �joinrP r< r; �r- r; r" r" r# �_flush� s �zTreeBuilder._flushc C rZ )z Add text to current element.N)rM rQ �r- r� r" r" r# r� � s zTreeBuilder.datac C sX | � � | �||� | _}| jr| jd �|� n| jdu r!|| _| j�|� d| _|S )z�Open new element and return it. *tag* is the element name, *attrs* is a dict containing element attributes. r Nr )rW rS rO rN rQ r� rP )r- r$ �attrsr= r" r" r# �start� s zTreeBuilder.startc C s@ | � � | j�� | _| jj|ksJ d| jj|f ��d| _| jS )zOClose and return current Element. *tag* is the element name. z&end tag mismatch (expected %s, got %s)r )rW rN �poprO r$ rP r� r" r" r# r< � s ��zTreeBuilder.endc C s | � | j| j|�S )z`Create a comment using the comment_factory. *text* is the text of the comment. )�_handle_singlerQ rK rV r" r" r# �comment� s �zTreeBuilder.commentc C s | � | j| j||�S )z�Create a processing instruction using the pi_factory. *target* is the target name of the processing instruction. *text* is the data of the processing instruction, or ''. )r\ rR rL )r- rw r; r" r" r# �pi� s �zTreeBuilder.pic G s: ||� }|r| � � || _| jr| jd �|� d| _|S )Nr r )rW rO rN rQ rP )r- �factoryrV �argsr= r" r" r# r\ � s zTreeBuilder._handle_singler: ) r r r r! r/ r� rW r� rZ r< r] r^ r\ r" r" r" r# r l s � r c @ sp e Zd ZdZddd�dd�Zdd� Zdd � Zd d � Zd d � Zdd� Z dd� Z dd� Z dd� Z dd� Z dd� ZdS )r aa Element structure builder for XML source data based on the expat parser. *target* is an optional target object which defaults to an instance of the standard TreeBuilder class, *encoding* is an optional encoding string which if given, overrides the encoding specified in the XML file: http://www.iana.org/assignments/character-sets N)rw r� c C sN zddl m} W n ty# zdd l}W n ty td��w Y nw |�|d�}|d u r1t� }| | _| _| | _| _ |j | _ i | _ | j |_t|d�rQ| j|_t|d�rZ| j|_t|d�rc| j|_t|d�rl| j|_t|d �ru|j|_t|d �r~|j|_t|d �r�|j |_ d |_ d |_ d | _ i | _!z d |j" | _#W d S t$y� Y d S w )Nr ��expatz7No module named expat; use SimpleXMLTreeBuilder insteadr� rZ r< �start_ns�end_nsr� r] r^ r zExpat %d.%d.%d)%� xml.parsersrb � ImportError�pyexpat� ParserCreater r� r. rw �_target�error�_error�_names�_default�DefaultHandlerExpandr% �_start�StartElementHandler�_end�EndElementHandler� _start_ns�StartNamespaceDeclHandler�_end_ns�EndNamespaceDeclHandlerr� �CharacterDataHandlerr] �CommentHandlerr^ � ProcessingInstructionHandler� buffer_text�ordered_attributes�_doctype�entity� version_info�versionr� )r- rw r� rb r� r" r" r# r/ � sV ���� �zXMLParser.__init__c C s* | j }|j}|D ]�}|dkr d|_||| jfdd�}||_q|dkr/||| jfdd�}||_q|dkrNt| jd�rC||| j fd d�}n||fd d�}||_ q|d krmt| jd �rb||| j fd d�}n||fdd�}||_ q|dkr}||| fdd�}||_ q|dkr�||| fdd�}||_qtd| ��d S )NrZ r c S � |||| |�f� d S r: r" )r$ � attrib_inrE rQ rZ r" r" r# �handler) � z%XMLParser._setevents.<locals>.handlerr< c S � |||| �f� d S r: r" )r$ rE rQ r< r" r" r# r� . � zstart-nsrc c S r� r: r" )r� r� rE rQ rc r" r" r# r� 5 r� c S s ||| pd|pdff� d S �Nr� r" )r� r� rE rQ r" r" r# r� 9 s zend-nsrd c S r� r: r" )r� rE rQ rd r" r" r# r� ? r� c S s ||d f� d S r: r" )r� rE rQ r" r" r# r� C r r] c S s |||j �| �f� d S r: )rw r] )r; rE rQ r- r" r" r# r� G r3 r^ c S s |||j �| |�f� d S r: )rw r^ )� pi_targetr� rE rQ r- r" r" r# r� K s zunknown event %r)r. rQ r{ ro rp rq rr r% rw rs rt ru rv rx ry r� )r- � events_queue�events_to_reportr� rQ � event_namer� r" r" r# r? sL � � � � � �zXMLParser._seteventsc C s" t |�}|j|_|j|jf|_|�r: )r �code�lineno�offset�position)r- rj �errr" r" r# � _raiseerrorR s zXMLParser._raiseerrorc C sD z| j | }W |S ty! |}d|v rd| }|| j |< Y |S w )Nr� r� )rl �KeyError)r- ri �namer" r" r# �_fixnameX s � �zXMLParser._fixnamec C s | j �|pd|p d�S r� )rw rc �r- r� r� r" r" r# rs c s zXMLParser._start_nsc C s | j �|pd�S r� )rw rd )r- r� r" r" r# ru f r zXMLParser._end_nsc C sR | j }||�}i }|r"tdt|�d�D ]}||d |||| �< q| j�||�S )Nr rB r )r� �ranger? rw rZ )r- r$ � attr_list�fixnamer+ �ir" r" r# ro i s zXMLParser._startc C s | j �| �|��S r: )rw r< r� r� r" r" r# rq u r| zXMLParser._endc C s� |d d� }|dkrTz| j j}W n ty Y d S w z|| j|dd� � W d S tyS ddlm} |�d|| jj | jj f �}d|_ | jj |_ | jj |_ |�w |dkre|d d � d kreg | _d S | jd ur�|d krsd | _d S |�� }|s{d S | j�|� t| j�}|d kr�| jd }|d kr�|dkr�| j\}}} } | r�| dd� } n|dkr�|dkr�| j\}}} d } nd S t| j d�r�| j �|| | dd� � n t| d�r�t�dt� d | _d S d S d S )Nr r r r ra z'undefined entity %s: line %d, column %d� r� � z <!DOCTYPEr� rB �PUBLIC� �SYSTEM� �doctypezaThe doctype() method of XMLParser is ignored. Define doctype() method on the TreeBuilder target.)rw r� r� r} r� re rb rj r� �ErrorLineNumber�ErrorColumnNumberr� r� r� r| r# rQ r? r% r� r5 r6 �RuntimeWarning) r- r; r� � data_handlerrb r� �nrX r� �pubid�systemr" r" r# rm x sn � ��� � � � � zXMLParser._defaultc C sH z | j �|d� W dS | jy# } z | �|� W Y d}~dS d}~ww )r@ FN)r� �Parserk r� )r- r� r� r" r" r# r� � s ��zXMLParser.feedc C s� z | j �dd� W n | jy! } z | �|� W Y d}~nd}~ww z'z| jj}W n ty2 Y n w |� W | ` | `| `| `S W | ` | `| `| `dS | ` | `| `| `w )z;Finish feeding data to parser and return element structure.� TN) r� r� rk r� rw r� r� r. ri )r- r� � close_handlerr" r" r# r� � s& �� � � � zXMLParser.close)r r r r! r/ r? r� r� rs ru ro rq rm r� r� r" r" r" r# r � s -5 6 r )�out� from_filec K s� | du r |du r t d��d}|du rt�� }}tt|jfi |��d�}| dur2|�| � |�� n |dur<t||d� |durD|� � S dS )a3 Convert XML to its C14N 2.0 serialised form. If *out* is provided, it must be a file or file-like object that receives the serialised canonical XML output (text, not bytes) through its ``.write()`` method. To write to a file, open it in text mode with encoding "utf-8". If *out* is not provided, this function returns the output as text string. Either *xml_data* (an XML string) or *from_file* (a file path or file-like object) must be provided as input. The configuration options are the same as for the ``C14NWriterTarget``. Nz:Either 'xml_data' or 'from_file' must be provided as inputr; )r� ) r� r� r r r r� r� r� r r )�xml_datar� r� �options�sior� r" r" r# r � s r z ^\w+:\w+$c @ s� e Zd ZdZdddddddd�dd�Zefdd�Zd d � Zd d d �Zd d� Z dj fdd�Z dd� Z dd� Z d dd�Zdd� Zdd� Zd d � ZdS ) r a� Canonicalization writer target for the XMLParser. Serialises parse events to XML C14N 2.0. The *write* function is used for writing out the resulting data stream as text (not bytes). To write to a file, open it in text mode with encoding "utf-8" and pass its ``.write`` method. Configuration options: - *with_comments*: set to true to include comments - *strip_text*: set to true to strip whitespace before and after text content - *rewrite_prefixes*: set to true to replace namespace prefixes by "n{number}" - *qname_aware_tags*: a set of qname aware tag names in which prefixes should be replaced in text content - *qname_aware_attrs*: a set of qname aware attribute names in which prefixes should be replaced in text content - *exclude_attrs*: a set of attribute names that should not be serialised - *exclude_tags*: a set of tag names that should not be serialised FN)� with_comments� strip_text�rewrite_prefixes�qname_aware_tags�qname_aware_attrs� exclude_attrs� exclude_tagsc C s� || _ g | _|| _|| _|rt|�nd | _|rt|�nd | _|| _|r)t|�| _nd | _|r5t|�j | _ nd | _ dgg| _ g | _ |sL| j � tt�� �� | j � g � i | _dg| _d | _d| _d| _d| _d S )N)r r� Fr )�_writerM �_with_comments� _strip_textrk �_exclude_attrs� _exclude_tags�_rewrite_prefixes�_qname_aware_tags� intersection�_find_qname_aware_attrs�_declared_ns_stack� _ns_stackrQ r� r� rn � _prefix_map�_preserve_space�_pending_start� _root_seen� _root_done�_ignored_depth) r- r� r� r� r� r� r� r� r� r" r" r# r/ s2 � zC14NWriterTarget.__init__c c s" � ||�D ] }|r|E d H qd S r: r" )r- �ns_stack� _reversedr` r" r" r# �_iter_namespaces& s � ��z!C14NWriterTarget._iter_namespacesc C sX |� dd�\}}| �| j�D ]\}}||kr d|� d|� � S qtd|� d|� d���)Nr� r r� r� zPrefix z of QName "�" is not declared in scope)�splitr� r� r� )r- � prefixed_namer� r� r� �pr" r" r# �_resolve_prefix_name+ s �z%C14NWriterTarget._resolve_prefix_namec C sx |d u r |d d� dkr|dd � � dd�nd|f\}}n|}t� }| �| j�D ]!\}}||krD||vrD|r=|� d|� �n|||f S |�|� q(| jry|| jv rX| j| }n dt| j�� � }| j|< | jd �||f� |� d|� �||fS |s�d|vr�|||fS | �| j �D ]"\}}||kr�| jd �||f� |r�|� d|� �n|||f S q�|s�|||fS t d|� d ���) Nr r� r� r� r� r� r z Namespace "r� ) r� rk r� r� �addr� r� r? rQ r� r� )r- r� r� r$ � prefixes_seen�ur� r" r" r# �_qname2 s0 2 � zC14NWriterTarget._qnamec C s | j s | j�|� d S d S r: )r� rM rQ rX r" r" r# r� W s �zC14NWriterTarget.datar� c C s� || j �}| j d d �= | jr| jd s|�� }| jd ur=| jd }| _|r+t|�r+|nd }| jg |�|�R � |d ur=d S |rK| jrM| �t |�� d S d S d S �Nr ) rM r� r� r# r� �_looks_like_prefix_namero r� r� �_escape_cdata_c14n)r- � _join_textr� r` � qname_textr" r" r# rW [ s �zC14NWriterTarget._flushc C s0 | j rd S | jr | �� | jd �||f� d S r� )r� rM rW r� rQ r� r" r" r# rc i s zC14NWriterTarget.start_nsc C s� | j d ur| js || j v r| jd7 _d S | jr | �� g }| j�|� | jd ur7|| jv r7|||f| _d S | �|||� d S r� ) r� r� rM rW r� rQ r� r� ro )r- r$ rY �new_namespacesr" r" r# rZ q s � zC14NWriterTarget.startc s� �j d ur|r�fdd�|�� D �}|h|�}i }|d ur+��|� }||< |�|� �jd urX|rX��|�}|rU|D ]} || } t| �rS��| � }|| < |�|� q;nd }nd }�j� � fdd�t|dd� d�D �} |rzdd� |D �} | �� ng } |r�t|�� �D ]*\} }|d ur�| |v r�||v r�| || d }| | \}} }| � |r�|n| |f� q�|� d �}�j � |r�|d kn�j d � �j }|d | | d � | r�|d� dd� | D ��� |d� |d ur�|t| || d �� d�_�j� g � d S )Nc s i | ] \}}|� j vr||�qS r" )r� ��.0r� r� r1 r" r# � <dictcomp>� s z+C14NWriterTarget._start.<locals>.<dictcomp>c s i | ]}|� |��qS r" r" )r� r� )� parse_qnamer" r# r� � s c S s | � dd�S )Nr� r )r� )r� r" r" r# r� � s z)C14NWriterTarget._start.<locals>.<lambda>r� c S s$ g | ]\}}|r d | nd|f�qS )zxmlns:�xmlnsr" )r� r� r� r" r" r# � <listcomp>� s ��z+C14NWriterTarget._start.<locals>.<listcomp>r z+{http://www.w3.org/XML/1998/namespace}space�preserver r� r� c S s& g | ]\}}d |� dt |�� d��qS )rv z="r )�_escape_attrib_c14nr� r" r" r# r� � s & r� T)r� rn r� r� r� r� r� r� �sortrQ rh r� r� rU r� r� r� )r- r$ rY r� r� r� �resolved_namesr� �qattrs� attr_namerj � parsed_qnamesr� r� r� � attr_qnamer� �space_behaviourr� r" )r� r- r# ro � sb �� �� �zC14NWriterTarget._startc C st | j r | j d8 _ d S | jr| �� | �d| �|�d � d�� | j�� t| j�dk| _| j �� | j �� d S )Nr r� r r� ) r� rM rW r� r� r� r[ r? r� r� r� r� r" r" r# r< � s zC14NWriterTarget.endc C sh | j sd S | jr d S | jr| �d� n | jr | jr | �� | �dt|�� d�� | js2| �d� d S d S )Nr� z<!--z-->)r� r� r� r� r� rM rW r� rV r" r" r# r] � s �zC14NWriterTarget.commentc C st | j rd S | jr| �d� n | jr| jr| �� | �|r'd|� dt|�� d�nd|� d�� | js8| �d� d S d S )Nr� z<?rv z?>)r� r� r� r� rM rW r� )r- rw r� r" r" r# r^ � s $��zC14NWriterTarget.pir: )r r r r! r/ �reversedr� r� r� r� rU rW rc rZ ro r< r] r^ r" r" r" r# r � s" � % % E r c C sx z+d| v r | � dd�} d| v r| � dd�} d| v r | � dd�} d| v r)| � dd�} | W S ttfy; t| � Y d S w ) Nr r r� r r� r r �
r rx r" r" r# r� � s �r� c C s� z?d| v r | � dd�} d| v r| � dd�} d| v r | � dd�} d| v r)| � dd�} d | v r3| � d d �} d | v r=| � d d �} | W S ttfyO t| � Y d S w ) Nr r r� r r r r z	r� z
r r� r rx r" r" r# r� s" �r� )ro )�_set_factoriesr: rt )r! r )Ar! �__all__r r r r5 r� r7 �collections.abcr� r� r rA r r r r r r r r r �contextmanagerr� r� r� r� rk � NameErrorr� r� r� r r� r� r� r� r� r r� r r r r r r r r r r r r r r �compile�UNICODEr r� r r� r� rW � _elementtreer� rf r" r" r" r# �<module> s� H / 0 e 1=2 �2� � � � 6 2 5 z e � etree/__pycache__/cElementTree.cpython-310.pyc 0000644 00000000260 15027446000 0015131 0 ustar 00 o }�5hR � @ s d dl T dS )� )�*N)�xml.etree.ElementTree� r r �-/usr/lib/python3.10/xml/etree/cElementTree.py�<module> s etree/cElementTree.py 0000644 00000000122 15027446000 0010567 0 ustar 00 # Deprecated alias for xml.etree.ElementTree from xml.etree.ElementTree import * etree/ElementInclude.py 0000644 00000015342 15027446000 0011122 0 ustar 00 # # ElementTree # $Id: ElementInclude.py 3375 2008-02-13 08:05:08Z fredrik $ # # limited xinclude support for element trees # # history: # 2003-08-15 fl created # 2003-11-14 fl fixed default loader # # Copyright (c) 2003-2004 by Fredrik Lundh. All rights reserved. # # fredrik@pythonware.com # http://www.pythonware.com # # -------------------------------------------------------------------- # The ElementTree toolkit is # # Copyright (c) 1999-2008 by Fredrik Lundh # # By obtaining, using, and/or copying this software and/or its # associated documentation, you agree that you have read, understood, # and will comply with the following terms and conditions: # # Permission to use, copy, modify, and distribute this software and # its associated documentation for any purpose and without fee is # hereby granted, provided that the above copyright notice appears in # all copies, and that both that copyright notice and this permission # notice appear in supporting documentation, and that the name of # Secret Labs AB or the author not be used in advertising or publicity # pertaining to distribution of the software without specific, written # prior permission. # # SECRET LABS AB AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD # TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANT- # ABILITY AND FITNESS. IN NO EVENT SHALL SECRET LABS AB OR THE AUTHOR # BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY # DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, # WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS # ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE # OF THIS SOFTWARE. # -------------------------------------------------------------------- # Licensed to PSF under a Contributor Agreement. # See https://www.python.org/psf/license for licensing details. ## # Limited XInclude support for the ElementTree package. ## import copy from . import ElementTree from urllib.parse import urljoin XINCLUDE = "{http://www.w3.org/2001/XInclude}" XINCLUDE_INCLUDE = XINCLUDE + "include" XINCLUDE_FALLBACK = XINCLUDE + "fallback" # For security reasons, the inclusion depth is limited to this read-only value by default. DEFAULT_MAX_INCLUSION_DEPTH = 6 ## # Fatal include error. class FatalIncludeError(SyntaxError): pass class LimitedRecursiveIncludeError(FatalIncludeError): pass ## # Default loader. This loader reads an included resource from disk. # # @param href Resource reference. # @param parse Parse mode. Either "xml" or "text". # @param encoding Optional text encoding (UTF-8 by default for "text"). # @return The expanded resource. If the parse mode is "xml", this # is an ElementTree instance. If the parse mode is "text", this # is a Unicode string. If the loader fails, it can return None # or raise an OSError exception. # @throws OSError If the loader fails to load the resource. def default_loader(href, parse, encoding=None): if parse == "xml": with open(href, 'rb') as file: data = ElementTree.parse(file).getroot() else: if not encoding: encoding = 'UTF-8' with open(href, 'r', encoding=encoding) as file: data = file.read() return data ## # Expand XInclude directives. # # @param elem Root element. # @param loader Optional resource loader. If omitted, it defaults # to {@link default_loader}. If given, it should be a callable # that implements the same interface as <b>default_loader</b>. # @param base_url The base URL of the original file, to resolve # relative include file references. # @param max_depth The maximum number of recursive inclusions. # Limited to reduce the risk of malicious content explosion. # Pass a negative value to disable the limitation. # @throws LimitedRecursiveIncludeError If the {@link max_depth} was exceeded. # @throws FatalIncludeError If the function fails to include a given # resource, or if the tree contains malformed XInclude elements. # @throws IOError If the function fails to load a given resource. # @returns the node or its replacement if it was an XInclude node def include(elem, loader=None, base_url=None, max_depth=DEFAULT_MAX_INCLUSION_DEPTH): if max_depth is None: max_depth = -1 elif max_depth < 0: raise ValueError("expected non-negative depth or None for 'max_depth', got %r" % max_depth) if hasattr(elem, 'getroot'): elem = elem.getroot() if loader is None: loader = default_loader _include(elem, loader, base_url, max_depth, set()) def _include(elem, loader, base_url, max_depth, _parent_hrefs): # look for xinclude elements i = 0 while i < len(elem): e = elem[i] if e.tag == XINCLUDE_INCLUDE: # process xinclude directive href = e.get("href") if base_url: href = urljoin(base_url, href) parse = e.get("parse", "xml") if parse == "xml": if href in _parent_hrefs: raise FatalIncludeError("recursive include of %s" % href) if max_depth == 0: raise LimitedRecursiveIncludeError( "maximum xinclude depth reached when including file %s" % href) _parent_hrefs.add(href) node = loader(href, parse) if node is None: raise FatalIncludeError( "cannot load %r as %r" % (href, parse) ) node = copy.copy(node) # FIXME: this makes little sense with recursive includes _include(node, loader, href, max_depth - 1, _parent_hrefs) _parent_hrefs.remove(href) if e.tail: node.tail = (node.tail or "") + e.tail elem[i] = node elif parse == "text": text = loader(href, parse, e.get("encoding")) if text is None: raise FatalIncludeError( "cannot load %r as %r" % (href, parse) ) if e.tail: text += e.tail if i: node = elem[i-1] node.tail = (node.tail or "") + text else: elem.text = (elem.text or "") + text del elem[i] continue else: raise FatalIncludeError( "unknown parse type in xi:include tag (%r)" % parse ) elif e.tag == XINCLUDE_FALLBACK: raise FatalIncludeError( "xi:fallback tag must be child of xi:include (%r)" % e.tag ) else: _include(e, loader, base_url, max_depth, _parent_hrefs) i += 1 etree/ElementPath.py 0000644 00000033177 15027446000 0010441 0 ustar 00 # # ElementTree # $Id: ElementPath.py 3375 2008-02-13 08:05:08Z fredrik $ # # limited xpath support for element trees # # history: # 2003-05-23 fl created # 2003-05-28 fl added support for // etc # 2003-08-27 fl fixed parsing of periods in element names # 2007-09-10 fl new selection engine # 2007-09-12 fl fixed parent selector # 2007-09-13 fl added iterfind; changed findall to return a list # 2007-11-30 fl added namespaces support # 2009-10-30 fl added child element value filter # # Copyright (c) 2003-2009 by Fredrik Lundh. All rights reserved. # # fredrik@pythonware.com # http://www.pythonware.com # # -------------------------------------------------------------------- # The ElementTree toolkit is # # Copyright (c) 1999-2009 by Fredrik Lundh # # By obtaining, using, and/or copying this software and/or its # associated documentation, you agree that you have read, understood, # and will comply with the following terms and conditions: # # Permission to use, copy, modify, and distribute this software and # its associated documentation for any purpose and without fee is # hereby granted, provided that the above copyright notice appears in # all copies, and that both that copyright notice and this permission # notice appear in supporting documentation, and that the name of # Secret Labs AB or the author not be used in advertising or publicity # pertaining to distribution of the software without specific, written # prior permission. # # SECRET LABS AB AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD # TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANT- # ABILITY AND FITNESS. IN NO EVENT SHALL SECRET LABS AB OR THE AUTHOR # BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY # DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, # WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS # ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE # OF THIS SOFTWARE. # -------------------------------------------------------------------- # Licensed to PSF under a Contributor Agreement. # See https://www.python.org/psf/license for licensing details. ## # Implementation module for XPath support. There's usually no reason # to import this module directly; the <b>ElementTree</b> does this for # you, if needed. ## import re xpath_tokenizer_re = re.compile( r"(" r"'[^']*'|\"[^\"]*\"|" r"::|" r"//?|" r"\.\.|" r"\(\)|" r"!=|" r"[/.*:\[\]\(\)@=])|" r"((?:\{[^}]+\})?[^/\[\]\(\)@!=\s]+)|" r"\s+" ) def xpath_tokenizer(pattern, namespaces=None): default_namespace = namespaces.get('') if namespaces else None parsing_attribute = False for token in xpath_tokenizer_re.findall(pattern): ttype, tag = token if tag and tag[0] != "{": if ":" in tag: prefix, uri = tag.split(":", 1) try: if not namespaces: raise KeyError yield ttype, "{%s}%s" % (namespaces[prefix], uri) except KeyError: raise SyntaxError("prefix %r not found in prefix map" % prefix) from None elif default_namespace and not parsing_attribute: yield ttype, "{%s}%s" % (default_namespace, tag) else: yield token parsing_attribute = False else: yield token parsing_attribute = ttype == '@' def get_parent_map(context): parent_map = context.parent_map if parent_map is None: context.parent_map = parent_map = {} for p in context.root.iter(): for e in p: parent_map[e] = p return parent_map def _is_wildcard_tag(tag): return tag[:3] == '{*}' or tag[-2:] == '}*' def _prepare_tag(tag): _isinstance, _str = isinstance, str if tag == '{*}*': # Same as '*', but no comments or processing instructions. # It can be a surprise that '*' includes those, but there is no # justification for '{*}*' doing the same. def select(context, result): for elem in result: if _isinstance(elem.tag, _str): yield elem elif tag == '{}*': # Any tag that is not in a namespace. def select(context, result): for elem in result: el_tag = elem.tag if _isinstance(el_tag, _str) and el_tag[0] != '{': yield elem elif tag[:3] == '{*}': # The tag in any (or no) namespace. suffix = tag[2:] # '}name' no_ns = slice(-len(suffix), None) tag = tag[3:] def select(context, result): for elem in result: el_tag = elem.tag if el_tag == tag or _isinstance(el_tag, _str) and el_tag[no_ns] == suffix: yield elem elif tag[-2:] == '}*': # Any tag in the given namespace. ns = tag[:-1] ns_only = slice(None, len(ns)) def select(context, result): for elem in result: el_tag = elem.tag if _isinstance(el_tag, _str) and el_tag[ns_only] == ns: yield elem else: raise RuntimeError(f"internal parser error, got {tag}") return select def prepare_child(next, token): tag = token[1] if _is_wildcard_tag(tag): select_tag = _prepare_tag(tag) def select(context, result): def select_child(result): for elem in result: yield from elem return select_tag(context, select_child(result)) else: if tag[:2] == '{}': tag = tag[2:] # '{}tag' == 'tag' def select(context, result): for elem in result: for e in elem: if e.tag == tag: yield e return select def prepare_star(next, token): def select(context, result): for elem in result: yield from elem return select def prepare_self(next, token): def select(context, result): yield from result return select def prepare_descendant(next, token): try: token = next() except StopIteration: return if token[0] == "*": tag = "*" elif not token[0]: tag = token[1] else: raise SyntaxError("invalid descendant") if _is_wildcard_tag(tag): select_tag = _prepare_tag(tag) def select(context, result): def select_child(result): for elem in result: for e in elem.iter(): if e is not elem: yield e return select_tag(context, select_child(result)) else: if tag[:2] == '{}': tag = tag[2:] # '{}tag' == 'tag' def select(context, result): for elem in result: for e in elem.iter(tag): if e is not elem: yield e return select def prepare_parent(next, token): def select(context, result): # FIXME: raise error if .. is applied at toplevel? parent_map = get_parent_map(context) result_map = {} for elem in result: if elem in parent_map: parent = parent_map[elem] if parent not in result_map: result_map[parent] = None yield parent return select def prepare_predicate(next, token): # FIXME: replace with real parser!!! refs: # http://javascript.crockford.com/tdop/tdop.html signature = [] predicate = [] while 1: try: token = next() except StopIteration: return if token[0] == "]": break if token == ('', ''): # ignore whitespace continue if token[0] and token[0][:1] in "'\"": token = "'", token[0][1:-1] signature.append(token[0] or "-") predicate.append(token[1]) signature = "".join(signature) # use signature to determine predicate type if signature == "@-": # [@attribute] predicate key = predicate[1] def select(context, result): for elem in result: if elem.get(key) is not None: yield elem return select if signature == "@-='" or signature == "@-!='": # [@attribute='value'] or [@attribute!='value'] key = predicate[1] value = predicate[-1] def select(context, result): for elem in result: if elem.get(key) == value: yield elem def select_negated(context, result): for elem in result: if (attr_value := elem.get(key)) is not None and attr_value != value: yield elem return select_negated if '!=' in signature else select if signature == "-" and not re.match(r"\-?\d+$", predicate[0]): # [tag] tag = predicate[0] def select(context, result): for elem in result: if elem.find(tag) is not None: yield elem return select if signature == ".='" or signature == ".!='" or ( (signature == "-='" or signature == "-!='") and not re.match(r"\-?\d+$", predicate[0])): # [.='value'] or [tag='value'] or [.!='value'] or [tag!='value'] tag = predicate[0] value = predicate[-1] if tag: def select(context, result): for elem in result: for e in elem.findall(tag): if "".join(e.itertext()) == value: yield elem break def select_negated(context, result): for elem in result: for e in elem.iterfind(tag): if "".join(e.itertext()) != value: yield elem break else: def select(context, result): for elem in result: if "".join(elem.itertext()) == value: yield elem def select_negated(context, result): for elem in result: if "".join(elem.itertext()) != value: yield elem return select_negated if '!=' in signature else select if signature == "-" or signature == "-()" or signature == "-()-": # [index] or [last()] or [last()-index] if signature == "-": # [index] index = int(predicate[0]) - 1 if index < 0: raise SyntaxError("XPath position >= 1 expected") else: if predicate[0] != "last": raise SyntaxError("unsupported function") if signature == "-()-": try: index = int(predicate[2]) - 1 except ValueError: raise SyntaxError("unsupported expression") if index > -2: raise SyntaxError("XPath offset from last() must be negative") else: index = -1 def select(context, result): parent_map = get_parent_map(context) for elem in result: try: parent = parent_map[elem] # FIXME: what if the selector is "*" ? elems = list(parent.findall(elem.tag)) if elems[index] is elem: yield elem except (IndexError, KeyError): pass return select raise SyntaxError("invalid predicate") ops = { "": prepare_child, "*": prepare_star, ".": prepare_self, "..": prepare_parent, "//": prepare_descendant, "[": prepare_predicate, } _cache = {} class _SelectorContext: parent_map = None def __init__(self, root): self.root = root # -------------------------------------------------------------------- ## # Generate all matching objects. def iterfind(elem, path, namespaces=None): # compile selector pattern if path[-1:] == "/": path = path + "*" # implicit all (FIXME: keep this?) cache_key = (path,) if namespaces: cache_key += tuple(sorted(namespaces.items())) try: selector = _cache[cache_key] except KeyError: if len(_cache) > 100: _cache.clear() if path[:1] == "/": raise SyntaxError("cannot use absolute path on element") next = iter(xpath_tokenizer(path, namespaces)).__next__ try: token = next() except StopIteration: return selector = [] while 1: try: selector.append(ops[token[0]](next, token)) except StopIteration: raise SyntaxError("invalid path") from None try: token = next() if token[0] == "/": token = next() except StopIteration: break _cache[cache_key] = selector # execute selector pattern result = [elem] context = _SelectorContext(elem) for select in selector: result = select(context, result) return result ## # Find first matching object. def find(elem, path, namespaces=None): return next(iterfind(elem, path, namespaces), None) ## # Find all matching objects. def findall(elem, path, namespaces=None): return list(iterfind(elem, path, namespaces)) ## # Find text for first matching object. def findtext(elem, path, default=None, namespaces=None): try: elem = next(iterfind(elem, path, namespaces)) return elem.text or "" except StopIteration: return default etree/ElementTree.py 0000644 00000220141 15027446000 0010431 0 ustar 00 """Lightweight XML support for Python. XML is an inherently hierarchical data format, and the most natural way to represent it is with a tree. This module has two classes for this purpose: 1. ElementTree represents the whole XML document as a tree and 2. Element represents a single node in this tree. Interactions with the whole document (reading and writing to/from files) are usually done on the ElementTree level. Interactions with a single XML element and its sub-elements are done on the Element level. Element is a flexible container object designed to store hierarchical data structures in memory. It can be described as a cross between a list and a dictionary. Each Element has a number of properties associated with it: 'tag' - a string containing the element's name. 'attributes' - a Python dictionary storing the element's attributes. 'text' - a string containing the element's text content. 'tail' - an optional string containing text after the element's end tag. And a number of child elements stored in a Python sequence. To create an element instance, use the Element constructor, or the SubElement factory function. You can also use the ElementTree class to wrap an element structure and convert it to and from XML. """ #--------------------------------------------------------------------- # Licensed to PSF under a Contributor Agreement. # See https://www.python.org/psf/license for licensing details. # # ElementTree # Copyright (c) 1999-2008 by Fredrik Lundh. All rights reserved. # # fredrik@pythonware.com # http://www.pythonware.com # -------------------------------------------------------------------- # The ElementTree toolkit is # # Copyright (c) 1999-2008 by Fredrik Lundh # # By obtaining, using, and/or copying this software and/or its # associated documentation, you agree that you have read, understood, # and will comply with the following terms and conditions: # # Permission to use, copy, modify, and distribute this software and # its associated documentation for any purpose and without fee is # hereby granted, provided that the above copyright notice appears in # all copies, and that both that copyright notice and this permission # notice appear in supporting documentation, and that the name of # Secret Labs AB or the author not be used in advertising or publicity # pertaining to distribution of the software without specific, written # prior permission. # # SECRET LABS AB AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD # TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANT- # ABILITY AND FITNESS. IN NO EVENT SHALL SECRET LABS AB OR THE AUTHOR # BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY # DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, # WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS # ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE # OF THIS SOFTWARE. # -------------------------------------------------------------------- __all__ = [ # public symbols "Comment", "dump", "Element", "ElementTree", "fromstring", "fromstringlist", "indent", "iselement", "iterparse", "parse", "ParseError", "PI", "ProcessingInstruction", "QName", "SubElement", "tostring", "tostringlist", "TreeBuilder", "VERSION", "XML", "XMLID", "XMLParser", "XMLPullParser", "register_namespace", "canonicalize", "C14NWriterTarget", ] VERSION = "1.3.0" import sys import re import warnings import io import collections import collections.abc import contextlib from . import ElementPath class ParseError(SyntaxError): """An error when parsing an XML document. In addition to its exception value, a ParseError contains two extra attributes: 'code' - the specific exception code 'position' - the line and column of the error """ pass # -------------------------------------------------------------------- def iselement(element): """Return True if *element* appears to be an Element.""" return hasattr(element, 'tag') class Element: """An XML element. This class is the reference implementation of the Element interface. An element's length is its number of subelements. That means if you want to check if an element is truly empty, you should check BOTH its length AND its text attribute. The element tag, attribute names, and attribute values can be either bytes or strings. *tag* is the element name. *attrib* is an optional dictionary containing element attributes. *extra* are additional element attributes given as keyword arguments. Example form: <tag attrib>text<child/>...</tag>tail """ tag = None """The element's name.""" attrib = None """Dictionary of the element's attributes.""" text = None """ Text before first subelement. This is either a string or the value None. Note that if there is no text, this attribute may be either None or the empty string, depending on the parser. """ tail = None """ Text after this element's end tag, but before the next sibling element's start tag. This is either a string or the value None. Note that if there was no text, this attribute may be either None or an empty string, depending on the parser. """ def __init__(self, tag, attrib={}, **extra): if not isinstance(attrib, dict): raise TypeError("attrib must be dict, not %s" % ( attrib.__class__.__name__,)) self.tag = tag self.attrib = {**attrib, **extra} self._children = [] def __repr__(self): return "<%s %r at %#x>" % (self.__class__.__name__, self.tag, id(self)) def makeelement(self, tag, attrib): """Create a new element with the same type. *tag* is a string containing the element name. *attrib* is a dictionary containing the element attributes. Do not call this method, use the SubElement factory function instead. """ return self.__class__(tag, attrib) def copy(self): """Return copy of current element. This creates a shallow copy. Subelements will be shared with the original tree. """ warnings.warn( "elem.copy() is deprecated. Use copy.copy(elem) instead.", DeprecationWarning ) return self.__copy__() def __copy__(self): elem = self.makeelement(self.tag, self.attrib) elem.text = self.text elem.tail = self.tail elem[:] = self return elem def __len__(self): return len(self._children) def __bool__(self): warnings.warn( "The behavior of this method will change in future versions. " "Use specific 'len(elem)' or 'elem is not None' test instead.", FutureWarning, stacklevel=2 ) return len(self._children) != 0 # emulate old behaviour, for now def __getitem__(self, index): return self._children[index] def __setitem__(self, index, element): if isinstance(index, slice): for elt in element: self._assert_is_element(elt) else: self._assert_is_element(element) self._children[index] = element def __delitem__(self, index): del self._children[index] def append(self, subelement): """Add *subelement* to the end of this element. The new element will appear in document order after the last existing subelement (or directly after the text, if it's the first subelement), but before the end tag for this element. """ self._assert_is_element(subelement) self._children.append(subelement) def extend(self, elements): """Append subelements from a sequence. *elements* is a sequence with zero or more elements. """ for element in elements: self._assert_is_element(element) self._children.append(element) def insert(self, index, subelement): """Insert *subelement* at position *index*.""" self._assert_is_element(subelement) self._children.insert(index, subelement) def _assert_is_element(self, e): # Need to refer to the actual Python implementation, not the # shadowing C implementation. if not isinstance(e, _Element_Py): raise TypeError('expected an Element, not %s' % type(e).__name__) def remove(self, subelement): """Remove matching subelement. Unlike the find methods, this method compares elements based on identity, NOT ON tag value or contents. To remove subelements by other means, the easiest way is to use a list comprehension to select what elements to keep, and then use slice assignment to update the parent element. ValueError is raised if a matching element could not be found. """ # assert iselement(element) self._children.remove(subelement) def find(self, path, namespaces=None): """Find first matching element by tag name or path. *path* is a string having either an element tag or an XPath, *namespaces* is an optional mapping from namespace prefix to full name. Return the first matching element, or None if no element was found. """ return ElementPath.find(self, path, namespaces) def findtext(self, path, default=None, namespaces=None): """Find text for first matching element by tag name or path. *path* is a string having either an element tag or an XPath, *default* is the value to return if the element was not found, *namespaces* is an optional mapping from namespace prefix to full name. Return text content of first matching element, or default value if none was found. Note that if an element is found having no text content, the empty string is returned. """ return ElementPath.findtext(self, path, default, namespaces) def findall(self, path, namespaces=None): """Find all matching subelements by tag name or path. *path* is a string having either an element tag or an XPath, *namespaces* is an optional mapping from namespace prefix to full name. Returns list containing all matching elements in document order. """ return ElementPath.findall(self, path, namespaces) def iterfind(self, path, namespaces=None): """Find all matching subelements by tag name or path. *path* is a string having either an element tag or an XPath, *namespaces* is an optional mapping from namespace prefix to full name. Return an iterable yielding all matching elements in document order. """ return ElementPath.iterfind(self, path, namespaces) def clear(self): """Reset element. This function removes all subelements, clears all attributes, and sets the text and tail attributes to None. """ self.attrib.clear() self._children = [] self.text = self.tail = None def get(self, key, default=None): """Get element attribute. Equivalent to attrib.get, but some implementations may handle this a bit more efficiently. *key* is what attribute to look for, and *default* is what to return if the attribute was not found. Returns a string containing the attribute value, or the default if attribute was not found. """ return self.attrib.get(key, default) def set(self, key, value): """Set element attribute. Equivalent to attrib[key] = value, but some implementations may handle this a bit more efficiently. *key* is what attribute to set, and *value* is the attribute value to set it to. """ self.attrib[key] = value def keys(self): """Get list of attribute names. Names are returned in an arbitrary order, just like an ordinary Python dict. Equivalent to attrib.keys() """ return self.attrib.keys() def items(self): """Get element attributes as a sequence. The attributes are returned in arbitrary order. Equivalent to attrib.items(). Return a list of (name, value) tuples. """ return self.attrib.items() def iter(self, tag=None): """Create tree iterator. The iterator loops over the element and all subelements in document order, returning all elements with a matching tag. If the tree structure is modified during iteration, new or removed elements may or may not be included. To get a stable set, use the list() function on the iterator, and loop over the resulting list. *tag* is what tags to look for (default is to return all elements) Return an iterator containing all the matching elements. """ if tag == "*": tag = None if tag is None or self.tag == tag: yield self for e in self._children: yield from e.iter(tag) def itertext(self): """Create text iterator. The iterator loops over the element and all subelements in document order, returning all inner text. """ tag = self.tag if not isinstance(tag, str) and tag is not None: return t = self.text if t: yield t for e in self: yield from e.itertext() t = e.tail if t: yield t def SubElement(parent, tag, attrib={}, **extra): """Subelement factory which creates an element instance, and appends it to an existing parent. The element tag, attribute names, and attribute values can be either bytes or Unicode strings. *parent* is the parent element, *tag* is the subelements name, *attrib* is an optional directory containing element attributes, *extra* are additional attributes given as keyword arguments. """ attrib = {**attrib, **extra} element = parent.makeelement(tag, attrib) parent.append(element) return element def Comment(text=None): """Comment element factory. This function creates a special element which the standard serializer serializes as an XML comment. *text* is a string containing the comment string. """ element = Element(Comment) element.text = text return element def ProcessingInstruction(target, text=None): """Processing Instruction element factory. This function creates a special element which the standard serializer serializes as an XML comment. *target* is a string containing the processing instruction, *text* is a string containing the processing instruction contents, if any. """ element = Element(ProcessingInstruction) element.text = target if text: element.text = element.text + " " + text return element PI = ProcessingInstruction class QName: """Qualified name wrapper. This class can be used to wrap a QName attribute value in order to get proper namespace handing on output. *text_or_uri* is a string containing the QName value either in the form {uri}local, or if the tag argument is given, the URI part of a QName. *tag* is an optional argument which if given, will make the first argument (text_or_uri) be interpreted as a URI, and this argument (tag) be interpreted as a local name. """ def __init__(self, text_or_uri, tag=None): if tag: text_or_uri = "{%s}%s" % (text_or_uri, tag) self.text = text_or_uri def __str__(self): return self.text def __repr__(self): return '<%s %r>' % (self.__class__.__name__, self.text) def __hash__(self): return hash(self.text) def __le__(self, other): if isinstance(other, QName): return self.text <= other.text return self.text <= other def __lt__(self, other): if isinstance(other, QName): return self.text < other.text return self.text < other def __ge__(self, other): if isinstance(other, QName): return self.text >= other.text return self.text >= other def __gt__(self, other): if isinstance(other, QName): return self.text > other.text return self.text > other def __eq__(self, other): if isinstance(other, QName): return self.text == other.text return self.text == other # -------------------------------------------------------------------- class ElementTree: """An XML element hierarchy. This class also provides support for serialization to and from standard XML. *element* is an optional root element node, *file* is an optional file handle or file name of an XML file whose contents will be used to initialize the tree with. """ def __init__(self, element=None, file=None): # assert element is None or iselement(element) self._root = element # first node if file: self.parse(file) def getroot(self): """Return root element of this tree.""" return self._root def _setroot(self, element): """Replace root element of this tree. This will discard the current contents of the tree and replace it with the given element. Use with care! """ # assert iselement(element) self._root = element def parse(self, source, parser=None): """Load external XML document into element tree. *source* is a file name or file object, *parser* is an optional parser instance that defaults to XMLParser. ParseError is raised if the parser fails to parse the document. Returns the root element of the given source document. """ close_source = False if not hasattr(source, "read"): source = open(source, "rb") close_source = True try: if parser is None: # If no parser was specified, create a default XMLParser parser = XMLParser() if hasattr(parser, '_parse_whole'): # The default XMLParser, when it comes from an accelerator, # can define an internal _parse_whole API for efficiency. # It can be used to parse the whole source without feeding # it with chunks. self._root = parser._parse_whole(source) return self._root while True: data = source.read(65536) if not data: break parser.feed(data) self._root = parser.close() return self._root finally: if close_source: source.close() def iter(self, tag=None): """Create and return tree iterator for the root element. The iterator loops over all elements in this tree, in document order. *tag* is a string with the tag name to iterate over (default is to return all elements). """ # assert self._root is not None return self._root.iter(tag) def find(self, path, namespaces=None): """Find first matching element by tag name or path. Same as getroot().find(path), which is Element.find() *path* is a string having either an element tag or an XPath, *namespaces* is an optional mapping from namespace prefix to full name. Return the first matching element, or None if no element was found. """ # assert self._root is not None if path[:1] == "/": path = "." + path warnings.warn( "This search is broken in 1.3 and earlier, and will be " "fixed in a future version. If you rely on the current " "behaviour, change it to %r" % path, FutureWarning, stacklevel=2 ) return self._root.find(path, namespaces) def findtext(self, path, default=None, namespaces=None): """Find first matching element by tag name or path. Same as getroot().findtext(path), which is Element.findtext() *path* is a string having either an element tag or an XPath, *namespaces* is an optional mapping from namespace prefix to full name. Return the first matching element, or None if no element was found. """ # assert self._root is not None if path[:1] == "/": path = "." + path warnings.warn( "This search is broken in 1.3 and earlier, and will be " "fixed in a future version. If you rely on the current " "behaviour, change it to %r" % path, FutureWarning, stacklevel=2 ) return self._root.findtext(path, default, namespaces) def findall(self, path, namespaces=None): """Find all matching subelements by tag name or path. Same as getroot().findall(path), which is Element.findall(). *path* is a string having either an element tag or an XPath, *namespaces* is an optional mapping from namespace prefix to full name. Return list containing all matching elements in document order. """ # assert self._root is not None if path[:1] == "/": path = "." + path warnings.warn( "This search is broken in 1.3 and earlier, and will be " "fixed in a future version. If you rely on the current " "behaviour, change it to %r" % path, FutureWarning, stacklevel=2 ) return self._root.findall(path, namespaces) def iterfind(self, path, namespaces=None): """Find all matching subelements by tag name or path. Same as getroot().iterfind(path), which is element.iterfind() *path* is a string having either an element tag or an XPath, *namespaces* is an optional mapping from namespace prefix to full name. Return an iterable yielding all matching elements in document order. """ # assert self._root is not None if path[:1] == "/": path = "." + path warnings.warn( "This search is broken in 1.3 and earlier, and will be " "fixed in a future version. If you rely on the current " "behaviour, change it to %r" % path, FutureWarning, stacklevel=2 ) return self._root.iterfind(path, namespaces) def write(self, file_or_filename, encoding=None, xml_declaration=None, default_namespace=None, method=None, *, short_empty_elements=True): """Write element tree to a file as XML. Arguments: *file_or_filename* -- file name or a file object opened for writing *encoding* -- the output encoding (default: US-ASCII) *xml_declaration* -- bool indicating if an XML declaration should be added to the output. If None, an XML declaration is added if encoding IS NOT either of: US-ASCII, UTF-8, or Unicode *default_namespace* -- sets the default XML namespace (for "xmlns") *method* -- either "xml" (default), "html, "text", or "c14n" *short_empty_elements* -- controls the formatting of elements that contain no content. If True (default) they are emitted as a single self-closed tag, otherwise they are emitted as a pair of start/end tags """ if not method: method = "xml" elif method not in _serialize: raise ValueError("unknown method %r" % method) if not encoding: if method == "c14n": encoding = "utf-8" else: encoding = "us-ascii" with _get_writer(file_or_filename, encoding) as (write, declared_encoding): if method == "xml" and (xml_declaration or (xml_declaration is None and encoding.lower() != "unicode" and declared_encoding.lower() not in ("utf-8", "us-ascii"))): write("<?xml version='1.0' encoding='%s'?>\n" % ( declared_encoding,)) if method == "text": _serialize_text(write, self._root) else: qnames, namespaces = _namespaces(self._root, default_namespace) serialize = _serialize[method] serialize(write, self._root, qnames, namespaces, short_empty_elements=short_empty_elements) def write_c14n(self, file): # lxml.etree compatibility. use output method instead return self.write(file, method="c14n") # -------------------------------------------------------------------- # serialization support @contextlib.contextmanager def _get_writer(file_or_filename, encoding): # returns text write method and release all resources after using try: write = file_or_filename.write except AttributeError: # file_or_filename is a file name if encoding.lower() == "unicode": encoding="utf-8" with open(file_or_filename, "w", encoding=encoding, errors="xmlcharrefreplace") as file: yield file.write, encoding else: # file_or_filename is a file-like object # encoding determines if it is a text or binary writer if encoding.lower() == "unicode": # use a text writer as is yield write, getattr(file_or_filename, "encoding", None) or "utf-8" else: # wrap a binary writer with TextIOWrapper with contextlib.ExitStack() as stack: if isinstance(file_or_filename, io.BufferedIOBase): file = file_or_filename elif isinstance(file_or_filename, io.RawIOBase): file = io.BufferedWriter(file_or_filename) # Keep the original file open when the BufferedWriter is # destroyed stack.callback(file.detach) else: # This is to handle passed objects that aren't in the # IOBase hierarchy, but just have a write method file = io.BufferedIOBase() file.writable = lambda: True file.write = write try: # TextIOWrapper uses this methods to determine # if BOM (for UTF-16, etc) should be added file.seekable = file_or_filename.seekable file.tell = file_or_filename.tell except AttributeError: pass file = io.TextIOWrapper(file, encoding=encoding, errors="xmlcharrefreplace", newline="\n") # Keep the original file open when the TextIOWrapper is # destroyed stack.callback(file.detach) yield file.write, encoding def _namespaces(elem, default_namespace=None): # identify namespaces used in this tree # maps qnames to *encoded* prefix:local names qnames = {None: None} # maps uri:s to prefixes namespaces = {} if default_namespace: namespaces[default_namespace] = "" def add_qname(qname): # calculate serialized qname representation try: if qname[:1] == "{": uri, tag = qname[1:].rsplit("}", 1) prefix = namespaces.get(uri) if prefix is None: prefix = _namespace_map.get(uri) if prefix is None: prefix = "ns%d" % len(namespaces) if prefix != "xml": namespaces[uri] = prefix if prefix: qnames[qname] = "%s:%s" % (prefix, tag) else: qnames[qname] = tag # default element else: if default_namespace: # FIXME: can this be handled in XML 1.0? raise ValueError( "cannot use non-qualified names with " "default_namespace option" ) qnames[qname] = qname except TypeError: _raise_serialization_error(qname) # populate qname and namespaces table for elem in elem.iter(): tag = elem.tag if isinstance(tag, QName): if tag.text not in qnames: add_qname(tag.text) elif isinstance(tag, str): if tag not in qnames: add_qname(tag) elif tag is not None and tag is not Comment and tag is not PI: _raise_serialization_error(tag) for key, value in elem.items(): if isinstance(key, QName): key = key.text if key not in qnames: add_qname(key) if isinstance(value, QName) and value.text not in qnames: add_qname(value.text) text = elem.text if isinstance(text, QName) and text.text not in qnames: add_qname(text.text) return qnames, namespaces def _serialize_xml(write, elem, qnames, namespaces, short_empty_elements, **kwargs): tag = elem.tag text = elem.text if tag is Comment: write("<!--%s-->" % text) elif tag is ProcessingInstruction: write("<?%s?>" % text) else: tag = qnames[tag] if tag is None: if text: write(_escape_cdata(text)) for e in elem: _serialize_xml(write, e, qnames, None, short_empty_elements=short_empty_elements) else: write("<" + tag) items = list(elem.items()) if items or namespaces: if namespaces: for v, k in sorted(namespaces.items(), key=lambda x: x[1]): # sort on prefix if k: k = ":" + k write(" xmlns%s=\"%s\"" % ( k, _escape_attrib(v) )) for k, v in items: if isinstance(k, QName): k = k.text if isinstance(v, QName): v = qnames[v.text] else: v = _escape_attrib(v) write(" %s=\"%s\"" % (qnames[k], v)) if text or len(elem) or not short_empty_elements: write(">") if text: write(_escape_cdata(text)) for e in elem: _serialize_xml(write, e, qnames, None, short_empty_elements=short_empty_elements) write("</" + tag + ">") else: write(" />") if elem.tail: write(_escape_cdata(elem.tail)) HTML_EMPTY = ("area", "base", "basefont", "br", "col", "frame", "hr", "img", "input", "isindex", "link", "meta", "param") try: HTML_EMPTY = set(HTML_EMPTY) except NameError: pass def _serialize_html(write, elem, qnames, namespaces, **kwargs): tag = elem.tag text = elem.text if tag is Comment: write("<!--%s-->" % _escape_cdata(text)) elif tag is ProcessingInstruction: write("<?%s?>" % _escape_cdata(text)) else: tag = qnames[tag] if tag is None: if text: write(_escape_cdata(text)) for e in elem: _serialize_html(write, e, qnames, None) else: write("<" + tag) items = list(elem.items()) if items or namespaces: if namespaces: for v, k in sorted(namespaces.items(), key=lambda x: x[1]): # sort on prefix if k: k = ":" + k write(" xmlns%s=\"%s\"" % ( k, _escape_attrib(v) )) for k, v in items: if isinstance(k, QName): k = k.text if isinstance(v, QName): v = qnames[v.text] else: v = _escape_attrib_html(v) # FIXME: handle boolean attributes write(" %s=\"%s\"" % (qnames[k], v)) write(">") ltag = tag.lower() if text: if ltag == "script" or ltag == "style": write(text) else: write(_escape_cdata(text)) for e in elem: _serialize_html(write, e, qnames, None) if ltag not in HTML_EMPTY: write("</" + tag + ">") if elem.tail: write(_escape_cdata(elem.tail)) def _serialize_text(write, elem): for part in elem.itertext(): write(part) if elem.tail: write(elem.tail) _serialize = { "xml": _serialize_xml, "html": _serialize_html, "text": _serialize_text, # this optional method is imported at the end of the module # "c14n": _serialize_c14n, } def register_namespace(prefix, uri): """Register a namespace prefix. The registry is global, and any existing mapping for either the given prefix or the namespace URI will be removed. *prefix* is the namespace prefix, *uri* is a namespace uri. Tags and attributes in this namespace will be serialized with prefix if possible. ValueError is raised if prefix is reserved or is invalid. """ if re.match(r"ns\d+$", prefix): raise ValueError("Prefix format reserved for internal use") for k, v in list(_namespace_map.items()): if k == uri or v == prefix: del _namespace_map[k] _namespace_map[uri] = prefix _namespace_map = { # "well-known" namespace prefixes "http://www.w3.org/XML/1998/namespace": "xml", "http://www.w3.org/1999/xhtml": "html", "http://www.w3.org/1999/02/22-rdf-syntax-ns#": "rdf", "http://schemas.xmlsoap.org/wsdl/": "wsdl", # xml schema "http://www.w3.org/2001/XMLSchema": "xs", "http://www.w3.org/2001/XMLSchema-instance": "xsi", # dublin core "http://purl.org/dc/elements/1.1/": "dc", } # For tests and troubleshooting register_namespace._namespace_map = _namespace_map def _raise_serialization_error(text): raise TypeError( "cannot serialize %r (type %s)" % (text, type(text).__name__) ) def _escape_cdata(text): # escape character data try: # it's worth avoiding do-nothing calls for strings that are # shorter than 500 characters, or so. assume that's, by far, # the most common case in most applications. if "&" in text: text = text.replace("&", "&") if "<" in text: text = text.replace("<", "<") if ">" in text: text = text.replace(">", ">") return text except (TypeError, AttributeError): _raise_serialization_error(text) def _escape_attrib(text): # escape attribute value try: if "&" in text: text = text.replace("&", "&") if "<" in text: text = text.replace("<", "<") if ">" in text: text = text.replace(">", ">") if "\"" in text: text = text.replace("\"", """) # Although section 2.11 of the XML specification states that CR or # CR LN should be replaced with just LN, it applies only to EOLNs # which take part of organizing file into lines. Within attributes, # we are replacing these with entity numbers, so they do not count. # http://www.w3.org/TR/REC-xml/#sec-line-ends # The current solution, contained in following six lines, was # discussed in issue 17582 and 39011. if "\r" in text: text = text.replace("\r", " ") if "\n" in text: text = text.replace("\n", " ") if "\t" in text: text = text.replace("\t", "	") return text except (TypeError, AttributeError): _raise_serialization_error(text) def _escape_attrib_html(text): # escape attribute value try: if "&" in text: text = text.replace("&", "&") if ">" in text: text = text.replace(">", ">") if "\"" in text: text = text.replace("\"", """) return text except (TypeError, AttributeError): _raise_serialization_error(text) # -------------------------------------------------------------------- def tostring(element, encoding=None, method=None, *, xml_declaration=None, default_namespace=None, short_empty_elements=True): """Generate string representation of XML element. All subelements are included. If encoding is "unicode", a string is returned. Otherwise a bytestring is returned. *element* is an Element instance, *encoding* is an optional output encoding defaulting to US-ASCII, *method* is an optional output which can be one of "xml" (default), "html", "text" or "c14n", *default_namespace* sets the default XML namespace (for "xmlns"). Returns an (optionally) encoded string containing the XML data. """ stream = io.StringIO() if encoding == 'unicode' else io.BytesIO() ElementTree(element).write(stream, encoding, xml_declaration=xml_declaration, default_namespace=default_namespace, method=method, short_empty_elements=short_empty_elements) return stream.getvalue() class _ListDataStream(io.BufferedIOBase): """An auxiliary stream accumulating into a list reference.""" def __init__(self, lst): self.lst = lst def writable(self): return True def seekable(self): return True def write(self, b): self.lst.append(b) def tell(self): return len(self.lst) def tostringlist(element, encoding=None, method=None, *, xml_declaration=None, default_namespace=None, short_empty_elements=True): lst = [] stream = _ListDataStream(lst) ElementTree(element).write(stream, encoding, xml_declaration=xml_declaration, default_namespace=default_namespace, method=method, short_empty_elements=short_empty_elements) return lst def dump(elem): """Write element tree or element structure to sys.stdout. This function should be used for debugging only. *elem* is either an ElementTree, or a single Element. The exact output format is implementation dependent. In this version, it's written as an ordinary XML file. """ # debugging if not isinstance(elem, ElementTree): elem = ElementTree(elem) elem.write(sys.stdout, encoding="unicode") tail = elem.getroot().tail if not tail or tail[-1] != "\n": sys.stdout.write("\n") def indent(tree, space=" ", level=0): """Indent an XML document by inserting newlines and indentation space after elements. *tree* is the ElementTree or Element to modify. The (root) element itself will not be changed, but the tail text of all elements in its subtree will be adapted. *space* is the whitespace to insert for each indentation level, two space characters by default. *level* is the initial indentation level. Setting this to a higher value than 0 can be used for indenting subtrees that are more deeply nested inside of a document. """ if isinstance(tree, ElementTree): tree = tree.getroot() if level < 0: raise ValueError(f"Initial indentation level must be >= 0, got {level}") if not len(tree): return # Reduce the memory consumption by reusing indentation strings. indentations = ["\n" + level * space] def _indent_children(elem, level): # Start a new indentation level for the first child. child_level = level + 1 try: child_indentation = indentations[child_level] except IndexError: child_indentation = indentations[level] + space indentations.append(child_indentation) if not elem.text or not elem.text.strip(): elem.text = child_indentation for child in elem: if len(child): _indent_children(child, child_level) if not child.tail or not child.tail.strip(): child.tail = child_indentation # Dedent after the last child by overwriting the previous indentation. if not child.tail.strip(): child.tail = indentations[level] _indent_children(tree, 0) # -------------------------------------------------------------------- # parsing def parse(source, parser=None): """Parse XML document into element tree. *source* is a filename or file object containing XML data, *parser* is an optional parser instance defaulting to XMLParser. Return an ElementTree instance. """ tree = ElementTree() tree.parse(source, parser) return tree def iterparse(source, events=None, parser=None): """Incrementally parse XML document into ElementTree. This class also reports what's going on to the user based on the *events* it is initialized with. The supported events are the strings "start", "end", "start-ns" and "end-ns" (the "ns" events are used to get detailed namespace information). If *events* is omitted, only "end" events are reported. *source* is a filename or file object containing XML data, *events* is a list of events to report back, *parser* is an optional parser instance. Returns an iterator providing (event, elem) pairs. """ # Use the internal, undocumented _parser argument for now; When the # parser argument of iterparse is removed, this can be killed. pullparser = XMLPullParser(events=events, _parser=parser) def iterator(source): close_source = False try: if not hasattr(source, "read"): source = open(source, "rb") close_source = True yield None while True: yield from pullparser.read_events() # load event buffer data = source.read(16 * 1024) if not data: break pullparser.feed(data) root = pullparser._close_and_return_root() yield from pullparser.read_events() it.root = root finally: if close_source: source.close() class IterParseIterator(collections.abc.Iterator): __next__ = iterator(source).__next__ it = IterParseIterator() it.root = None del iterator, IterParseIterator next(it) return it class XMLPullParser: def __init__(self, events=None, *, _parser=None): # The _parser argument is for internal use only and must not be relied # upon in user code. It will be removed in a future release. # See https://bugs.python.org/issue17741 for more details. self._events_queue = collections.deque() self._parser = _parser or XMLParser(target=TreeBuilder()) # wire up the parser for event reporting if events is None: events = ("end",) self._parser._setevents(self._events_queue, events) def feed(self, data): """Feed encoded data to parser.""" if self._parser is None: raise ValueError("feed() called after end of stream") if data: try: self._parser.feed(data) except SyntaxError as exc: self._events_queue.append(exc) def _close_and_return_root(self): # iterparse needs this to set its root attribute properly :( root = self._parser.close() self._parser = None return root def close(self): """Finish feeding data to parser. Unlike XMLParser, does not return the root element. Use read_events() to consume elements from XMLPullParser. """ self._close_and_return_root() def read_events(self): """Return an iterator over currently available (event, elem) pairs. Events are consumed from the internal event queue as they are retrieved from the iterator. """ events = self._events_queue while events: event = events.popleft() if isinstance(event, Exception): raise event else: yield event def XML(text, parser=None): """Parse XML document from string constant. This function can be used to embed "XML Literals" in Python code. *text* is a string containing XML data, *parser* is an optional parser instance, defaulting to the standard XMLParser. Returns an Element instance. """ if not parser: parser = XMLParser(target=TreeBuilder()) parser.feed(text) return parser.close() def XMLID(text, parser=None): """Parse XML document from string constant for its IDs. *text* is a string containing XML data, *parser* is an optional parser instance, defaulting to the standard XMLParser. Returns an (Element, dict) tuple, in which the dict maps element id:s to elements. """ if not parser: parser = XMLParser(target=TreeBuilder()) parser.feed(text) tree = parser.close() ids = {} for elem in tree.iter(): id = elem.get("id") if id: ids[id] = elem return tree, ids # Parse XML document from string constant. Alias for XML(). fromstring = XML def fromstringlist(sequence, parser=None): """Parse XML document from sequence of string fragments. *sequence* is a list of other sequence, *parser* is an optional parser instance, defaulting to the standard XMLParser. Returns an Element instance. """ if not parser: parser = XMLParser(target=TreeBuilder()) for text in sequence: parser.feed(text) return parser.close() # -------------------------------------------------------------------- class TreeBuilder: """Generic element structure builder. This builder converts a sequence of start, data, and end method calls to a well-formed element structure. You can use this class to build an element structure using a custom XML parser, or a parser for some other XML-like format. *element_factory* is an optional element factory which is called to create new Element instances, as necessary. *comment_factory* is a factory to create comments to be used instead of the standard factory. If *insert_comments* is false (the default), comments will not be inserted into the tree. *pi_factory* is a factory to create processing instructions to be used instead of the standard factory. If *insert_pis* is false (the default), processing instructions will not be inserted into the tree. """ def __init__(self, element_factory=None, *, comment_factory=None, pi_factory=None, insert_comments=False, insert_pis=False): self._data = [] # data collector self._elem = [] # element stack self._last = None # last element self._root = None # root element self._tail = None # true if we're after an end tag if comment_factory is None: comment_factory = Comment self._comment_factory = comment_factory self.insert_comments = insert_comments if pi_factory is None: pi_factory = ProcessingInstruction self._pi_factory = pi_factory self.insert_pis = insert_pis if element_factory is None: element_factory = Element self._factory = element_factory def close(self): """Flush builder buffers and return toplevel document Element.""" assert len(self._elem) == 0, "missing end tags" assert self._root is not None, "missing toplevel element" return self._root def _flush(self): if self._data: if self._last is not None: text = "".join(self._data) if self._tail: assert self._last.tail is None, "internal error (tail)" self._last.tail = text else: assert self._last.text is None, "internal error (text)" self._last.text = text self._data = [] def data(self, data): """Add text to current element.""" self._data.append(data) def start(self, tag, attrs): """Open new element and return it. *tag* is the element name, *attrs* is a dict containing element attributes. """ self._flush() self._last = elem = self._factory(tag, attrs) if self._elem: self._elem[-1].append(elem) elif self._root is None: self._root = elem self._elem.append(elem) self._tail = 0 return elem def end(self, tag): """Close and return current Element. *tag* is the element name. """ self._flush() self._last = self._elem.pop() assert self._last.tag == tag,\ "end tag mismatch (expected %s, got %s)" % ( self._last.tag, tag) self._tail = 1 return self._last def comment(self, text): """Create a comment using the comment_factory. *text* is the text of the comment. """ return self._handle_single( self._comment_factory, self.insert_comments, text) def pi(self, target, text=None): """Create a processing instruction using the pi_factory. *target* is the target name of the processing instruction. *text* is the data of the processing instruction, or ''. """ return self._handle_single( self._pi_factory, self.insert_pis, target, text) def _handle_single(self, factory, insert, *args): elem = factory(*args) if insert: self._flush() self._last = elem if self._elem: self._elem[-1].append(elem) self._tail = 1 return elem # also see ElementTree and TreeBuilder class XMLParser: """Element structure builder for XML source data based on the expat parser. *target* is an optional target object which defaults to an instance of the standard TreeBuilder class, *encoding* is an optional encoding string which if given, overrides the encoding specified in the XML file: http://www.iana.org/assignments/character-sets """ def __init__(self, *, target=None, encoding=None): try: from xml.parsers import expat except ImportError: try: import pyexpat as expat except ImportError: raise ImportError( "No module named expat; use SimpleXMLTreeBuilder instead" ) parser = expat.ParserCreate(encoding, "}") if target is None: target = TreeBuilder() # underscored names are provided for compatibility only self.parser = self._parser = parser self.target = self._target = target self._error = expat.error self._names = {} # name memo cache # main callbacks parser.DefaultHandlerExpand = self._default if hasattr(target, 'start'): parser.StartElementHandler = self._start if hasattr(target, 'end'): parser.EndElementHandler = self._end if hasattr(target, 'start_ns'): parser.StartNamespaceDeclHandler = self._start_ns if hasattr(target, 'end_ns'): parser.EndNamespaceDeclHandler = self._end_ns if hasattr(target, 'data'): parser.CharacterDataHandler = target.data # miscellaneous callbacks if hasattr(target, 'comment'): parser.CommentHandler = target.comment if hasattr(target, 'pi'): parser.ProcessingInstructionHandler = target.pi # Configure pyexpat: buffering, new-style attribute handling. parser.buffer_text = 1 parser.ordered_attributes = 1 self._doctype = None self.entity = {} try: self.version = "Expat %d.%d.%d" % expat.version_info except AttributeError: pass # unknown def _setevents(self, events_queue, events_to_report): # Internal API for XMLPullParser # events_to_report: a list of events to report during parsing (same as # the *events* of XMLPullParser's constructor. # events_queue: a list of actual parsing events that will be populated # by the underlying parser. # parser = self._parser append = events_queue.append for event_name in events_to_report: if event_name == "start": parser.ordered_attributes = 1 def handler(tag, attrib_in, event=event_name, append=append, start=self._start): append((event, start(tag, attrib_in))) parser.StartElementHandler = handler elif event_name == "end": def handler(tag, event=event_name, append=append, end=self._end): append((event, end(tag))) parser.EndElementHandler = handler elif event_name == "start-ns": # TreeBuilder does not implement .start_ns() if hasattr(self.target, "start_ns"): def handler(prefix, uri, event=event_name, append=append, start_ns=self._start_ns): append((event, start_ns(prefix, uri))) else: def handler(prefix, uri, event=event_name, append=append): append((event, (prefix or '', uri or ''))) parser.StartNamespaceDeclHandler = handler elif event_name == "end-ns": # TreeBuilder does not implement .end_ns() if hasattr(self.target, "end_ns"): def handler(prefix, event=event_name, append=append, end_ns=self._end_ns): append((event, end_ns(prefix))) else: def handler(prefix, event=event_name, append=append): append((event, None)) parser.EndNamespaceDeclHandler = handler elif event_name == 'comment': def handler(text, event=event_name, append=append, self=self): append((event, self.target.comment(text))) parser.CommentHandler = handler elif event_name == 'pi': def handler(pi_target, data, event=event_name, append=append, self=self): append((event, self.target.pi(pi_target, data))) parser.ProcessingInstructionHandler = handler else: raise ValueError("unknown event %r" % event_name) def _raiseerror(self, value): err = ParseError(value) err.code = value.code err.position = value.lineno, value.offset raise err def _fixname(self, key): # expand qname, and convert name string to ascii, if possible try: name = self._names[key] except KeyError: name = key if "}" in name: name = "{" + name self._names[key] = name return name def _start_ns(self, prefix, uri): return self.target.start_ns(prefix or '', uri or '') def _end_ns(self, prefix): return self.target.end_ns(prefix or '') def _start(self, tag, attr_list): # Handler for expat's StartElementHandler. Since ordered_attributes # is set, the attributes are reported as a list of alternating # attribute name,value. fixname = self._fixname tag = fixname(tag) attrib = {} if attr_list: for i in range(0, len(attr_list), 2): attrib[fixname(attr_list[i])] = attr_list[i+1] return self.target.start(tag, attrib) def _end(self, tag): return self.target.end(self._fixname(tag)) def _default(self, text): prefix = text[:1] if prefix == "&": # deal with undefined entities try: data_handler = self.target.data except AttributeError: return try: data_handler(self.entity[text[1:-1]]) except KeyError: from xml.parsers import expat err = expat.error( "undefined entity %s: line %d, column %d" % (text, self.parser.ErrorLineNumber, self.parser.ErrorColumnNumber) ) err.code = 11 # XML_ERROR_UNDEFINED_ENTITY err.lineno = self.parser.ErrorLineNumber err.offset = self.parser.ErrorColumnNumber raise err elif prefix == "<" and text[:9] == "<!DOCTYPE": self._doctype = [] # inside a doctype declaration elif self._doctype is not None: # parse doctype contents if prefix == ">": self._doctype = None return text = text.strip() if not text: return self._doctype.append(text) n = len(self._doctype) if n > 2: type = self._doctype[1] if type == "PUBLIC" and n == 4: name, type, pubid, system = self._doctype if pubid: pubid = pubid[1:-1] elif type == "SYSTEM" and n == 3: name, type, system = self._doctype pubid = None else: return if hasattr(self.target, "doctype"): self.target.doctype(name, pubid, system[1:-1]) elif hasattr(self, "doctype"): warnings.warn( "The doctype() method of XMLParser is ignored. " "Define doctype() method on the TreeBuilder target.", RuntimeWarning) self._doctype = None def feed(self, data): """Feed encoded data to parser.""" try: self.parser.Parse(data, False) except self._error as v: self._raiseerror(v) def close(self): """Finish feeding data to parser and return element structure.""" try: self.parser.Parse(b"", True) # end of data except self._error as v: self._raiseerror(v) try: close_handler = self.target.close except AttributeError: pass else: return close_handler() finally: # get rid of circular references del self.parser, self._parser del self.target, self._target # -------------------------------------------------------------------- # C14N 2.0 def canonicalize(xml_data=None, *, out=None, from_file=None, **options): """Convert XML to its C14N 2.0 serialised form. If *out* is provided, it must be a file or file-like object that receives the serialised canonical XML output (text, not bytes) through its ``.write()`` method. To write to a file, open it in text mode with encoding "utf-8". If *out* is not provided, this function returns the output as text string. Either *xml_data* (an XML string) or *from_file* (a file path or file-like object) must be provided as input. The configuration options are the same as for the ``C14NWriterTarget``. """ if xml_data is None and from_file is None: raise ValueError("Either 'xml_data' or 'from_file' must be provided as input") sio = None if out is None: sio = out = io.StringIO() parser = XMLParser(target=C14NWriterTarget(out.write, **options)) if xml_data is not None: parser.feed(xml_data) parser.close() elif from_file is not None: parse(from_file, parser=parser) return sio.getvalue() if sio is not None else None _looks_like_prefix_name = re.compile(r'^\w+:\w+$', re.UNICODE).match class C14NWriterTarget: """ Canonicalization writer target for the XMLParser. Serialises parse events to XML C14N 2.0. The *write* function is used for writing out the resulting data stream as text (not bytes). To write to a file, open it in text mode with encoding "utf-8" and pass its ``.write`` method. Configuration options: - *with_comments*: set to true to include comments - *strip_text*: set to true to strip whitespace before and after text content - *rewrite_prefixes*: set to true to replace namespace prefixes by "n{number}" - *qname_aware_tags*: a set of qname aware tag names in which prefixes should be replaced in text content - *qname_aware_attrs*: a set of qname aware attribute names in which prefixes should be replaced in text content - *exclude_attrs*: a set of attribute names that should not be serialised - *exclude_tags*: a set of tag names that should not be serialised """ def __init__(self, write, *, with_comments=False, strip_text=False, rewrite_prefixes=False, qname_aware_tags=None, qname_aware_attrs=None, exclude_attrs=None, exclude_tags=None): self._write = write self._data = [] self._with_comments = with_comments self._strip_text = strip_text self._exclude_attrs = set(exclude_attrs) if exclude_attrs else None self._exclude_tags = set(exclude_tags) if exclude_tags else None self._rewrite_prefixes = rewrite_prefixes if qname_aware_tags: self._qname_aware_tags = set(qname_aware_tags) else: self._qname_aware_tags = None if qname_aware_attrs: self._find_qname_aware_attrs = set(qname_aware_attrs).intersection else: self._find_qname_aware_attrs = None # Stack with globally and newly declared namespaces as (uri, prefix) pairs. self._declared_ns_stack = [[ ("http://www.w3.org/XML/1998/namespace", "xml"), ]] # Stack with user declared namespace prefixes as (uri, prefix) pairs. self._ns_stack = [] if not rewrite_prefixes: self._ns_stack.append(list(_namespace_map.items())) self._ns_stack.append([]) self._prefix_map = {} self._preserve_space = [False] self._pending_start = None self._root_seen = False self._root_done = False self._ignored_depth = 0 def _iter_namespaces(self, ns_stack, _reversed=reversed): for namespaces in _reversed(ns_stack): if namespaces: # almost no element declares new namespaces yield from namespaces def _resolve_prefix_name(self, prefixed_name): prefix, name = prefixed_name.split(':', 1) for uri, p in self._iter_namespaces(self._ns_stack): if p == prefix: return f'{{{uri}}}{name}' raise ValueError(f'Prefix {prefix} of QName "{prefixed_name}" is not declared in scope') def _qname(self, qname, uri=None): if uri is None: uri, tag = qname[1:].rsplit('}', 1) if qname[:1] == '{' else ('', qname) else: tag = qname prefixes_seen = set() for u, prefix in self._iter_namespaces(self._declared_ns_stack): if u == uri and prefix not in prefixes_seen: return f'{prefix}:{tag}' if prefix else tag, tag, uri prefixes_seen.add(prefix) # Not declared yet => add new declaration. if self._rewrite_prefixes: if uri in self._prefix_map: prefix = self._prefix_map[uri] else: prefix = self._prefix_map[uri] = f'n{len(self._prefix_map)}' self._declared_ns_stack[-1].append((uri, prefix)) return f'{prefix}:{tag}', tag, uri if not uri and '' not in prefixes_seen: # No default namespace declared => no prefix needed. return tag, tag, uri for u, prefix in self._iter_namespaces(self._ns_stack): if u == uri: self._declared_ns_stack[-1].append((uri, prefix)) return f'{prefix}:{tag}' if prefix else tag, tag, uri if not uri: # As soon as a default namespace is defined, # anything that has no namespace (and thus, no prefix) goes there. return tag, tag, uri raise ValueError(f'Namespace "{uri}" is not declared in scope') def data(self, data): if not self._ignored_depth: self._data.append(data) def _flush(self, _join_text=''.join): data = _join_text(self._data) del self._data[:] if self._strip_text and not self._preserve_space[-1]: data = data.strip() if self._pending_start is not None: args, self._pending_start = self._pending_start, None qname_text = data if data and _looks_like_prefix_name(data) else None self._start(*args, qname_text) if qname_text is not None: return if data and self._root_seen: self._write(_escape_cdata_c14n(data)) def start_ns(self, prefix, uri): if self._ignored_depth: return # we may have to resolve qnames in text content if self._data: self._flush() self._ns_stack[-1].append((uri, prefix)) def start(self, tag, attrs): if self._exclude_tags is not None and ( self._ignored_depth or tag in self._exclude_tags): self._ignored_depth += 1 return if self._data: self._flush() new_namespaces = [] self._declared_ns_stack.append(new_namespaces) if self._qname_aware_tags is not None and tag in self._qname_aware_tags: # Need to parse text first to see if it requires a prefix declaration. self._pending_start = (tag, attrs, new_namespaces) return self._start(tag, attrs, new_namespaces) def _start(self, tag, attrs, new_namespaces, qname_text=None): if self._exclude_attrs is not None and attrs: attrs = {k: v for k, v in attrs.items() if k not in self._exclude_attrs} qnames = {tag, *attrs} resolved_names = {} # Resolve prefixes in attribute and tag text. if qname_text is not None: qname = resolved_names[qname_text] = self._resolve_prefix_name(qname_text) qnames.add(qname) if self._find_qname_aware_attrs is not None and attrs: qattrs = self._find_qname_aware_attrs(attrs) if qattrs: for attr_name in qattrs: value = attrs[attr_name] if _looks_like_prefix_name(value): qname = resolved_names[value] = self._resolve_prefix_name(value) qnames.add(qname) else: qattrs = None else: qattrs = None # Assign prefixes in lexicographical order of used URIs. parse_qname = self._qname parsed_qnames = {n: parse_qname(n) for n in sorted( qnames, key=lambda n: n.split('}', 1))} # Write namespace declarations in prefix order ... if new_namespaces: attr_list = [ ('xmlns:' + prefix if prefix else 'xmlns', uri) for uri, prefix in new_namespaces ] attr_list.sort() else: # almost always empty attr_list = [] # ... followed by attributes in URI+name order if attrs: for k, v in sorted(attrs.items()): if qattrs is not None and k in qattrs and v in resolved_names: v = parsed_qnames[resolved_names[v]][0] attr_qname, attr_name, uri = parsed_qnames[k] # No prefix for attributes in default ('') namespace. attr_list.append((attr_qname if uri else attr_name, v)) # Honour xml:space attributes. space_behaviour = attrs.get('{http://www.w3.org/XML/1998/namespace}space') self._preserve_space.append( space_behaviour == 'preserve' if space_behaviour else self._preserve_space[-1]) # Write the tag. write = self._write write('<' + parsed_qnames[tag][0]) if attr_list: write(''.join([f' {k}="{_escape_attrib_c14n(v)}"' for k, v in attr_list])) write('>') # Write the resolved qname text content. if qname_text is not None: write(_escape_cdata_c14n(parsed_qnames[resolved_names[qname_text]][0])) self._root_seen = True self._ns_stack.append([]) def end(self, tag): if self._ignored_depth: self._ignored_depth -= 1 return if self._data: self._flush() self._write(f'</{self._qname(tag)[0]}>') self._preserve_space.pop() self._root_done = len(self._preserve_space) == 1 self._declared_ns_stack.pop() self._ns_stack.pop() def comment(self, text): if not self._with_comments: return if self._ignored_depth: return if self._root_done: self._write('\n') elif self._root_seen and self._data: self._flush() self._write(f'<!--{_escape_cdata_c14n(text)}-->') if not self._root_seen: self._write('\n') def pi(self, target, data): if self._ignored_depth: return if self._root_done: self._write('\n') elif self._root_seen and self._data: self._flush() self._write( f'<?{target} {_escape_cdata_c14n(data)}?>' if data else f'<?{target}?>') if not self._root_seen: self._write('\n') def _escape_cdata_c14n(text): # escape character data try: # it's worth avoiding do-nothing calls for strings that are # shorter than 500 character, or so. assume that's, by far, # the most common case in most applications. if '&' in text: text = text.replace('&', '&') if '<' in text: text = text.replace('<', '<') if '>' in text: text = text.replace('>', '>') if '\r' in text: text = text.replace('\r', '
') return text except (TypeError, AttributeError): _raise_serialization_error(text) def _escape_attrib_c14n(text): # escape attribute value try: if '&' in text: text = text.replace('&', '&') if '<' in text: text = text.replace('<', '<') if '"' in text: text = text.replace('"', '"') if '\t' in text: text = text.replace('\t', '	') if '\n' in text: text = text.replace('\n', '
') if '\r' in text: text = text.replace('\r', '
') return text except (TypeError, AttributeError): _raise_serialization_error(text) # -------------------------------------------------------------------- # Import the C accelerators try: # Element is going to be shadowed by the C implementation. We need to keep # the Python version of it accessible for some "creative" by external code # (see tests) _Element_Py = Element # Element, SubElement, ParseError, TreeBuilder, XMLParser, _set_factories from _elementtree import * from _elementtree import _set_factories except ImportError: pass else: _set_factories(Comment, ProcessingInstruction) etree/__init__.py 0000644 00000003105 15027446000 0007756 0 ustar 00 # $Id: __init__.py 3375 2008-02-13 08:05:08Z fredrik $ # elementtree package # -------------------------------------------------------------------- # The ElementTree toolkit is # # Copyright (c) 1999-2008 by Fredrik Lundh # # By obtaining, using, and/or copying this software and/or its # associated documentation, you agree that you have read, understood, # and will comply with the following terms and conditions: # # Permission to use, copy, modify, and distribute this software and # its associated documentation for any purpose and without fee is # hereby granted, provided that the above copyright notice appears in # all copies, and that both that copyright notice and this permission # notice appear in supporting documentation, and that the name of # Secret Labs AB or the author not be used in advertising or publicity # pertaining to distribution of the software without specific, written # prior permission. # # SECRET LABS AB AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD # TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANT- # ABILITY AND FITNESS. IN NO EVENT SHALL SECRET LABS AB OR THE AUTHOR # BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY # DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, # WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS # ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE # OF THIS SOFTWARE. # -------------------------------------------------------------------- # Licensed to PSF under a Contributor Agreement. # See https://www.python.org/psf/license for licensing details. sax/handler.py 0000644 00000036401 15027446000 0007330 0 ustar 00 """ 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$ """ version = '2.0beta' #============================================================================ # # HANDLER INTERFACES # #============================================================================ # ===== ERRORHANDLER ===== class ErrorHandler: """Basic interface for SAX error handlers. If you create an object that implements this interface, then register the object with your XMLReader, the parser will call the methods in your object to report all warnings and errors. There are three levels of errors available: warnings, (possibly) recoverable errors, and unrecoverable errors. All methods take a SAXParseException as the only parameter.""" def error(self, exception): "Handle a recoverable error." raise exception def fatalError(self, exception): "Handle a non-recoverable error." raise exception def warning(self, exception): "Handle a warning." print(exception) # ===== CONTENTHANDLER ===== class ContentHandler: """Interface for receiving logical document content events. This is the main callback interface in SAX, and the one most important to applications. The order of events in this interface mirrors the order of the information in the document.""" def __init__(self): self._locator = None def setDocumentLocator(self, locator): """Called by the parser to give the application a locator for locating the origin of document events. SAX parsers are strongly encouraged (though not absolutely required) to supply a locator: if it does so, it must supply the locator to the application by invoking this method before invoking any of the other methods in the DocumentHandler interface. The locator allows the application to determine the end position of any document-related event, even if the parser is not reporting an error. Typically, the application will use this information for reporting its own errors (such as character content that does not match an application's business rules). The information returned by the locator is probably not sufficient for use with a search engine. Note that the locator will return correct information only during the invocation of the events in this interface. The application should not attempt to use it at any other time.""" self._locator = locator def startDocument(self): """Receive notification of the beginning of a document. The SAX parser will invoke this method only once, before any other methods in this interface or in DTDHandler (except for setDocumentLocator).""" def endDocument(self): """Receive notification of the end of a document. The SAX parser will invoke this method only once, and it will be the last method invoked during the parse. The parser shall not invoke this method until it has either abandoned parsing (because of an unrecoverable error) or reached the end of input.""" def startPrefixMapping(self, prefix, uri): """Begin the scope of a prefix-URI Namespace mapping. The information from this event is not necessary for normal Namespace processing: the SAX XML reader will automatically replace prefixes for element and attribute names when the http://xml.org/sax/features/namespaces feature is true (the default). There are cases, however, when applications need to use prefixes in character data or in attribute values, where they cannot safely be expanded automatically; the start/endPrefixMapping event supplies the information to the application to expand prefixes in those contexts itself, if necessary. Note that start/endPrefixMapping events are not guaranteed to be properly nested relative to each-other: all startPrefixMapping events will occur before the corresponding startElement event, and all endPrefixMapping events will occur after the corresponding endElement event, but their order is not guaranteed.""" def endPrefixMapping(self, prefix): """End the scope of a prefix-URI mapping. See startPrefixMapping for details. This event will always occur after the corresponding endElement event, but the order of endPrefixMapping events is not otherwise guaranteed.""" def startElement(self, name, attrs): """Signals the start of an element in non-namespace mode. The name parameter contains the raw XML 1.0 name of the element type as a string and the attrs parameter holds an instance of the Attributes class containing the attributes of the element.""" def endElement(self, name): """Signals the end of an element in non-namespace mode. The name parameter contains the name of the element type, just as with the startElement event.""" def startElementNS(self, name, qname, attrs): """Signals the start of an element in namespace mode. The name parameter contains the name of the element type as a (uri, localname) tuple, the qname parameter the raw XML 1.0 name used in the source document, and the attrs parameter holds an instance of the Attributes class containing the attributes of the element. The uri part of the name tuple is None for elements which have no namespace.""" def endElementNS(self, name, qname): """Signals the end of an element in namespace mode. The name parameter contains the name of the element type, just as with the startElementNS event.""" def characters(self, content): """Receive notification of character data. The Parser will call this method to report each chunk of character data. SAX parsers may return all contiguous character data in a single chunk, or they may split it into several chunks; however, all of the characters in any single event must come from the same external entity so that the Locator provides useful information.""" def ignorableWhitespace(self, whitespace): """Receive notification of ignorable whitespace in element content. Validating Parsers must use this method to report each chunk of ignorable whitespace (see the W3C XML 1.0 recommendation, section 2.10): non-validating parsers may also use this method if they are capable of parsing and using content models. SAX parsers may return all contiguous whitespace in a single chunk, or they may split it into several chunks; however, all of the characters in any single event must come from the same external entity, so that the Locator provides useful information.""" def processingInstruction(self, target, data): """Receive notification of a processing instruction. The Parser will invoke this method once for each processing instruction found: note that processing instructions may occur before or after the main document element. A SAX parser should never report an XML declaration (XML 1.0, section 2.8) or a text declaration (XML 1.0, section 4.3.1) using this method.""" def skippedEntity(self, name): """Receive notification of a skipped entity. The Parser will invoke this method once for each entity skipped. Non-validating processors may skip entities if they have not seen the declarations (because, for example, the entity was declared in an external DTD subset). All processors may skip external entities, depending on the values of the http://xml.org/sax/features/external-general-entities and the http://xml.org/sax/features/external-parameter-entities properties.""" # ===== DTDHandler ===== class DTDHandler: """Handle DTD events. This interface specifies only those DTD events required for basic parsing (unparsed entities and attributes).""" def notationDecl(self, name, publicId, systemId): "Handle a notation declaration event." def unparsedEntityDecl(self, name, publicId, systemId, ndata): "Handle an unparsed entity declaration event." # ===== ENTITYRESOLVER ===== class EntityResolver: """Basic interface for resolving entities. If you create an object implementing this interface, then register the object with your Parser, the parser will call the method in your object to resolve all external entities. Note that DefaultHandler implements this interface with the default behaviour.""" def resolveEntity(self, publicId, systemId): """Resolve the system identifier of an entity and return either the system identifier to read from as a string, or an InputSource to read from.""" return systemId #============================================================================ # # CORE FEATURES # #============================================================================ feature_namespaces = "http://xml.org/sax/features/namespaces" # true: Perform Namespace processing (default). # false: Optionally do not perform Namespace processing # (implies namespace-prefixes). # access: (parsing) read-only; (not parsing) read/write feature_namespace_prefixes = "http://xml.org/sax/features/namespace-prefixes" # true: Report the original prefixed names and attributes used for Namespace # declarations. # false: Do not report attributes used for Namespace declarations, and # optionally do not report original prefixed names (default). # access: (parsing) read-only; (not parsing) read/write feature_string_interning = "http://xml.org/sax/features/string-interning" # true: All element names, prefixes, attribute names, Namespace URIs, and # local names are interned using the built-in intern function. # false: Names are not necessarily interned, although they may be (default). # access: (parsing) read-only; (not parsing) read/write feature_validation = "http://xml.org/sax/features/validation" # true: Report all validation errors (implies external-general-entities and # external-parameter-entities). # false: Do not report validation errors. # access: (parsing) read-only; (not parsing) read/write feature_external_ges = "http://xml.org/sax/features/external-general-entities" # true: Include all external general (text) entities. # false: Do not include external general entities. # access: (parsing) read-only; (not parsing) read/write feature_external_pes = "http://xml.org/sax/features/external-parameter-entities" # true: Include all external parameter entities, including the external # DTD subset. # false: Do not include any external parameter entities, even the external # DTD subset. # access: (parsing) read-only; (not parsing) read/write all_features = [feature_namespaces, feature_namespace_prefixes, feature_string_interning, feature_validation, feature_external_ges, feature_external_pes] #============================================================================ # # CORE PROPERTIES # #============================================================================ property_lexical_handler = "http://xml.org/sax/properties/lexical-handler" # data type: xml.sax.sax2lib.LexicalHandler # description: An optional extension handler for lexical events like comments. # access: read/write property_declaration_handler = "http://xml.org/sax/properties/declaration-handler" # data type: xml.sax.sax2lib.DeclHandler # description: An optional extension handler for DTD-related events other # than notations and unparsed entities. # access: read/write property_dom_node = "http://xml.org/sax/properties/dom-node" # data type: org.w3c.dom.Node # description: When parsing, the current DOM node being visited if this is # a DOM iterator; when not parsing, the root DOM node for # iteration. # access: (parsing) read-only; (not parsing) read/write property_xml_string = "http://xml.org/sax/properties/xml-string" # data type: String # description: The literal string of characters that was the source for # the current event. # access: read-only property_encoding = "http://www.python.org/sax/properties/encoding" # data type: String # description: The name of the encoding to assume for input data. # access: write: set the encoding, e.g. established by a higher-level # protocol. May change during parsing (e.g. after # processing a META tag) # read: return the current encoding (possibly established through # auto-detection. # initial value: UTF-8 # property_interning_dict = "http://www.python.org/sax/properties/interning-dict" # data type: Dictionary # description: The dictionary used to intern common strings in the document # access: write: Request that the parser uses a specific dictionary, to # allow interning across different documents # read: return the current interning dictionary, or None # all_properties = [property_lexical_handler, property_dom_node, property_declaration_handler, property_xml_string, property_encoding, property_interning_dict] class LexicalHandler: """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/properties/lexical-handler'.""" def comment(self, content): """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.""" def startDTD(self, name, public_id, system_id): """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).""" def endDTD(self): """Signals the end of DTD declarations.""" def startCDATA(self): """Reports the beginning of a CDATA marked section. The contents of the CDATA marked section will be reported through the characters event.""" def endCDATA(self): """Reports the end of a CDATA marked section.""" sax/__pycache__/__init__.cpython-310.pyc 0000644 00000006205 15027446000 0014010 0 ustar 00 o }�5h: � @ s d Z ddlmZ ddlmZmZ ddlmZmZm Z m Z m Z e� fdd�Z e� fdd�Z d gZd Zer7d d lZd d lZd d lZejjsPd ejv rPejd �d �Z[dZejd d� dkrkej�e�rkej� e��d �Zddd�Z ejd d� dkr�dd� Z [d S dd� Z [d S )a� Simple API for XML (SAX) implementation for Python. This module provides an implementation of the SAX 2 interface; information about the Java version of the interface can be found at http://www.megginson.com/SAX/. The Python version of the interface is documented at <...>. This package contains the following modules: handler -- Base classes and constants which define the SAX 2 API for the 'client-side' of SAX for Python. saxutils -- Implementation of the convenience classes commonly used to work with SAX. xmlreader -- Base classes and constants which define the SAX 2 API for the parsers used with SAX for Python. expatreader -- Driver that allows use of the Expat parser with SAX. � )� InputSource)�ContentHandler� ErrorHandler)� SAXException�SAXNotRecognizedException�SAXParseException�SAXNotSupportedException�SAXReaderNotAvailablec C s( t � }|�|� |�|� |�| � d S )N)� make_parser�setContentHandler�setErrorHandler�parse)�source�handler� errorHandler�parser� r �'/usr/lib/python3.10/xml/sax/__init__.pyr s r c C sp dd l }|d u r t� }t� }|�|� |�|� t� }t| t�r)|�|� | �� n|� |� | �� |� |� d S )N� ) �ior r r r r � isinstance�str�setCharacterStream�StringIO� setByteStream�BytesIOr )�stringr r r r �inpsrcr r r � parseString# s r zxml.sax.expatreaderr N� PY_SAX_PARSER�,zpython.xml.sax.parser� �javar c C s` t | �t D ]$}zt|�W S ty" ddl}||jv r � Y q ty* Y qw tdd��)a3 Creates and returns a SAX parser. Creates the first parser it is able to instantiate of the ones given in the iterable created by chaining parser_list and default_parser_list. The iterables must contain the names of Python modules containing both a SAX parser and a create_parser function.r NzNo parsers found)�list�default_parser_list�_create_parser� ImportError�sys�modulesr )� parser_list� parser_namer' r r r r F s � � r c C s$ ddl m} |�| dt� �}|�� S )Nr )�imp)�org.python.corer+ � importName�globals� create_parser)r* r+ � drv_moduler r r r% a s r% c C s t | i i dg�}|�� S )Nr/ )� __import__r/ )r* r0 r r r r% g s )r ) �__doc__� xmlreaderr r r r � _exceptionsr r r r r r r r$ �_false�xml.sax.expatreader�xml�osr' �flags�ignore_environment�environ�split�_key�platform�registry� containsKey� getPropertyr r% r r r r �<module> s. � sax/__pycache__/handler.cpython-310.pyc 0000644 00000034320 15027446000 0013665 0 ustar 00 o }�5h= � @ s� d Z dZG dd� d�ZG dd� d�ZG dd� d�ZG dd � d �Zd Zd Zd Zd Z dZ dZ eeee e e gZ dZ dZdZdZdZdZe eeeeegZG dd� d�ZdS )a0 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$ z2.0betac @ s( e Zd ZdZdd� Zdd� Zdd� ZdS ) � ErrorHandlera� Basic interface for SAX error handlers. If you create an object that implements this interface, then register the object with your XMLReader, the parser will call the methods in your object to report all warnings and errors. There are three levels of errors available: warnings, (possibly) recoverable errors, and unrecoverable errors. All methods take a SAXParseException as the only parameter.c C � |�)zHandle a recoverable error.� ��self� exceptionr r �&/usr/lib/python3.10/xml/sax/handler.py�error � zErrorHandler.errorc C r )z Handle a non-recoverable error.r r r r r � fatalError$ r zErrorHandler.fatalErrorc C s t |� dS )zHandle a warning.N)�printr r r r �warning( s zErrorHandler.warningN)�__name__� __module__� __qualname__�__doc__r r r r r r r r s r c @ s� e Zd ZdZdd� Zdd� Zdd� Zdd � Zd d � Zd d � Z dd� Z dd� Z dd� Z dd� Z dd� Zdd� Zdd� Zd d � Zd S ) �ContentHandlerz�Interface for receiving logical document content events. This is the main callback interface in SAX, and the one most important to applications. The order of events in this interface mirrors the order of the information in the document.c C s d | _ d S )N��_locator�r r r r �__init__6 s zContentHandler.__init__c C s || _ dS )a# Called by the parser to give the application a locator for locating the origin of document events. SAX parsers are strongly encouraged (though not absolutely required) to supply a locator: if it does so, it must supply the locator to the application by invoking this method before invoking any of the other methods in the DocumentHandler interface. The locator allows the application to determine the end position of any document-related event, even if the parser is not reporting an error. Typically, the application will use this information for reporting its own errors (such as character content that does not match an application's business rules). The information returned by the locator is probably not sufficient for use with a search engine. Note that the locator will return correct information only during the invocation of the events in this interface. The application should not attempt to use it at any other time.Nr )r �locatorr r r �setDocumentLocator9 s z!ContentHandler.setDocumentLocatorc C � dS )z�Receive notification of the beginning of a document. The SAX parser will invoke this method only once, before any other methods in this interface or in DTDHandler (except for setDocumentLocator).Nr r r r r � startDocumentP � z ContentHandler.startDocumentc C r )aQ Receive notification of the end of a document. The SAX parser will invoke this method only once, and it will be the last method invoked during the parse. The parser shall not invoke this method until it has either abandoned parsing (because of an unrecoverable error) or reached the end of input.Nr r r r r � endDocumentW r zContentHandler.endDocumentc C r )a Begin the scope of a prefix-URI Namespace mapping. The information from this event is not necessary for normal Namespace processing: the SAX XML reader will automatically replace prefixes for element and attribute names when the http://xml.org/sax/features/namespaces feature is true (the default). There are cases, however, when applications need to use prefixes in character data or in attribute values, where they cannot safely be expanded automatically; the start/endPrefixMapping event supplies the information to the application to expand prefixes in those contexts itself, if necessary. Note that start/endPrefixMapping events are not guaranteed to be properly nested relative to each-other: all startPrefixMapping events will occur before the corresponding startElement event, and all endPrefixMapping events will occur after the corresponding endElement event, but their order is not guaranteed.Nr )r �prefix�urir r r �startPrefixMapping` r z!ContentHandler.startPrefixMappingc C r )z�End the scope of a prefix-URI mapping. See startPrefixMapping for details. This event will always occur after the corresponding endElement event, but the order of endPrefixMapping events is not otherwise guaranteed.Nr )r r r r r �endPrefixMappingw r z ContentHandler.endPrefixMappingc C r )a Signals the start of an element in non-namespace mode. The name parameter contains the raw XML 1.0 name of the element type as a string and the attrs parameter holds an instance of the Attributes class containing the attributes of the element.Nr )r �name�attrsr r r � startElement~ r zContentHandler.startElementc C r )z�Signals the end of an element in non-namespace mode. The name parameter contains the name of the element type, just as with the startElement event.Nr �r r r r r � endElement� r zContentHandler.endElementc C r )a� Signals the start of an element in namespace mode. The name parameter contains the name of the element type as a (uri, localname) tuple, the qname parameter the raw XML 1.0 name used in the source document, and the attrs parameter holds an instance of the Attributes class containing the attributes of the element. The uri part of the name tuple is None for elements which have no namespace.Nr )r r �qnamer! r r r �startElementNS� r z ContentHandler.startElementNSc C r )z�Signals the end of an element in namespace mode. The name parameter contains the name of the element type, just as with the startElementNS event.Nr )r r r% r r r � endElementNS� r zContentHandler.endElementNSc C r )a� Receive notification of character data. The Parser will call this method to report each chunk of character data. SAX parsers may return all contiguous character data in a single chunk, or they may split it into several chunks; however, all of the characters in any single event must come from the same external entity so that the Locator provides useful information.Nr �r �contentr r r � characters� r zContentHandler.charactersc C r )aw Receive notification of ignorable whitespace in element content. Validating Parsers must use this method to report each chunk of ignorable whitespace (see the W3C XML 1.0 recommendation, section 2.10): non-validating parsers may also use this method if they are capable of parsing and using content models. SAX parsers may return all contiguous whitespace in a single chunk, or they may split it into several chunks; however, all of the characters in any single event must come from the same external entity, so that the Locator provides useful information.Nr )r � whitespacer r r �ignorableWhitespace� r z"ContentHandler.ignorableWhitespacec C r )a� Receive notification of a processing instruction. The Parser will invoke this method once for each processing instruction found: note that processing instructions may occur before or after the main document element. A SAX parser should never report an XML declaration (XML 1.0, section 2.8) or a text declaration (XML 1.0, section 4.3.1) using this method.Nr )r �target�datar r r �processingInstruction� r z$ContentHandler.processingInstructionc C r )a Receive notification of a skipped entity. The Parser will invoke this method once for each entity skipped. Non-validating processors may skip entities if they have not seen the declarations (because, for example, the entity was declared in an external DTD subset). All processors may skip external entities, depending on the values of the http://xml.org/sax/features/external-general-entities and the http://xml.org/sax/features/external-parameter-entities properties.Nr r# r r r � skippedEntity� r z ContentHandler.skippedEntityN)r r r r r r r r r r r" r$ r& r' r* r, r/ r0 r r r r r / s r c @ s e Zd ZdZdd� Zdd� ZdS )� DTDHandlerz�Handle DTD events. This interface specifies only those DTD events required for basic parsing (unparsed entities and attributes).c C r )z$Handle a notation declaration event.Nr )r r �publicId�systemIdr r r � notationDecl� r zDTDHandler.notationDeclc C r )z,Handle an unparsed entity declaration event.Nr )r r r2 r3 �ndatar r r �unparsedEntityDecl� r z DTDHandler.unparsedEntityDeclN)r r r r r4 r6 r r r r r1 � s r1 c @ s e Zd ZdZdd� ZdS )�EntityResolvera7 Basic interface for resolving entities. If you create an object implementing this interface, then register the object with your Parser, the parser will call the method in your object to resolve all external entities. Note that DefaultHandler implements this interface with the default behaviour.c C s |S )z�Resolve the system identifier of an entity and return either the system identifier to read from as a string, or an InputSource to read from.r )r r2 r3 r r r � resolveEntity� s z EntityResolver.resolveEntityN)r r r r r8 r r r r r7 � s r7 z&http://xml.org/sax/features/namespacesz.http://xml.org/sax/features/namespace-prefixesz,http://xml.org/sax/features/string-interningz&http://xml.org/sax/features/validationz5http://xml.org/sax/features/external-general-entitiesz7http://xml.org/sax/features/external-parameter-entitiesz-http://xml.org/sax/properties/lexical-handlerz1http://xml.org/sax/properties/declaration-handlerz&http://xml.org/sax/properties/dom-nodez(http://xml.org/sax/properties/xml-stringz-http://www.python.org/sax/properties/encodingz3http://www.python.org/sax/properties/interning-dictc @ s8 e Zd ZdZdd� Zdd� Zdd� Zdd � Zd d � Zd S ) �LexicalHandlera� 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/properties/lexical-handler'.c C r )z�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.Nr r( r r r �commentf r zLexicalHandler.commentc C r )a 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).Nr )r r � public_id� system_idr r r �startDTDl r zLexicalHandler.startDTDc C r )z$Signals the end of DTD declarations.Nr r r r r �endDTDy r zLexicalHandler.endDTDc C r )z�Reports the beginning of a CDATA marked section. The contents of the CDATA marked section will be reported through the characters event.Nr r r r r � startCDATA| r zLexicalHandler.startCDATAc C r )z*Reports the end of a CDATA marked section.Nr r r r r �endCDATA� r zLexicalHandler.endCDATAN) r r r r r: r= r> r? r@ r r r r r9 Y s r9 N)r �versionr r r1 r7 �feature_namespaces�feature_namespace_prefixes�feature_string_interning�feature_validation�feature_external_ges�feature_external_pes� all_features�property_lexical_handler� property_declaration_handler�property_dom_node�property_xml_string�property_encoding�property_interning_dict�all_propertiesr9 r r r r �<module> sD "� � sax/__pycache__/saxutils.cpython-310.pyc 0000644 00000030546 15027446000 0014132 0 ustar 00 o }�5h�/ � @ s� d Z ddlZddlZddlZddlZddlZddlmZ ddlm Z dd� Z i fdd �Z i fd d �Z i fd d �Z dd� ZG dd� dej�ZG dd� de j�Zddd�ZdS )znA library of useful helper classes to the SAX classes, for the convenience of application and driver writers. � N� )�handler)� xmlreaderc C s" |� � D ] \}}| �||�} q| S )z2Replace substrings of a string using a dictionary.)�items�replace)�s�d�key�value� r �'/usr/lib/python3.10/xml/sax/saxutils.py�__dict_replace s r c C s6 | � dd�} | � dd�} | � dd�} |rt| |�} | S )z�Escape &, <, and > in a string of data. You can escape other strings of data by passing a dictionary as the optional entities parameter. The keys and values must all be strings; each key will be replaced with its corresponding value. �&�&�>�>�<�<�r r ��data�entitiesr r r �escape s r c C s2 | � dd�} | � dd�} |rt| |�} | � dd�S )a Unescape &, <, and > in a string of data. You can unescape other strings of data by passing a dictionary as the optional entities parameter. The keys and values must all be strings; each key will be replaced with its corresponding value. r r r r r r r r r r r �unescape" s r c C sZ i |�dddd��}t | |�} d| v r'd| v r!d| �dd� } | S d | } | S d| } | S ) a� Escape and quote an attribute value. Escape &, <, and > in a string of data, then quote it for use as an attribute value. The " character will be escaped as well, if necessary. You can escape other strings of data by passing a dictionary as the optional entities parameter. The keys and values must all be strings; each key will be replaced with its corresponding value. z z z	)� � � �"�'z"%s"z"z'%s')r r r r r r � quoteattr0 s ��r c s� � d u r dd l }|jS t� tj�r� S t� tjtjf�r � S t� tj�r6G � fdd�d�}|� }dd� |_ n!t� � }dd� |_ � j |_ z � j |_ � j|_W n tyV Y nw tj||ddd d �S ) Nr c s e Zd Z� jZ� fdd�ZdS )z _gettextwriter.<locals>._wrapperc s t � |�S �N)�getattr��self�name��outr r � __getattr__Z � z,_gettextwriter.<locals>._wrapper.__getattr__N)�__name__� __module__� __qualname__� __class__r' r r% r r �_wrapperX s r- c S s d S r r r r r r �<lambda>] � z _gettextwriter.<locals>.<lambda>c S s dS )NTr r r r r r. b r/ �xmlcharrefreplacer T)�encoding�errors�newline� write_through)�sys�stdout� isinstance�io� TextIOBase�codecs� StreamWriter�StreamReaderWriter� RawIOBase�close�BufferedIOBase�writable�write�seekable�tell�AttributeError� TextIOWrapper)r& r1 r5 r- �bufferr r% r �_gettextwriterG s2 ��rG c @ s� e Zd Zd dd�Zdd� Zd!dd �Zd d � Zd d � Zdd� Zdd� Z dd� Z dd� Z dd� Z dd� Z dd� Zd d � Zd d � ZdS )"� XMLGeneratorN� iso-8859-1Fc C sV t j�| � t||�}|j| _|j| _i g| _| jd | _ g | _ || _ || _ d| _ d S )N���F)r �ContentHandler�__init__rG rA �_write�flush�_flush� _ns_contexts�_current_context�_undeclared_ns_maps� _encoding�_short_empty_elements�_pending_start_element)r# r& r1 �short_empty_elementsr r r rL r s zXMLGenerator.__init__c C sJ |d r!d|d krd|d S | j |d }|r!|d |d S |d S )z7Builds a qualified name from a (ns_url, localname) pairr z$http://www.w3.org/XML/1998/namespacezxml:r �:)rQ )r# r$ �prefixr r r �_qname~ s zXMLGenerator._qnamec C s | j r | �d� d| _ d S d S )Nr F�rU rM )r# � endElementr r r � _finish_pending_start_element� s �z*XMLGenerator._finish_pending_start_elementc C s | � d| j � d S )Nz$<?xml version="1.0" encoding="%s"?> )rM rS �r# r r r � startDocument� s �zXMLGenerator.startDocumentc C s | � � d S r )rO r] r r r � endDocument� � zXMLGenerator.endDocumentc C s0 | j �| j�� � || j|< | j�||f� d S r )rP �appendrQ �copyrR �r# rX �urir r r �startPrefixMapping� s z XMLGenerator.startPrefixMappingc C s | j d | _| j d= d S )NrJ )rP rQ �r# rX r r r �endPrefixMapping� s z XMLGenerator.endPrefixMappingc C s\ | � � | �d| � |�� D ]\}}| �d|t|�f � q| jr'd| _d S | �d� d S )Nr � %s=%sTr )r\ rM r r rT rU )r# r$ �attrsr r r r � startElement� s zXMLGenerator.startElementc C s, | j r | �d� d| _ d S | �d| � d S �Nz/>Fz</%s>rZ r" r r r r[ � s zXMLGenerator.endElementc C s� | � � | �d| �|� � | jD ]\}}|r!| �d||f � q| �d| � qg | _|�� D ]\}}| �d| �|�t|�f � q0| jrKd| _d S | �d� d S )Nr z xmlns:%s="%s"z xmlns="%s"rh Tr )r\ rM rY rR r r rT rU )r# r$ �qnameri rX rd r r r r �startElementNS� s zXMLGenerator.startElementNSc C s2 | j r | �d� d| _ d S | �d| �|� � d S rk )rU rM rY �r# r$ rl r r r � endElementNS� s zXMLGenerator.endElementNSc C s8 |r| � � t|t�st|| j�}| �t|�� d S d S r )r\ r7 �strrS rM r �r# �contentr r r � characters� s �zXMLGenerator.charactersc C s4 |r| � � t|t�st|| j�}| �|� d S d S r )r\ r7 rp rS rM rq r r r �ignorableWhitespace� s �z XMLGenerator.ignorableWhitespacec C s | � � | �d||f � d S )Nz <?%s %s?>)r\ rM �r# �targetr r r r �processingInstruction� s z"XMLGenerator.processingInstruction)NrI F)F)r) r* r+ rL rY r\ r^ r_ re rg rj r[ rm ro rs rt rw r r r r rH p 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 )<� XMLFilterBaseaY This class is designed to sit between an XMLReader and the client application's event handlers. By default, it does nothing but pass requests up to the reader and events on to the handlers unmodified, but subclasses can override specific methods to modify the event stream or the configuration requests as they pass through.Nc C s t j�| � || _d S r )r � XMLReaderrL �_parent�r# �parentr r r rL � s zXMLFilterBase.__init__c C � | j �|� d S r )� _err_handler�error�r# � exceptionr r r r � � zXMLFilterBase.errorc C r} r )r~ � fatalErrorr� r r r r� � r� zXMLFilterBase.fatalErrorc C r} r )r~ �warningr� r r r r� � r� zXMLFilterBase.warningc C r} r )� _cont_handler�setDocumentLocator)r# �locatorr r r r� � r� z XMLFilterBase.setDocumentLocatorc C � | j �� d S r )r� r^ r] r r r r^ � � zXMLFilterBase.startDocumentc C r� r )r� r_ r] r r r r_ r� zXMLFilterBase.endDocumentc C � | j �||� d S r )r� re rc r r r re � z XMLFilterBase.startPrefixMappingc C r} r )r� rg rf r r r rg r� z XMLFilterBase.endPrefixMappingc C r� r )r� rj )r# r$ ri r r r rj r� zXMLFilterBase.startElementc C r} r )r� r[ r" r r r r[ r� zXMLFilterBase.endElementc C � | j �|||� d S r )r� rm )r# r$ rl ri r r r rm � z XMLFilterBase.startElementNSc C r� r )r� ro rn r r r ro r� zXMLFilterBase.endElementNSc C r} r )r� rs rq r r r rs r� zXMLFilterBase.charactersc C r} r )r� rt )r# �charsr r r rt r� z!XMLFilterBase.ignorableWhitespacec C r� r )r� rw ru r r r rw r� z#XMLFilterBase.processingInstructionc C r} r )r� � skippedEntityr" r r r r� r� zXMLFilterBase.skippedEntityc C r� r )� _dtd_handler� notationDecl)r# r$ �publicId�systemIdr r r r� % r� zXMLFilterBase.notationDeclc C s | j �||||� d S r )r� �unparsedEntityDecl)r# r$ r� r� �ndatar r r r� ( s z XMLFilterBase.unparsedEntityDeclc C s | j �||�S r )� _ent_handler� resolveEntity)r# r� r� r r r r� - r� zXMLFilterBase.resolveEntityc C s@ | j �| � | j �| � | j �| � | j �| � | j �|� d S r )rz �setContentHandler�setErrorHandler�setEntityResolver� setDTDHandler�parse)r# �sourcer r r r� 2 s zXMLFilterBase.parsec C r} r )rz � setLocale)r# �localer r r r� 9 r� zXMLFilterBase.setLocalec C � | j �|�S r )rz � getFeaturer" r r r r� < r` zXMLFilterBase.getFeaturec C r� r )rz � setFeature)r# r$ �stater r r r� ? r� zXMLFilterBase.setFeaturec C r� r )rz � getPropertyr" r r r r� B r` zXMLFilterBase.getPropertyc C r� r )rz � setProperty)r# r$ r r r r r� E r� zXMLFilterBase.setPropertyc C s | j S r �rz r] r r r � getParentJ s zXMLFilterBase.getParentc C s || _ d S r r� r{ r r r � setParentM r( zXMLFilterBase.setParentr ) r) r* r+ �__doc__rL r r� r� r� r^ r_ re rg rj r[ rm ro rs rt rw r� r� r� r� r� r� r� r� r� r� r� r� r r r r rx � s< rx � c C s t | tj�r t�| �} t | t�rt�| �} n/t| d�rE| }t�� } t |�d�t�r/| � |� n| � |� t|d�rEt |j t�rE| � |j � | � � du r�| �� du r�| �� }tj�tj�|��}tj�||�}tj�|�rw| � |� t|d�}n| � tj�||�� tj�| �� �}| � |� | S )z�This function takes an InputSource and an optional base URL and returns a fully resolved InputSource object ready for reading.�readr r$ N�rb)r7 �os�PathLike�fspathrp r � InputSource�hasattrr� �setCharacterStream� setByteStreamr$ � setSystemId�getCharacterStream� getByteStream� getSystemId�path�dirname�normpath�join�isfile�open�urllibr� �urljoin�request�urlopen)r� �base�f�sysid�basehead� sysidfilenamer r r �prepare_input_sourceR s. r� )r� )r� r� � urllib.parser� �urllib.requestr8 r: r� r r r r r r rG rK rH ry rx r� r r r r �<module> s )so sax/__pycache__/xmlreader.cpython-310.pyc 0000644 00000040003 15027446000 0014226 0 ustar 00 o }�5h�1 � @ s� d Z ddlmZ ddlmZmZ G dd� d�ZG dd� de�ZG dd � d �ZG d d � d �Z G d d � d �Z G dd� de �Z dd� Z e dkrIe � dS dS )z]An XML Reader is the SAX 2 name for an XML parser. XML Parsers should be based on this code. � )�handler)�SAXNotSupportedException�SAXNotRecognizedExceptionc @ s� e Zd ZdZdd� Zdd� Zdd� Zdd � Zd d � Zd d � Z dd� Z dd� Z dd� Z dd� Z dd� Zdd� Zdd� Zd d � Zd d � Zd S )!� XMLReadera% Interface for reading an XML document using callbacks. XMLReader is the interface that an XML parser's SAX2 driver must implement. This interface allows an application to set and query features and properties in the parser, to register event handlers for document processing, and to initiate a document parse. All SAX interfaces are assumed to be synchronous: the parse methods must not return until parsing is complete, and readers must wait for an event-handler callback to return before reporting the next event.c C s, t �� | _t �� | _t �� | _t �� | _d S �N) r �ContentHandler� _cont_handler� DTDHandler� _dtd_handler�EntityResolver� _ent_handler� ErrorHandler� _err_handler��self� r �(/usr/lib/python3.10/xml/sax/xmlreader.py�__init__ s zXMLReader.__init__c C � t d��)zAParse an XML document from a system identifier or an InputSource.� This method must be implemented!��NotImplementedError�r �sourcer r r �parse s zXMLReader.parsec C � | j S )z#Returns the current ContentHandler.�r r r r r �getContentHandler" � zXMLReader.getContentHandlerc C � || _ dS )z:Registers a new object to receive document content events.Nr �r r r r r �setContentHandler& � zXMLReader.setContentHandlerc C r )z Returns the current DTD handler.�r r r r r � getDTDHandler* r zXMLReader.getDTDHandlerc C r )z7Register an object to receive basic DTD-related events.Nr# r r r r � setDTDHandler. r" zXMLReader.setDTDHandlerc C r )z#Returns the current EntityResolver.�r r r r r �getEntityResolver2 r zXMLReader.getEntityResolverc C r )z0Register an object to resolve external entities.Nr& )r �resolverr r r �setEntityResolver6 r" zXMLReader.setEntityResolverc C r )z!Returns the current ErrorHandler.�r r r r r �getErrorHandler: r zXMLReader.getErrorHandlerc C r )z3Register an object to receive error-message events.Nr* r r r r �setErrorHandler> r" zXMLReader.setErrorHandlerc C r )aH Allow an application to set the locale for errors and warnings. SAX parsers are not required to provide localization for errors and warnings; if they cannot support the requested locale, however, they must raise a SAX exception. Applications may request a locale change in the middle of a parse.z Locale support not implemented)r )r �localer r r � setLocaleB � zXMLReader.setLocalec C � t d| ��)z1Looks up and returns the state of a SAX2 feature.�Feature '%s' not recognized�r �r �namer r r � getFeatureK � zXMLReader.getFeaturec C r0 )z!Sets the state of a SAX2 feature.r1 r2 )r r4 �stater r r � setFeatureO r6 zXMLReader.setFeaturec C r0 )z2Looks up and returns the value of a SAX2 property.� Property '%s' not recognizedr2 r3 r r r � getPropertyS r6 zXMLReader.getPropertyc C r0 )z"Sets the value of a SAX2 property.r9 r2 )r r4 �valuer r r � setPropertyW r6 zXMLReader.setPropertyN)�__name__� __module__� __qualname__�__doc__r r r r! r$ r% r' r) r+ r, r. r5 r8 r: r< r r r r r s" r c @ sB e Zd ZdZddd�Zdd� Zdd� Zd d � Zd d � Zd d� Z dS )�IncrementalParseras This interface adds three extra methods to the XMLReader interface that allow XML parsers to support incremental parsing. Support for this interface is optional, since not all underlying XML parsers support this functionality. When the parser is instantiated it is ready to begin accepting data from the feed method immediately. After parsing has been finished with a call to close the reset method must be called to make the parser ready to accept new data, either from feed or using the parse method. Note that these methods must _not_ be called during parsing, that is, after parse has been called and before it returns. By default, the class also implements the parse method of the XMLReader interface using the feed, close and reset methods of the IncrementalParser interface as a convenience to SAX 2.0 driver writers.� c C s || _ t�| � d S r )�_bufsizer r )r �bufsizer r r r o s zIncrementalParser.__init__c C sn ddl m} |�|�}| �|� |�� }|d u r |�� }|�| j�}|r1| �|� |�| j�}|s$| � � d S )Nr )�saxutils) � rE �prepare_input_source� prepareParser�getCharacterStream� getByteStream�readrC �feed�close)r r rE �file�bufferr r r r s s � zIncrementalParser.parsec C r )a This method gives the raw XML data in the data parameter to the parser and makes it parse the data, emitting the corresponding events. It is allowed for XML constructs to be split across several calls to feed. feed may raise SAXException.r r )r �datar r r rL � r/ zIncrementalParser.feedc C r )ztThis method is called by the parse implementation to allow the SAX 2.0 driver to prepare itself for parsing.z!prepareParser must be overridden!r r r r r rH � s z IncrementalParser.prepareParserc C r )a� This method is called when the entire XML document has been passed to the parser through the feed method, to notify the parser that there are no more data. This allows the parser to do the final checks on the document and empty the internal data buffer. The parser will not be ready to parse another document until the reset method has been called. close may raise SAXException.r r r r r r rM � s zIncrementalParser.closec C r )z�This method is called after close has been called to reset the parser so that it is ready to parse new documents. The results of calling parse or feed after close without calling reset are undefined.r r r r r r �reset� s zIncrementalParser.resetN)rB ) r= r> r? r@ r r rL rH rM rQ r r r r rA [ s rA c @ s0 e Zd ZdZdd� Zdd� Zdd� Zdd � Zd S ) �Locatorz�Interface for associating a SAX event with a document location. A locator object will return valid results only during calls to DocumentHandler methods; at any other time, the results are unpredictable.c C � dS )z6Return the column number where the current event ends.���r r r r r �getColumnNumber� � zLocator.getColumnNumberc C rS )z4Return the line number where the current event ends.rT r r r r r � getLineNumber� rV zLocator.getLineNumberc C rS )z3Return the public identifier for the current event.Nr r r r r � getPublicId� rV zLocator.getPublicIdc C rS )z3Return the system identifier for the current event.Nr r r r r � getSystemId� rV zLocator.getSystemIdN)r= r> r? r@ rU rW rX rY r r r r rR � s rR c @ sj e Zd ZdZddd�Zdd� Zdd� Zd d � Zd d � Zd d� Z dd� Z dd� Z dd� Z dd� Z dd� ZdS )� InputSourcean Encapsulation of the information needed by the XMLReader to read entities. This class may include information about the public identifier, system identifier, byte stream (possibly with character encoding information) and/or the character stream of an entity. Applications will create objects of this class for use in the XMLReader.parse method and for returning from EntityResolver.resolveEntity. An InputSource belongs to the application, the XMLReader is not allowed to modify InputSource objects passed to it from the application, although it may make copies and modify those.Nc C s" || _ d | _d | _d | _d | _d S r )�_InputSource__system_id�_InputSource__public_id�_InputSource__encoding�_InputSource__bytefile�_InputSource__charfile�r � system_idr r r r � s zInputSource.__init__c C r )z/Sets the public identifier of this InputSource.N�r\ )r � public_idr r r � setPublicId� r" zInputSource.setPublicIdc C r )z2Returns the public identifier of this InputSource.rb r r r r rX � r zInputSource.getPublicIdc C r )z/Sets the system identifier of this InputSource.N�r[ r` r r r � setSystemId� r" zInputSource.setSystemIdc C r )z2Returns the system identifier of this InputSource.re r r r r rY � r zInputSource.getSystemIdc C r )a4 Sets the character encoding of this InputSource. The encoding must be a string acceptable for an XML encoding declaration (see section 4.3.3 of the XML recommendation). The encoding attribute of the InputSource is ignored if the InputSource also contains a character stream.N�r] )r �encodingr r r � setEncoding� � zInputSource.setEncodingc C r )z/Get the character encoding of this InputSource.rg r r r r � getEncoding� r zInputSource.getEncodingc C r )a� Set the byte stream (a Python file-like object which does not perform byte-to-character conversion) for this input source. The SAX parser will ignore this if there is also a character stream specified, but it will use a byte stream in preference to opening a URI connection itself. If the application knows the character encoding of the byte stream, it should set it with the setEncoding method.N�r^ )r �bytefiler r r � setByteStream� s zInputSource.setByteStreamc C r )z�Get the byte stream for this input source. The getEncoding method will return the character encoding for this byte stream, or None if unknown.rl r r r r rJ � s zInputSource.getByteStreamc C r )a^ Set the character stream for this input source. (The stream must be a Python 2.0 Unicode-wrapped file-like that performs conversion to Unicode strings.) If there is a character stream specified, the SAX parser will ignore any byte stream and will not attempt to open a URI connection to the system identifier.N�r_ )r �charfiler r r �setCharacterStream rj z InputSource.setCharacterStreamc C r )z/Get the character stream for this input source.ro r r r r rI r z InputSource.getCharacterStreamr )r= r> r? r@ r rd rX rf rY ri rk rn rJ rq rI r r r r rZ � s rZ c @ s� e Zd Zdd� Zdd� Zdd� Zdd� Zd d � Zd d � Zd d� Z dd� Z dd� Z dd� Z dd� Z dd� Zdd� Zd$d d �Zd d � Zd d!� Zd"d#� ZdS )%�AttributesImplc C r )zQNon-NS-aware implementation. attrs should be of the form {name : value}.N��_attrs)r �attrsr r r r s zAttributesImpl.__init__c C � t | j�S r ��lenrt r r r r � getLength � zAttributesImpl.getLengthc C rS )N�CDATAr r3 r r r �getType! s zAttributesImpl.getTypec C � | j | S r rs r3 r r r �getValue$ rz zAttributesImpl.getValuec C r} r rs r3 r r r �getValueByQName' rz z AttributesImpl.getValueByQNamec C � || j vr t|��|S r �rt �KeyErrorr3 r r r �getNameByQName* � z AttributesImpl.getNameByQNamec C r� r r� r3 r r r �getQNameByName/ r� z AttributesImpl.getQNameByNamec C � t | j�� �S r ��listrt �keysr r r r �getNames4 � zAttributesImpl.getNamesc C r� r r� r r r r � getQNames7 r� zAttributesImpl.getQNamesc C rv r rw r r r r �__len__: rz zAttributesImpl.__len__c C r} r rs r3 r r r � __getitem__= rz zAttributesImpl.__getitem__c C r� r r� r r r r r� @ r� zAttributesImpl.keysc C s || j v S r rs r3 r r r � __contains__C rz zAttributesImpl.__contains__Nc C s | j �||�S r )rt �get)r r4 � alternativer r r r� F r� zAttributesImpl.getc C s | � | j�S r )� __class__rt r r r r �copyI s zAttributesImpl.copyc C r� r )r� rt �itemsr r r r r� L r� zAttributesImpl.itemsc C r� r )r� rt �valuesr r r r r� O r� zAttributesImpl.valuesr )r= r> r? r ry r| r~ r r� r� r� r� r� r� r� r� r� r� r� r� r r r r rr s$ rr c @ s< e Zd Zdd� Zdd� Zdd� Zdd� Zd d � Zd d � Zd S )�AttributesNSImplc C s || _ || _dS )z�NS-aware implementation. attrs should be of the form {(ns_uri, lname): value, ...}. qnames of the form {(ns_uri, lname): qname, ...}.N)rt �_qnames)r ru �qnamesr r r r V s zAttributesNSImpl.__init__c C s2 | j �� D ]\}}||kr| j| S qt|��r )r� r� rt r� �r r4 �nsname�qnamer r r r ^ s �z AttributesNSImpl.getValueByQNamec C s, | j �� D ] \}}||kr| S qt|��r )r� r� r� r� r r r r� e s �z AttributesNSImpl.getNameByQNamec C r} r )r� r3 r r r r� l rz z AttributesNSImpl.getQNameByNamec C r� r )r� r� r� r r r r r� o r� zAttributesNSImpl.getQNamesc C s | � | j| j�S r )r� rt r� r r r r r� r s zAttributesNSImpl.copyN) r= r> r? r r r� r� r� r� r r r r r� T s r� c C s t � t� t� d S r )r rA rR r r r r �_testv s r� �__main__N)r@ rF r � _exceptionsr r r rA rR rZ rr r� r� r= r r r r �<module> s PJY>" � sax/__pycache__/expatreader.cpython-310.pyc 0000644 00000030325 15027446000 0014555 0 ustar 00 o }�5ho= � @ s� d Z dZddlT ddlmZmZ ddlmZ ddlmZmZ ddlm Z ddlm Z m Z dd l Z e j d d � d kr>ed d ��[ zdd lmZ W n eyS edd ��w eed�s^edd ��ddlmZmZmZ ejZejZzdd lZW n ey� dd� ZY n w dd lZej Z[[G dd� d�Z G dd� dej �Z G dd� dej ej �Z!dd� Z"e#dkr�dd l$Z%e"� Z&e&�'e%j(j�)� � e&�*e%j(�+� � e&�,d � d S d S ) z] SAX driver for the pyexpat C module. This driver works with pyexpat.__version__ == '2.22'. z0.20� )�*)�feature_validation�feature_namespaces)�feature_namespace_prefixes)�feature_external_ges�feature_external_pes)�feature_string_interning)�property_xml_string�property_interning_dictN� �javazexpat not available in Java)�expatzexpat not supported� ParserCreate)� xmlreader�saxutils�handlerc C s | S �N� )�or r �*/usr/lib/python3.10/xml/sax/expatreader.py�_mkproxy' s r c @ s e Zd ZdS )� _ClosedParserN)�__name__� __module__� __qualname__r r r r r . s r c @ s8 e Zd ZdZdd� Zdd� Zdd� Zdd � Zd d � Zd S ) � ExpatLocatorz�Locator for use with the ExpatParser class. This uses a weak reference to the parser object to avoid creating a circular reference between the parser and the content handler. c C s t |�| _d S r )r �_ref��self�parserr r r �__init__9 � zExpatLocator.__init__c C s | j }|jd u r d S |jjS r )r �_parser�ErrorColumnNumberr r r r �getColumnNumber< � z ExpatLocator.getColumnNumberc C s | j }|jd u r dS |jjS �N� )r r" �ErrorLineNumberr r r r � getLineNumberB r% zExpatLocator.getLineNumberc C � | j }|d u r d S |j�� S r )r �_source� getPublicIdr r r r r, H � zExpatLocator.getPublicIdc C r* r )r r+ � getSystemIdr r r r r. N r- zExpatLocator.getSystemIdN) r r r �__doc__r r$ r) r, r. r r r r r 3 s r c @ s e Zd ZdZdDdd�Zdd� Zdd � Zd d � Zd d � Zdd� Z dd� Z dd� Z dEdd�Z dd� Z dd� Zdd � Zd d � Zd d � Zd!d"� Zd#d$� Zd%d&� Zd'd(� Zd)d*� Zd+d,� Zd-d.� Zd/d0� Zd1d2� Zd3d4� Zd5d6� Z d7d8� Z d9d:� Z d;d<� Z d=d>� Z d?d@� Z!dAdB� Z"dCS )F� ExpatParserz$SAX driver for the pyexpat C module.r �� c C sF t j�| |� t �� | _d | _|| _d | _d| _g | _ d| _ d | _ d S )NFr ) r �IncrementalParserr � InputSourcer+ r" � _namespaces�_lex_handler_prop�_parsing� _entity_stack� _external_ges� _interning)r �namespaceHandling�bufsizer r r r Z s zExpatParser.__init__c C sN t �|�}|| _z| �� | j�t| �� tj� | |� W dS | � � � )z3Parse an XML document from a URL or an InputSource.N) r �prepare_input_sourcer+ �reset� _cont_handler�setDocumentLocatorr r r2 �parse� _close_source�r �sourcer r r r@ g s zExpatParser.parsec C s$ |� � d ur| j�|� � � d S d S r )r. r" �SetBaserB r r r � prepareParserw s �zExpatParser.prepareParserc C s$ t j�| |� | jr| �� d S d S r )r r2 �setContentHandlerr6 �_reset_cont_handler)r r r r r rF } s �z ExpatParser.setContentHandlerc C sL |t kr| jS |tkr| jd uS |tttfv rdS |tkr | jS t d| ��)Nr �Feature '%s' not recognized) r r4 r r9 r r r r r8 �SAXNotRecognizedException�r �namer r r � getFeature� s � zExpatParser.getFeaturec C s� | j rtd��|tkr|| _d S |tkr|| _d S |tkr0|r+| jd u r)i | _d S d S d | _d S |tkr<|r:td��d S |t krH|rFtd��d S |t krT|rRtd��d S t d| ��)Nz!Cannot set features while parsingz!expat does not support validationz/expat does not read external parameter entitiesz(expat does not report namespace prefixesrH ) r6 �SAXNotSupportedExceptionr r4 r r8 r r9 r r r rI )r rK �stater r r � setFeature� sB � �������zExpatParser.setFeaturec C s^ |t jkr| jS |tkr| jS |tkr)| jr%t| jd�r!| j�� S t d��t d��t d| ��)N�GetInputContextz=This version of expat does not support getting the XML stringz.XML string cannot be returned when not parsing� Property '%s' not recognized) r �property_lexical_handlerr5 r r9 r r" �hasattrrP rI rM rJ r r r � getProperty� s �� zExpatParser.getPropertyc C sX |t jkr|| _| jr| �� d S d S |tkr || _d S |tkr&td| ��t d| ��)NzProperty '%s' cannot be setrQ ) r rR r5 r6 �_reset_lex_handler_propr r9 r rM rI )r rK �valuer r r � setProperty� s � ��zExpatParser.setPropertyFc C s| | j s| �� d| _ | j�� z | j�||� W d S tjy= } ztt� |j �|| �}| j � |� W Y d }~d S d }~ww )NT) r6 r= r> � startDocumentr" �Parser �error�SAXParseException� ErrorString�code� _err_handler� fatalError)r �data�isFinal�e�excr r r �feed� s ��zExpatParser.feedc C s^ | j }z |�� }|d ur|�� W |�� }|d ur |�� d S d S |�� }|d ur.|�� w w r )r+ �getCharacterStream�close� getByteStream)r rC �filer r r rA � s � �� �zExpatParser._close_sourcec C s� | j s| jd u st| jt�rd S z1| jddd� | j�� d| _d | _W d| _| jd ur<t� }| jj|_| jj |_ || _| � � d S d| _| jd urZt� }| jj|_| jj |_ || _| � � w )N� T)ra F) r7 r" � isinstancer rd r> � endDocumentr6 r# r( rA r r r r rf � s. � � zExpatParser.closec C s | j j| j_| j j| j_d S r )r> �processingInstructionr" � ProcessingInstructionHandler� characters�CharacterDataHandler�r r r r rG � s �z ExpatParser._reset_cont_handlerc C sb | j }| j}|d u rd |_d |_d |_d |_d |_d S |j|_|j|_|j |_| j |_|j |_d S r ) r5 r" �CommentHandler�StartCdataSectionHandler�EndCdataSectionHandler�StartDoctypeDeclHandler�EndDoctypeDeclHandler�comment� startCDATA�endCDATA�start_doctype_decl�endDTD)r �lexr r r r rU s z#ExpatParser._reset_lex_handler_propc C s� | j r tj| j�� d| jd�| _d| j_| j| j_ | j | j_ ntj| j�� | jd�| _| j | j_ | j | j_ | �� | j| j_| j| j_| j| j_| j| j_d | _| jrW| �� | j| j_z| j | j_ W n t yl Y nw | j� tj � d| _!g | _"d S )N� )�internr' F)#r4 r r r+ � getEncodingr9 r" �namespace_prefixes�start_element_ns�StartElementHandler�end_element_ns�EndElementHandler� start_element� end_elementrG �unparsed_entity_decl�UnparsedEntityDeclHandler� notation_decl�NotationDeclHandler�start_namespace_decl�StartNamespaceDeclHandler�end_namespace_decl�EndNamespaceDeclHandler�_decl_handler_propr5 rU �external_entity_ref�ExternalEntityRefHandler�skipped_entity_handler�SkippedEntityHandler�AttributeError�SetParamEntityParsing�*XML_PARAM_ENTITY_PARSING_UNLESS_STANDALONEr6 r7 rp r r r r= s> � � �� zExpatParser.resetc C s | j d u rd S | j jS r )r" r# rp r r r r$ ; � zExpatParser.getColumnNumberc C s | j d u rdS | j jS r& )r" r( rp r r r r) @ r� zExpatParser.getLineNumberc C � | j �� S r )r+ r, rp r r r r, E � zExpatParser.getPublicIdc C r� r )r+ r. rp r r r r. H r� zExpatParser.getSystemIdc C s | j �|t|�� d S r )r> � startElement�AttributesImpl)r rK �attrsr r r r� L � zExpatParser.start_elementc C � | j �|� d S r )r> � endElementrJ r r r r� O � zExpatParser.end_elementc C s� |� � }t|�dkrd |f}nt|�dkr |d |d f}nt|�}i }i }|�� D ]>\}}|� � }t|�} | dkrA|} d |f} n | dkrXd|d |d f } |d |d f} n|d } t|�} ||| < | || < q*| j�|d t||�� d S )Nr' � r z%s:%s� )�split�len�tuple�itemsr> �startElementNS�AttributesNSImpl) r rK r� �pair�newattrs�qnames�anamerV �parts�length�qname�apairr r r r� R s0 �z ExpatParser.start_element_nsc C sV |� � }t|�dkrd |f}nt|�dkr |d |d f}nt|�}| j�|d � d S )Nr' r� r )r� r� r� r> � endElementNS)r rK r� r r r r� t s zExpatParser.end_element_nsc C � | j �||� d S r )r> rl )r �targetr` r r r �processing_instruction� � z"ExpatParser.processing_instructionc C r� r )r> rn )r r` r r r �character_data� r� zExpatParser.character_datac C r� r )r> �startPrefixMapping)r �prefix�urir r r r� � r� z ExpatParser.start_namespace_declc C r� r )r> �endPrefixMapping)r r� r r r r� � r� z ExpatParser.end_namespace_declc C s | j �|||� d S r )r5 �startDTD)r rK �sysid�pubid�has_internal_subsetr r r ry � � z ExpatParser.start_doctype_declc C s | j �||||� d S r )� _dtd_handler�unparsedEntityDecl)r rK �baser� r� � notation_namer r r r� � r� z ExpatParser.unparsed_entity_declc C s | j �|||� d S r )r� � notationDecl)r rK r� r� r� r r r r� � r� zExpatParser.notation_declc C s� | j sdS | j�||�}t�|| j�� pd�}| j�| j | jf� | j � |�| _ || _z t j � | |� W n Y dS | jd \| _ | _| jd= dS )Nr' � r ���)r8 � _ent_handler� resolveEntityr r< r+ r. r7 �appendr" �ExternalEntityParserCreater r2 r@ )r �contextr� r� r� rC r r r r� � s" �z ExpatParser.external_entity_refc C s |rd| }| j �|� d S )N�%)r> � skippedEntity)r rK �is_per r r r� � s z"ExpatParser.skipped_entity_handlerN)r r1 )F)#r r r r/ r r@ rE rF rL rO rT rW rd rA rf rG rU r= r$ r) r, r. r� r� r� r� r� r� r� r� ry r� r� r� r� r r r r r0 W sB '" r0 c O s t | i |��S r )r0 )�args�kwargsr r r � create_parser� r! r� �__main__z:http://www.ibiblio.org/xml/examples/shakespeare/hamlet.xml)-r/ �version�xml.sax._exceptions�xml.sax.handlerr r r r r r r r �sys�platform�SAXReaderNotAvailable� xml.parsersr � ImportErrorrS �xml.saxr r r r� r� �_weakrefr �weakref�proxyr �Locatorr r2 r0 r� r �xml.sax.saxutils�xml�prF �sax� XMLGenerator�setErrorHandler� ErrorHandlerr@ r r r r �<module> sV � �$ _� sax/__pycache__/_exceptions.cpython-310.pyc 0000644 00000012376 15027446000 0014577 0 ustar 00 o }�5h� � @ s� d Z ddlZejdd� dkrddlmZ [G dd� de�ZG dd � d e�ZG d d � d e�ZG d d � d e�ZG dd� de�Z dS )z!Different kinds of SAX Exceptions� N� �java)� Exceptionc @ s: e Zd ZdZd dd�Zdd� Zdd� Zd d � Zd d � ZdS )� SAXExceptiona� Encapsulate an XML error or warning. This class can contain basic error or warning information from either the XML parser or the application: you can subclass it to provide additional functionality, or to add localization. Note that although you will receive a SAXException as the argument to the handlers in the ErrorHandler interface, you are not actually required to raise the exception; instead, you can simply read the information in it.Nc C s || _ || _t�| |� dS )zUCreates an exception. The message is required, but the exception is optional.N)�_msg� _exceptionr �__init__)�self�msg� exception� r �*/usr/lib/python3.10/xml/sax/_exceptions.pyr s zSAXException.__init__c C � | j S )z$Return a message for this exception.�r �r r r r � getMessage � zSAXException.getMessagec C r )z9Return the embedded exception, or None if there was none.)r r r r r � getException r zSAXException.getExceptionc C r )�0Create a string representation of the exception.r r r r r �__str__" r zSAXException.__str__c C s t d��)zvAvoids weird error messages if someone does exception[ix] by mistake, since Exception has __getitem__ defined.� __getitem__)�AttributeError)r �ixr r r r & s zSAXException.__getitem__)N) �__name__� __module__� __qualname__�__doc__r r r r r r r r r r s r c @ s@ e Zd ZdZdd� Zdd� Zdd� Zdd � Zd d � Zd d � Z dS )�SAXParseExceptiona# Encapsulate an XML parse error or warning. This exception will include information for locating the error in the original XML document. Note that although the application will receive a SAXParseException as the argument to the handlers in the ErrorHandler interface, the application is not actually required to raise the exception; instead, it can simply read the information in it and take a different action. Since this exception is a subclass of SAXException, it inherits the ability to wrap another exception.c C s< t �| ||� || _| j�� | _| j�� | _| j�� | _dS )zECreates the exception. The exception parameter is allowed to be None.N) r r �_locator� getSystemId� _systemId�getColumnNumber�_colnum� getLineNumber�_linenum)r r r �locatorr r r r ; s zSAXParseException.__init__c C r )zNThe column number of the end of the text where the exception occurred.)r" r r r r r! H s z!SAXParseException.getColumnNumberc C r )zDThe line number of the end of the text where the exception occurred.)r$ r r r r r# M r z SAXParseException.getLineNumberc C s | j �� S )zEGet the public identifier of the entity where the exception occurred.)r � getPublicIdr r r r r& Q s z SAXParseException.getPublicIdc C r )zEGet the system identifier of the entity where the exception occurred.)r r r r r r U r z SAXParseException.getSystemIdc C sN | � � }|du r d}| �� }|du rd}| �� }|du r d}d|||| jf S )r Nz <unknown>�?z %s:%s:%s: %s)r r# r! r )r �sysid�linenum�colnumr r r r Y s zSAXParseException.__str__N) r r r r r r! r# r& r r r r r r r . s r c @ � e Zd ZdZdS )�SAXNotRecognizedExceptionz�Exception class for an unrecognized identifier. An XMLReader will raise this exception when it is confronted with an unrecognized feature or property. SAX applications and extensions may use this class for similar purposes.N�r r r r r r r r r, i � r, c @ r+ )�SAXNotSupportedExceptiona Exception class for an unsupported operation. An XMLReader will raise this exception when a service it cannot perform is requested (specifically setting a state or value). SAX applications and extensions may use this class for similar purposes.Nr- r r r r r/ s r. r/ c @ r+ )�SAXReaderNotAvailablea Exception class for a missing driver. An XMLReader module (driver) should raise this exception when it is first imported, e.g. when a support module cannot be imported. It also may be raised during parsing, e.g. if executing an external program is not permitted.Nr- r r r r r0 } r. r0 ) r �sys�platform� java.langr r r r, r/ r0 r r r r �<module> s %; sax/_exceptions.py 0000644 00000011261 15027446000 0010230 0 ustar 00 """Different kinds of SAX Exceptions""" import sys if sys.platform[:4] == "java": from java.lang import Exception del sys # ===== SAXEXCEPTION ===== class SAXException(Exception): """Encapsulate an XML error or warning. This class can contain basic error or warning information from either the XML parser or the application: you can subclass it to provide additional functionality, or to add localization. Note that although you will receive a SAXException as the argument to the handlers in the ErrorHandler interface, you are not actually required to raise the exception; instead, you can simply read the information in it.""" def __init__(self, msg, exception=None): """Creates an exception. The message is required, but the exception is optional.""" self._msg = msg self._exception = exception Exception.__init__(self, msg) def getMessage(self): "Return a message for this exception." return self._msg def getException(self): "Return the embedded exception, or None if there was none." return self._exception def __str__(self): "Create a string representation of the exception." return self._msg def __getitem__(self, ix): """Avoids weird error messages if someone does exception[ix] by mistake, since Exception has __getitem__ defined.""" raise AttributeError("__getitem__") # ===== SAXPARSEEXCEPTION ===== class SAXParseException(SAXException): """Encapsulate an XML parse error or warning. This exception will include information for locating the error in the original XML document. Note that although the application will receive a SAXParseException as the argument to the handlers in the ErrorHandler interface, the application is not actually required to raise the exception; instead, it can simply read the information in it and take a different action. Since this exception is a subclass of SAXException, it inherits the ability to wrap another exception.""" def __init__(self, msg, exception, locator): "Creates the exception. The exception parameter is allowed to be None." SAXException.__init__(self, msg, exception) self._locator = locator # We need to cache this stuff at construction time. # If this exception is raised, the objects through which we must # traverse to get this information may be deleted by the time # it gets caught. self._systemId = self._locator.getSystemId() self._colnum = self._locator.getColumnNumber() self._linenum = self._locator.getLineNumber() def getColumnNumber(self): """The column number of the end of the text where the exception occurred.""" return self._colnum def getLineNumber(self): "The line number of the end of the text where the exception occurred." return self._linenum def getPublicId(self): "Get the public identifier of the entity where the exception occurred." return self._locator.getPublicId() def getSystemId(self): "Get the system identifier of the entity where the exception occurred." return self._systemId def __str__(self): "Create a string representation of the exception." sysid = self.getSystemId() if sysid is None: sysid = "<unknown>" linenum = self.getLineNumber() if linenum is None: linenum = "?" colnum = self.getColumnNumber() if colnum is None: colnum = "?" return "%s:%s:%s: %s" % (sysid, linenum, colnum, self._msg) # ===== SAXNOTRECOGNIZEDEXCEPTION ===== class SAXNotRecognizedException(SAXException): """Exception class for an unrecognized identifier. An XMLReader will raise this exception when it is confronted with an unrecognized feature or property. SAX applications and extensions may use this class for similar purposes.""" # ===== SAXNOTSUPPORTEDEXCEPTION ===== class SAXNotSupportedException(SAXException): """Exception class for an unsupported operation. An XMLReader will raise this exception when a service it cannot perform is requested (specifically setting a state or value). SAX applications and extensions may use this class for similar purposes.""" # ===== SAXNOTSUPPORTEDEXCEPTION ===== class SAXReaderNotAvailable(SAXNotSupportedException): """Exception class for a missing driver. An XMLReader module (driver) should raise this exception when it is first imported, e.g. when a support module cannot be imported. It also may be raised during parsing, e.g. if executing an external program is not permitted.""" sax/expatreader.py 0000644 00000036557 15027446000 0010233 0 ustar 00 """ SAX driver for the pyexpat C module. This driver works with pyexpat.__version__ == '2.22'. """ version = "0.20" from xml.sax._exceptions import * from xml.sax.handler import feature_validation, feature_namespaces from xml.sax.handler import feature_namespace_prefixes from xml.sax.handler import feature_external_ges, feature_external_pes from xml.sax.handler import feature_string_interning from xml.sax.handler import property_xml_string, property_interning_dict # xml.parsers.expat does not raise ImportError in Jython import sys if sys.platform[:4] == "java": raise SAXReaderNotAvailable("expat not available in Java", None) del sys try: from xml.parsers import expat except ImportError: raise SAXReaderNotAvailable("expat not supported", None) else: if not hasattr(expat, "ParserCreate"): raise SAXReaderNotAvailable("expat not supported", None) from xml.sax import xmlreader, saxutils, handler AttributesImpl = xmlreader.AttributesImpl AttributesNSImpl = xmlreader.AttributesNSImpl # If we're using a sufficiently recent version of Python, we can use # weak references to avoid cycles between the parser and content # handler, otherwise we'll just have to pretend. try: import _weakref except ImportError: def _mkproxy(o): return o else: import weakref _mkproxy = weakref.proxy del weakref, _weakref class _ClosedParser: pass # --- ExpatLocator class ExpatLocator(xmlreader.Locator): """Locator for use with the ExpatParser class. This uses a weak reference to the parser object to avoid creating a circular reference between the parser and the content handler. """ def __init__(self, parser): self._ref = _mkproxy(parser) def getColumnNumber(self): parser = self._ref if parser._parser is None: return None return parser._parser.ErrorColumnNumber def getLineNumber(self): parser = self._ref if parser._parser is None: return 1 return parser._parser.ErrorLineNumber def getPublicId(self): parser = self._ref if parser is None: return None return parser._source.getPublicId() def getSystemId(self): parser = self._ref if parser is None: return None return parser._source.getSystemId() # --- ExpatParser class ExpatParser(xmlreader.IncrementalParser, xmlreader.Locator): """SAX driver for the pyexpat C module.""" def __init__(self, namespaceHandling=0, bufsize=2**16-20): xmlreader.IncrementalParser.__init__(self, bufsize) self._source = xmlreader.InputSource() self._parser = None self._namespaces = namespaceHandling self._lex_handler_prop = None self._parsing = False self._entity_stack = [] self._external_ges = 0 self._interning = None # XMLReader methods def parse(self, source): "Parse an XML document from a URL or an InputSource." source = saxutils.prepare_input_source(source) self._source = source try: self.reset() self._cont_handler.setDocumentLocator(ExpatLocator(self)) xmlreader.IncrementalParser.parse(self, source) except: # bpo-30264: Close the source on error to not leak resources: # xml.sax.parse() doesn't give access to the underlying parser # to the caller self._close_source() raise def prepareParser(self, source): if source.getSystemId() is not None: self._parser.SetBase(source.getSystemId()) # Redefined setContentHandler to allow changing handlers during parsing def setContentHandler(self, handler): xmlreader.IncrementalParser.setContentHandler(self, handler) if self._parsing: self._reset_cont_handler() def getFeature(self, name): if name == feature_namespaces: return self._namespaces elif name == feature_string_interning: return self._interning is not None elif name in (feature_validation, feature_external_pes, feature_namespace_prefixes): return 0 elif name == feature_external_ges: return self._external_ges raise SAXNotRecognizedException("Feature '%s' not recognized" % name) def setFeature(self, name, state): if self._parsing: raise SAXNotSupportedException("Cannot set features while parsing") if name == feature_namespaces: self._namespaces = state elif name == feature_external_ges: self._external_ges = state elif name == feature_string_interning: if state: if self._interning is None: self._interning = {} else: self._interning = None elif name == feature_validation: if state: raise SAXNotSupportedException( "expat does not support validation") elif name == feature_external_pes: if state: raise SAXNotSupportedException( "expat does not read external parameter entities") elif name == feature_namespace_prefixes: if state: raise SAXNotSupportedException( "expat does not report namespace prefixes") else: raise SAXNotRecognizedException( "Feature '%s' not recognized" % name) def getProperty(self, name): if name == handler.property_lexical_handler: return self._lex_handler_prop elif name == property_interning_dict: return self._interning elif name == property_xml_string: if self._parser: if hasattr(self._parser, "GetInputContext"): return self._parser.GetInputContext() else: raise SAXNotRecognizedException( "This version of expat does not support getting" " the XML string") else: raise SAXNotSupportedException( "XML string cannot be returned when not parsing") raise SAXNotRecognizedException("Property '%s' not recognized" % name) def setProperty(self, name, value): if name == handler.property_lexical_handler: self._lex_handler_prop = value if self._parsing: self._reset_lex_handler_prop() elif name == property_interning_dict: self._interning = value elif name == property_xml_string: raise SAXNotSupportedException("Property '%s' cannot be set" % name) else: raise SAXNotRecognizedException("Property '%s' not recognized" % name) # IncrementalParser methods def feed(self, data, isFinal=False): if not self._parsing: self.reset() self._parsing = True self._cont_handler.startDocument() try: # The isFinal parameter is internal to the expat reader. # If it is set to true, expat will check validity of the entire # document. When feeding chunks, they are not normally final - # except when invoked from close. self._parser.Parse(data, isFinal) except expat.error as e: exc = SAXParseException(expat.ErrorString(e.code), e, self) # FIXME: when to invoke error()? self._err_handler.fatalError(exc) def _close_source(self): source = self._source try: file = source.getCharacterStream() if file is not None: file.close() finally: file = source.getByteStream() if file is not None: file.close() def close(self): if (self._entity_stack or self._parser is None or isinstance(self._parser, _ClosedParser)): # If we are completing an external entity, do nothing here return try: self.feed(b"", isFinal=True) self._cont_handler.endDocument() self._parsing = False # break cycle created by expat handlers pointing to our methods self._parser = None finally: self._parsing = False if self._parser is not None: # Keep ErrorColumnNumber and ErrorLineNumber after closing. parser = _ClosedParser() parser.ErrorColumnNumber = self._parser.ErrorColumnNumber parser.ErrorLineNumber = self._parser.ErrorLineNumber self._parser = parser self._close_source() def _reset_cont_handler(self): self._parser.ProcessingInstructionHandler = \ self._cont_handler.processingInstruction self._parser.CharacterDataHandler = self._cont_handler.characters def _reset_lex_handler_prop(self): lex = self._lex_handler_prop parser = self._parser if lex is None: parser.CommentHandler = None parser.StartCdataSectionHandler = None parser.EndCdataSectionHandler = None parser.StartDoctypeDeclHandler = None parser.EndDoctypeDeclHandler = None else: parser.CommentHandler = lex.comment parser.StartCdataSectionHandler = lex.startCDATA parser.EndCdataSectionHandler = lex.endCDATA parser.StartDoctypeDeclHandler = self.start_doctype_decl parser.EndDoctypeDeclHandler = lex.endDTD def reset(self): if self._namespaces: self._parser = expat.ParserCreate(self._source.getEncoding(), " ", intern=self._interning) self._parser.namespace_prefixes = 1 self._parser.StartElementHandler = self.start_element_ns self._parser.EndElementHandler = self.end_element_ns else: self._parser = expat.ParserCreate(self._source.getEncoding(), intern = self._interning) self._parser.StartElementHandler = self.start_element self._parser.EndElementHandler = self.end_element self._reset_cont_handler() self._parser.UnparsedEntityDeclHandler = self.unparsed_entity_decl self._parser.NotationDeclHandler = self.notation_decl self._parser.StartNamespaceDeclHandler = self.start_namespace_decl self._parser.EndNamespaceDeclHandler = self.end_namespace_decl self._decl_handler_prop = None if self._lex_handler_prop: self._reset_lex_handler_prop() # self._parser.DefaultHandler = # self._parser.DefaultHandlerExpand = # self._parser.NotStandaloneHandler = self._parser.ExternalEntityRefHandler = self.external_entity_ref try: self._parser.SkippedEntityHandler = self.skipped_entity_handler except AttributeError: # This pyexpat does not support SkippedEntity pass self._parser.SetParamEntityParsing( expat.XML_PARAM_ENTITY_PARSING_UNLESS_STANDALONE) self._parsing = False self._entity_stack = [] # Locator methods def getColumnNumber(self): if self._parser is None: return None return self._parser.ErrorColumnNumber def getLineNumber(self): if self._parser is None: return 1 return self._parser.ErrorLineNumber def getPublicId(self): return self._source.getPublicId() def getSystemId(self): return self._source.getSystemId() # event handlers def start_element(self, name, attrs): self._cont_handler.startElement(name, AttributesImpl(attrs)) def end_element(self, name): self._cont_handler.endElement(name) def start_element_ns(self, name, attrs): pair = name.split() if len(pair) == 1: # no namespace pair = (None, name) elif len(pair) == 3: pair = pair[0], pair[1] else: # default namespace pair = tuple(pair) newattrs = {} qnames = {} for (aname, value) in attrs.items(): parts = aname.split() length = len(parts) if length == 1: # no namespace qname = aname apair = (None, aname) elif length == 3: qname = "%s:%s" % (parts[2], parts[1]) apair = parts[0], parts[1] else: # default namespace qname = parts[1] apair = tuple(parts) newattrs[apair] = value qnames[apair] = qname self._cont_handler.startElementNS(pair, None, AttributesNSImpl(newattrs, qnames)) def end_element_ns(self, name): pair = name.split() if len(pair) == 1: pair = (None, name) elif len(pair) == 3: pair = pair[0], pair[1] else: pair = tuple(pair) self._cont_handler.endElementNS(pair, None) # this is not used (call directly to ContentHandler) def processing_instruction(self, target, data): self._cont_handler.processingInstruction(target, data) # this is not used (call directly to ContentHandler) def character_data(self, data): self._cont_handler.characters(data) def start_namespace_decl(self, prefix, uri): self._cont_handler.startPrefixMapping(prefix, uri) def end_namespace_decl(self, prefix): self._cont_handler.endPrefixMapping(prefix) def start_doctype_decl(self, name, sysid, pubid, has_internal_subset): self._lex_handler_prop.startDTD(name, pubid, sysid) def unparsed_entity_decl(self, name, base, sysid, pubid, notation_name): self._dtd_handler.unparsedEntityDecl(name, pubid, sysid, notation_name) def notation_decl(self, name, base, sysid, pubid): self._dtd_handler.notationDecl(name, pubid, sysid) def external_entity_ref(self, context, base, sysid, pubid): if not self._external_ges: return 1 source = self._ent_handler.resolveEntity(pubid, sysid) source = saxutils.prepare_input_source(source, self._source.getSystemId() or "") self._entity_stack.append((self._parser, self._source)) self._parser = self._parser.ExternalEntityParserCreate(context) self._source = source try: xmlreader.IncrementalParser.parse(self, source) except: return 0 # FIXME: save error info here? (self._parser, self._source) = self._entity_stack[-1] del self._entity_stack[-1] return 1 def skipped_entity_handler(self, name, is_pe): if is_pe: # The SAX spec requires to report skipped PEs with a '%' name = '%'+name self._cont_handler.skippedEntity(name) # --- def create_parser(*args, **kwargs): return ExpatParser(*args, **kwargs) # --- if __name__ == "__main__": import xml.sax.saxutils p = create_parser() p.setContentHandler(xml.sax.saxutils.XMLGenerator()) p.setErrorHandler(xml.sax.ErrorHandler()) p.parse("http://www.ibiblio.org/xml/examples/shakespeare/hamlet.xml") sax/saxutils.py 0000644 00000027737 15027446000 0007603 0 ustar 00 """\ A library of useful helper classes to the SAX classes, for the convenience of application and driver writers. """ import os, urllib.parse, urllib.request import io import codecs from . import handler from . import xmlreader def __dict_replace(s, d): """Replace substrings of a string using a dictionary.""" for key, value in d.items(): s = s.replace(key, value) return s def escape(data, entities={}): """Escape &, <, and > in a string of data. You can escape other strings of data by passing a dictionary as the optional entities parameter. The keys and values must all be strings; each key will be replaced with its corresponding value. """ # must do ampersand first data = data.replace("&", "&") data = data.replace(">", ">") data = data.replace("<", "<") if entities: data = __dict_replace(data, entities) return data def unescape(data, entities={}): """Unescape &, <, and > in a string of data. You can unescape other strings of data by passing a dictionary as the optional entities parameter. The keys and values must all be strings; each key will be replaced with its corresponding value. """ data = data.replace("<", "<") data = data.replace(">", ">") if entities: data = __dict_replace(data, entities) # must do ampersand last return data.replace("&", "&") def quoteattr(data, entities={}): """Escape and quote an attribute value. Escape &, <, and > in a string of data, then quote it for use as an attribute value. The \" character will be escaped as well, if necessary. You can escape other strings of data by passing a dictionary as the optional entities parameter. The keys and values must all be strings; each key will be replaced with its corresponding value. """ entities = {**entities, '\n': ' ', '\r': ' ', '\t':'	'} data = escape(data, entities) if '"' in data: if "'" in data: data = '"%s"' % data.replace('"', """) else: data = "'%s'" % data else: data = '"%s"' % data return data def _gettextwriter(out, encoding): if out is None: import sys return sys.stdout if isinstance(out, io.TextIOBase): # use a text writer as is return out if isinstance(out, (codecs.StreamWriter, codecs.StreamReaderWriter)): # use a codecs stream writer as is return out # wrap a binary writer with TextIOWrapper if isinstance(out, io.RawIOBase): # Keep the original file open when the TextIOWrapper is # destroyed class _wrapper: __class__ = out.__class__ def __getattr__(self, name): return getattr(out, name) buffer = _wrapper() buffer.close = lambda: None else: # This is to handle passed objects that aren't in the # IOBase hierarchy, but just have a write method buffer = io.BufferedIOBase() buffer.writable = lambda: True buffer.write = out.write try: # TextIOWrapper uses this methods to determine # if BOM (for UTF-16, etc) should be added buffer.seekable = out.seekable buffer.tell = out.tell except AttributeError: pass return io.TextIOWrapper(buffer, encoding=encoding, errors='xmlcharrefreplace', newline='\n', write_through=True) class XMLGenerator(handler.ContentHandler): def __init__(self, out=None, encoding="iso-8859-1", short_empty_elements=False): handler.ContentHandler.__init__(self) out = _gettextwriter(out, encoding) self._write = out.write self._flush = out.flush self._ns_contexts = [{}] # contains uri -> prefix dicts self._current_context = self._ns_contexts[-1] self._undeclared_ns_maps = [] self._encoding = encoding self._short_empty_elements = short_empty_elements self._pending_start_element = False def _qname(self, name): """Builds a qualified name from a (ns_url, localname) pair""" if name[0]: # Per http://www.w3.org/XML/1998/namespace, The 'xml' prefix is # bound by definition to http://www.w3.org/XML/1998/namespace. It # does not need to be declared and will not usually be found in # self._current_context. if 'http://www.w3.org/XML/1998/namespace' == name[0]: return 'xml:' + name[1] # The name is in a non-empty namespace prefix = self._current_context[name[0]] if prefix: # If it is not the default namespace, prepend the prefix return prefix + ":" + name[1] # Return the unqualified name return name[1] def _finish_pending_start_element(self,endElement=False): if self._pending_start_element: self._write('>') self._pending_start_element = False # ContentHandler methods def startDocument(self): self._write('<?xml version="1.0" encoding="%s"?>\n' % self._encoding) def endDocument(self): self._flush() def startPrefixMapping(self, prefix, uri): self._ns_contexts.append(self._current_context.copy()) self._current_context[uri] = prefix self._undeclared_ns_maps.append((prefix, uri)) def endPrefixMapping(self, prefix): self._current_context = self._ns_contexts[-1] del self._ns_contexts[-1] def startElement(self, name, attrs): self._finish_pending_start_element() self._write('<' + name) for (name, value) in attrs.items(): self._write(' %s=%s' % (name, quoteattr(value))) if self._short_empty_elements: self._pending_start_element = True else: self._write(">") def endElement(self, name): if self._pending_start_element: self._write('/>') self._pending_start_element = False else: self._write('</%s>' % name) def startElementNS(self, name, qname, attrs): self._finish_pending_start_element() self._write('<' + self._qname(name)) for prefix, uri in self._undeclared_ns_maps: if prefix: self._write(' xmlns:%s="%s"' % (prefix, uri)) else: self._write(' xmlns="%s"' % uri) self._undeclared_ns_maps = [] for (name, value) in attrs.items(): self._write(' %s=%s' % (self._qname(name), quoteattr(value))) if self._short_empty_elements: self._pending_start_element = True else: self._write(">") def endElementNS(self, name, qname): if self._pending_start_element: self._write('/>') self._pending_start_element = False else: self._write('</%s>' % self._qname(name)) def characters(self, content): if content: self._finish_pending_start_element() if not isinstance(content, str): content = str(content, self._encoding) self._write(escape(content)) def ignorableWhitespace(self, content): if content: self._finish_pending_start_element() if not isinstance(content, str): content = str(content, self._encoding) self._write(content) def processingInstruction(self, target, data): self._finish_pending_start_element() self._write('<?%s %s?>' % (target, data)) class XMLFilterBase(xmlreader.XMLReader): """This class is designed to sit between an XMLReader and the client application's event handlers. By default, it does nothing but pass requests up to the reader and events on to the handlers unmodified, but subclasses can override specific methods to modify the event stream or the configuration requests as they pass through.""" def __init__(self, parent = None): xmlreader.XMLReader.__init__(self) self._parent = parent # ErrorHandler methods def error(self, exception): self._err_handler.error(exception) def fatalError(self, exception): self._err_handler.fatalError(exception) def warning(self, exception): self._err_handler.warning(exception) # ContentHandler methods def setDocumentLocator(self, locator): self._cont_handler.setDocumentLocator(locator) def startDocument(self): self._cont_handler.startDocument() def endDocument(self): self._cont_handler.endDocument() def startPrefixMapping(self, prefix, uri): self._cont_handler.startPrefixMapping(prefix, uri) def endPrefixMapping(self, prefix): self._cont_handler.endPrefixMapping(prefix) def startElement(self, name, attrs): self._cont_handler.startElement(name, attrs) def endElement(self, name): self._cont_handler.endElement(name) def startElementNS(self, name, qname, attrs): self._cont_handler.startElementNS(name, qname, attrs) def endElementNS(self, name, qname): self._cont_handler.endElementNS(name, qname) def characters(self, content): self._cont_handler.characters(content) def ignorableWhitespace(self, chars): self._cont_handler.ignorableWhitespace(chars) def processingInstruction(self, target, data): self._cont_handler.processingInstruction(target, data) def skippedEntity(self, name): self._cont_handler.skippedEntity(name) # DTDHandler methods def notationDecl(self, name, publicId, systemId): self._dtd_handler.notationDecl(name, publicId, systemId) def unparsedEntityDecl(self, name, publicId, systemId, ndata): self._dtd_handler.unparsedEntityDecl(name, publicId, systemId, ndata) # EntityResolver methods def resolveEntity(self, publicId, systemId): return self._ent_handler.resolveEntity(publicId, systemId) # XMLReader methods def parse(self, source): self._parent.setContentHandler(self) self._parent.setErrorHandler(self) self._parent.setEntityResolver(self) self._parent.setDTDHandler(self) self._parent.parse(source) def setLocale(self, locale): self._parent.setLocale(locale) def getFeature(self, name): return self._parent.getFeature(name) def setFeature(self, name, state): self._parent.setFeature(name, state) def getProperty(self, name): return self._parent.getProperty(name) def setProperty(self, name, value): self._parent.setProperty(name, value) # XMLFilter methods def getParent(self): return self._parent def setParent(self, parent): self._parent = parent # --- Utility functions def prepare_input_source(source, base=""): """This function takes an InputSource and an optional base URL and returns a fully resolved InputSource object ready for reading.""" if isinstance(source, os.PathLike): source = os.fspath(source) if isinstance(source, str): source = xmlreader.InputSource(source) elif hasattr(source, "read"): f = source source = xmlreader.InputSource() if isinstance(f.read(0), str): source.setCharacterStream(f) else: source.setByteStream(f) if hasattr(f, "name") and isinstance(f.name, str): source.setSystemId(f.name) if source.getCharacterStream() is None and source.getByteStream() is None: sysid = source.getSystemId() basehead = os.path.dirname(os.path.normpath(base)) sysidfilename = os.path.join(basehead, sysid) if os.path.isfile(sysidfilename): source.setSystemId(sysidfilename) f = open(sysidfilename, "rb") else: source.setSystemId(urllib.parse.urljoin(base, sysid)) f = urllib.request.urlopen(source.getSystemId()) source.setByteStream(f) return source sax/xmlreader.py 0000644 00000030614 15027446000 0007676 0 ustar 00 """An XML Reader is the SAX 2 name for an XML parser. XML Parsers should be based on this code. """ from . import handler from ._exceptions import SAXNotSupportedException, SAXNotRecognizedException # ===== XMLREADER ===== class XMLReader: """Interface for reading an XML document using callbacks. XMLReader is the interface that an XML parser's SAX2 driver must implement. This interface allows an application to set and query features and properties in the parser, to register event handlers for document processing, and to initiate a document parse. All SAX interfaces are assumed to be synchronous: the parse methods must not return until parsing is complete, and readers must wait for an event-handler callback to return before reporting the next event.""" def __init__(self): self._cont_handler = handler.ContentHandler() self._dtd_handler = handler.DTDHandler() self._ent_handler = handler.EntityResolver() self._err_handler = handler.ErrorHandler() def parse(self, source): "Parse an XML document from a system identifier or an InputSource." raise NotImplementedError("This method must be implemented!") def getContentHandler(self): "Returns the current ContentHandler." return self._cont_handler def setContentHandler(self, handler): "Registers a new object to receive document content events." self._cont_handler = handler def getDTDHandler(self): "Returns the current DTD handler." return self._dtd_handler def setDTDHandler(self, handler): "Register an object to receive basic DTD-related events." self._dtd_handler = handler def getEntityResolver(self): "Returns the current EntityResolver." return self._ent_handler def setEntityResolver(self, resolver): "Register an object to resolve external entities." self._ent_handler = resolver def getErrorHandler(self): "Returns the current ErrorHandler." return self._err_handler def setErrorHandler(self, handler): "Register an object to receive error-message events." self._err_handler = handler def setLocale(self, locale): """Allow an application to set the locale for errors and warnings. SAX parsers are not required to provide localization for errors and warnings; if they cannot support the requested locale, however, they must raise a SAX exception. Applications may request a locale change in the middle of a parse.""" raise SAXNotSupportedException("Locale support not implemented") def getFeature(self, name): "Looks up and returns the state of a SAX2 feature." raise SAXNotRecognizedException("Feature '%s' not recognized" % name) def setFeature(self, name, state): "Sets the state of a SAX2 feature." raise SAXNotRecognizedException("Feature '%s' not recognized" % name) def getProperty(self, name): "Looks up and returns the value of a SAX2 property." raise SAXNotRecognizedException("Property '%s' not recognized" % name) def setProperty(self, name, value): "Sets the value of a SAX2 property." raise SAXNotRecognizedException("Property '%s' not recognized" % name) class IncrementalParser(XMLReader): """This interface adds three extra methods to the XMLReader interface that allow XML parsers to support incremental parsing. Support for this interface is optional, since not all underlying XML parsers support this functionality. When the parser is instantiated it is ready to begin accepting data from the feed method immediately. After parsing has been finished with a call to close the reset method must be called to make the parser ready to accept new data, either from feed or using the parse method. Note that these methods must _not_ be called during parsing, that is, after parse has been called and before it returns. By default, the class also implements the parse method of the XMLReader interface using the feed, close and reset methods of the IncrementalParser interface as a convenience to SAX 2.0 driver writers.""" def __init__(self, bufsize=2**16): self._bufsize = bufsize XMLReader.__init__(self) def parse(self, source): from . import saxutils source = saxutils.prepare_input_source(source) self.prepareParser(source) file = source.getCharacterStream() if file is None: file = source.getByteStream() buffer = file.read(self._bufsize) while buffer: self.feed(buffer) buffer = file.read(self._bufsize) self.close() def feed(self, data): """This method gives the raw XML data in the data parameter to the parser and makes it parse the data, emitting the corresponding events. It is allowed for XML constructs to be split across several calls to feed. feed may raise SAXException.""" raise NotImplementedError("This method must be implemented!") def prepareParser(self, source): """This method is called by the parse implementation to allow the SAX 2.0 driver to prepare itself for parsing.""" raise NotImplementedError("prepareParser must be overridden!") def close(self): """This method is called when the entire XML document has been passed to the parser through the feed method, to notify the parser that there are no more data. This allows the parser to do the final checks on the document and empty the internal data buffer. The parser will not be ready to parse another document until the reset method has been called. close may raise SAXException.""" raise NotImplementedError("This method must be implemented!") def reset(self): """This method is called after close has been called to reset the parser so that it is ready to parse new documents. The results of calling parse or feed after close without calling reset are undefined.""" raise NotImplementedError("This method must be implemented!") # ===== LOCATOR ===== class Locator: """Interface for associating a SAX event with a document location. A locator object will return valid results only during calls to DocumentHandler methods; at any other time, the results are unpredictable.""" def getColumnNumber(self): "Return the column number where the current event ends." return -1 def getLineNumber(self): "Return the line number where the current event ends." return -1 def getPublicId(self): "Return the public identifier for the current event." return None def getSystemId(self): "Return the system identifier for the current event." return None # ===== INPUTSOURCE ===== class InputSource: """Encapsulation of the information needed by the XMLReader to read entities. This class may include information about the public identifier, system identifier, byte stream (possibly with character encoding information) and/or the character stream of an entity. Applications will create objects of this class for use in the XMLReader.parse method and for returning from EntityResolver.resolveEntity. An InputSource belongs to the application, the XMLReader is not allowed to modify InputSource objects passed to it from the application, although it may make copies and modify those.""" def __init__(self, system_id = None): self.__system_id = system_id self.__public_id = None self.__encoding = None self.__bytefile = None self.__charfile = None def setPublicId(self, public_id): "Sets the public identifier of this InputSource." self.__public_id = public_id def getPublicId(self): "Returns the public identifier of this InputSource." return self.__public_id def setSystemId(self, system_id): "Sets the system identifier of this InputSource." self.__system_id = system_id def getSystemId(self): "Returns the system identifier of this InputSource." return self.__system_id def setEncoding(self, encoding): """Sets the character encoding of this InputSource. The encoding must be a string acceptable for an XML encoding declaration (see section 4.3.3 of the XML recommendation). The encoding attribute of the InputSource is ignored if the InputSource also contains a character stream.""" self.__encoding = encoding def getEncoding(self): "Get the character encoding of this InputSource." return self.__encoding def setByteStream(self, bytefile): """Set the byte stream (a Python file-like object which does not perform byte-to-character conversion) for this input source. The SAX parser will ignore this if there is also a character stream specified, but it will use a byte stream in preference to opening a URI connection itself. If the application knows the character encoding of the byte stream, it should set it with the setEncoding method.""" self.__bytefile = bytefile def getByteStream(self): """Get the byte stream for this input source. The getEncoding method will return the character encoding for this byte stream, or None if unknown.""" return self.__bytefile def setCharacterStream(self, charfile): """Set the character stream for this input source. (The stream must be a Python 2.0 Unicode-wrapped file-like that performs conversion to Unicode strings.) If there is a character stream specified, the SAX parser will ignore any byte stream and will not attempt to open a URI connection to the system identifier.""" self.__charfile = charfile def getCharacterStream(self): "Get the character stream for this input source." return self.__charfile # ===== ATTRIBUTESIMPL ===== class AttributesImpl: def __init__(self, attrs): """Non-NS-aware implementation. attrs should be of the form {name : value}.""" self._attrs = attrs def getLength(self): return len(self._attrs) def getType(self, name): return "CDATA" def getValue(self, name): return self._attrs[name] def getValueByQName(self, name): return self._attrs[name] def getNameByQName(self, name): if name not in self._attrs: raise KeyError(name) return name def getQNameByName(self, name): if name not in self._attrs: raise KeyError(name) return name def getNames(self): return list(self._attrs.keys()) def getQNames(self): return list(self._attrs.keys()) def __len__(self): return len(self._attrs) def __getitem__(self, name): return self._attrs[name] def keys(self): return list(self._attrs.keys()) def __contains__(self, name): return name in self._attrs def get(self, name, alternative=None): return self._attrs.get(name, alternative) def copy(self): return self.__class__(self._attrs) def items(self): return list(self._attrs.items()) def values(self): return list(self._attrs.values()) # ===== ATTRIBUTESNSIMPL ===== class AttributesNSImpl(AttributesImpl): def __init__(self, attrs, qnames): """NS-aware implementation. attrs should be of the form {(ns_uri, lname): value, ...}. qnames of the form {(ns_uri, lname): qname, ...}.""" self._attrs = attrs self._qnames = qnames def getValueByQName(self, name): for (nsname, qname) in self._qnames.items(): if qname == name: return self._attrs[nsname] raise KeyError(name) def getNameByQName(self, name): for (nsname, qname) in self._qnames.items(): if qname == name: return nsname raise KeyError(name) def getQNameByName(self, name): return self._qnames[name] def getQNames(self): return list(self._qnames.values()) def copy(self): return self.__class__(self._attrs, self._qnames) def _test(): XMLReader() IncrementalParser() Locator() if __name__ == "__main__": _test() sax/__init__.py 0000644 00000007072 15027446000 0007454 0 ustar 00 """Simple API for XML (SAX) implementation for Python. This module provides an implementation of the SAX 2 interface; information about the Java version of the interface can be found at http://www.megginson.com/SAX/. The Python version of the interface is documented at <...>. This package contains the following modules: handler -- Base classes and constants which define the SAX 2 API for the 'client-side' of SAX for Python. saxutils -- Implementation of the convenience classes commonly used to work with SAX. xmlreader -- Base classes and constants which define the SAX 2 API for the parsers used with SAX for Python. expatreader -- Driver that allows use of the Expat parser with SAX. """ from .xmlreader import InputSource from .handler import ContentHandler, ErrorHandler from ._exceptions import SAXException, SAXNotRecognizedException, \ SAXParseException, SAXNotSupportedException, \ SAXReaderNotAvailable def parse(source, handler, errorHandler=ErrorHandler()): parser = make_parser() parser.setContentHandler(handler) parser.setErrorHandler(errorHandler) parser.parse(source) def parseString(string, handler, errorHandler=ErrorHandler()): import io if errorHandler is None: errorHandler = ErrorHandler() parser = make_parser() parser.setContentHandler(handler) parser.setErrorHandler(errorHandler) inpsrc = InputSource() if isinstance(string, str): inpsrc.setCharacterStream(io.StringIO(string)) else: inpsrc.setByteStream(io.BytesIO(string)) parser.parse(inpsrc) # this is the parser list used by the make_parser function if no # alternatives are given as parameters to the function default_parser_list = ["xml.sax.expatreader"] # tell modulefinder that importing sax potentially imports expatreader _false = 0 if _false: import xml.sax.expatreader import os, sys if not sys.flags.ignore_environment and "PY_SAX_PARSER" in os.environ: default_parser_list = os.environ["PY_SAX_PARSER"].split(",") del os _key = "python.xml.sax.parser" if sys.platform[:4] == "java" and sys.registry.containsKey(_key): default_parser_list = sys.registry.getProperty(_key).split(",") def make_parser(parser_list=()): """Creates and returns a SAX parser. Creates the first parser it is able to instantiate of the ones given in the iterable created by chaining parser_list and default_parser_list. The iterables must contain the names of Python modules containing both a SAX parser and a create_parser function.""" for parser_name in list(parser_list) + default_parser_list: try: return _create_parser(parser_name) except ImportError: import sys if parser_name in sys.modules: # The parser module was found, but importing it # failed unexpectedly, pass this exception through raise except SAXReaderNotAvailable: # The parser module detected that it won't work properly, # so try the next one pass raise SAXReaderNotAvailable("No parsers found", None) # --- Internal utility methods used by make_parser if sys.platform[ : 4] == "java": def _create_parser(parser_name): from org.python.core import imp drv_module = imp.importName(parser_name, 0, globals()) return drv_module.create_parser() else: def _create_parser(parser_name): drv_module = __import__(parser_name,{},{},['create_parser']) return drv_module.create_parser() del sys __init__.py 0000644 00000001055 15027446000 0006654 0 ustar 00 """Core XML support for Python. This package contains four sub-packages: dom -- The W3C Document Object Model. This supports DOM Level 1 + Namespaces. parsers -- Python wrappers for XML parsers (currently only supports Expat). sax -- The Simple API for XML, developed by XML-Dev, led by David Megginson and ported to Python by Lars Marius Garshol. This supports the SAX 2 API. etree -- The ElementTree XML library. This is a subset of the full ElementTree XML release. """ __all__ = ["dom", "parsers", "sax", "etree"]
| ver. 1.4 |
Github
|
.
| PHP 8.2.28 | Generation time: 0.03 |
proxy
|
phpinfo
|
Settings