Файловый менеджер - Редактировать - /opt/imh-python/lib/python3.9/site-packages/traitlets/config/__pycache__/sphinxdoc.cpython-39.pyc
Ðазад
a _�h� � @ s� d Z ddlmZ ddlZddlmZ ddlmZ ddl m Z m Z ddl m Z ddlmZ d d d �d d �Zd dd�dd�Zddd�dd�Zdd dd�dd�Zdd d �d d �Zd$dddd d d!�d"d#�ZdS )%a� Machinery for documenting traitlets config options with Sphinx. This includes: - A Sphinx extension defining directives and roles for config options. - A function to generate an rst file given an Application instance. To make this documentation, first set this module as an extension in Sphinx's conf.py:: extensions = [ # ... 'traitlets.config.sphinxdoc', ] Autogenerate the config documentation by running code like this before Sphinx builds:: from traitlets.config.sphinxdoc import write_doc from myapp import MyApplication writedoc('config/options.rst', # File to write 'MyApp config options', # Title MyApplication() ) The generated rST syntax looks like this:: .. configtrait:: Application.log_datefmt Description goes here. Cross reference like this: :configtrait:`Application.log_datefmt`. � )� annotationsN)� defaultdict)�dedent)� HasTraits� Undefined)� Application)�indentzt.Anyzdict[str, t.Any])�app�returnc C s | j dddd� ddd�S )z�Registers the Sphinx extension. You shouldn't need to call this directly; configure Sphinx to use this module instead. Z configtraitz Config option)ZobjnameT)Zparallel_read_safeZparallel_write_safe)Zadd_object_type)r � r ��/root/rpmbuild/BUILDROOT/imh-python39-modules-3.9.7-92.el8.x86_64/opt/imh-python/lib/python3.9/site-packages/traitlets/config/sphinxdoc.py�setup. s r �bool)�dvr c C s4 | d u s| t u rdS t| tttttf�r0t| �S dS )NFT)r � isinstance�str�list�tuple�dict�setr )r r r r �interesting_default_value8 s r z list[str]r )�aliasesr c C sB g }| D ].}t |�dkr dnd}|�d|� |� d�� qd�|�S )N� �-z--z``�, )�len�append�join)r Zfmted�a�dashesr r r �format_aliases@ s r ztype[HasTraits])�cls� trait_aliasesr c C sj g }| j }t| jdd��� �D �]>\}}|jj }|d |jp>d }|d| dg7 }|j�� p^d}|�t t |��d � d|v r�|�t d d � d d � |j D �� �� n|�t d | �� t |j��r,z |�� } W n ty� d} Y n0 | du�r,t| �dk�r| dd� d } | �dd�} |�t d| �� || �rTt|| �} |�t d| �� |�d� q d� |�S )zoGenerate rST documentation for this class' config options. Excludes traits defined on parent classes. T)�config�.� z.. configtrait:: zNo description� �Enumz :options: r c s s | ]}d | V qdS )z``%r``Nr )�.0�xr r r � <genexpr>[ � z'class_config_rst_doc.<locals>.<genexpr>z :trait type: N�@ �= z...z\nz\\nz:default: ``%s``z :CLI option: )�__name__�sortedZ class_traits�items� __class__�name�help�rstripr r r r �valuesr � default_valueZdefault_value_repr� Exceptionr �replacer ) r! r" �lines� classname�_�trait�ttype�fullnamer3 ZdvrZ fmt_aliasesr r r �class_config_rst_docH s4 & r? r zdict[str, list[str]]c C s� t t�}| j�� D ]\}}|| �|� q| j�� D ]f\}\}}t|�dkr4tt|��}|| }t|�dkr4tt|��} || du r4||d | �|� q4|S )zBProduce a mapping of trait names to lists of command line aliases.r Tr$ ) r r r r0 r �flagsr �next�iter) r �res�aliasr< �flag�cfgr; r: Zcls_cfgZ traitnamer r r �reverse_aliasesx s rG z str | None�None)�path�titler �preambler c C s� t |�}t| d��|}|�|d � |�dt|� d � |�d� |durX|�|d � |�� D ] }|�t||�� |�d� q`W d � n1 s�0 Y dS )a� Write a rst file documenting config options for a traitlets application. Parameters ---------- path : str The file to be written title : str The human-readable title of the document app : traitlets.config.Application An instance of the application class to be documented preamble : str Extra text to add just after the title (optional) �wr& �=Nz )rG �open�writer Z_classes_inc_parentsr? )rI rJ r rK r" �f�cr r r � write_doc� s rR )N)�__doc__� __future__r �typing�t� collectionsr �textwrapr Z traitletsr r Z traitlets.config.applicationr Ztraitlets.utils.textr r r r r? rG rR r r r r �<module> s " 0
| ver. 1.1 | |
.
| PHP 8.3.30 | Ð“ÐµÐ½ÐµÑ€Ð°Ñ†Ð¸Ñ Ñтраницы: 0 |
proxy
|
phpinfo
|
ÐаÑтройка