| Server IP : 217.160.0.135 / Your IP : 216.73.217.85 Web Server : Apache System : Linux www 6.18.52-i1-ampere #1203 SMP Mon Sep 14 18:29:59 CEST 2026 aarch64 User : sws1074145052 ( 1074145052) PHP Version : 8.3.32 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : ON | Perl : ON | Python : OFF | Sudo : OFF | Pkexec : OFF Directory : /usr/lib/python3/dist-packages/traitlets/utils/__pycache__/ |
Upload File : |
�
� Uc � �@ � d dl Z d dlZd dlZdd�Zd� Zd� Zd d�Zd� ZdS )
� NFc � � t | t � � r| � � � } t j |� � st |� � j }n|j }|rt |� � |z }| dk s| ��<t j |� � �s'|� |� d|� �}| �t |d|� � S |S d}t j |� � r|j }n�t |t j
� � r
|j }d}n�t |t j � � r|j j }d}n_t |� � j
t j
t
j
fv r"dt t! |� � � � z }d}nt# |� � }d}|rt |� � |z }|r|� d� � }t' | ||||�� � S | d v s| �| �|S t |d|� � S t) d
| z � � �) a� Return string that describes a value
Parameters
----------
article : str or None
A definite or indefinite article. If the article is
indefinite (i.e. "a" or "an") the appropriate one
will be infered. Thus, the arguments of ``describe``
can themselves represent what the resulting string
will actually look like. If None, then no article
will be prepended to the result. For non-articled
description, values that are instances are treated
definitely, while classes are handled indefinitely.
value : any
The value which will be named.
name : str or None (default: None)
Only applies when ``article`` is "the" - this
``name`` is a definite reference to the value.
By default one will be infered from the value's
type and repr methods.
verbose : bool (default: False)
Whether the name should be concise or verbose. When
possible, verbose names include the module, and/or
class name where an object was defined.
capital : bool (default: False)
Whether the first letter of the article should
be capitalized or not. By default it is not.
Examples
--------
Indefinite description:
>>> describe("a", object())
'an object'
>>> describe("a", object)
'an object'
>>> describe("a", type(object))
'a type'
Definite description:
>>> describe("the", object())
"the object at '...'"
>>> describe("the", object)
'the object object'
>>> describe("the", type(object))
'the type type'
Definitely named description:
>>> describe("the", object(), "I made")
'the object I made'
>>> describe("the", object, "I will use")
'the object I will use'
�theN� TFzat '%s'z'')�name�verbose�capital)�a�anzAThe 'article' argument should be 'the', 'a', 'an', or None not %r)�
isinstance�str�lower�inspect�isclass�type�__name__�_prefix� add_article�types� FunctionType�
MethodType�__func__�__repr__�object�hex�id�repr�join�describe�
ValueError)�article�valuer r r �typename�result� tick_wraps �>/usr/lib/python3/dist-packages/traitlets/utils/descriptions.pyr r s � �p �'�3� � � "��-�-�/�/�� �?�5� !� !� "���;�;�'����>��� -��5�>�>�H�,���%���G�O�G�O�E�4J�4J�O� � � �)�)�4�)�)�F��"�"�6�4��9�9�9� �
� �I���u�%�%�
� �~����E�5�#5�6�6�
� �~�� � � ��E�5�#3�4�4�
� �~�.�� � � ��e���%����
�*� � � !�3�r�%�y�y�>�>�1�� ����E�{�{�� ���
-� �u�~�~��,���
'��y�y������G�U��w�PW�X�X�X� X� �K� � �7�?� �?��O��8�U�G�4�4�4�� O�RY� Y�
�
�
� c �� � t | t j � � rt d | j d�� � dz }n.t j | � � }|�|j dk r |j dz }nd}|S )NT)r �.�builtins� )r r r r �__self__r � getmoduler )r! r �modules r% r r q sn � ��%��)�*�*� ���e�n�d�;�;�;�c�A����"�5�)�)�� � �&�/�Z�"?�"?��?�S�(�D�D��D� �Kr& c � � t j | � � rt | j � � S t t | � � � � S )zsReturns a string of the value's type with an indefinite article.
For example 'an Image' or 'a PlotValue'.
)r r r r �class_ofr )r! s r% r/ r/ } s: � �
��u� � � %��5�>�*�*�*���U� � �$�$�$r& c � � |rd| z }nQt j d� � � d| � � }|dd� � � � dv rd| z }nd| z }|r%|d � � � |dd� z S |S )
a� Returns the string with a prepended article.
The input does not need to begin with a charater.
Parameters
----------
name : str
Name to which to prepend an article
definite : bool (default: False)
Whether the article is definite or not.
Indefinite articles being 'a' and 'an',
while 'the' is definite.
capital : bool (default: False)
Whether the added article should have
its first letter capitalized or not.
zthe z[\W_]+r* N� �aeiouzan za r )�re�compile�subr
�upper)r �definiter r# �
first_letterss r% r r � s� � �" � !��$� ����
�9�-�-�1�1�"�d�;�;�
� ��!�� � "� "� $� $�� /� /��T�\�F�F��D�[�F�� ��a�y��� � �6�!�"�"�:�-�-��
r& c �2 � t | � � }| �d|��}|S )z]Return a string representation of a value and its type for readable
error messages.
r )r )�obj�the_type�msgs r% � repr_typer= � s' � �
�C�y�y�H�
�
!�
!�X�
!�
!�C� �Jr& )NFF)FF)r r3 r r r r/ r r= � r& r% �<module>r? s� �� ���� � � � � � � � �h
� h
� h
� h
�V � � �%� %� %� � � � �>� � � � r&