Dashboard
PHP:
8.2.30
OS:
Linux
User:
dh_nv8b2m
/
/
usr
/
lib
/
python3
/
dist-packages
/
sphinx
/
util
/
__pycache__
📤 Upload
📝 New File
📁 New Folder
Close
Editing: docstrings.cpython-310.pyc
o �$�a� � @ s� d Z ddlZddlZddlZddlmZmZmZ ddlm Z ddl m Z m Z e� e jd �Zdedeeeeef f fd d �Zdedeeef fd d �Zddedededee fdd�Zdedee fdd�ZdS )z� sphinx.util.docstrings ~~~~~~~~~~~~~~~~~~~~~~ Utilities for docstring processing. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. � N)�Dict�List�Tuple)�Body)�RemovedInSphinx50Warning�RemovedInSphinx60Warning� field_marker�s�returnc C s� d}i }g }| s | |fS t | �D ]N}|�� dkr d}|�|� qt�|�}|rW|sW|�� dd� �dd�d }|�d�rQ|dd� �� }||�� d� �� ||< q|�|� qd }|�|� qd � |�|fS ) z,Separate docstring into metadata and others.F� � N�:r zmeta � T� ) �prepare_docstring�strip�append�field_list_item_re�match�group�split� startswith�end�join)r �in_other_element�metadata�lines�line�matched� field_name�name� r! �8/usr/lib/python3/dist-packages/sphinx/util/docstrings.py�separate_metadata s& r# c C s t jdtdd� t| �\}}|S )Nz!extract_metadata() is deprecated.� �� stacklevel)�warnings�warnr r# )r � docstringr r! r! r" �extract_metadata4 s � r* � �ignore�tabsizec C s |du rd}nt jdtdd� | �|��� }tj}||d� D ]}t|�� �}|r4t|�| }t ||�}q t |�D ]}|t|�k rI|| �� ||< q9|tjk rct |t|��D ] }|| |d� ||< qV|rt|d st|� d� |rt|d ri|r|d r|� d� |S ) a� Convert a docstring into lines of parseable reST. Remove common leading indentation, where the indentation of a given number of lines (usually just one) is ignored. Return the docstring as a list of lines usable for inserting into a docutils ViewList (used as argument of nested_parse().) An empty line is added to act as a separator between this docstring and following content. Nr z;The 'ignore' argument to prepare_docstring() is deprecated.r$ r% r ���r ) r' r( r � expandtabs� splitlines�sys�maxsize�len�lstrip�min�range�popr ) r r, r- r �marginr �content�indent�ir! r! r" r < s4 � � � � r c C sz g }dd� | � � �� D �}|D ] }|�d�r/|dd� }|r*|d dkr*|dd� }|�|� q|r;|d r;|�d � |S ) z�Extract documentation comment lines (starting with #:) and return them as a list of lines. Returns an empty list if there is no documentation. c S s g | ]}|� � �qS r! )r )�.0r r! r! r" � <listcomp>h s z&prepare_commentdoc.<locals>.<listcomp>z#:r$ Nr � r r. r )r/ r0 r r )r �resultr r r! r! r" �prepare_commentdocc s � r@ )Nr+ )�__doc__�rer1 r' �typingr r r �docutils.parsers.rst.statesr �sphinx.deprecationr r �compile�patternsr �strr# r* �intr r@ r! r! r! r" �<module> s " '
Save
Cancel