| Server IP : 3.96.16.70 / Your IP : 216.73.216.15 Web Server : Apache System : Linux ip-172-31-26-103.ca-central-1.compute.internal 6.1.163-186.299.amzn2023.x86_64 #1 SMP PREEMPT_DYNAMIC Tue Feb 24 16:35:42 UTC 2026 x86_64 User : ec2-user ( 1000) PHP Version : 8.4.18 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : ON | Perl : ON | Python : OFF | Sudo : ON | Pkexec : OFF Directory : /usr/lib/python3.9/site-packages/docutils/transforms/__pycache__/ |
Upload File : |
a
�?�]h � @ sP d Z dZddlmZmZmZ G dd� de�ZG dd� de�ZG dd � d e�Z d
S ) a�
This package contains modules for standard tree transforms available
to Docutils components. Tree transforms serve a variety of purposes:
- To tie up certain syntax-specific "loose ends" that remain after the
initial parsing of the input plaintext. These transforms are used to
supplement a limited syntax.
- To automate the internal linking of the document tree (hyperlink
references, footnote references, etc.).
- To extract useful information from the document tree. These
transforms may be used to construct (for example) indexes and tables
of contents.
Each transform is an optional step that a Docutils component may
choose to perform on the parsed document.
ZreStructuredText� )� languages�ApplicationError�
TransformSpecc @ s e Zd ZdS )�TransformErrorN)�__name__�
__module__� __qualname__� r r �@/usr/lib/python3.9/site-packages/docutils/transforms/__init__.pyr � r c @ s& e Zd ZdZdZddd�Zdd� ZdS )� Transformz;
Docutils transform component abstract base class.
Nc C s$ || _ || _t�|jj|j�| _dS )zA
Initial setup for in-place document transforms.
N)�document� startnoder Z get_languageZsettingsZ
language_code�reporterZlanguage)�selfr
r r r r
�__init__* s
�zTransform.__init__c K s t d��dS )z5Override to apply the transform to the document tree.z"subclass must override this methodN)�NotImplementedError)r �kwargsr r r
�apply; s zTransform.apply)N)r r r �__doc__�default_priorityr r r r r r
r ! s
r c @ sL e Zd ZdZdd� Zddd�Zdd� Zdd d
�Zd d � Zd
d� Z dd� Z
dS )� Transformerz�
Stores transforms (`Transform` classes) and applies them to document
trees. Also keeps track of components by component type name.
c C s. g | _ g | _|| _g | _d| _i | _d| _d S )Nr )�
transforms�unknown_reference_resolversr
�applied�sorted�
components�serialno)r r
r r r
r G s zTransformer.__init__Nc K s6 |du r|j }| �|�}| j�||d|f� d| _dS )a+
Store a single transform. Use `priority` to override the default.
`kwargs` is a dictionary whose contents are passed as keyword
arguments to the `apply` method of the transform. This can be used to
pass application-specific data to the transform instance.
Nr )r �get_priority_stringr �appendr )r �transform_class�priorityr �priority_stringr r r
�
add_transforma s
�zTransformer.add_transformc C s4 |D ]$}| � |j�}| j�||di f� qd| _dS )z3Store multiple transforms, with default priorities.Nr )r r r r r )r Ztransform_listr r" r r r
�add_transformso s �
�zTransformer.add_transformsc C s< |j }|du r|j}| �|�}| j�|||i f� d| _dS )z4Store a transform with an associated `pending` node.Nr )� transformr r r r r )r �pendingr! r r" r r r
� add_pendingx s
�zTransformer.add_pendingc C s | j d7 _ d|| j f S )z�
Return a string, `priority` combined with `self.serialno`.
This ensures FIFO order on transforms with identical priority.
� z %03d-%03d)r )r r! r r r
r � s z Transformer.get_priority_stringc C sz |D ](}|du rq| � |�� � || j|j< qd| _g }|D ]}|�|j� q<tdd� |D ��}| j�dd� |D �� dS )z�
Store each component's default transforms, with default priorities.
Also, store components by type name in a mapping for later lookup.
Nr c s s | ]}|j |fV qd S )N)r! ��.0�fr r r
� <genexpr>� r z7Transformer.populate_from_components.<locals>.<genexpr>c s s | ]}|d V qdS )r( Nr r) r r r
r, � r )r$ Zget_transformsr Zcomponent_typer �extendr )r r Z componentr �iZdecorated_listr r r
�populate_from_components� s z$Transformer.populate_from_componentsc C s� | j j�| j j� | jr~| js8| j�� | j�� d| _| j�� \}}}}|| j |d�}|j f i |�� | j
� ||||f� qdS )z6Apply all of the stored transforms, in priority order.r( )r N) r
r Zattach_observerZnote_transform_messager r �sort�reverse�popr r r )r r! r r& r r% r r r
�apply_transforms� s �
z Transformer.apply_transforms)N)N) r r r r r r# r$ r' r r/ r3 r r r r
r @ s
r N)
r Z
__docformat__Zdocutilsr r r r �objectr r r r r r
�<module> s