Dashboard
PHP:
8.2.30
OS:
Linux
User:
dh_nv8b2m
/
/
usr
/
lib
/
python3
/
dist-packages
/
sphinx
/
directives
/
__pycache__
📤 Upload
📝 New File
📁 New Folder
Close
Editing: other.cpython-310.pyc
o �$�a�8 � @ s� d Z ddlZddlmZmZmZmZmZ ddlm Z ddl m Z m Z ddl mZ ddlmZ ddlmZ dd lmZ dd lmZ dd lmZ dd lmZmZ dd l m Z m Z m Z ddl m!Z! ddl"m#Z#m$Z$ ddl%m&Z& ddl'm(Z( erzddl)m*Z* e�+d�Z,e �-e.�Z/de0de1fdd�Z2G dd� de!�Z3G dd� de!�Z4G d d � d e�Z5G d d � d e!�Z6G d d!� d!e!�Z7G d"d#� d#e!�Z8G d$d%� d%e!�Z9G d&d'� d'e!�Z:G d(d)� d)ee!�Zd*d+dee0ef fd,d-�Z;dS ).z� sphinx.directives.other ~~~~~~~~~~~~~~~~~~~~~~~ :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. � N)� TYPE_CHECKING�Any�Dict�List�cast)�nodes)�Element�Node)� directives)�BaseAdmonition)�Class)�Include)�addnodes)� VersionChange)�_�__)� docname_join�logging�url_re)�SphinxDirective)�Matcher� patfilter)�explicit_title_re)� OptionSpec)�Sphinxz .*[*?\[].*�argument�returnc C s | sdS t | �S )Ni� )�int)r � r �9/usr/lib/python3/dist-packages/sphinx/directives/other.py�int_or_nothing$ s r c @ sp e Zd ZdZdZdZdZdZee j e j e j e j e j e e j e j d� Zdee fdd�Zd ejdee fd d �Zd S ) �TocTreez� Directive to notify Sphinx about the hierarchical structure of the docs, and to include a table-of-contents like tree in the current document. Tr F) �maxdepth�name�caption�glob�hidden� includehidden�numbered� titlesonly�reversedr c C s� t �� }| jj|d< g |d< g |d< | j�dd�|d< | j�d�|d< d| jv |d< d| jv |d< d | jv |d < | j�d d �|d < d | jv |d < | �|� tjd gd�}|� |� | � |� | � |�}|� |� |S )N�parent�entries� includefilesr" ���r$ r% r& r' r( r r) ztoctree-wrapper)�classes) r �toctree�env�docname�options�get�set_source_infor �compound�append�add_name� parse_content)�self�subnode� wrappernode�retr r r �run? s$ z TocTree.runr0 c C s8 | j j}| jj�� }|�| jj� g }t| j j�}| j D ]�}|s!q t � |�}|d rkt � |�rk|skt � |�skt| jj|�}tt||��} | D ]} |�| � |d �d | f� |d �| � qF| sjtjtd�||d� q |rz|�d�} |�d�} | } n| } } d } |D ]} | �| �r�| d t| � � } nq�t| jj| �} t � | �s�| dkr�|d �| | f� q | | jjvr�|| j�| d ��r�td �}d }ntd �}d }tj|| d ||d� | j�� q | |v r�|�| � n tjtd�| |d� |d �| | f� |d �| � q d| jv �rtt |d ��|d< tt |d ��|d< |S )Nr% r, r- z2toctree glob pattern %r didn't match any documents��location� � r: z2toctree contains reference to excluded document %r�excludedz5toctree contains reference to nonexisting document %r� not_readable�toc)�type�subtyper@ z%duplicated entry found in toctree: %sr* ) �config� source_suffixr1 � found_docs�copy�remover2 r �exclude_patterns�contentr �match�glob_rer r �sortedr r7 �logger�warningr �group�endswith�len�doc2path� note_rereadr3 �listr* )r: r0 �suffixes� all_docnamesr= rC �entry�explicit�patname�docnamesr2 �ref�title�suffix�messagerG r r r r9 W sx �� �� � � � zTocTree.parse_contentN)�__name__� __module__� __qualname__�__doc__� has_content�required_arguments�optional_arguments�final_argument_whitespacer r � unchanged�unchanged_required�flagr � option_specr r r> r r0 r9 r r r r r! * s$ � r! c @ �@ e Zd ZU dZdZdZdZdZi Ze e d< de e fdd �Z d S ) �Authorz� Directive to give the name of the author of the current document or section. Shown in the output only if the show_authors option is on. FrB r Tro r c C s� | j jsg S tjdd�}t�� }||7 }| jdkr td�}n| jdkr(td�}n| jdkr2td�}ntd �}|t�||�7 }| j� | j d | j �\}}|� |� |g}||7 }|S ) NF)� translatable� sectionauthorzSection author: � moduleauthorzModule author: � codeauthorz Code author: zAuthor: r ) rH � show_authorsr � paragraph�emphasisr# r �Text�state� inline_text� arguments�lineno�extend)r: �para�emph�text�inodes�messagesr= r r r r> � s$ z Author.runN�rd re rf rg rh ri rj rk ro r �__annotations__r r r> r r r r rq � s rq c @ s e Zd ZdZejZdS )�SeeAlsozB An admonition mentioning things to look at as reference. N)rd re rf rg r �seealso� node_classr r r r r� � s r� c @ rp ) �TabularColumnszL Directive to give an explicit tabulary column definition to LaTeX. FrB r Tro r c C s& t �� }| jd |d< | �|� |gS )Nr �spec)r �tabular_col_specr| r5 �r: �noder r r r> � s zTabularColumns.runNr� r r r r r� � � r� c @ rp ) �Centeredz; Directive to create a centered line of bold text. FrB r Tro r c C sH | j sg S t�� }| j�| j d | j�\}}|�|� |g}||7 }|S )Nr )r| r �centeredrz r{ r} r~ )r: r; r� r� r= r r r r> � s z Centered.runNr� r r r r r� � r� r� c @ s@ e Zd ZU dZdZdZdZdZi Ze e d< de e fdd�Z d S ) �Acksz( Directive for a list of names. Tr Fro r c C sl t �� }| jj|_| j�| j| j|� t|j�dks#t |jd t j �s3t j td�| jj| jfd� g S |gS )NrB r z .. acks content is not a listr? )r �acksrz �document� nested_parserN �content_offsetrV �children� isinstancer � bullet_listrR rS r r1 r2 r} r� r r r r> � s � �zAcks.runNr� r r r r r� � r� r� c @ sD e Zd ZU dZdZdZdZdZdeiZ e e d< de e fdd �Zd S ) �HListz@ Directive for a list that gets compacted horizontally. Tr F�columnsro r c C s | j �dd�}t�� }| jj|_| j�| j| j|� t |j �dks*t |j d tj �s:t jtd�| jj| jfd� g S |j d }tt |�|�\}}d}t�� }t|�|d< t|�D ]%}|||k rc|d n| } t� � } | |j || � 7 } |t�d| �7 }| }qX|gS ) Nr� rA rB r z .. hlist content is not a listr? �ncolumns� )r3 r4 r rw rz r� r� rN r� rV r� r� r� rR rS r r1 r2 r} �divmodr �hlist�str�range�hlistcol) r: r� r� �fulllist�npercol�nmore�index�newnode�column�endindexr� r r r r> s. � � z HList.runN)rd re rf rg rh ri rj rk r ro r r� r r r> r r r r r� s �r� c @ s@ e Zd ZU dZdZdZdZdZi Ze e d< de e fdd�Z d S ) �OnlyzI Directive to only include text if the given tag(s) are enabled. TrB r ro r c C sF t �� }| jj|_| �|� | jd |d< | jj}|j}|j}g |_d|_zv| jj | j | j |dd� |j}|rC|rC|d |vsC| jj sM|gW ||_||_S d}| jj }|r^|d7 }|j }|sU|d8 }|d }t |�} ||v rs|�|�} || d } ttj| jj �}t| �D ]} |j r�|j }q�|�|� g W ||_||_S ||_||_w )Nr �exprT)� match_titlesrB rA )r �onlyrz r� r5 r| �memo� title_styles� section_levelr� rN r� r+ rV r� r r r r� r7 ) r: r� r� �surrounding_title_styles�surrounding_section_levelr� � current_depthr+ � title_style� nested_depth�n_sects_to_raise�ir r r r> 3 s\ �� ��� � �zOnly.runNr� r r r r r� ) r� r� c s* e Zd ZdZdee f� fdd� Z� ZS )r z� Like the standard "Include" directive, but interprets absolute paths "correctly", i.e. relative to source directory. r c s` | j d �d�r| j d �d�rt� �� S | j�| j d �\}}|| j d< | j�|� t� �� S )Nr �<�>)r| � startswithrU �superr> r1 � relfn2path� note_included)r: � rel_filename�filename�� __class__r r r> i s � z Include.run)rd re rf rg r r r> � __classcell__r r r� r r c s r �appr c C s� t �dt� t �dt� t �dt� t �dt� t �dt� t �dt� t �dt� t �dt� t �d t� t �d t � t �d t � t �d t � t �d t � dddd�S )Nr0 rs rt ru r� �tabularcolumnsr� r� r� r� �include�cssclassz rst-class�builtinT)�version�parallel_read_safe�parallel_write_safe) r �register_directiver! rq r� r� r� r� r� r� r r )r� r r r �setupt s" �r� )<rg �re�typingr r r r r �docutilsr �docutils.nodesr r �docutils.parsers.rstr �+docutils.parsers.rst.directives.admonitionsr �$docutils.parsers.rst.directives.miscr r � BaseInclude�sphinxr �sphinx.domains.changesetr � sphinx.localer r � sphinx.utilr r r �sphinx.util.docutilsr �sphinx.util.matchingr r �sphinx.util.nodesr �sphinx.util.typingr �sphinx.applicationr �compilerP � getLoggerrd rR r� r r r! rq r� r� r� r� r� r� r� r r r r �<module> s@ t"%:
Save
Cancel