← Back
Editing: descriptions.cpython-311.pyc
� � 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&
Save File
Cancel