Dashboard
PHP:
8.2.30
OS:
Linux
User:
dh_nv8b2m
/
/
usr
/
lib
/
python3
/
dist-packages
/
sphinx
/
domains
/
__pycache__
📤 Upload
📝 New File
📁 New Folder
Close
Editing: std.cpython-310.pyc
o �$�a$� � @ s� d Z ddlZddlZddlZddlmZ ddlmZmZmZm Z m Z m Z m Z m Z mZmZmZmZ ddlmZ ddlmZmZmZ ddlmZmZ ddlm Z dd l m Z dd l m Z m!Z! dd l"m#Z# dd l$m%Z% dd l&m'Z'm(Z( ddl)m*Z*m+Z+ ddl,m-Z- ddl.m/Z/m0Z0m1Z1 ddl2m3Z3 ddl4m5Z5m6Z6m7Z7 ddl8m9Z9m:Z: er�ddl;m<Z< ddl=m>Z> ddl?m@Z@ e0�AeB�ZCe�Dd�ZEe�DdejF�ZGG dd� de%eH �ZIG dd � d eI�ZJG d d � d e-�ZKG d d � d e3�ZLG d!d"� d"e%eH �ZMG d#d$� d$e3�ZNG d%d&� d&e-�ZOd'eHd(e e eH fd)d*�ZPd+d,d-e e d.eHd/eHd0eQd1eHd2ejRd(ejSfd3d4�ZTG d5d6� d6e3�ZUdJd8eHd9eHd(e e fd:d;�ZVG d<d=� d=e3�ZWG d>d?� d?e-�ZXG d@dA� dAe'�ZYdBdCdDe'dEe!d(e eZ fdFdG�Z[dBdCd(e eHef fdHdI�Z\dS )Kz� sphinx.domains.std ~~~~~~~~~~~~~~~~~~ The standard domain. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. � N)�copy) � TYPE_CHECKING�Any�Callable�Dict�Iterable�Iterator�List�Optional�Tuple�Type�Union�cast)�nodes)�Element�Node�system_message)� Directive� directives)� StringList)�addnodes)�desc_signature� pending_xref)�RemovedInSphinx50Warning)�ObjectDescription)�Domain�ObjType)�_�__)�XRefRole)� docname_join�logging�ws_re)�SphinxDirective)� clean_astext�make_id� make_refnode)� OptionSpec� RoleFunction)�Sphinx)�Builder)�BuildEnvironmentz ((?:/|--|-|\+)?[^\s=]+)(=?\s*.*)z`((~?\w*:)?\w+)`c @ s| e Zd ZU dZdZeed< dZed dee gef ed< dede d efd d �Z d edede d dfd d�Z d ed efdd�Z dS )� GenericObjectzM A generic x-ref directive registered with Sphinx.add_object_type(). � � indextemplateNr+ � parse_node�sig�signode�returnc C sB | j r | � | j||�}|S |�� |t�||�7 }t�d|�}|S )N� )r/ �env�clearr � desc_namer" �sub)�selfr0 r1 �name� r: �4/usr/lib/python3/dist-packages/sphinx/domains/std.py�handle_signature8 s � z GenericObject.handle_signaturer9 c C s t | j| jj| j|�}|d �|� | �|�}|| jjjvr+||d vr+|d �|� | jj�|� | j rl| j � d�}|dkrW| j d |� � � }| j |d d � � � |f }nd}| j |f }| j d �|||dd f� t t| j�d��} | j| j|||d � d S ) N�ids�:���� �single�entriesr- �std��location)r% r4 �state�document�objtype�append� make_old_idr= �note_explicit_targetr. �find�strip� indexnoder �StandardDomain� get_domain� note_object) r8 r9 r0 r1 �node_id� old_node_id�colon� indextype� indexentryrC r: r: r; �add_target_and_indexB s z"GenericObject.add_target_and_indexc C � | j d | S )z�Generate old styled node_id for generic objects. .. note:: Old Styled node_id was used until Sphinx-3.0. This will be removed in Sphinx-5.0. �-)rH �r8 r9 r: r: r; rJ [ � zGenericObject.make_old_id) �__name__� __module__� __qualname__�__doc__r. �str�__annotations__r/ r r r< rW rJ r: r: r: r; r, 1 s r, c @ s e Zd Zed�ZdS )�EnvVar�environment variable; %sN)r\ r] r^ r r. r: r: r: r; rb d s rb c @ s@ e Zd ZdZdejdddededee e e e f f dd �Z d S ) �EnvVarXRefRolezQ Cross-referencing role for environment variables (adds an index entry). rG r4 r+ �node�is_refr2 c C s~ |s|gg fS |d }d|� d� }t�� }d||dd fdtd�| |dd fg|d< tjdd|gd�}|�|� |||gg fS ) N� reftargetzindex-%s�indexrA r- rc rB �r= )� new_serialnor rh r r �targetrK ) r8 rG r4 re rf �varname�tgtidrN � targetnoder: r: r; � result_nodesm s � zEnvVarXRefRole.result_nodesN) r\ r] r^ r_ r rG r �boolr r r r ro r: r: r: r; rd h s ��rd c @ sV e Zd ZU dZdZdZdZdZdZi Z e e d< de e fd d �Zd edefd d �ZdS )�Targetz@ Generic target for user-defined cross-reference types. r- Fr@ r T� option_specr2 c C sH t �d| jd �� �}t| j| jj| j|�}t j dd|gd�}| � |� | � |�}|| jjj vr=||d vr=|d �|� | jj�|� |g}| jr| j|f }d}|�d�}|dkrm|d |� �� }||d d � �� }tj|||dd fgd �} |�d| � | j} d| jv r�| j�dd �\} } tt| j�d ��} | j| |||d � |S ) Nr3 r r- ri r= rA r> r? r@ )rB rC rD )r" r7 � argumentsrM r% r4 rF rG r9 r rk �set_source_inforJ r= rI rK r. rL r rh �insert�splitr rO rP rQ ) r8 �fullnamerR re rS �retrV rU rT �inoder9 r rC r: r: r; �run� s0 z Target.runr9 c C rX )z�Generate old styled node_id for targets. .. note:: Old Styled node_id was used until Sphinx-3.0. This will be removed in Sphinx-5.0. rY )r9 rZ r: r: r; rJ � r[ zTarget.make_old_idN)r\ r] r^ r_ r. � has_content�required_arguments�optional_arguments�final_argument_whitespacerr r' ra r r rz r` rJ r: r: r: r; rq } s !rq c @ sV e Zd ZdZdededefdd�Zdedededdfd d �Zd ed edefd d�ZdS )� Cmdoptionz; Description of a command-line option (.. option). r0 r1 r2 c C s� d}d}|� d�D ]a}|�� }t�|�}|s!tjtd�||d� q |�� \}}|�d�r;|�d�r;|dd � }d| }|rE|t � dd�7 }|t � ||�7 }|t � ||�7 }|s_|}|g|d < n|d � |� |d 7 }q |sot �|S ) z/Transform an option description into RST nodes.r r- �, znMalformed option description %r, should look like "opt", "-opt args", "--opt args", "/opt args" or "+opt args"rD �[�]Nr? �allnamesr@ )rv rM �option_desc_re�match�logger�warningr �groups�endswithr � desc_addnamer6 rI � ValueError) r8 r0 r1 �count� firstname�potential_option�m�optname�argsr: r: r; r< � s6 � zCmdoption.handle_signaturer� Nc C sT | j j�d�}|�dg �D ]F}dg}|r|�|� |�d�s#|�d� d�|�}t| j | jj||�}|d �|� | � ||�} | | jjj vrS| |d vrS|d �| � q | jj� |� t t | j �d��} |�dg �D ]}| �||| j j|d d � qj|r�td �| } ntd �} |�d �D ]} d �| | g�} | jd �d| |d d dd f� q�d S )N� std:programr� � cmdoption)rY �/�argrY r= rC r z%s command line optionzcommand line optionr� z; rB �pairr- )r4 � ref_context�getrI � startswith�joinr% rF rG rJ r= rK r rO rP �add_program_option�docnamer rv rN )r8 r� r0 r1 � currprogramr� �prefixes�prefixrR rS �domain�descr�option�entryr: r: r; rW � s8 ��$�z Cmdoption.add_target_and_indexr� r� c C s t �|d | �S )z�Generate old styled node_id for cmdoption. .. note:: Old Styled node_id was used until Sphinx-3.0. This will be removed in Sphinx-5.0. rY �r r% )r8 r� r� r: r: r; rJ � s zCmdoption.make_old_id) r\ r] r^ r_ r` r r< rW rJ r: r: r: r; r � s !!r c @ s@ e Zd ZU dZdZdZdZdZi Ze e d< de e fdd �Z d S ) �ProgramzI Directive to name the program for which options are documented. Fr@ r Trr r2 c C sB t �d| jd �� �}|dkr| jj�dd � g S || jjd< g S )NrY r �Noner� )r" r7 rs rM r4 r� �pop)r8 �programr: r: r; rz s �z Program.runN)r\ r] r^ r_ r{ r| r} r~ rr r' ra r r rz r: r: r: r; r� s r� c @ �6 e Zd Zdddededededeeef f dd �Zd S ) �OptionXRefRoler4 r+ �refnode�has_explicit_title�titlerk r2 c C s |j �d�|d< ||fS )Nr� )r� r� )r8 r4 r� r� r� rk r: r: r; � process_link s zOptionXRefRole.process_linkN�r\ r] r^ r rp r` r r� r: r: r: r; r� � �� �r� �liner2 c C s t �d| �d g }|S )Nz +: +)�rerv )r� �partsr: r: r; �split_term_classifiers s r� r4 r+ � textnodes� index_key�source�linenorR rG c C s� t jddg|�R � }||_||_|�� }|r |d �|� nt| |d|�}|d �|� |�|� tt | � d��} | j |||d� t � � } d||d|fg| d< |j|j| _| _|�| � |S ) Nr- r= �termrC rD rA �mainrB )r r� r� r� �astextrI r% rK r rO rP � _note_termr rh ) r4 r� r� r� r� rR rG r� �termtextrC rN r: r: r; �make_glossary_term$ s r� c @ sF e Zd ZU dZdZdZdZdZdej iZ e e d< de e fdd �Zd S ) �Glossaryz[ Directive to create a glossary with cross-reference targets for :term: roles. Tr F�sortedrr r2 c C s� t �� }| jj|_g }d}d}d}g }t| j| jj�D ]�\}\}} |s5|r2|r2|d d �d|| � d}q|r�|d �� s�|� d�rEd}qd}|ri|sZ|�| jj j t d�|| d �� |�||| fgt � f� d}nb|rz|�| jj j t d �|| d �� |r�|d d �||| f� nB|�| jj j t d �|| d �� n2|r�n/|s�d}t|�t|�� � } |r�|d d �|| d � || � n|�| jj j t d �|| d �� d}qg } |D ]q\} } g }g }g }| D ]8\}}} t|�}| j�|d | �\}}t| j||d || d | jjd �}||_|�|� |�|�� � |�|� q�|�|� t�� }| �r0| j�| | jd d |� |�|� | �|tjdg|�R � f� q�d | jv �rR| j dd� d� t� � }|d �d� |�dd� | D �� ||7 }||g S )NTFr? r@ r- r z.. z,glossary term must be preceded by empty line)r� r� z3glossary terms must not be separated by empty linesz4glossary seems to be misformatted, check indentation)rR rG r� c S s t �d| d d �� �S )N�NFDr )� unicodedata� normalize�lower)�xr: r: r; �<lambda>� s z Glossary.run.<locals>.<lambda>)�key�classes�glossaryc s s � | ]}|d V qdS )r@ Nr: )�.0�itemr: r: r; � <genexpr>� s � z Glossary.run.<locals>.<genexpr>) r r� rF rG �zip�content�itemsrI �isspacer� �reporterr� r r �len�lstripr� � inline_textr� r4 � rawsource�extendr� r � definition� nested_parse�definition_list_item�options�sort�definition_list)r8 re rB � in_definition� in_comment� was_empty�messagesr� r� r� � indent_lenr� �termsr� � termtexts� termnodes�system_messagesr� r� �sysmsgr� �defnode�dlistr: r: r; rz P s� � � � � � � � z Glossary.runN)r\ r] r^ r_ r{ r| r} r~ r �flagrr r' ra r r rz r: r: r: r; r� B s �r� r- �text�productionGroupc C s2 t |�dkr |d7 }g }d}t�| �D ]l}|�� |kr,| ||�� � }|�t�||�� |�d�}d|v r]|d dkrI|�d�\}}|dd � } n|d dkrX|dd � }|} n |}|} n|}|| } t |dd| d�} | tj ||dgd �7 } |�| � |� � }q|t | �k r�|�t�| |d � | |d � �� |S ) Nr r> r@ �~�tokenrC )�reftype� refdomainrg �xref�r� ) r� �token_re�finditer�startrI r �Text�grouprv r �literal�end) r� r� �retnodes�posr� �txtr� r r� rk r� r: r: r; � token_xrefs� s: � "r� c @ sR e Zd ZU dZdZdZdZdZi Ze e d< de e fdd �Z d edefd d �Zd S )�ProductionListz0 Directive to list grammar productions. Fr@ r Trr r2 c C s� t t| j�d��}t�� }| �|� t�d�}|� d| j d �� d�}d}d}|D ]�}|dkr8d|vr8|� � }q)|d7 }z |� dd�\}} W n t yR Y |gS w t�|�} |� � }|| d< | d r�d | } t| j| jj| |�} | d �| � | �|�} | | jjjvr�| | d vr�| d �| � | jj�| | � t|�dkr�d ||f }n|}|jd || |d � | �t| |�� |�| � q)|gS )NrC z\\\nr- r � r> r@ � tokennamezgrammar-token-%sr= z%s:%sr� rD )r rO r4 rP r �productionlistrt r� �compiler7 rs rv rM r� � productionr% rF rG rI rJ r= �note_implicit_targetr� rQ r� r� )r8 r� re � nl_escape_re�linesr� �i�ruler9 �tokens�subnoder� rR rS �objNamer: r: r; rz � sJ � zProductionList.runr� c C s t �d| �S )z�Generate old styled node_id for tokens. .. note:: Old Styled node_id was used until Sphinx-3.0. This will be removed in Sphinx-5.0. zgrammar-token-r� )r8 r� r: r: r; rJ r[ zProductionList.make_old_idN)r\ r] r^ r_ r{ r| r} r~ rr r' ra r r rz r` rJ r: r: r: r; r� � s -r� c @ r� ) � TokenXRefRoler4 r+ r� r� r� rk r2 c C sN |� d�}| js#|d dkr#d|v r |�d�\}}||fS |dd � }||fS )Nr� r r> r@ )r� r� rv )r8 r4 r� r� r� rk r r: r: r; r� s �zTokenXRefRole.process_linkNr� r: r: r: r; r r� r c s� e Zd ZU dZdZdZeed�ddd�eed�d dd�eed �d d dd�eed �d�eed�d�eed�ddd�d�Ze e ef e d< e e e eeed�Ze e ee f e d< edd�e� e� eejdd�edejdd�eddd�edd�edejd �d �Ze e ee ef f e d < i i d d ed!�fd"d ed#�fd$d ed%�fd&�d'd(d)d&�d*�Z d+d,d-d.d/d0�Z ej d1ej d2ej!d3iZ"e ee# e$e e%e& f f e d4< d�� fd9d:� Z' d�d;e d<e d=e d>e d7d8f d?d@�Z(e)d7e e$e e f e$e e f f fdAdB��Z*d�dCe d;e dDe dEe+d7d8f dFdG�Z,dCe d;e d<e dDe d7d8f dHdI�Z-e)d7e e e$e e f f fdJdK��Z.d�de dDe dEe+d7d8fdLdM�Z/e)d7e e$e e f e$e e f f fdNdO��Z0e)d7e e e$e e e f f fdPdQ��Z1e)d7e e e$e e f f fdRdS��Z2d<e d7d8fdTdU�Z3dVe4e dWe d7d8fdXdY�Z5d5d6d<e dej6d7d8fdZd[�Z7d\e d;e d<e dDe d7d8f d]d^�Z8d_e d`dad<e dDe dbe dce dde+d7e9fdedf�Z:d5d6d_e d`dadge dhe die;dje9d7e%e9 fdkdl�Z<d5d6d_e d`dadge dhe die;dje9d7e%e9 fdmdn�Z=d5d6d_e d`dadge dhe die;dje9d7e%e9 fdodp�Z>d5d6d_e d`dadge dhe die;dje9d7e%e9 fdqdr�Z?d5d6d_e d`dadge dhe die;dje9d7e%e9 fdsdt�Z@d5d6d_e d`dadge dhe die;dje9d7e%e9 fdudv�ZAd5d6d_e d`dadge dhe die;dje9d7e9fdwdx�ZBd5d6d_e d`dadge dhe die;dje9d7e%e9 fdydz�ZCd5d6d_e d`dadhe die;dje9d7e4e$e e9f fd{d|�ZDd7eEe$e e e e e eFf fd}d~�ZGd�d�ed�eHd7e fd�d��ZIdie#d7eHfd�d��ZJdie#d7e%e fd�d��ZKdie#d7e%e fd�d��ZLd5d6d`dad�e d<e d�e9d7e$eFd�f f d�d��ZMdie9d7e%e fd�d��ZN� ZOS )�rO zs Domain for all objects that don't fit into another domain or are added via the application interface. rC �Defaultz glossary termr� r? )� searchprioz grammar tokenr� zreference label�ref�keywordzenvironment variable�envvarzprogram optionr� rG �doc)r� r� �labelr r� r � object_types)r� r� r� r r� r r T)� warn_dangling)�innernodeclassr )� lowercaser r )r r )r r )r� r r� r� r �numrefr r �roles�genindexr- �Index� py-modindexz Module Index�searchz Search Page)r �modindexr )r r- )r r- )r r- )� progoptions�objects�labels� anonlabelsz term not in glossary: %(target)szundefined label: %(target)szunknown keyword: %(target)sz unknown document: %(target)szunknown option: %(target)s)r� r r r r� )�figureN)�tableN)� code-blockN�enumerable_nodesr4 r+ r2 Nc s> t � �|� t| j�| _|jjj�� D ] \}}|| j|< qd S �N)�super�__init__r r% �app�registryr� )r8 r4 re �settings�� __class__r: r; r( v s �zStandardDomain.__init__r9 r� rR r� c C sj || j v r | j | ||fkr t�td�|| j�| j | d �� ||f| j |< |r3|||f| j|< dS dS )aU Add a hyperlink target for cross reference. .. warning:: This is only for internal use. Please don't use this from your extension. ``document.note_explicit_target()`` or ``note_implicit_target()`` are recommended to add a hyperlink target to the document. This only adds a hyperlink target to the StandardDomain. And this does not add a node_id to node. Therefore, it is very fragile to calling this without understanding hyperlink target framework in both docutils and Sphinx. .. versionadded:: 3.0 �(duplicate label %s, other instance in %sr N)r! r� r� r r4 �doc2pathr )r8 r9 r� rR r� r: r: r; �note_hyperlink_target~ s ��z$StandardDomain.note_hyperlink_targetc C � | j �di �S )Nr ��data� setdefault�r8 r: r: r; r � � zStandardDomain.objectsrH �labelidrE c C sR ||f| j v r | j ||f d }tjtd�||||d� | jj|f| j ||f< dS )zRNote a generic object for cross reference. .. versionadded:: 3.0 r z4duplicate %s description of %s, other instance in %srD N)r r� r� r r4 r� )r8 rH r9 r7 rE r� r: r: r; rQ � s �zStandardDomain.note_objectc C s& t jdtdd� ||f| j||f< d S )Nz*StandardDomain.add_object() is deprecated.� )� stacklevel)�warnings�warnr r )r8 rH r9 r� r7 r: r: r; � add_object� s �zStandardDomain.add_objectc C r1 )z2.. note:: Will be removed soon. internal use only.r� r2 r5 r: r: r; �_terms� s zStandardDomain._termsc C s* | � d|||� | jj|f| j|�� < dS )zeNote a term for cross reference. .. note:: Will be removed soon. internal use only. r� N)rQ r4 r� r= r� )r8 r� r7 rE r: r: r; r� � s zStandardDomain._note_termc C r1 )Nr r2 r5 r: r: r; r � r6 zStandardDomain.progoptionsc C r1 )Nr r2 r5 r: r: r; r � r6 zStandardDomain.labelsc C r1 )Nr! r2 r5 r: r: r; r! � r6 zStandardDomain.anonlabelsc C s� d }t | j�� �D ]\}\}}||kr| j|= q t | j�� �D ]\}\}}||kr-| j|= q t | j�� �D ]\}\}}||krC| j|= q5t | j�� �D ]\}\}}}||krZ| j|= qKt | j�� �D ]\}\}}||krp| j|= qbd S r& )�listr r� r r= r r! )r8 r� r� �fn�_lr: r: r; � clear_doc� s, ��� ���zStandardDomain.clear_doc�docnames� otherdatac C s� |d � � D ]\}}|d |v r|| j|< q|d � � D ]\}}|d |v r+|| j|< q |d � � D ]\}}|d |v rA|| j|< q2|d � � D ]\}}|d |v rW|| j|< qH|d � � D ]\}}|d |v rm|| j|< q^d S )Nr r r r� r r! )r� r r r= r r! )r8 rB rC r� r3 r: r: r; �merge_domaindata� s* � � � � ��z StandardDomain.merge_domaindatac C s` |j �� D ]�\}}|s q|j| }|d u rq|j| }t|tj�r3d|v r3|j�|d �}|d d }|jdksBd|v sB|j� d�rCq|| j v r[t j t d�||�| j | d �|d� ||f| j|< |jd krtttj|d �}t|�} n1|jd kr~t|�} n'| �|�r�| �|�} | s�qntt|�tj��d �} | r�| �d �r�| �d �} nq||| f| j |< qd S ) N�refid�namesr �footnote�refuri�desc_r. rD �section�rubric�caption)� nametypesr� �nameidsr= � isinstancer rk r� �tagnamer� r r� r� r r/ r! r r� r$ �is_enumerable_node�get_numfig_title�next�iter�traverser �toctree) r8 r4 r� rG r9 �explicitr7 re r� �sectnamerV r: r: r; � process_doc� sJ � � � �zStandardDomain.process_docr� c C s ||f| j ||f< d S r& )r )r8 r� r9 r� r7 r: r: r; r� � z!StandardDomain.add_program_option� fromdocname�builderr* rX �rolenamer� c K s� |� dtj�}|d ddi|��} t�||�} | �d�d ur-| d �d� | d �d| � ||kr6|| d< n td�} || d < || d < |�||�| d < |rV| d d | 7 < | �| � | S )N� nodeclassr- �internalTr� rC zstd-rE � refdocname� refsectnamerH �#�r- r- )r� r � reference�inliner� rI r �get_relative_uri) r8 r[ r\ r� r7 rX r] r� r^ �newnode� innernode�contnoder: r: r; �build_reference_node s$ � z#StandardDomain.build_reference_node�typrk re ri c C sz |dkr| j }n+|dkr| j}n#|dkr| j}n|dkr | j}n|dkr(| j}n |dkr0| j}n| j}||||||||�S )Nr r r r r� r� )�_resolve_ref_xref�_resolve_numref_xref�_resolve_keyword_xref�_resolve_doc_xref�_resolve_option_xref�_resolve_term_xref�_resolve_obj_xref) r8 r4 r[ r\ rk rk re ri �resolverr: r: r; � resolve_xref. s zStandardDomain.resolve_xrefc C sT |d r| j �|d�\}} |�� } n | j�|d�\}} } |s d S | �|||| | d�S )N� refexplicitrc �r- r- r- r )r! r� r� r rj ) r8 r4 r[ r\ rk rk re ri r� r7 rX r: r: r; rl B s �z StandardDomain._resolve_ref_xrefc C s� || j v r| j �|d�\}} } n | j�|d�\}} d } |s d S |�|�j�| �} | �| �} | d u r3d S | dkrH|jjdu rHtj t d�|d� |S z| � ||| || �} | d u rY|W S W n t yo tj t d�| |d� | Y S w zM|d rz|� � }n|jj�| d �}| d u r�d |v r�tj t d �||d� |W S d �tt| ��}d |v s�d |v r�| r�|j| |d�}n |j|d�}n|| }W n3 ty� } ztj t d�|||d� |W Y d }~S d }~w ty� tj t d�||d� | Y S w | j|||| |dtj|d�S )Nrv rc rJ Fz(numfig is disabled. :numref: is ignored.rD zBFailed to create a cross reference. Any number is not assigned: %sru r- z{name}zthe link has no caption: %s�.�number)r9 rx )rx z invalid numfig_format: %s (%r)zinvalid numfig_format: %sr )r^ r� )r r� r! � get_doctreer= �get_enumerable_node_type�config�numfigr� r� r � get_fignumberr� r� � numfig_formatr� �mapr` �format�KeyError� TypeErrorrj r �number_reference)r8 r4 r[ r\ rk rk re ri r� r7 �figname� target_node�figtype� fignumberr� �fignum�newtitle�excr: r: r; rm T sf � �� �� ��z#StandardDomain._resolve_numref_xrefc C s, | j �|d�\}} } |sd S t|||| |�S )Nrv )r r� r& ) r8 r4 r[ r\ rk rk re ri r� r7 r r: r: r; rn � s �z$StandardDomain._resolve_keyword_xrefc C sj |� d|�}t||d �} | |jvrd S |d r |�� } nt|j| �} tj| | dgd�} t||| d | �S )N�refdocrg ru r r� ) r� r �all_docsr� r$ �titlesr re r& ) r8 r4 r[ r\ rk rk re ri r� r� rL rh r: r: r; ro � s z StandardDomain._resolve_doc_xrefc C s� |� d�}|�� }| j� ||fd�\} } | sDg } t�|�rBt�|d�\} }| �| � d�| �}| j� ||fd�\} } | r=nt�|�s d S t||| | |�S )Nr� rc r@ rY ) r� rM r r" r rv rI r� r& ) r8 r4 r[ r\ rk rk re ri �prognamer� r7 �commands� subcommandr: r: r; rp � s" � �z#StandardDomain._resolve_option_xrefc C sR | � |||||||�}|r|S |�� | jv r'| j|�� \} } t||| | |�S d S r& )rr r� r= r& ) r8 r4 r[ r\ rk rk re ri �resultr� r7 r: r: r; rq � s �z!StandardDomain._resolve_term_xrefc C s\ | � |�pg }|D ]} | |f| jv r | j| |f \} } nq d\} } | s&d S t||| | |�S )Nrc )�objtypes_for_roler r& ) r8 r4 r[ r\ rk rk re ri �objtypesrH r� r7 r: r: r; rr � s ��z StandardDomain._resolve_obj_xrefc C s� g }|� � }dD ] } | �|||| | dkr|n|||�} | r&|�d| | f� q| jD ],} | |f} | dkr8| |f} | | jv rV| j| \} }|�d| �| � t||| ||�f� q*|S )N)r r� r zstd:r� )r� rt rI r r �role_for_objtyper& )r8 r4 r[ r\ rk re ri �results�ltarget�role�resrH r� r� r7 r: r: r; �resolve_any_xref� s. �� ���z StandardDomain.resolve_any_xrefc c s8 � | j jD ]}|t| j j| �d|ddfV q| j�� D ]*\\}}}|r9d�||g�}||d|d |d dfV q ||d|d |d dfV q | j�� D ]\\}}}||||d |d | j| j d fV qL| j �� D ]\}\}} } || d || dfV qkt | j �} | j �� D ]\}\}} || vr�||d || dfV q�d S ) Nr r- r? rw r� r r@ r r ) r4 r� r$ r� r r� r� r r �attrsr �setr! ) r8 r �progr� �inforw �typer9 r� r7 � sectionname�non_anon_labelsr: r: r; � get_objects� s( � � ��zStandardDomain.get_objectsFr� �primaryc C s |j S r& )�lname)r8 r� r� r: r: r; � get_type_name s z StandardDomain.get_type_namec C s |j | jv S r& )r- r% )r8 re r: r: r; rQ s z!StandardDomain.is_enumerable_nodec C s` | � |�r.tt|�}| j�|jd�\}}|r||�S |D ]}t|tjtj f�r-t |� S q dS )z?Get the title of enumerable nodes to refer them using its title�NNN) rQ r r r% r� r- rO r rL r� r$ )r8 re �elemr � title_getterr r: r: r; rR s �z StandardDomain.get_numfig_titlec C sb dt dtdtfdd�}t|tj�rdS t|tj�r%d|v r%||tj�r%dS | j� |j d �\}}|S ) z Get type of enumerable nodes.re �clsr2 c s t � fdd�| D ��S )Nc 3 s � | ]}t |� �V qd S r& )rO )r� �child�r� r: r; r� & s � zMStandardDomain.get_enumerable_node_type.<locals>.has_child.<locals>.<genexpr>)�any)re r� r: r� r; � has_child% rZ z:StandardDomain.get_enumerable_node_type.<locals>.has_childrJ � literal_blockr$ r� ) r r rp rO r rJ � containerr� r% r� r- )r8 re r� r� r r: r: r; rz # s �z'StandardDomain.get_enumerable_node_typer� r� .c C s� |dkr2|j dkr t� S ||jvrt�d|d d }||j| vr*|j| �d�S |j| �|�S z|d d }|j| | | W S ttfyS } zt|�d }~ww )NrJ �latexrb r= r r- )r9 �tuple�toc_secnumbersr� r� �toc_fignumbersr� � IndexError) r8 r4 r\ r� r� r� � anchorname� figure_idr� r: r: r; r} 3 s ��z StandardDomain.get_fignumberc C s` |� d�dkr.|� d�}t�|� d��}|r |�d|� |�� }|r,d�d�|�|g�S d S d S )Nr� r� r� rg r rw rY )r� r" rv ru r� r� )r8 re r� �commandr� r: r: r; �get_full_qualified_nameJ s z&StandardDomain.get_full_qualified_name)r4 r+ r2 N�r- r& )F)Pr\ r] r^ r_ r9 r r r r r r` ra r� r rb r� r� r r r r� rd r r r re r r r( � initial_data�dangling_warningsr" r# r� r% r r r r r( r0 �propertyr r rQ r< r= r� r r r! rA r rD rG rY r� r rj r rt rl rm rn ro rp rq rr r� r �intr� rp r� rQ rR rz r} r� � __classcell__r: r: r, r; rO ) s� � � � ��� � ���� $� �� �( � (" )���� ����� � ����� � ����� � ?����� � ����� � ����� � ����� � ����� � ���� �" ��� � rO r) r) r� re c C s` |r|j dks |d dkrd S |d }||jvr td�}ntd�}tj|| |d|d d� dS ) NrC r� r rg zundefined label: %szDFailed to create a cross reference. A title or caption not found: %s)rE r� �subtypeT)r9 r! r r� r� )r) r� re rk �msgr: r: r; �warn_missing_referenceY s r� c C s$ | � t� | �dt� ddddd�S )Nzwarn-missing-reference�builtinr8 T)�version� env_version�parallel_read_safe�parallel_write_safe)� add_domainrO �connectr� )r) r: r: r; �setuph s �r� r� )]r_ r� r� r: r �typingr r r r r r r r r r r r �docutilsr �docutils.nodesr r r �docutils.parsers.rstr r �docutils.statemachiner �sphinxr �sphinx.addnodesr r �sphinx.deprecationr �sphinx.directivesr �sphinx.domainsr r � sphinx.localer r � sphinx.rolesr � sphinx.utilr r! r" �sphinx.util.docutilsr# �sphinx.util.nodesr$ r% r& �sphinx.util.typingr' r( �sphinx.applicationr) �sphinx.buildersr* �sphinx.environmentr+ � getLoggerr\ r� r r� �Ur� r` r, rb rd rq r r� r� r� r� rG r� r� r� r� r� r rO rp r� r� r: r: r: r; �<module> sx 8 36P���� � y!A 4 �
Save
Cancel