Dashboard
PHP:
8.2.30
OS:
Linux
User:
dh_nv8b2m
/
/
usr
/
lib
/
python3
/
dist-packages
/
docutils
/
transforms
/
__pycache__
📤 Upload
📝 New File
📁 New Folder
Close
Editing: references.cpython-310.pyc
o S��_ߎ � @ s� d Z dZddlZddlZddlmZmZ ddlmZm Z G dd� de �Z G dd � d e �Z G d d � d e �Z G d d � d e �Z G dd� de �ZG dd� de �ZG dd� de�ZG dd� de �ZG dd� de �ZG dd� de �ZG dd� dej�ZdS ) z& Transforms for resolving references. �reStructuredText� N)�nodes�utils)�TransformError� Transformc @ � e Zd ZdZdZdd� ZdS )�PropagateTargetsa} Propagate empty internal targets to the next element. Given the following nodes:: <target ids="internal1" names="internal1"> <target anonymous="1" ids="id1"> <target ids="internal2" names="internal2"> <paragraph> This is a test. PropagateTargets propagates the ids and names of the internal targets preceding the paragraph to the paragraph itself:: <target refid="internal1"> <target anonymous="1" refid="id1"> <target refid="internal2"> <paragraph ids="internal2 id1 internal1" names="internal2 internal1"> This is a test. i c C sf | j �tj�D ]�}t|jtj�s |�d�s |�d�s |�d�r qt|�dks*J d��|j dd�}|d ur�t|tj �s@t|tj �rFt|tj�r�|d � |d � |d � |d � t|d �s`i |_ t|d �shi |_|d D ] }|| j j|< ||j|< ql|d D ]}||j |< q~|j �t|d i �� |j�t|d i �� |d d |d< g |d< g |d < | j �|� qd S ) N�refid�refuri�refnamer z&error: block-level target has childrenT)�ascend�ids�names�expect_referenced_by_name�expect_referenced_by_id)�document�traverser �target� isinstance�parent� TextElement�hasattr�len� next_node� Invisible� Targetable�extendr r r �update�getattr� note_refid)�selfr r �id�name� r# �@/usr/lib/python3/dist-packages/docutils/transforms/references.py�apply* sR ��� � � � � � ��zPropagateTargets.applyN��__name__� __module__� __qualname__�__doc__�default_priorityr% r# r# r# r$ r s r c @ r )�AnonymousHyperlinksa� Link anonymous references to targets. Given:: <paragraph> <reference anonymous="1"> internal <reference anonymous="1"> external <target anonymous="1" ids="id1"> <target anonymous="1" ids="id2" refuri="http://external"> Corresponding references are linked via "refid" or resolved via "refuri":: <paragraph> <reference anonymous="1" refid="id1"> text <reference anonymous="1" refuri="http://external"> external <target anonymous="1" ids="id1"> <target anonymous="1" ids="id2" refuri="http://external"> i� c C sJ g }g }| j �tj�D ] }|�d�r|�|� q | j �tj�D ] }|�d�r+|�|� q t|�t|�krj| j j� dt|�t|�f �}| j � |�}|D ] }tj |j |j |d�}| j � |�}|� |� |�|� qKd S t||�D ]3\}} d| _ | �d�r�| d |d< d|_n | d s�| j j| d } qv| d d |d< | j �|� qod S ) N� anonymousz]Anonymous hyperlink mismatch: %s references but %s targets. See "backrefs" attribute for IDs.�r � Tr r r r )r r r � reference�get�appendr r �reporter�error�set_id� problematic� rawsource� add_backref� replace_self�zip� referencedr �resolvedr r ) r �anonymous_refs�anonymous_targets�node�msg�msgid�ref�prb�prbidr r# r# r$ r% r sT � ���� � ��zAnonymousHyperlinks.applyNr& r# r# r# r$ r, X s r, c @ sD e Zd ZdZdZdd� Zdd� Zdd� Zd d � Zd d � Z d d� Z dS )�IndirectHyperlinksaN a) Indirect external references:: <paragraph> <reference refname="indirect external"> indirect external <target id="id1" name="direct external" refuri="http://indirect"> <target id="id2" name="indirect external" refname="direct external"> The "refuri" attribute is migrated back to all indirect targets from the final direct target (i.e. a target not referring to another indirect target):: <paragraph> <reference refname="indirect external"> indirect external <target id="id1" name="direct external" refuri="http://indirect"> <target id="id2" name="indirect external" refuri="http://indirect"> Once the attribute is migrated, the preexisting "refname" attribute is dropped. b) Indirect internal references:: <target id="id1" name="final target"> <paragraph> <reference refname="indirect internal"> indirect internal <target id="id2" name="indirect internal 2" refname="final target"> <target id="id3" name="indirect internal" refname="indirect internal 2"> Targets which indirectly refer to an internal target become one-hop indirect (their "refid" attributes are directly set to the internal target's "id"). References which indirectly refer to an internal target become direct internal references:: <target id="id1" name="final target"> <paragraph> <reference refid="id1"> indirect internal <target id="id2" name="indirect internal 2" refid="id1"> <target id="id3" name="indirect internal" refid="id1"> i� c C s, | j jD ]}|js| �|� | �|� qd S �N)r �indirect_targetsr< �resolve_indirect_target�resolve_indirect_references�r r r# r# r$ r% � s �zIndirectHyperlinks.applyc C sH |� d�}|d u r|d }n | jj� |�}|s-| jjjD ] }||�r% d S q | �|� d S | jj| }|j|d� t|t j �r]|j s]|� d�r]t |d�rS| � |� d S d|_| �|� |`|� d�rp|d |d< d|v ro|d= n(|� d�r�|d |d< | j�|� n|d r�||d< | j�|� n| �|� d S |d ur�|d= d|_ d S )Nr r �r! �multiply_indirectr/ r r )r1 r �nameids� transformer�unknown_reference_resolvers�nonexistent_indirect_targetr �note_referenced_byr r r r< r �circular_indirect_referencerL rH r )r r r � reftarget_id�resolver_function� reftargetr# r# r$ rH � sT �� �� � z*IndirectHyperlinks.resolve_indirect_targetc C s0 |d | j jv r| �|d� d S | �|d� d S )Nr z>which is a duplicate, and cannot be used as a unique referencezwhich does not exist)r rM �indirect_target_errorrJ r# r# r$ rP s z.IndirectHyperlinks.nonexistent_indirect_targetc C s | � |d� d S )Nz forming a circular reference)rV rJ r# r# r$ rR s z.IndirectHyperlinks.circular_indirect_referencec C s� d}g }|d rd|d d }|d D ] }|� | jj�|g �� q|d D ] }|� | jj�|g �� q&|d rB|d|d d 7 }| jjjd||d |f |d �}| j�|�}t� |�D ] } t j | j | j |d �} | j�| �} |� | � | �| � q]d |_d S ) N� r z"%s" r r z (id="%s")z7Indirect hyperlink target %s refers to target "%s", %s.r �� base_noder. r/ )r r �refnamesr1 �refidsr3 r4 r5 r �uniqr r6 r7 r8 r9 r< ) r r � explanation�naming�reflistr" r! r@ rA rB rC rD r# r# r$ rV s2 �� � z(IndirectHyperlinks.indirect_target_errorc C s( |� d�r d}| jj}n |� d�rd}d }nd S || }|d D ]6}| jj�|g �}|r2|j|d� |D ]!}|jr:q4|d= |||< |rG||� d|_t|tj �rU| � |� q4q |d D ]6}| jj �|g �}|rm|j|d� |D ]!}|jruqo|d= |||< |r�||� d|_t|tj �r�| � |� qoq[d S ) Nr r r �r" r r/ r rK ) r r r rZ r1 rQ r< r r r rI r[ ) r r �attname� call_method�attvalr" r_ rB r! r# r# r$ rI $ sR �� ���z.IndirectHyperlinks.resolve_indirect_referencesN) r' r( r) r* r+ r% rH rP rR rV rI r# r# r# r$ rE � s 2- rE c @ r )�ExternalTargetsa� Given:: <paragraph> <reference refname="direct external"> direct external <target id="id1" name="direct external" refuri="http://direct"> The "refname" attribute is replaced by the direct "refuri" attribute:: <paragraph> <reference refuri="http://direct"> direct external <target id="id1" name="direct external" refuri="http://direct"> i� c C s~ | j �tj�D ]5}|�d�r<|d }|d D ]%}| j j�|g �}|r(|j|d� |D ]}|jr0q*|d= ||d< d|_q*qqd S )Nr r r` r r/ ) r r r r r rZ r1 rQ r< )r r r r" r_ rB r# r# r$ r% ` s ���zExternalTargets.applyNr& r# r# r# r$ rd L s rd c @ s e Zd ZdZdd� Zdd� ZdS )�InternalTargetsi� c C s6 | j �tj�D ]}|�d�s|�d�s| �|� qd S )Nr r )r r r r r �resolve_reference_idsrJ r# r# r$ r% t s ��zInternalTargets.applyc C sj |d D ].}| j j�|�}| j j�|g �}|r |j|d� |D ]}|jr%q |r.|d= ||d< d|_q qdS )a� Given:: <paragraph> <reference refname="direct internal"> direct internal <target id="id1" name="direct internal"> The "refname" attribute is replaced by "refid" linking to the target's "id":: <paragraph> <reference refid="id1"> direct internal <target id="id1" name="direct internal"> r r` r r r/ N)r rM r1 rZ rQ r< )r r r" r r_ rB r# r# r$ rf y s ��z%InternalTargets.resolve_reference_idsN)r' r( r) r+ r% rf r# r# r# r$ re p s re c @ sR e Zd ZdZdZdZ g d�Zdd� Zdd� Zd d � Z d d � Z d d� Z dd� Z dS )� Footnotesa� Assign numbers to autonumbered footnotes, and resolve links to footnotes, citations, and their references. Given the following ``document`` as input:: <document> <paragraph> A labeled autonumbered footnote referece: <footnote_reference auto="1" id="id1" refname="footnote"> <paragraph> An unlabeled autonumbered footnote referece: <footnote_reference auto="1" id="id2"> <footnote auto="1" id="id3"> <paragraph> Unlabeled autonumbered footnote. <footnote auto="1" id="footnote" name="footnote"> <paragraph> Labeled autonumbered footnote. Auto-numbered footnotes have attribute ``auto="1"`` and no label. Auto-numbered footnote_references have no reference text (they're empty elements). When resolving the numbering, a ``label`` element is added to the beginning of the ``footnote``, and reference text to the ``footnote_reference``. The transformed result will be:: <document> <paragraph> A labeled autonumbered footnote referece: <footnote_reference auto="1" id="id1" refid="footnote"> 2 <paragraph> An unlabeled autonumbered footnote referece: <footnote_reference auto="1" id="id2" refid="id3"> 1 <footnote auto="1" id="id3" backrefs="id2"> <label> 1 <paragraph> Unlabeled autonumbered footnote. <footnote auto="1" id="footnote" name="footnote" backrefs="id1"> <label> 2 <paragraph> Labeled autonumbered footnote. Note that the footnotes are not in the same order as the references. The labels and reference text are added to the auto-numbered ``footnote`` and ``footnote_reference`` elements. Footnote elements are backlinked to their references via "refids" attributes. References are assigned "id" and "refid" attributes. After adding labels and reference text, the "auto" attributes can be ignored. il N) �*u †u ‡� §� ¶�#u ♠u ♥u ♦u ♣c C s: g | _ | jj}| �|�| j_| �|� | �� | �� d S rF )�autofootnote_labelsr �autofootnote_start�number_footnotes�number_footnote_references�symbolize_footnotes� resolve_footnotes_and_citations)r �startnumr# r# r$ r% � s zFootnotes.applyc C s | j jD ]�} t|�}|d7 }|| j jvrnq|�dt�d|�� |d D ]I}| j j�|g �D ]>}|t� |�7 }|� d� t |d �t |d � krPdksSJ � J �|d d |d< |� |d d � | j � |� d|_q/q%|d s�|d s�|d �|� | j �||� | j�|� q|S ) z� Assign numbers to autonumbered footnotes. For labeled autonumbered footnotes, copy the number over to corresponding footnote references. Tr/ r rW r r r r �dupnames)r � autofootnotes�strrM �insertr �label� footnote_refsr1 �Text�delattrr r8 r r< r2 �note_explicit_targetrl )r rr �footnoterw r" rB r# r# r$ rn � s0 � , � �zFootnotes.number_footnotesc C s@ d}| j jD ]�}|js|�d�rqz| j| }W nM tye | j jjdt| j� |d�}| j � |�}| j j|d� D ]%}|jsE|�d�rFq;t j |j |j |d�}| j � |�}|� |� |�|� q;Y dS w |t �|�7 }| j j| } | j j| } | |d< | j �|� t|d �d ks�J �| � |d d � d |_|d 7 }qdS ) z3Assign numbers to autonumbered footnote references.r r zUToo many autonumbered footnote references: only %s corresponding footnotes available.rX Nr r. r r/ )r �autofootnote_refsr< r rl � IndexErrorr3 r4 r r5 r r6 r7 r8 r9 ry rM r r ) r rr �irB rw r@ rA rC rD r! r| r# r# r$ ro sF �� � � �z$Footnotes.number_footnote_referencesc C s� g }| j jD ]4}t| j jt| j��\}}| j| |d }|�|� |�dt� d|�� | j jd7 _| j � |� qd}| j j D ]�}z |t� || �7 }W nL t y� | j jjdt|� |d�}| j � |�} | j j |d� D ]%}|jsz|�d�r{qptj|j|j| d�} | j � | �} |�| � |�| � qpY dS w | j j| }t|d �dks�J �|d d |d< | j �|� |�|d d � |d7 }qAdS ) z<Add symbols indexes to "[*]"-style footnotes and references.r/ r rW zOToo many symbol footnote references: only %s corresponding footnotes available.rX Nr r. r )r �symbol_footnotes�divmod�symbol_footnote_startr �symbolsr2 rv r rw r5 �symbol_footnote_refsry r~ r3 r4 r< r r6 r7 r8 r9 r ) r �labelsr| �reps�index� labeltextr rB r@ rA rC rD r# r# r$ rp 1 sP � �� � � �z Footnotes.symbolize_footnotesc C s� | j jD ]}|d D ]}|| j jv r | j j| }| �||� q q| j jD ]}|d D ]}|| j jv r>| j j| }| �||� q*q$dS )za Link manually-labeled footnotes and citations to/from their references. r N)r � footnotesrx �resolve_references� citations� citation_refs)r r| rw r_ �citationr# r# r$ rq V s �� ���z)Footnotes.resolve_footnotes_and_citationsc C sz t |d �dks J �|d d }|D ]%}|jrq|�d� ||d< t |d �dks+J �|�|d d � d|_qd|_d S )Nr r/ r r r )r r< rz r8 )r �noter_ r! rB r# r# r$ r� f s z Footnotes.resolve_references) r' r( r) r* r+ rl r� r% rn ro rp rq r� r# r# r# r$ rg � s ; !% rg c @ s e Zd ZdS )�#CircularSubstitutionDefinitionErrorN)r' r( r) r# r# r# r$ r� t s r� c @ s e Zd ZdZdZ dd� ZdS )� SubstitutionsaD Given the following ``document`` as input:: <document> <paragraph> The <substitution_reference refname="biohazard"> biohazard symbol is deservedly scary-looking. <substitution_definition name="biohazard"> <image alt="biohazard" uri="biohazard.png"> The ``substitution_reference`` will simply be replaced by the contents of the corresponding ``substitution_definition``. The transformed result will be:: <document> <paragraph> The <image alt="biohazard" uri="biohazard.png"> symbol is deservedly scary-looking. <substitution_definition name="biohazard"> <image alt="biohazard" uri="biohazard.png"> �� c C s | j j}| j j}i }t| j jdd�}t| j �tj��}|D �]o}d}|d }||v r-|} n |� � } |� | d �} | d u rG| j j j d| |d�}n|| } t | �� �|kr\| j j � d| �}|r| j �|�} tj|j|j| d�} | j �| �}|�|� |�| � q |j}|�|�}d | jv s�d | jv r�|d kr�t||d tj�r�||d �� ||d < d | jv s�d | jv r�t |�|d kr�t||d tj�r�||d �� ||d < | �� }z-|�tj�D ]$}||d � � }||� |g �v r�t �|| � | � ||d< |� |� q�W ni t �ym |j}t|tj ��r.| j j j dt� |j|j�|j!|d�}|�|� n=|}|�"d��r@|d }|�"d��s6| j j j d| |d�}| j �|�} tj|j|j| d�} | j �| �}|�|� |�| � Y q w |�|j#� |j#D ]}t|tj$��r�d|v �r�| j �%|� �qwq d S )N�line_length_limiti' rW r z(Undefined substitution referenced: "%s".rX z;Substitution definition "%s" exceeds the line-length-limit.r. �ltrim�trimr r/ �rtrimz ref-originz*Circular substitution definition detected:)�linerY z2Circular substitution definition referenced: "%s".)&r �substitution_defs�substitution_namesr �settings�listr r �substitution_reference�lowerr1 r3 r4 r �astextr5 r6 r7 r8 r9 r r� � attributesr ry �rstrip�lstrip�deepcopy� setdefaultr� r2 �substitution_definition� literal_blockr� r �children� Referential� note_refname)r �defs�normed�nestedr� � subreflistrB r@ r �key� normed_name�subdefrA rC rD r r� � subdef_copy� nested_ref� nested_name� ref_originr? r# r# r$ r% � s� � ���� � � �� ��� ��� � � ���zSubstitutions.applyNr& r# r# r# r$ r� w s r� c @ s. e Zd ZdZdZ dd� Zdd� Zdd� Zd S ) � TargetNotesz� Creates a footnote for each external target in the text, and corresponding footnote references after each reference. i c C s$ t j| ||d� |j�dg �| _d S )N)� startnode�class)r �__init__�detailsr1 �classes)r r r� r# r# r$ r� s zTargetNotes.__init__c C s� i }g }| j �tj�D ];}|�d�sq |d }g }|D ] }|�| j j�|g �� q|s,q | �|d ||�}|d |vrF|||d < |� |� q | j �tj �D ](}|�d�sVqN|�d�rv| �|d |g|�}|d |vrv|||d < |� |� qN| j � |� d S )Nr r r- ) r r r r r r rZ r1 �make_target_footnoter2 r0 r� r9 ) r �notes�nodelistr r �refsr" r| rB r# r# r$ r% s< � � � �zTargetNotes.applyc C sV ||v r|| }t |d �dksJ �|d d }n6t�� }| j�|�}d| }d|d< |g|d< t�� }|tjd||d�7 }||7 }| j�|� | j�||� |D ]W}t |tj �rZqQtj |dd�} | d | j 7 < | j� | � | j�| � |j�|�d } | g} t�| jj�s�| j r�| �dtjd | j d �� n | �dt�d �� |j�| | � qQ|S ) Nr r/ r z TARGET_NOTE: �autorW )r )r r� r� � )�text�Classes)r r r| r r5 � paragraphr0 �note_autofootnoter{ r r �footnote_referencer� �note_autofootnote_ref�note_footnote_refr r� r �get_trim_footnote_ref_spacer� rv �inlinery ) r r r� r� r| � footnote_name� footnote_id�footnote_paragraphrB �refnoder� r_ r# r# r$ r� # s: z TargetNotes.make_target_footnoteN)r' r( r) r* r+ r� r% r� r# r# r# r$ r� � s r� c @ r )�DanglingReferencesze Check for dangling references (incl. footnote & citation) and for unreferenced targets. iR c C s� t | j| jjj�}| j�|� | j�tj�D ]0}|jsF|� d�r!q|d r,|d d }n|d r7|d d }n|d }| jj j d| |d� qd S )Nr- r r r r z(Hyperlink target "%s" is not referenced.rX ) �DanglingReferencesVisitorr rN rO �walkr r r r; r1 r3 �info)r �visitorr r^ r# r# r$ r% P s, � ����zDanglingReferences.applyNr& r# r# r# r$ r� G s r� c @ s, e Zd Zdd� Zdd� Zdd� Ze ZZdS )r� c C s t j�| |� || _|| _d S rF )r �SparseNodeVisitorr� r rO )r r rO r# r# r$ r� n s z"DanglingReferencesVisitor.__init__c C s d S rF r# )r r? r# r# r$ � unknown_visits s z'DanglingReferencesVisitor.unknown_visitc C s" |j s|�d�s d S |d }| jj�|�}|d u r{| jD ] }||�r% d S q || jjv r:| jjjd|d |d�}n | jjjd|d |d�}| j�|�}t j |j |j |d�}z|d d }W n t yn | j�|�}Y nw |� |� |�|� d S |d= ||d< | jj| j|d � d |_ d S ) Nr zBDuplicate target name, cannot be used as a unique reference: "%s".rX zUnknown target name: "%s".r. r r r rK r/ )r< r r rM r1 rO r3 r4 r5 r r6 r7 r~ r8 r9 r rQ ) r r? r r! rT r@ rA rC rD r# r# r$ �visit_referencev sF � �� � � � z)DanglingReferencesVisitor.visit_referenceN)r' r( r) r� r� r� �visit_footnote_reference�visit_citation_referencer# r# r# r$ r� l s !r� )r* � __docformat__�sys�re�docutilsr r �docutils.transformsr r r r, rE rd re rg � Exceptionr� r� r� r� r� r� r# r# r# r$ �<module> s& GB 3$( ]}S%
Save
Cancel