Файловый менеджер - Редактировать - /opt/imh-python/lib/python3.9/site-packages/traitlets/config/__pycache__/configurable.cpython-39.pyc
Ðазад
a _�h�W � @ s0 d Z ddlmZ ddlZddlZddlmZ ddlm Z ddl m Z m Z m Z mZmZmZmZmZmZmZ ddlmZ ddlmZ dd lmZmZ d d l m Z m Z m Z m Z ej!r�ej"ej#ej$ej f Z%nej Z%G d d � d e&�Z'G dd� de'�Z(G dd� de�Z)G dd� de)�Z*ej+ddd�Z,G dd� de*�Z-dS )z/A base class for objects that are configurable.� )� annotationsN)�deepcopy)�dedent) �Any� Container�Dict� HasTraits�Instance� TraitType�default�observe�observe_compat�validate)�warnings)�Bunch)�indent�wrap_paragraphs� )�Config�DeferredConfig�LazyConfigValue�_is_section_keyc @ s e Zd ZdS )�ConfigurableErrorN��__name__� __module__� __qualname__� 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/configurable.pyr ( s r c @ s e Zd ZdS )�MultipleInstanceErrorNr r r r r r , s r c s$ e Zd Zeedi �Zeddd�Zddd�� fdd � Zed d �d d ��Z ddd�dd�Z d7ddddd�dd�Z e d�e ddd�dd ���Zddd �d d �Zed8d d!d"�d#d$��Zed9d%d d&d!d'�d(d)��Zed:d dd"�d*d+��Zed%d,d-d.�d/d0��Zed;d1d!d2�d3d4��Zed!d �d5d6��Z� ZS )<� Configurabler z*traitlets.config.configurable.ConfigurableT)� allow_none�t.Any�None)�kwargs�returnc s� �� dd�}|dur4��dd�du r.|j�d< || _�� dd�}t� jf i ��� t� � ddd�� �fdd� }| �|� |dur�|| _n | �| j� | � |� � D ]}t | |�| � q�dS ) a� Create a configurable given a config config. Parameters ---------- config : Config If this is empty, default values are used. If config is a :class:`Config` instance, it will be used to configure the instance. parent : Configurable instance, optional The parent Configurable instance of this object. Notes ----- Subclasses of Configurable must call the :meth:`__init__` method of :class:`Configurable` *before* doing anything else and using :func:`super`:: class MyConfigurable(Configurable): def __init__(self, config=None): super(MyConfigurable, self).__init__(config=config) # Then any other code you need to finish initialization. This ensures that instances will be configured properly. �parentN�configr r# ��changer% c s | j �v r� �| j � dS )z�Record traits set by both config and kwargs. They will need to be overridden again after loading config. N)�name�add)r) �Zconfig_override_namesr$ r r �notice_config_overridea s z5Configurable.__init__.<locals>.notice_config_override) �pop�getr' r& �super�__init__�setr � _load_configZ unobserve�setattr)�selfr$ r& r' r- r* �� __class__r, r r1 9 s zConfigurable.__init__z list[str]�r% c s � fdd�t � j�D �S )z return section names as a listc s& g | ] }t |t�rt � |�r|j�qS r �� issubclassr r )�.0�c��clsr r � <listcomp>� s �z.Configurable.section_names.<locals>.<listcomp>)�reversed�__mro__r= r r= r � section_names� s �zConfigurable.section_namesr )�cfgr% c C sX |g}| j r |�| j �|�� t� }|D ]*}| �� D ] }|�|�r4|�|| � q4q(|S )a� extract my config from a global Config object will construct a Config object of only the config values that apply to me based on my mro(), as well as those of my parent(s) if they exist. If I am Bar and my parent is Foo, and their parent is Tim, this will return merge following config sections, in this order:: [Bar, Foo.Bar, Tim.Foo.Bar] With the last item being the highest priority. )r& �append�_find_my_configr rB Z _has_section�merge)r5 rC Zcfgs� my_configr< Zsnamer r r rE � s z Configurable._find_my_configNzlist[str] | Nonez)dict[str, TraitType[t.Any, t.Any]] | None)rC rB �traitsr% c C s� |du r| j dd�}|du r$| �� }| �|�}| �� ��: |�� D �] \}}||v r�t|t�rtt| |�}|�|�}nt|t �r�|�|| �}t | |t |�� qBt |�sBt|t �sBddlm} t| t�r�| jdus�J �| jj} nddd�d d �} |||�} d |� d | jj� d �} t| �dk�r2| d| d � d�7 } n(t| �dk�rZ| djd�t| ��d�7 } | | � qBW d � n1 �sz0 Y dS )z load traits from a Config objectNT�r' r )�get_close_matchesr" r# )�msgr% c S s t j| tdd�S )N� �� stacklevel)r �warn� UserWarning)rK r r r rO � s z'Configurable._load_config.<locals>.warnzConfig option `z` not recognized by `z`.r z Did you mean `z`?z# Did you mean one of: `{matches}`?�, )�matches)rH rB rE Zhold_trait_notifications�items� isinstancer �getattr� get_valuer r4 r r r �difflibrJ �LoggingConfigurable�log�warningr7 r �len�format�join�sorted) r5 rC rB rH rG r* Z config_value�initialrJ rO rR rK r r r r3 � s: �zConfigurable._load_configr' r r( c C s* | j dd�}| �� }| j|j||d� dS )z�Update all the class traits having ``config=True`` in metadata. For any class trait with a ``config`` metadata attribute that is ``True``, we update the trait with the value of the corresponding config entry. TrI )rH rB N)rH rB r3 �new)r5 r) rH rB r r r �_config_changed� s z Configurable._config_changed)r' r% c C s& t | j�| _| �|� | j�|� dS )z%Update config and load the new valuesN)r r' r3 rF )r5 r' r r r � update_config� s zConfigurable.update_configzHasTraits | None�str)�instr% c C s� |du st || �sJ �g }d�dd� | jD ��}|�| j� d|� d�� |�t|d �d � t| jd d ��� �D ] \}}| � ||�}|�|� qrd �|�S ) z�Get the help string for this class in ReST format. If `inst` is given, its current trait values will be used in place of class defaults. NrQ c s s | ] }|j V qd S �N)r �r; �pr r r � <genexpr> � z.Configurable.class_get_help.<locals>.<genexpr>�(z ) optionsr �-TrI � ) rT r] � __bases__rD r r[ r^ � class_traitsrS �class_get_trait_help)r> rd Z final_helpZ base_classes�_�v�helpr r r �class_get_help� s zConfigurable.class_get_helpzTraitType[t.Any, t.Any]z str | None)�traitrd �helptextr% c C s� |du st || �sJ �g }d| j� d|j� �}t |ttf�r�|j�dd�}t |t�rZd}nd|jj�� }|dkr�|� d|� d �}q�|� d |� d �}n|� d |jj� d �}|� |� |du r�|j }|d kr�d� t |d��}|� t |�� d|jjv �r |� t d|�� �� |du�r:|� t dt||j�p,d ����� n`z |�� }W n t�y^ d}Y n0 |du�r�t|�dk�r�|dd� d }|� t d| �� d� |�S )a Get the helptext string for a single trait. :param inst: If given, its current trait values will be used in place of the class default. :param helptext: If not given, uses the `help` attribute of the current trait. Nz--�.� multiplicityrD z<key-1>=<value-1>z <%s-item-1>�=�...� z=<�>� rl �L �Enumz Choices: %sz Current: �@ �= z Default: %s)rT r r* r r �metadatar/ r7 �lowerrD rr r] r r �inforU �default_value_repr� Exceptionr[ ) r> rt rd ru �lines�headerrw Z sample_value�dvrr r r ro s> $ z!Configurable.class_get_trait_helpc C s t | �|�� dS )z4Get the help string for a single trait and print it.N)�printrs )r> rd r r r �class_print_helpD s z Configurable.class_print_helpzt.Sequence[type[HasTraits]]ztype[Configurable])rt �classesr% c C sT | }|j dusJ �| �� D ]4}t|t�r||v r|jdd��|j d�|u r|}q|S )a7 Get the class that defines a trait For reducing redundant help output in config files. Returns the current class if: - the trait is defined on this class, or - the class where it is defined would not be in the config file Parameters ---------- trait : Trait The trait to look for classes : list The list of other classes to consider for redundancy. Will return `cls` even if it is not defined on `cls` if the defining class is not in `classes`. NTrI )r* �mror: r Zclass_own_traitsr/ )r> rt r� Z defining_clsr& r r r �_defining_classI s ���z Configurable._defining_classz"t.Sequence[type[HasTraits]] | None)r� r% c C s� ddd�dd�}d}d� dd� | jD ��}d | j� d |� d �}|||g}| �� �d �}|r`|j}|spt| d d�}|r�|�||�� |�d� t| jdd�� � �D ]�\}} | � � } |r�| � | |�} n| } | | u �r| j r�|�|| j �� dt | �jv �r|�d| �� � |�d| � n<| j �r<|�|| j �dd�d �� |�d| j� d|� �� |�d| j� d|� d| � �� |�d� q�d� |�S )z�Get the config section for this class. Parameters ---------- classes : list, optional The list of other classes in the config file. Used to reduce redundant information. rc )�sr% c S s d� t| d��} d| �dd� S )z"return a commented, wrapped block.z �N z## rl z # )r] r �replace)r� r r r r< s s z,Configurable.class_config_section.<locals>.czO#------------------------------------------------------------------------------rQ c s s | ]}t |t�r|jV qd S re r9 rf r r r rh { ri z4Configurable.class_config_section.<locals>.<genexpr>z# rj z) configuration� description�__doc__r| TrI r~ z# Choices: %sz# Default: %srl r r z # See also: rv z# c.z = )r] rm r rn r/ � default_valuerU rD r^ rS r� r� rr �typer� �split) r> r� r< ZbreakerZparent_classesr� r� �descr* rt Z default_repr�defining_classr r r �class_config_sectionh s< z!Configurable.class_config_sectionc C s g }| j }t| jdd��� �D ]�\}}|jj }|js6q |d |j }d|v r^|d|�� 7 }n |d| 7 }|�|� z |�� }W n t y� d}Y n0 |dur�t |�dkr�|dd� d }|� d d �}|�t d | �� |�d � |j p�d}|�t t|��� |�d � q d�|�S )zwGenerate rST documentation for this class' config options. Excludes traits defined on parent classes. TrI rv r~ z : Nr r� ry z\nz\\nzDefault: ``%s``r| zNo descriptionrl )r r^ rn rS r7 r* Zinfo_rstrD r� r� r[ r� r rr r r] ) r> r� � classnamerp rt �ttypeZtermliner� rr r r r �class_config_rst_doc� s2 z!Configurable.class_config_rst_doc)NN)N)NN)N)N)r r r r r r' r& r1 � classmethodrB rE r3 r r ra rb rs ro r� r� r� r� � __classcell__r r r6 r r 5 s6 H �5 �8 ;r c @ sX e Zd ZdZeddd�Zed�ddd�d d ��Zed�dd �d d ��Z dd �dd�Z dS )rX z�A parent class for Configurables that log. Subclasses have a log trait, and the default behavior is to get the logger from the currently running Application. z Logger or LoggerAdapter instanceF)rr r! rY r � LoggerType)�proposalr% c C sD t |jtjtjf�s6tj| jj� d|j� d�t dd� t � t |j�S )Nz..log should be a Logger or LoggerAdapter, got rv � rM ) rT �value�logging�Logger� LoggerAdapterr rO r7 r rP �t�castr� )r5 r� r r r � _validate_log� s ��z!LoggingConfigurable._validate_logr8 c C s@ t | jt�r,| jd usJ �t�tj| jj�S ddlm} |� � S )Nr )rY ) rT r& rX r� r� r� r� rY Z traitletsZ get_logger)r5 rY r r r � _log_default� s z LoggingConfigurable._log_defaultzlogging.Handler | Nonec C s@ | j s dS t| j tj�r | j n| j j}t|dd�s6dS |jd S )z�Return the default Handler Returns None if none can be found Deprecated, this now returns the first log handler which may or may not be the default one. N�handlersr )rY rT r� r� �loggerrU r� )r5 r� r r r �_get_log_handler� s � z$LoggingConfigurable._get_log_handlerN) r r r r� r rY r r� r r� r� r r r r rX � s rX �CT�SingletonConfigurable)�boundc @ sb e Zd ZdZdZedd�dd��Zedd�dd ��Zed d d d d �dd��Zedd�dd��Z dS )r� z�A configurable that only allows one instance. This class is for classes that should only have one instance of itself or *any* subclass. To create and retrieve such a class use the :meth:`SingletonConfigurable.instance` method. Nz4t.Generator[type[SingletonConfigurable], None, None]r8 c c s4 | � � D ]&}t| |�rt|t�r|tkr|V qdS )zfWalk the cls.mro() for parent classes that are also singletons For use in instance() N)r� r: r� �r> �subclassr r r � _walk_mro s ���z SingletonConfigurable._walk_mror# c C s0 | � � s dS | �� D ]}t|j| �rd|_qdS )z5unset _instance for this class and singleton parents.N)� initializedr� rT � _instancer� r r r �clear_instance s z$SingletonConfigurable.clear_instanceztype[CT]r" r� )r> �argsr$ r% c O s` | j du r,| |i |��}| �� D ] }||_ q t| j | �r>| j S td| j� dt| j �j� ���dS )a� Returns a global instance of this class. This method create a new instance if none have previously been created and returns a previously created instance is one already exists. The arguments and keyword arguments passed to this method are passed on to the :meth:`__init__` method of the class upon instantiation. Examples -------- Create a singleton class using instance, and retrieve it:: >>> from traitlets.config.configurable import SingletonConfigurable >>> class Foo(SingletonConfigurable): pass >>> foo = Foo.instance() >>> foo == Foo.instance() True Create a subclass that is retrieved using the base class instance:: >>> class Bar(SingletonConfigurable): pass >>> class Bam(Bar): pass >>> bam = Bam.instance() >>> bam == Bar.instance() True Nz An incompatible sibling of 'z(' is already instantiated as singleton: )r� r� rT r r r� )r> r� r$ rd r� r r r �instance) s ��z SingletonConfigurable.instance�boolc C s t | d�o| jduS )z Has an instance been created?r� N)�hasattrr� r= r r r r� U s z!SingletonConfigurable.initialized) r r r r� r� r� r� r� r� r� r r r r r� s +).r� � __future__r r� �typingr� �copyr �textwrapr Ztraitlets.traitletsr r r r r r r r r r Ztraitlets.utilsr Ztraitlets.utils.bunchr Ztraitlets.utils.textr r �loaderr r r r � TYPE_CHECKING�Unionr� r� r� r� r r r rX �TypeVarr� r� r r r r �<module> s, 0 1
| ver. 1.1 | |
.
| PHP 8.3.30 | Ð“ÐµÐ½ÐµÑ€Ð°Ñ†Ð¸Ñ Ñтраницы: 0 |
proxy
|
phpinfo
|
ÐаÑтройка