traitlets.pyc
1 o 2 ��c�� � @ s� d Z ddlZddlZddlZddlZddlZddlZddlZddlZ ddl 3 m Z ddl m Z mZ ddlmZ ddlmZmZmZmZ ddlmZ dd lmZ dd 4 lmZ e e e e fZ e!fZ"g d �Z#ed d d�Z$edd d�Z%e$Z&G dd� de'�Z(e�)d�Z*dd� Z+e � Z,dd� Z-dd� Z.dd� Z/d d � Z0d d � Z1G d d!� d!�Z2d�d"d#�Z3d$d%� Z4G d&d'� d'�Z5G d(d)� d)�Z6e6Z7G d*d+� d+�Z8G d,d-� d-e8�Z9G d.d/� d/�Z:d0d1� Z;G d2d3� d3e!�Z<G d4d5� d5e<�Z=d6d7�d8e j>ee?f d9e?d:d;fd<d=�Z@d>d?� ZAd8e j>ee?f d:d@fdAdB�ZBdCe?d:dDfdEdF�ZCG dGdH� dHe8�ZDG dId;� d;eD�ZEG dJd@� d@eD�ZFG dKdD� dDeD�ZGG dLdM� dMe<dN�ZHG dOdP� dPeHe=dN�ZIG dQdR� dRe9�ZJG dSdT� dTeJ�ZKG dUdV� dVeJ�ZLG dWdX� dX�ZMG dYdZ� dZeMeK�ZNG d[d\� d\eMeL�ZOG d]d^� d^eJ�ZPG d_d`� d`e9�Z>G dadb� dbe9�ZQdcdd� ZRG dedf� dfe9�ZSG dgdh� dheS�ZTeSeTZUZVeSZWG didj� dje9�ZXG dkdl� dleX�ZYG dmdn� dne9�ZZG dodp� dpeZ�Z[G dqdr� dre9�Z\G dsdt� dte\�Z]G dudv� dve9�Z^G dwdx� dxe^�Z_G dydz� dze9�Z`G d{d|� d|e`�ZaG d}d~� d~e9�ZbG dd�� d�eb�ZcG d�d�� d�e9�ZdG d�d�� d�ed�ZeG d�d�� d�ed�ZfG d�d�� d�eL�ZgG d�d�� d�eg�ZhG d�d�� d�eh�ZiG d�d�� d�eg�ZjG d�d�� d�eL�ZkG d�d�� d�e9�ZlG d�d�� d�e9�ZmG d�d�� d�e9�ZnG d�d�� d�e9�ZodS )�a� 5 A lightweight Traits like module. 6 7 This is designed to provide a lightweight, simple, pure Python version of 8 many of the capabilities of enthought.traits. This includes: 9 10 * Validation 11 * Type specification with defaults 12 * Static and dynamic notification 13 * Basic predefined types 14 * An API that is similar to enthought.traits 15 16 We don't support: 17 18 * Delegation 19 * Automatic GUI generation 20 * A full set of trait types. Most importantly, we don't provide container 21 traits (list, dict, tuple) that can trigger notifications if their 22 contents change. 23 * API compatibility with enthought.traits 24 25 There are also some important difference in our design: 26 27 * enthought.traits does not validate default values. We do. 28 29 We choose to create this module because we need these capabilities, but 30 we need them to be pure Python so they work in all Python implementations, 31 including Jython and IronPython. 32 33 Inheritance diagram: 34 35 .. inheritance-diagram:: traitlets.traitlets 36 :parts: 3 37 � N)� literal_eval)�warn� warn_explicit� )�Bunch)� add_article�class_of�describe� repr_type)� 38 getargspec�� import_item)�Sentinel);�All�Any�BaseDescriptor�Bool�Bytes�CBool�CBytes�CComplex�CFloat�CInt�CLong�CRegExp�CUnicode�Callable�CaselessStrEnum�ClassBasedTraitType�Complex� Container�DefaultHandler�Dict�DottedObjectName�Enum� EventHandler�Float�ForwardDeclaredInstance�ForwardDeclaredMixin�ForwardDeclaredType� FuzzyEnum�HasDescriptors� HasTraits�Instance�Int�Integer�List�Long�MetaHasDescriptors� MetaHasTraits� 39 ObjectName�ObserveHandler�Set� 40 TCPAddress�This� 41 TraitError� TraitType�Tuple�Type�Unicode� Undefined�Union�UseEnum�ValidateHandler�default�directional_link�dlink�link�observe�observe_compat�parse_notifier_name�validater> � traitletszA 42 Used in Traitlets to specify that no defaults are set in kwargs 43 r zi 44 Used in Traitlets to listen to all types of notification or to notifications 45 from all trait attributes. 46 c @ s e Zd ZdS )r9 N)�__name__� 47 __module__� __qualname__� rN rN ��C:\Users\Jacks.GUTTSPC\AppData\Local\Packages\PythonSoftwareFoundation.Python.3.10_qbz5n2kfra8p0\LocalCache\local-packages\Python310\site-packages\traitlets\traitlets.pyr9 � s r9 z[a-zA-Z_][a-zA-Z0-9_]*$c C � | � � S �N�� isidentifier��srN rN rO rS � � rS c C s6 t j�d�}|r|dkrdS | tvrt�| � dS dS )zZAdd our own checks for too many deprecation warnings. 48 49 Limit to once per package. 50 ZTRAITLETS_ALL_DEPRECATIONS�0TF)�os�environ�get�_deprecations_shown�add)�keyZenv_flagrN rN rO � _should_warn� s 51 r^ c 52 C s� dj |j||d�}t�|�D ] }||jv r|} nq|j�dd�d }||f}t|�s-dS zt�| �p4d}t� | �d p=d} W n t 53 t fy] } 54 zt |d| 55 t � W Y d} 56 ~ 57 dS d} 58 ~ 59 ww t|t || � dS ) z�Show deprecation warning about a magic method definition. 60 61 Uses warn_explicit to bind warning to method definition instead of triggering code, 62 which isn't relevant. 63 z?{classname}.{method_name} is deprecated in traitlets 4.1: {msg})� classname� method_name�msg�.r r Nz <unknown>z 64 (inspection failed) %s)�formatrK �inspect�getmro�__dict__rL �splitr^ � getsourcefile�getsourcelines�OSError� TypeErrorr �DeprecationWarningr ) �method�clsr` ra Zwarn_msg�parent� package_namer] �fname�lineno�erN rN rO �_deprecated_method� s( � 65 � ��rt c 66 C s( zt | �W S tttfy | Y S w )zwSafely evaluate an expression 67 68 Returns original string if eval fails. 69 70 Use only where types are ambiguous. 71 )r � NameError� SyntaxError� 72 ValueErrorrT rN rN rO �_safe_literal_eval� s 73 74 �rx c C s t | t�pt | t�ot| t�S )zHReturns whether the given value is an instance or subclass of TraitType.)� 75 isinstancer: �type� 76 issubclass)�trN rN rO �is_trait� s r} c C sN | t u s t| t�r | gS | rt | v rt gS | D ] }t|t�s$td| ��q| S )a Convert the name argument to a list of names. 77 78 Examples 79 -------- 80 >>> parse_notifier_name([]) 81 [traitlets.All] 82 >>> parse_notifier_name("a") 83 ['a'] 84 >>> parse_notifier_name(["a", "b"]) 85 ['a', 'b'] 86 >>> parse_notifier_name(All) 87 [traitlets.All] 88 z names must be strings, not %r)r ry �strrk )�names�nrN rN rO rH � s 89 �rH c @ s, e Zd Zdd� Zdd� Zdd� Zdd� Zd S ) 90 � _SimpleTestc C � 91 || _ d S rQ ��value��selfr� rN rN rO �__init__ � 92 z_SimpleTest.__init__c C s 93 || j kS rQ r� )r� �testrN rN rO �__call__ 94 r� z_SimpleTest.__call__c C s 95 d| j S )Nz<SimpleTest(%r)r� �r� rN rN rO �__repr__ r� z_SimpleTest.__repr__c C rP rQ )r� r� rN rN rO �__str__ rV z_SimpleTest.__str__N)rK rL rM r� r� r� r� rN rN rN rO r� s 96 r� c C sZ g }t | �D ] }zt| |�}W n ty Y qw |r ||�r&|�||f� q|�� |S )a A safe version of inspect.getmembers that handles missing attributes. 97 98 This is useful when there are descriptor based attributes that for 99 some reason raise AttributeError even though they exist. This happens 100 in zope.inteface with the __provides__ attribute. 101 )�dir�getattr�AttributeError�append�sort)�object� predicate�resultsr] r� rN rN rO � 102 getmembers s � �r� c G sf | D ].}t |�dkstdt ��|\}}t|t�s!tdt|� ��||�� vr0t|�d|����qdS )z.Validate arguments for traitlet link functions� zKEach linked traitlet must be specified as (HasTraits, 'trait_name'), not %rz%Each object must be HasTraits, not %rz has no trait N)�lenrk r| ry r, rz �traits)�tuples�tup�obj� 103 trait_namerN rN rO �_validate_link( s � 104 ��r� c @ sL e Zd ZdZdZddd�Zdd� Zejdd � �Z d 105 d � Z 106 d d � Z dd� Z dS )rE aR Link traits from different objects together so they remain in sync. 107 108 Parameters 109 ---------- 110 source : (object / attribute name) pair 111 target : (object / attribute name) pair 112 transform: iterable with two callables (optional) 113 Data transformation between source and target and target and source. 114 115 Examples 116 -------- 117 >>> class X(HasTraits): 118 ... value = Int() 119 120 >>> src = X(value=1) 121 >>> tgt = X(value=42) 122 >>> c = link((src, "value"), (tgt, "value")) 123 124 Setting source updates target objects: 125 >>> src.value = 5 126 >>> tgt.value 127 5 128 FNc C sB t ||� ||| _| _|r|ndd� fd \| _| _| �� d S )Nc S � | S rQ rN ��xrN rN rO �<lambda>T � z link.__init__.<locals>.<lambda>r� )r� �source�target� 129 _transform�_transform_invrE �r� r� r� � transformrN rN rO r� Q s 130 z link.__init__c 131 C s� z7t | jd | jd | �t| jd | jd ��� W | jd j| j| jd d� | jd j| j| jd d� d S | jd j| j| jd d� | jd j| j| jd d� w �Nr r �r )�setattrr� r� r� r� rF �_update_target�_update_sourcer� rN rN rO rE X s � � z link.linkc c �$ � d| _ z d V W d| _ d S d| _ w �NTF��updatingr� rN rN rO �_busy_updatingd � 132 �zlink._busy_updatingc C � | j rd S | �� �. t| jd | jd | �|j�� t| jd | jd �|jkr/td� | ���W d � d S 1 s:w Y d S )Nr r zCBroken link {}: the source value changed while updating the target.) 133 r� r� r� r� r� �newr� r� r9 rc �r� �changerN rN rO r� l � 134 ��"�zlink._update_targetc C r� )Nr r zCBroken link {}: the target value changed while updating the source.) 135 r� r� r� r� r� r� r� r� r9 rc r� rN rN rO r� w r� zlink._update_sourcec C s< | j d j| j| j d d� | jd j| j| jd d� d S r� )r� � unobserver� r� r� r� rN rN rO �unlink� s z link.unlinkrQ ) rK rL rM �__doc__r� r� rE � 136 contextlib�contextmanagerr� r� r� r� rN rN rN rO rE 6 s 137 138 rE c @ sD e Zd ZdZdZddd�Zdd� Zejdd � �Z d 139 d � Z 140 d d � Z dS )rC a� Link the trait of a source object with traits of target objects. 141 142 Parameters 143 ---------- 144 source : (object, attribute name) pair 145 target : (object, attribute name) pair 146 transform: callable (optional) 147 Data transformation between source and target. 148 149 Examples 150 -------- 151 >>> class X(HasTraits): 152 ... value = Int() 153 154 >>> src = X(value=1) 155 >>> tgt = X(value=42) 156 >>> c = directional_link((src, "value"), (tgt, "value")) 157 158 Setting source updates target objects: 159 >>> src.value = 5 160 >>> tgt.value 161 5 162 163 Setting target does not update source object: 164 >>> tgt.value = 6 165 >>> src.value 166 5 167 168 FNc C s6 |r|ndd� | _ t||� ||| _| _| �� d S )Nc S r� rQ rN r� rN rN rO r� � r� z+directional_link.__init__.<locals>.<lambda>)r� r� r� r� rE r� rN rN rO r� � s 169 zdirectional_link.__init__c 170 C sr z)t | jd | jd | �t| jd | jd ��� W | jd j| j| jd d� d S | jd j| j| jd d� w r� )r� r� r� r� r� rF �_updater� rN rN rO rE � s �>zdirectional_link.linkc c r� r� r� r� rN rN rO r� � r� z directional_link._busy_updatingc C sX | j rd S | �� � t| jd | jd | �|j�� W d � d S 1 s%w Y d S �Nr r )r� r� r� r� r� r� r� rN rN rO r� � s 171 172 ""�zdirectional_link._updatec C s | j d j| j| j d d� d S r� )r� r� r� r� rN rN rO r� � s zdirectional_link.unlinkrQ ) rK rL rM r� r� r� rE r� r� r� r� r� rN rN rN rO rC � s 173 174 175 rC c @ sV e Zd ZU dZdZeje ed< dZ ejej 176 ej ed< dd� Z dd� Z d d 177 � ZdS ) r a� Base descriptor class 178 179 Notes 180 ----- 181 This implements Python's descriptor protocol. 182 183 This class is the base class for all such descriptors. The 184 only magic we use is a custom metaclass for the main :class:`HasTraits` 185 class that does the following: 186 187 1. Sets the :attr:`name` attribute of every :class:`BaseDescriptor` 188 instance in the class dict to the name of the attribute. 189 2. Sets the :attr:`this_class` attribute of every :class:`BaseDescriptor` 190 instance in the class dict to the *class* that declared the trait. 191 This is used by the :class:`This` trait to allow subclasses to 192 accept superclasses for :class:`This` values. 193 N�name� 194 this_classc C s || _ || _dS )aE Part of the initialization which may depend on the underlying 195 HasDescriptors class. 196 197 It is typically overloaded for specific types. 198 199 This method is called by :meth:`MetaHasDescriptors.__init__` 200 passing the class (`cls`) and `name` under which the descriptor 201 has been assigned. 202 N)r� r� �r� rn r� rN rN rO � 203 class_init� s 204 205 zBaseDescriptor.class_initc C s |j �| j� d S rQ )�_instance_initsr� � instance_init�r� rn rN rN rO � subclass_init� s z BaseDescriptor.subclass_initc C s dS )aL Part of the initialization which may depend on the underlying 206 HasDescriptors instance. 207 208 It is typically overloaded for specific types. 209 210 This method is called by :meth:`HasTraits.__new__` and in the 211 :meth:`BaseDescriptor.instance_init` method of descriptors holding 212 other descriptors. 213 NrN �r� r� rN rN rO r� s 214 z BaseDescriptor.instance_init)rK rL rM r� r� r| �Optionalr~ �__annotations__r� r< r r� r� r� rN rN rN rO r � s 215 r c @ s� e Zd ZU dZi Zejeejf e d< dZ 216 dZ dZ e Zejej e d< e ddddfdd�Zd d 217 � Zd+d d �Zd d� Zdd� Zd+dd�Zd+dd�Zdd� Zdd� Zdd� Zdd � Zd d � Zd d � Z d,d!d"�Z d+d#d$�Z d%d&� Z d'd(� Z d)d*� Z!dS )-r: z!A base class for all trait types.�metadataF� any value� default_valueNc K sT |t ur|| _|r || _|dur|| _|dur|nd| _| jr#| j| _t|�dkr�d}t�� }|dus5J �|j j 218 dkrN|d7 }|j }|dusHJ �|j j 219 dks;|j � d�pUd} | �dd�d } 220 td| 221 gt|� �} t| �rvtd |f t|d 222 � t| j�dkr�| j�� | _| j�|� n 223 || _n| j�� | _|dur�|| jd < |dur�|| jd < dS dS ) a Declare a traitlet. 224 225 If *allow_none* is True, None is a valid value in addition to any 226 values that are normally valid. The default is up to the subclass. 227 For most trait types, the default value for ``allow_none`` is False. 228 229 If *read_only* is True, attempts to directly modify a trait attribute raises a TraitError. 230 231 Extra metadata can be associated with the traitlet using the .tag() convenience method 232 or by using the traitlet instance's .metadata dictionary. 233 N� r r r� rK rb z metadata-tagz�metadata %s was set from the constructor. With traitlets 4.1, metadata should be set using the .tag() method, e.g., Int().tag(key1='value1', key2='value2')�� 234 stacklevel�config�help)r> r� � 235 allow_none� read_onlyr� r� r� rd � currentframe�f_code�co_name�f_back� f_globalsrZ rg �tuple�sortedr^ r rl r� �copy�update) r� r� r� r� r� r� �kwargsr� �f�mod�pkgr] rN rN rO r� sN ��� 236 �zTraitType.__init__c C s | j r |dkr dS |S )a 237 Get a value from a config string 238 239 such as an environment variable or CLI arguments. 240 241 Traits can override this method to define their own 242 parsing of config strings. 243 244 .. seealso:: item_from_string 245 246 .. versionadded:: 5.0 247 �NoneN�r� �r� rU rN rN rO � from_stringX s zTraitType.from_stringc C s( | j tur| j S t| d�r| �� S | j S )z�The default generator for this trait 248 249 Notes 250 ----- 251 This method is registered to HasTraits classes during ``class_init`` 252 in the same way that dynamic defaults defined by ``@default`` are. 253 �make_dynamic_default)r� r> �hasattrr� r� rN rN rO rB h s 254 255 256 zTraitType.defaultc C s t dtdd� | jS )zmDEPRECATED: Retrieve the static default value for this trait. 257 Use self.default_value instead 258 zRget_default_value is deprecated in traitlets 4.0: use the .default_value attributer� r� )r rl r� r� rN rN rO �get_default_valuex s �zTraitType.get_default_valuec C s, t dtdd� | �|| j�}||j| j< |S )z<DEPRECATED: Set the static default value for the trait type.zSinit_default_value is deprecated in traitlets 4.0, and may be removed in the futurer� r� )r rl � _validater� � _trait_valuesr� �r� r� r� rN rN rO �init_default_value� s � z TraitType.init_default_valuec C s� z |j | j }W |S tyM |�| j�}|tu r!tdtdd� |j}zd|_| �||�}W ||_n||_w ||j | j< |� t 259 | j||dd�� | Y S t y] } zt d�|�d }~ww )NzxExplicit using of Undefined as the default value is deprecated in traitlets 5.0, and may cause exceptions in the future.r� r� TrB )r� r� �ownerrz z=Unexpected error in TraitType: default value not set properly) r� r� �KeyError�trait_defaultsr> r rl �_cross_validation_lockr� �_notify_observersr � Exceptionr9 )r� r� rn r� rB r� rs rN rN rO rZ � s< " � � �� 260 ��z TraitType.getc C s |du r| S | � ||�S )aM Get the value of the trait by self.name for the instance. 261 262 Default values are instantiated when :meth:`HasTraits.__new__` 263 is called. Thus by the time this method gets called either the 264 default value or a user defined value (they called :meth:`__set__`) 265 is in the :class:`HasTraits` instance. 266 N)rZ )r� r� rn rN rN rO �__get__� s zTraitType.__get__c C s� | � ||�}z|j| j }W n ty | j}Y nw ||j| j< zt||k�}W n ty4 d}Y nw |durC|�| j||� d S d S )NFT)r� r� r� r� r� �boolr� � _notify_trait)r� r� r� � new_value� old_value�silentrN rN rO �set� s 267 � ��z TraitType.setc C s$ | j r 268 td| j ��| �||� dS )z�Set the value of the trait by self.name for the instance. 269 270 Values pass through a validation stage where errors are raised when 271 impropper types, or types that cannot be coerced, are encountered. 272 z The "%s" trait is read-only.N)r� r9 r� r� r� rN rN rO �__set__� s zTraitType.__set__c C sB |d u r | j r |S t| d�r| �||�}|jdu r | �||�}|S )NrI F)r� r� rI r� �_cross_validater� rN rN rO r� � s 273 274 zTraitType._validatec C st | j |jv rt| ||d��}|j| j ||�}|S t|d| j �r8d| j }t||�}t||j|d� ||| �}|S )N)�traitr� r� � _%s_validate� use @validate decorator instead.)r� �_trait_validatorsr r� r� rt � __class__)r� r� r� �proposal� meth_nameZcross_validaterN rN rO r� � s � 275 276 � 277 zTraitType._cross_validatec C s& t |t�r t| g|j �S t| |g�S rQ �ry r? � trait_types�r� �otherrN rN rO �__or__� s 278 zTraitType.__or__c C s | j S rQ )� info_textr� rN rN rO �info� s zTraitType.infoc C s |durT| j | f7 _ | jdurRd�dd� |j dd� D ��}|dur>d| jtd|�||j d td |j d 279 �f f|_ |�d | j||j d td |j d 280 �f f|_ |�| jdu rct||p`| �� | ��|dur{d �| jt|�| �� td |��}t|��d �| j| �� td |��}t|��)a� Raise a TraitError 281 282 Parameters 283 ---------- 284 obj : HasTraits or None 285 The instance which owns the trait. If not 286 object is given, then an object agnostic 287 error will be raised. 288 value : any 289 The value that caused the error. 290 error : Exception (default: None) 291 An error that was raised by a child trait. 292 The arguments of this exception should be 293 of the form ``(value, info, *traits)``. 294 Where the ``value`` and ``info`` are the 295 problem value, and string describing the 296 expected value. The ``traits`` are a series 297 of :class:`TraitType` instances that are 298 "children" of this one (the first being 299 the deepest). 300 info : str (default: None) 301 A description of the expected value. By 302 default this is infered from this trait's 303 ``info`` method. 304 N� of c s s � | ]}t d |�V qdS )�aN)r )�.0r| rN rN rO � <genexpr> s � z"TraitType.error.<locals>.<genexpr>r� zDThe '%s' trait of %s instance contains %s which expected %s, not %s.�anr �ther z5The '%s' trait contains %s which expected %s, not %s.z2The '{}' trait of {} instance expected {}, not {}.z#The '{}' trait expected {}, not {}.)�argsr� �joinr r9 r 305 rc r )r� r� r� �errorr 306 �chainrs rN rN rO r sP 307 ������� 308 309 � ��zTraitType.errorc C s2 |dkrd}nd}t d| tdd� | j�||�S )znDEPRECATED: Get a metadata value. 310 311 Use .metadata[key] or .metadata.get(key, default) instead. 312 r� z3use the instance .help string directly, like x.helpzduse the instance .metadata dictionary directly, like x.metadata[key] or x.metadata.get(key, default)� Deprecated in traitlets 4.1, r� r� )r rl r� rZ )r� r] rB ra rN rN rO � get_metadataN � 313 zTraitType.get_metadatac C s2 |dkrd}nd}t d| tdd� || j|< dS )z[DEPRECATED: Set a metadata key/value. 314 315 Use .metadata[key] = value instead. 316 r� z;use the instance .help string directly, like x.help = valuezLuse the instance .metadata dictionary directly, like x.metadata[key] = valuer r� r� N)r rl r� )r� r] r� ra rN rN rO � set_metadataZ r zTraitType.set_metadatac K s< t |�� ��h d��}|rtd| tdd� | j�|� | S )a Sets metadata and returns self. 317 318 This allows convenient metadata tagging when initializing the trait, such as: 319 320 Examples 321 -------- 322 >>> Int(0).tag(config=True, sync=True) 323 <traitlets.traitlets.Int object at ...> 324 325 > r� r� r� r� zcThe following attributes are set in using `tag`, but seem to be constructor keywords arguments: %s r� r� )r� �keys� intersectionr � UserWarningr� r� )r� r� Zmaybe_constructor_keywordsrN rN rO �tagf s ��� z TraitType.tagc C s 326 t | j�S rQ )�reprr� r� rN rN rO �default_value_repr r� z TraitType.default_value_reprrQ )NN)"rK rL rM r� r� r| r" r~ r r� r� r� r r> r� r� r� r� rB r� r� rZ r� r� r� r� r� r r 327 r r r r r rN rN rN rO r: s< 328 329 �B 330 331 332 & 333 334 N r: c @ s( e Zd ZdZdd� Zdd� Zdd� ZdS ) �_CallbackWrapperz�An object adapting a on_trait_change callback into an observe callback. 335 336 The comparison operator __eq__ is implemented to enable removal of wrapped 337 callbacks. 338 c C sH || _ t| j tj�r dnd}tt|�d �| | _| jdkr"td��d S )N�����r � z1a trait changed callback must have 0-4 arguments.)�cbry �types� 339 MethodTyper� r �nargsr9 )r� r" �offsetrN rN rO r� � s 340 �z_CallbackWrapper.__init__c C s t |t�r | j|jkS | j|kS rQ )ry r r" r rN rN rO �__eq__� s 341 342 z_CallbackWrapper.__eq__c C s� | j dkr | �� d S | j dkr| �|j� d S | j dkr'| �|j|j� d S | j dkr8| �|j|j|j� d S | j dkrK| �|j|j|j|j� d S d S )Nr r r� � r! )r% r" r� r� �oldr� r� rN rN rO r� � s 343 344 345 346 347 �z_CallbackWrapper.__call__N)rK rL rM r� r� r' r� rN rN rN rO r � s 348 r c C s t | t�r| S t| �S rQ )ry r )r" rN rN rO �_callback_wrapper� s 349 r* c s4 e Zd ZdZ� fdd�Z� fdd�Zdd� Z� ZS )r2 z�A metaclass for HasDescriptors. 350 351 This metaclass makes sure that any TraitType class attributes are 352 instantiated and sets their name attribute. 353 c sP |� � D ]\}}t�|�r t|t�r tdtdd� |� ||< qt� �| |||�S )z Create the HasDescriptors class.�Traits should be given as instances, not types (for example, `Int()`, not `Int`). Passing types is deprecated in traitlets 4.1.r� r� ) �itemsrd �isclassr{ r: r rl �super�__new__)�mclsr� �bases� classdict�k�v�r rN rO r/ � s � 354 �zMetaHasDescriptors.__new__c s t � �|||� | �|� dS )z-Finish initializing the HasDescriptors class.N)r. r� � setup_class)rn r� r1 r2 r5 rN rO r� � s zMetaHasDescriptors.__init__c C sj g | _ g | _|�� D ]\}}t|t�r|�| |� q 355 t| �D ]\}}t|t�r2|�| � | j �|� q dS )z�Setup descriptor instance on the class 356 357 This sets the :attr:`this_class` and :attr:`name` attributes of each 358 BaseDescriptor in the class dict of the newly created ``cls`` before 359 calling their :attr:`class_init` method. 360 N) Z _descriptorsr� r, ry r r� r� r� r� )rn r2 r3 r4 �_rN rN rO r6 � s 361 � 362 363 ��z MetaHasDescriptors.setup_class)rK rL rM r� r/ r� r6 � __classcell__rN rN r5 rO r2 � s 364 r2 c s e Zd ZdZ� fdd�Z� ZS )r3 zA metaclass for HasTraits.c 365 s� i | _ i | _i | _i | _t� �|� | �� }t| �D �]+}zt| |�}W n t y- Y qw t 366 |t ��rF|| j|< |}d| }z|d |� |j �d � }W n tyV Y nw |D ]$}||jv rj|j| | j|< n�||j�di �v r}|j | | j|< n�qY|jd u o�|j} t|�ttfv r�|jd u r�|jd u r�t 367 |jt�s�| r�|j| j|< n�t|�ttfv r�|jd u r�|jd u r�t 368 |jt�s�| r�|j| j|< nxt|�t t fv r�t 369 |jt �s�| r�|j| j|< nat|�t t fv r�t 370 |jt!�s�| r�|j| j|< nJt|�t"k�rt 371 |jt!ttt f��s | �r|j| j|< n.t|�t#k�r%|jd u �r%d | j|< nt 372 |t$��r@|j%d u �r@|j&d u �r@|j�r@d | j|< |j'| j|< qd S )N� _%s_defaultr �_trait_default_generators)(r: � _all_trait_default_generators�_traits� _static_immutable_initial_valuesr. r6 �mror� r� r� ry r: �indexr� rw rf rZ r� r� rz r r. �min�max�intr r& �floatr r r� r r= r~ r r? r- � default_args�default_kwargsrB ) 373 rn r2 r> r� r� r� Zdefault_method_nameZ mro_trait�cZnone_okr5 rN rO r6 � s� � 374 � 375 � 376 377 378 379 �� 380 381 382 �� 383 �� 384 ���� � � 385 ��zMetaHasTraits.setup_class)rK rL rM r� r6 r8 rN rN r5 rO r3 � s r3 r� �rz r rz �returnr5 c G s@ |st d��|D ]}|turt|t�st d| ��qt|| d�S )a� A decorator which can be used to observe Traits on a class. 386 387 The handler passed to the decorator will be called with one ``change`` 388 dict argument. The change dictionary at least holds a 'type' key and a 389 'name' key, corresponding respectively to the type of notification and the 390 name of the attribute that triggered the notification. 391 392 Other keys may be passed depending on the value of 'type'. In the case 393 where type is 'change', we also have the following keys: 394 * ``owner`` : the HasTraits instance 395 * ``old`` : the old value of the modified trait attribute 396 * ``new`` : the new value of the modified trait attribute 397 * ``name`` : the name of the modified trait attribute. 398 399 Parameters 400 ---------- 401 *names 402 The str names of the Traits to observe on the object. 403 type : str, kwarg-only 404 The type of event to observe (e.g. 'change') 405 z2Please specify at least one trait name to observe.z5trait names to observe must be strings or All, not %rrG )rk r ry r~ r5 )rz r r� rN rN rO rF < s � rF c s t t f� fdd� }|S )aZ Backward-compatibility shim decorator for observers 406 407 Use with: 408 409 @observe('name') 410 @observe_compat 411 def _foo_changed(self, change): 412 ... 413 414 With this, `super()._foo_changed(self, name, old, new)` in subclasses will still work. 415 Allows adoption of new observer API without breaking subclasses that override and super. 416 c sF t |t�r|}n| jj}td||f t� td|||| d�}� | |�S )NzSA parent of %s._%s_changed has adopted the new (traitlets 4.1) @observe(change) APIr� )rz r) r� r� r� )ry �dictr rK r rl r )r� Zchange_or_namer) r� r� �clsname��funcrN rO �compatible_observerh s" 417 ��� 418 z+observe_compat.<locals>.compatible_observer)r> )rL rM rN rK rO rG Z s rG rA c G s< | st d��| D ]}|turt|t�st d| ��qt| �S )a� A decorator to register cross validator of HasTraits object's state 419 when a Trait is set. 420 421 The handler passed to the decorator must have one ``proposal`` dict argument. 422 The proposal dictionary must hold the following keys: 423 424 * ``owner`` : the HasTraits instance 425 * ``value`` : the proposed value for the modified trait attribute 426 * ``trait`` : the TraitType instance associated with the attribute 427 428 Parameters 429 ---------- 430 *names 431 The str names of the Traits to validate. 432 433 Notes 434 ----- 435 Since the owner has access to the ``HasTraits`` instance via the 'owner' key, 436 the registered cross validator could potentially make changes to attributes 437 of the ``HasTraits`` instance. However, we recommend not to do so. The reason 438 is that the cross-validation of attributes may run in arbitrary order when 439 exiting the ``hold_trait_notifications`` context, and such changes may not 440 commute. 441 z3Please specify at least one trait name to validate.z6trait names to validate must be strings or All, not %r)rk r ry r~ rA )r r� rN rN rO rI ~ s �rI r� r! c C s t | t�s td| ��t| �S )a, A decorator which assigns a dynamic default for a Trait on a HasTraits object. 442 443 Parameters 444 ---------- 445 name 446 The str name of the Trait on the object whose default should be generated. 447 448 Notes 449 ----- 450 Unlike observers and validators which are properties of the HasTraits 451 instance, default value generators are class-level properties. 452 453 Besides, default generators are only invoked if they are registered in 454 subclasses of `this_type`. 455 456 :: 457 458 class A(HasTraits): 459 bar = Int() 460 461 @default('bar') 462 def get_bar_default(self): 463 return 11 464 465 class B(A): 466 bar = Float() # This trait ignores the default generator defined in 467 # the base class A 468 469 class C(B): 470 471 @default('bar') 472 def some_other_default(self): # This default generator should not be 473 return 3.0 # ignored since it is defined in a 474 # class derived from B.a.this_class. 475 z*Trait name must be a string or All, not %r)ry r~ rk r! )r� rN rN rO rB � s 476 $ rB c @ s& e Zd Zdd� Zdd� Zddd�ZdS ) r% c C s 477 || _ | S rQ rK )r� rL rN rN rO � 478 _init_call� s zEventHandler._init_callc O s* t | d�r | j|i |��S | j|i |��S )zCPass `*args` and `**kwargs` to the handler's function if it exists.rL )r� rL rN )r� r r� rN rN rO r� � s 479 zEventHandler.__call__Nc C s |d u r| S t �| j|�S rQ )r# r$ rL )r� �instrn rN rN rO r� � s zEventHandler.__get__rQ )rK rL rM rN r� r� rN rN rN rO r% � s r% c @ � e Zd Zdd� Zdd� ZdS )r5 c C s || _ || _d S rQ )� trait_namesrz )r� r rz rN rN rO r� � s 480 zObserveHandler.__init__c C s |j | | j| jd� d S )NrG )rF rQ rz �r� rO rN rN rO r� � s z ObserveHandler.instance_initN�rK rL rM r� r� rN rN rN rO r5 � s c @ rP )rA c C r� rQ �rQ )r� r rN rN rO r� � r� zValidateHandler.__init__c C s |� | | j� d S rQ )�_register_validatorrQ rR rN rN rO r� � s z ValidateHandler.instance_initNrS rN rN rN rO rA � s c s$ e Zd Zdd� Z� fdd�Z� ZS )r! c C r� rQ )r� �r� r� rN rN rO r� � r� zDefaultHandler.__init__c s t � �||� | |j| j< d S rQ )r. r� r: r� r� r5 rN rO r� � s zDefaultHandler.class_init)rK rL rM r� r� r8 rN rN r5 rO r! � s c s< e Zd ZdZdejdejdejf� fdd� Zdd� Z� ZS ) r+ z5The base class for all classes that have descriptors.r r� rH c s^ | d }| dd � } t t|�j}|tju r||�}n ||g| �R i |��}|j| i |�� |S r� )r. r+ r/ r� �setup_instance)r r� rn �new_methrO r5 rN rO r/ � s 481 482 zHasDescriptors.__new__c O s8 | d }| dd� } d|_ |j}|jD ]}||� qdS )zD 483 This is called **before** self.__init__ is called. 484 r r NF)r� r r� )r r� r� rn �initrN rN rO rW s 485 486 �z HasDescriptors.setup_instance) rK rL rM r� r| r r/ rW r8 rN rN r5 rO r+ � s r+ )� metaclassc s� e Zd ZU ejeejf ed< ejeejf ed< ejeejf ed< ejeejf ed< eed< ejeejf ed< ejeejf ed< � fdd �Z � fd 487 d �Z 488 d d � Z dd� Z e ejdd� ��Zejdd� �Zdd� Zdd� Zdd� Zdd� Zd d � ZdId d!�Zed"fd#d$�Zed"fd%d&�Zefd'd(�Zd)d*� Z d+d,� Z d-d.� Z e d/d0� �Z e d1d2� �Z!e � fd3d4��Z"d5d6� Z#d7d8� Z$d9d:� Z%d;d<� Z&d=d>� Z'd?d@� Z(dAdB� Z)dJdCdD�Z*e � fdEdF��Z+e dJdGdH��Z,� Z-S )Kr, r� r= �_trait_notifiersr r� r< r; c sL | d }| dd � } |j �� |_i |_i |_d|_tt|�j| i |�� d S )Nr r F) r= r� r� r[ r r� r. r, rW )r r� r� r5 rN rO rW " s zHasTraits.setup_instancec 489 sv |}i }|rmdd� }|| _ d| _i }|�� D ] \}}| �|�r1t| ||� t|d || dd�||< q|||< qt|�t| j�@ } | D ]}| j| �| t | |��}| � 490 ||� ||| d< qAd| _| ` | D ] }| � || � qcz t � j |i |�� W d S t y� } 491 z5dd � |D �} |�� D ]\} } | �| � d 492 | ��� q�d �| �}td j|| jj| 493 d �tdd� W Y d } 494 ~ 495 d S d } 496 ~ 497 ww )Nc W � d S rQ rN )Z _ignore_argsrN rN rO �ignore: � z"HasTraits.__init__.<locals>.ignoreTr� �r� r) r� r� rz r� Fc S � g | ]}t |��qS rN )r )r �argrN rN rO � 498 <listcomp>\ � z&HasTraits.__init__.<locals>.<listcomp>�=z, z�Passing unrecognized arguments to super({classname}).__init__({arg_s}). 499 {error} 500 This is deprecated in traitlets 4.2.This error will be raised in a future release of traitlets.)�arg_sr_ r r� r� )� notify_changer� r, � has_traitr� r r� r< r� r� � set_traitr. r� rk r� r r rc r rK rl )r� r r� Z 501 super_argsZ super_kwargsr] �changesr] r� �changedrs Z 502 arg_s_listr3 r4 re r5 rN rO r� 0 s\ 503 � 504 505 ����zHasTraits.__init__c C s4 | j �� }i |d< i |d< | j�� |d< d|d< |S )Nr[ r r� Fr� )rf r� r� )r� �drN rN rO � __getstate__m s 506 zHasTraits.__getstate__c C sX |� � | _| j}t|�D ] }zt||�}W n ty Y q w t|t�r)|�| � q d S rQ ) r� rf r r� r� r� ry r% r� )r� �statern r] r� rN rN rO � __setstate__y s 507 � 508 509 ��zHasTraits.__setstate__c c s4 � | j r dV dS z d| _ dV W d| _ dS d| _ w )z� 510 A contextmanager for running a block with our cross validation lock set 511 to True. 512 513 At the end of the block, the lock's value is restored to its value 514 prior to entering the block. 515 NTF)r� r� rN rN rO �cross_validation_lock� s � 516 z HasTraits.cross_validation_lockc # sb � | j r dV dS i � dd� �� �fdd�}z�z)|| _d| _ dV t� �� �D ]}t| j|�}|�| t| |��}| �||� q'W n@ ty� } z4dd� | _� � � D ]&\}}|ddd � D ]}|j 517 d 518 krv|j t urp| �||j � q\| j �|� q\qQi � |�d}~ww W d | _ | `� �� D ] }|D ]}| �|� q�q�dS d | _ | `� �� D ] }|D ]}| �|� q�q�w ) aH Context manager for bundling trait change notifications and cross 519 validation. 520 521 Use this when doing multiple trait assignments (init, config), to avoid 522 race conditions in trait notifiers requesting other trait values. 523 All trait notifications will fire after all values have been assigned. 524 Nc S sH | du r|gS | d d dkr |j dkr |j| d d< | S | �|� | S )z5Merges the provided change with the last if possible.Nr rz r� r� )rz r� r� )Z past_changesr� rN rN rO �compress� s 525 �z4HasTraits.hold_trait_notifications.<locals>.compressc s | j }�� �|�| �� |< d S rQ )r� rZ )r� r� ��cacherp rN rO �hold� s z0HasTraits.hold_trait_notifications.<locals>.holdTc S r\ rQ rN r� rN rN rO r� � r� z4HasTraits.hold_trait_notifications.<locals>.<lambda>r r� F)r� rf �listr r� r r� rh r9 r, rz r) r> r� �pop�values)r� rs r� r� r� rs ri r� rN rq rO �hold_trait_notifications� sZ � � 526 527 528 ����� ��� ��z"HasTraits.hold_trait_notificationsc C s | � t|||| dd�� d S )Nr� r_ )rf r )r� r� r� r� rN rN rO r� � s ��zHasTraits._notify_traitc C s 529 | � |�S )z"Notify observers of a change event)r� r� rN rN rO rf � � 530 zHasTraits.notify_changec C sX t |t�s t|�}|d |d }}g }|| jv r5|�| j�|i ��|g �� |�| j�|i ��tg �� t| jv rV|�| j�ti ��|g �� |�| j�ti ��tg �� d| }|d dkr�t| |�r�t| j|�}t |t �s�t 531 || j|d� t| |�}||vr�|� t |�� |D ] }t |t �r�|j}nt |t�r�|jdur�t| |j�}||� q�dS )z Notify observers of any eventr� rz z _%s_changedr� z$use @observe and @unobserve instead.N)ry r r[ �extendrZ r r� r� r r5 rt r� r* r r� r% r� ) r� �eventr� rz � callables� 532 magic_name� class_valuer" rF rN rN rO r� � sD 533 534 535 �� 536 � 537 538 539 �zHasTraits._notify_observersc C sh || j vrg }||i| j |< n|| j | vr g }|| j | |< n| j | | }||vr2|�|� d S d S rQ )r[ r� )r� �handlerr� rz �nlistrN rN rO �_add_notifiers s 540 �zHasTraits._add_notifiersc C sJ z|d u r| j | |= W d S | j | | �|� W d S ty$ Y d S w rQ )r[ �remover� )r� r~ r� rz rN rN rO �_remove_notifiers* s �zHasTraits._remove_notifiersNFc C sJ t dtdd� |du r t}|r| jt|�|d� dS | jt|�|d� dS )a� DEPRECATED: Setup a handler to be called when a trait changes. 541 542 This is used to setup dynamic notifications of trait changes. 543 544 Static handlers can be created by creating methods on a HasTraits 545 subclass with the naming convention '_[traitname]_changed'. Thus, 546 to create static handler for the trait 'a', create the method 547 _a_changed(self, name, old, new) (fewer arguments can be used, see 548 below). 549 550 If `remove` is True and `handler` is not specified, all change 551 handlers for the specified name are uninstalled. 552 553 Parameters 554 ---------- 555 handler : callable, None 556 A callable that is called when a trait changes. Its 557 signature can be handler(), handler(name), handler(name, new), 558 handler(name, old, new), or handler(name, old, new, self). 559 name : list, str, None 560 If None, the handler will apply to all traits. If a list 561 of str, handler will apply to all names in the list. If a 562 str, the handler will apply just to that name. 563 remove : bool 564 If False (the default), then install the handler. If True 565 then unintall it. 566 zCon_trait_change is deprecated in traitlets 4.1: use observe insteadr� r� Nr� )r rl r r� r* rF )r� r~ r� r� rN rN rO �on_trait_change3 s �zHasTraits.on_trait_changer� c C �$ t |�}|D ] }| �|||� qdS )a Setup a handler to be called when a trait changes. 567 568 This is used to setup dynamic notifications of trait changes. 569 570 Parameters 571 ---------- 572 handler : callable 573 A callable that is called when a trait changes. Its 574 signature should be ``handler(change)``, where ``change`` is a 575 dictionary. The change dictionary at least holds a 'type' key. 576 * ``type``: the type of notification. 577 Other keys may be passed depending on the value of 'type'. In the 578 case where type is 'change', we also have the following keys: 579 * ``owner`` : the HasTraits instance 580 * ``old`` : the old value of the modified trait attribute 581 * ``new`` : the new value of the modified trait attribute 582 * ``name`` : the name of the modified trait attribute. 583 names : list, str, All 584 If names is All, the handler will apply to all traits. If a list 585 of str, handler will apply to all names in the list. If a 586 str, the handler will apply just to that name. 587 type : str, All (default: 'change') 588 The type of notification to filter by. If equal to All, then all 589 notifications are passed to the observe handler. 590 N)rH r� �r� r~ r rz r� rN rN rO rF [ s �zHasTraits.observec C r� )a� Remove a trait change handler. 591 592 This is used to unregister handlers to trait change notifications. 593 594 Parameters 595 ---------- 596 handler : callable 597 The callable called when a trait attribute changes. 598 names : list, str, All (default: All) 599 The names of the traits for which the specified handler should be 600 uninstalled. If names is All, the specified handler is uninstalled 601 from the list of notifiers corresponding to all changes. 602 type : str or All (default: 'change') 603 The type of notification to filter by. If All, the specified handler 604 is uninstalled from the list of notifiers corresponding to all types. 605 N)rH r� r� rN rN rO r� y s �zHasTraits.unobservec C s6 |t u r i | _dS z| j|= W dS ty Y dS w )zRemove trait change handlers of any type for the specified name. 606 If name is not specified, removes all trait notifiers.N)r r[ r� rV rN rN rO � unobserve_all� s 607 �zHasTraits.unobserve_allc C sZ |D ] }d| }t | |�r t| j|�}t|t�s t|| j|d� q|D ]}|| j|< q#dS )a� Setup a handler to be called when a trait should be cross validated. 608 609 This is used to setup dynamic notifications for cross-validation. 610 611 If a validator is already registered for any of the provided names, a 612 TraitError is raised and no new validator is registered. 613 614 Parameters 615 ---------- 616 handler : callable 617 A callable that is called when the given trait is cross-validated. 618 Its signature is handler(proposal), where proposal is a Bunch (dictionary with attribute access) 619 with the following attributes/keys: 620 * ``owner`` : the HasTraits instance 621 * ``value`` : the proposed value for the modified trait attribute 622 * ``trait`` : the TraitType instance associated with the attribute 623 names : List of strings 624 The names of the traits that should be cross-validated 625 r� r� N)r� r� r ry rA rt r )r� r~ r r� r| r} rN rN rO rU � s 626 627 �� �z HasTraits._register_validatorc K s\ | j }d|ji}t|d�r|j|d< |�|� t|j|f|�| _ |�� D ]}|�| � q$dS )z;Dynamically add trait attributes to the HasTraits instance.rL rM N) r rL r� rM r� rz rK rv r� )r� r� rn �attrsr� rN rN rO � 628 add_traits� s 629 630 631 632 �zHasTraits.add_traitsc C s< | j }| �|�std|j� d|� ���t||��| |� dS )z>Forcibly sets trait attribute, including read-only attributes.�Class � does not have a trait named N)r rg r9 rK r� r� )r� r� r� rn rN rN rO rh � s 633 zHasTraits.set_traitc K � t | jdi |���S )z�Get a list of all the names of this class' traits. 634 635 This method is just like the :meth:`trait_names` method, 636 but is unbound. 637 NrN )rt � class_traits�rn r� rN rN rO �class_trait_names� s zHasTraits.class_trait_namesc K �t | j �� }t|�dkr |S i }|�� D ]$\}}|�� D ]\}}t|�s't|�}||j�|d��s2 nq|||< q|S )a� Get a ``dict`` of all the traits of this class. The dictionary 638 is keyed on the name and the values are the TraitType objects. 639 640 This method is just like the :meth:`traits` method, but is unbound. 641 642 The TraitTypes returned don't know anything about the values 643 that the various HasTrait's instances are holding. 644 645 The metadata kwargs allow functions to be passed in which 646 filter traits based on metadata values. The functions should 647 take a single value as an argument and return a boolean. If 648 any function returns False, then the trait is not included in 649 the output. If a metadata key doesn't exist, None will be passed 650 to the function. 651 r N�r< r� r� r, �callabler� r� rZ )rn r� r� �resultr� r� � meta_name� meta_evalrN rN rO r� � s 652 ��zHasTraits.class_traitsc s, t | | �� � fdd�| jdi |���� D �S )z�Get a dict of all the traitlets defined on this class, not a parent. 653 654 Works like `class_traits`, except for excluding traits from parents. 655 c �& i | ]\}}t � |d �|ur||�qS rQ �r� )r r� r| ��suprN rO � 656 <dictcomp> � 657 �z.HasTraits.class_own_traits.<locals>.<dictcomp>NrN )r. r� r, r� r5 r� rO �class_own_traits� s 658 659 �zHasTraits.class_own_traitsc C � 660 || j v S )z?Returns True if the object has a trait with the specified name.)r< rV rN rN rO rg rx zHasTraits.has_traitc C r� )a' Returns True if the specified trait has a value. 661 662 This will return false even if ``getattr`` would return a 663 dynamically generated default value. These default values 664 will be recognized as existing only after they have been 665 generated. 666 667 Example 668 669 .. code-block:: python 670 671 class MyClass(HasTraits): 672 i = Int() 673 674 mc = MyClass() 675 assert not mc.trait_has_value("i") 676 mc.i # generates a default value 677 assert mc.trait_has_value("i") 678 )r� rV rN rN rO �trait_has_value s 679 zHasTraits.trait_has_valuec s � fdd�� j di |��D �S )a� A ``dict`` of trait names and their values. 680 681 The metadata kwargs allow functions to be passed in which 682 filter traits based on metadata values. The functions should 683 take a single value as an argument and return a boolean. If 684 any function returns False, then the trait is not included in 685 the output. If a metadata key doesn't exist, None will be passed 686 to the function. 687 688 Returns 689 ------- 690 A ``dict`` of trait names and their values. 691 692 Notes 693 ----- 694 Trait values are retrieved via ``getattr``, any exceptions raised 695 by traits or the operations they may trigger will result in the 696 absence of a trait value in the result ``dict``. 697 c s i | ]}|t � |��qS rN r� )r r� r� rN rO r� 5 s z*HasTraits.trait_values.<locals>.<dictcomp>NrN rT �r� r� rN r� rO � trait_values! s zHasTraits.trait_valuesc C s> d| }|| j v rt| |�S || jj v rt| j|�S | j| S )z�Return default generator for a given trait 698 699 Walk the MRO to resolve the correct default generator according to inheritance. 700 r9 )rf r� r r; )r� r� r` rN rN rO � _get_trait_default_generator7 s 701 702 703 z&HasTraits._get_trait_default_generatorc O s� |D ]}| � |�std|� dt| �j� d���qt|�dkr-t|�dkr-| �|d �| �S | jdi |��}|�|� i }|D ] }| �|�| �||< q>|S )z�Return a trait's default value or a dictionary of them 704 705 Notes 706 ----- 707 Dynamically generated default values may 708 depend on the current state of the object.�'z' is not a trait of 'z ' instancesr r NrN )rg r9 rz rK r� r� rQ ry )r� r r� r� rQ �defaultsrN rN rO r� C s 709 � 710 zHasTraits.trait_defaultsc K r� )z2Get a list of all the names of this class' traits.NrN )rt r� r� rN rN rO rQ Y s zHasTraits.trait_namesc K r� )a� Get a ``dict`` of all the traits of this class. The dictionary 711 is keyed on the name and the values are the TraitType objects. 712 713 The TraitTypes returned don't know anything about the values 714 that the various HasTrait's instances are holding. 715 716 The metadata kwargs allow functions to be passed in which 717 filter traits based on metadata values. The functions should 718 take a single value as an argument and return a boolean. If 719 any function returns False, then the trait is not included in 720 the output. If a metadata key doesn't exist, None will be passed 721 to the function. 722 r Nr� )r� r� r� r� r� r� r� r� rN rN rO r� ] s 723 ��zHasTraits.traitsc 724 C s� zt | j|�}W n ty! } z td| jj� d|� ��|�d}~ww d| d }t| |�r=|t | |�v r=t | |��||�S |j�||�S )z%Get metadata values for trait by key.r� r� Nr7 � _metadata)r� r r� r9 rK r� rZ r� )r� � traitnamer] rB r� rs Z metadata_namerN rN rO �trait_metadata| s ���� zHasTraits.trait_metadatac s& t | | �� � fdd�| �|��� D �S )z�Get a dict of all event handlers defined on this class, not a parent. 725 726 Works like ``event_handlers``, except for excluding traits from parents. 727 c r� rQ r� )r r� rs r� rN rO r� � r� z4HasTraits.class_own_trait_events.<locals>.<dictcomp>)r. �eventsr, )rn r� r5 r� rO �class_own_trait_events� s 728 729 �z HasTraits.class_own_trait_eventsc C sn i }t | �D ].\}}t|t�r4|du r|||< q||jv r"|||< qt|d�r4| jdi |j��r4|||< q|S )a� Get a ``dict`` of all the event handlers of this class. 730 731 Parameters 732 ---------- 733 name : str (default: None) 734 The name of a trait of this class. If name is ``None`` then all 735 the event handlers of this class will be returned instead. 736 737 Returns 738 ------- 739 The event handlers associated with a trait name, or all event handlers. 740 N�tagsrN )r� ry r% rQ r� r� )rn r� r� r3 r4 rN rN rO � trait_events� s 741 742 743 744 745 �zHasTraits.trait_events)NNFrQ ).rK rL rM r| r" r~ r r� r� rW r� rl rn �propertyr� r� ro rw r� rf r� r� r� r� r rF r� r� rU r� rh � classmethodr� r� r� rg r� r� r� r� rQ r� r� r� r� r8 rN rN r5 rO r, s^ 746 = 747 @ / 748 ( " 749 750 ! 751 r, c @ � e Zd ZdZdd� ZdS )r ze 752 A trait with error reporting and string -> type resolution for Type, 753 Instance and This. 754 c C � t |�S )zM 755 Resolve a string supplied for a type into an actual object. 756 r )r� �stringrN rN rO �_resolve_string� s z#ClassBasedTraitType._resolve_stringN�rK rL rM r� r� rN rN rN rO r � s r c sN e Zd ZdZedf� fdd� Zdd� Zdd� Zd d 757 � Zd d � Z d d� Z 758 � Z S )r< z<A trait whose value must be a subclass of a specified class.Nc sz |t u r |du r 759 tn|}n|}|du r |du s|t u r t}n|}t�|�s.t|t�s.td��|| _t� j |fi |�� dS )a^ Construct a Type trait 760 761 A Type trait specifies that its values must be subclasses of 762 a particular class. 763 764 If only ``default_value`` is given, it is used for the ``klass`` as 765 well. If neither are given, both default to ``object``. 766 767 Parameters 768 ---------- 769 default_value : class, str or None 770 The default value must be a subclass of klass. If an str, 771 the str must be a fully specified class name, like 'foo.bar.Bah'. 772 The string is resolved into real class, when the parent 773 :class:`HasTraits` class is instantiated. 774 klass : class, str [ default object ] 775 Values of this trait must be a subclass of klass. The klass 776 may be specified in a string like: 'foo.bar.MyClass'. 777 The string is resolved into real class, when the parent 778 :class:`HasTraits` class is instantiated. 779 allow_none : bool [ default False ] 780 Indicates whether None is allowed as an assignable value. 781 **kwargs 782 extra kwargs passed to `ClassBasedTraitType` 783 Nz"A Type trait must specify a class.) 784 r> r� rd r- ry r~ r9 �klassr. r� )r� r� r� r� Znew_default_valuer5 rN rO r� � s z Type.__init__c 785 C s� t |t�r$z| �|�}W n ty# } z td| j||f �|�d}~ww z t|| j�r.|W S W n ty8 Y nw | � ||� dS )z4Validates that the value is a valid object instance.zJThe '%s' trait of %s instance must be a type, but %r could not be importedN) 786 ry r~ r� � ImportErrorr9 r� r{ r� r� r �r� r� r� rs rN rN rO rI � s* 787 788 ����� � �z Type.validatec C sB t | jt�r 789 | j}n 790 | jjd | jj }d| }| jr |d S |S )�#Returns a description of the trait.rb za subclass of '%s'� or None)ry r� r~ rL rK r� )r� r� r� rN rN rO r 791 s z Type.infoc C � | � � d S rQ ��_resolve_classesr� rN rN rO r� � zType.instance_initc C s< t | jt�r | �| j�| _t | jt�r | �| j�| _d S d S rQ )ry r� r~ r� r� r� rN rN rO r� s 792 �zType._resolve_classesc C s: | j }|d us J �t|t�rt|�S t|j� d|j� ��S )Nrb )r� ry r~ r rL rK r� rN rN rO r s 793 794 zType.default_value_repr) rK rL rM r� r> r� rI r 795 r� r� r r8 rN rN r5 rO r< � s , r< c s^ e Zd ZdZdZd� fdd� Zdd� Zdd� Zd d 796 � Zd d � Z d d� Z 797 dd� Z dd� Z � Z S )r- z�A trait whose value must be an instance of a specified class. 798 799 The value can also be an instance of a subclass of the specified class. 800 801 Subclasses can declare default classes by overriding the klass attribute 802 Nc s� |du r| j }|durt�|�st|t�r|| _ ntd| ��|dur,t|t�s,td��|dur9t|t�s9td��|| _|| _ t 803 � j di |�� dS )a� Construct an Instance trait. 804 805 This trait allows values that are instances of a particular 806 class or its subclasses. Our implementation is quite different 807 from that of enthough.traits as we don't allow instances to be used 808 for klass and we handle the ``args`` and ``kw`` arguments differently. 809 810 Parameters 811 ---------- 812 klass : class, str 813 The class that forms the basis for the trait. Class names 814 can also be specified as strings, like 'foo.bar.Bar'. 815 args : tuple 816 Positional arguments for generating the default value. 817 kw : dict 818 Keyword arguments for generating the default value. 819 allow_none : bool [ default False ] 820 Indicates whether None is allowed as a value. 821 **kwargs 822 Extra kwargs passed to `ClassBasedTraitType` 823 824 Notes 825 ----- 826 If both ``args`` and ``kw`` are None, then the default value is None. 827 If ``args`` is a tuple and ``kw`` is a dict, then the default is 828 created as ``klass(*args, **kw)``. If exactly one of ``args`` or ``kw`` is 829 None, the None is replaced by ``()`` or ``{}``, respectively. 830 Nz+The klass attribute must be a class not: %rz)The 'kw' argument must be a dict or None.z,The 'args' argument must be a tuple or None.rN ) r� rd r- ry r~ r9 rI r� rD rE r. r� )r� r� r �kwr� r5 rN rO r� 2 s zInstance.__init__c C s. | j d usJ �t|| j �r|S | �||� d S rQ )r� ry r r� rN rN rO rI a s zInstance.validatec C s6 t | jt�r t| j�}ntd| j�}| jr|d7 }|S )Nr r� )ry r� r~ r r r� )r� r� rN rN rO r 831 h s z Instance.infoc C r� rQ r� r� rN rN rO r� q r� zInstance.instance_initc C s" t | jt�r| �| j�| _d S d S rQ )ry r� r~ r� r� rN rN rO r� v s �zInstance._resolve_classesc C sB | j d u r | jd u r d S | jd usJ �| j| j pdi | jp i ��S )NrN )rD rE r� r� rN rN rO r� z s ��z Instance.make_dynamic_defaultc C s t | �� �S rQ )r r� r� rN rN rO r � � zInstance.default_value_reprc C r� rQ )rx r� rN rN rO r� � rV zInstance.from_string)NNN)rK rL rM r� r� r� rI r 832 r� r� r� r r� r8 rN rN r5 rO r- ( s / r- c @ r� )r( zC 833 Mixin for forward-declared versions of Instance and Type. 834 c C s | j j}td�||g��S )z� 835 Find the specified class name by looking for it in the module in which 836 our this_class attribute was defined. 837 rb )r� rL r r )r� r� �modnamerN rN rO r� � s z$ForwardDeclaredMixin._resolve_stringNr� rN rN rN rO r( � s r( c @ � e Zd ZdZdS )r) z+ 838 Forward-declared version of Type. 839 N�rK rL rM r� rN rN rN rO r) � � r) c @ r� )r' z/ 840 Forward-declared version of Instance. 841 Nr� rN rN rN rO r' � r� r' c s, e Zd ZdZdZ� fdd�Zdd� Z� ZS )r8 a A trait for instances of the class containing this trait. 842 843 Because how how and when class bodies are executed, the ``This`` 844 trait can only have a default value of None. This, and because we 845 always validate default values, ``allow_none`` is *always* true. 846 z4an instance of the same type as the receiver or Nonec s t � jdi |�� d S )NrQ �r. r� �r� r� r5 rN rO r� � s z This.__init__c C s6 | j d usJ �t|| j �s|d u r|S | �||� d S rQ )r� ry r r� rN rN rO rI � s z This.validate)rK rL rM r� r r� rI r8 rN rN r5 rO r8 � s 847 r8 c s^ e Zd ZdZ� fdd�Zd� fdd� Z� fdd�Zd d 848 � Zd d � Zd d� Z � fdd�Z 849 � Z S )r? z'A trait type representing a Union type.c s8 t |�| _d�dd� | jD ��| _t� jdi |�� dS )a� Construct a Union trait. 850 851 This trait allows values that are allowed by at least one of the 852 specified trait types. A Union traitlet cannot have metadata on 853 its own, besides the metadata of the listed types. 854 855 Parameters 856 ---------- 857 trait_types : sequence 858 The list of trait types of length at least 1. 859 **kwargs 860 Extra kwargs passed to `TraitType` 861 862 Notes 863 ----- 864 Union([Float(), Bool(), Int()]) attempts to validate the provided values 865 with the validation function of Float, then Bool, and finally Int. 866 867 Parsing from string is ambiguous for container types which accept other 868 collection-like literals (e.g. List accepting both `[]` and `()` 869 precludes Union from ever parsing ``Union([List(), Tuple()])`` as a tuple; 870 you can modify behaviour of too permissive container traits by overriding 871 ``_literal_from_string_pairs`` in subclasses. 872 Similarly, parsing unions of numeric types is only unambiguous if 873 types are provided in order of increasing permissiveness, e.g. 874 ``Union([Int(), Float()])`` (since floats accept integer-looking values). 875 z or c S s g | ]}|� � �qS rN )r 876 )r �ttrN rN rO rb � rc z"Union.__init__.<locals>.<listcomp>NrN )rt r r r r. r� )r� r r� r5 rN rO r� � s 877 zUnion.__init__Nc s4 t � �|�}| jD ]}|tu r|�|�}q |S |S rQ )r. rB r r> )r� r� rB r� r5 rN rO rB � s 878 z Union.defaultc s. t | j�D ]}|�|d � qt� �||� d S rQ )�reversedr r� r. )r� rn r� � 879 trait_typer5 rN rO r� � s zUnion.class_initc C s t | j�D ]}|�|� qd S rQ )r� r r� )r� rn r� rN rN rO r� � s �zUnion.subclass_initc 880 C s� |j �: | jD ].}z#|�||�}| jd ur!t|d| j d |j� |W W d � S ty5 Y qw W d � n1 s@w Y | �||� d S )Nr7 r� )ro r r� r� r� r� r9 r )r� r� r� r� r4 rN rN rO rI � s 881 882 � �� � 883 zUnion.validatec C s* t |t�r t| j|j �S t| j|g �S rQ r r rN rN rO r s 884 z Union.__or__c 885 sJ | j D ]}z|�|�}|�d |�W S ttfy Y qw t� �|�S rQ )r r� rI r9 rw r. )r� rU r� r4 r5 rN rO r� s 886 887 � zUnion.from_stringrQ ) rK rL rM r� r� rB r� r� rI r r� r8 rN rN r5 rO r? � s r? c @ s6 e Zd ZU dZdZejej ed< dZ dZ 888 dd� Z dS )r z A trait which allows any value.Nr� Tr� c C r\ rQ rN r� rN rN rO r� r^ zAny.subclass_init) rK rL rM r� r� r| r� r r� r� r r� rN rN rN rO r s 889 r c C sh | j dur|| j k rtdj| jt|�|| j d���| jdur2|| jkr2tdj| jt|�|| jd���|S )z� 890 Validate that a number to be applied to a trait is between bounds. 891 892 If value is not between min_bound and max_bound, this raises a 893 TraitError with an error message appropriate for this trait. 894 Nz}The value of the '{name}' trait of {klass} instance should not be less than {min_bound}, but a value of {value} was specified)r� r� r� Z min_boundz�The value of the '{name}' trait of {klass} instance should not be greater than {max_bound}, but a value of {value} was specified)r� r� r� Z max_bound)r@ r9 rc r� r rA )r� r� r� rN rN rO �_validate_bounds# s ����r� c �F e Zd ZdZdZdZedf� fdd� Zdd� Zd d 895 � Z d d � Z 896 � Z S ) r. z An int trait.r zan intFc s8 |� dd �| _|� dd �| _t� jd||d�|�� d S )Nr@ rA �r� r� rN )ru r@ rA r. r� �r� r� r� r� r5 rN rO r� C s z Int.__init__c C s" t |t�s | �||� t| ||�S rQ )ry rB r r� r� rN rN rO rI H s 897 z Int.validatec C � | j r |dkr d S t|�S �Nr� )r� rB r� rN rN rO r� M � zInt.from_stringc C r\ rQ rN r� rN rN rO r� R r^ zInt.subclass_init� rK rL rM r� r� r r> r� rI r� r� r8 rN rN r5 rO r. = s r. c @ r� )r z#A casting version of the int trait.c C �8 zt |�}W n ty | �||� Y nw t| ||�S rQ )rB r� r r� r� rN rN rO rI Y � � z CInt.validateN�rK rL rM r� rI rN rN rN rO r V � r c r� ) r& zA float trait.g za floatFc sB |� dtd� �| _|� dtd��| _t� jd||d�|�� d S )Nr@ �infrA r� rN )ru rC r@ rA r. r� r� r5 rN rO r� k s zFloat.__init__c C s4 t |t�r t|�}t |t�s| �||� t| ||�S rQ )ry rB rC r r� r� rN rN rO rI p s 898 899 900 zFloat.validatec C r� r� )r� rC r� rN rN rO r� w r� zFloat.from_stringc C r\ rQ rN r� rN rN rO r� | r^ zFloat.subclass_initr� rN rN r5 rO r& e s r& c @ r� )r z%A casting version of the float trait.c C r� rQ )rC r� r r� r� rN rN rO rI � r� zCFloat.validateNr� rN rN rN rO r � r� r c @ �0 e Zd ZdZdZdZdd� Zdd� Zdd � Zd 901 S ) r z A trait for complex numbers.y za complex numberc C s4 t |t�r|S t |ttf�rt|�S | �||� d S rQ )ry �complexrC rB r r� rN rN rO rI � s 902 903 zComplex.validatec C r� r� )r� r� r� rN rN rO r� � r� zComplex.from_stringc C r\ rQ rN r� rN rN rO r� � r^ zComplex.subclass_initN� rK rL rM r� r� r rI r� r� rN rN rN rO r � s r c @ r� )r z.A casting version of the complex number trait.c C �, zt |�W S ty | �||� Y d S w rQ )r� r� r r� rN rN rO rI � � 904 905 �zCComplex.validateNr� rN rN rN rO r � r� r c @ r� ) r zA trait for byte strings.� za bytes objectc C s t |t�r|S | �||� d S rQ )ry �bytesr r� rN rN rO rI � � 906 zBytes.validatec C sz | j r |dkr d S t|�dkr8dD ]&}|d d� d|� �kr7|d |kr7|}|dd� }td||f t� nq|�d�S ) Nr� r( ��"r� r� �br zZSupporting extra quotes around Bytes is deprecated in traitlets 5.0. Use %r instead of %r.�utf8)r� r� r � FutureWarning�encode)r� rU �quote�old_srN rN rO r� � s " ��� 907 zBytes.from_stringc C r\ rQ rN r� rN rN rO r� � r^ zBytes.subclass_initNr� rN rN rN rO r � s r c @ r� )r z+A casting version of the byte string trait.c C r� rQ )r� r� r r� rN rN rO rI � r� zCBytes.validateNr� rN rN rN rO r � r� r c @ r� ) r= z A trait for unicode strings.r� za unicode stringc 908 C sn t |t�r|S t |t�r/z|�dd�W S ty. } zd}t|�|| jt|���|�d }~ww | � ||� d S )N�ascii�strictz<Could not decode {!r} for unicode trait '{}' of {} instance.) 909 ry r~ r� �decode�UnicodeDecodeErrorr9 rc r� r r )r� r� r� rs ra rN rN rO rI � s 910 911 ��zUnicode.validatec C sz | j r |dkr d S tj�|�}t|�dkr;dD ]#}|d |d kr'|kr:n q|}|dd� }td||f t� q|S )Nr� r� r� r r r z�Supporting extra quotes around strings is deprecated in traitlets 5.0. You can use %r instead of %r if you require traitlets >=5.)r� rX �path� 912 expanduserr� r r� )r� rU rF r� rN rN rO r� � s ���zUnicode.from_stringc C r\ rQ rN r� rN rN rO r� � r^ zUnicode.subclass_initNr� rN rN rN rO r= � s r= c @ r� )r z'A casting version of the unicode trait.c C r� rQ )r~ r� r r� rN rN rO rI 913 r� zCUnicode.validateNr� rN rN rN rO r � r� r c @ s0 e Zd ZdZdZedd� �Zdd� Zdd� Zd S ) 914 r4 z{A string holding a valid object name in this version of Python. 915 916 This does not check that the name exists in any scope.z#a valid object identifier in Pythonc C s |S rQ rN )r7 rU rN rN rO r� 917 r� zObjectName.<lambda>c C s2 | � ||�}t|t�rt|�r|S | �||� d S rQ )� 918 coerce_strry r~ rS r r� rN rN rO rI 919 s zObjectName.validatec C s | j r |dkr d S |S r� r� r� rN rN rO r� 920 s zObjectName.from_stringN) rK rL rM r� r � staticmethodr� rI r� rN rN rN rO r4 921 s r4 c @ r� )r# zFA string holding a valid dotted object name in Python, such as A.b3._cc C sB | � ||�}t|t�rtdd� |�d�D ��r|S | �||� d S )Nc s s � | ]}t |�V qd S rQ rR )r r rN rN rO r $ 922 � � z,DottedObjectName.validate.<locals>.<genexpr>rb )r� ry r~ �allrg r r� rN rN rO rI ! 923 s "zDottedObjectName.validateNr� rN rN rN rO r# 924 r� r# c @ s8 e Zd ZdZdZdZdd� Zdd� Zdd � Zd 925 d � Z d S ) r z A boolean (True, False) trait.Fz a booleanc C s@ t |t�r|S t |t�r|dkrdS |dkrdS | �||� d S )Nr Tr F)ry r� rB r r� rN rN rO rI / 926 s 927 928 z Bool.validatec C s: | j r |dkr d S |�� }|dv rdS |dv rdS td��)Nr� > �1�trueT> rW �falseFz %r is not 1, 0, true, or false)r� �lowerrw r� rN rN rO r� 9 929 s zBool.from_stringc C r\ rQ rN r� rN rN rO r� D 930 r^ zBool.subclass_initc K s g d�}| j r |�d� |S )� Completion hints for argcomplete)r� r� r� rW r� )r� r� )r� r� � completionsrN rN rO � argcompleterG 931 s 932 zBool.argcompleterN) 933 rK rL rM r� r� r rI r� r� r� rN rN rN rO r ) 934 s 935 r c @ r� )r z'A casting version of the boolean trait.c C r� rQ )r� r� r r� rN rN rO rI R 936 r� zCBool.validateNr� rN rN rN rO r O 937 r� r c sh e Zd ZdZef� fdd� Zdd� Zddd�Zdd d 938 �Zd d � Z d d� Z 939 dd� Z dd� Z dd� Z � ZS )r$ z0An enum whose value must be in a given sequence.c s6 || _ |�dd�r|tu rd }t� j|fi |�� d S )Nr� F)rv rZ r> r. r� �r� rv r� r� r5 rN rO r� \ 940 s z Enum.__init__c C s || j v r|S | �||� d S rQ )rv r r� rN rN rO rI b 941 r� z Enum.validateFc C s2 | j }|rd�dd� |D ��}|S tt|��}|S )�6Returns a description of the trait choices (not none).�|c s � � | ]}d | V qdS �z``%r``NrN �r r� rN rN rO r k 942 r� z$Enum._choices_str.<locals>.<genexpr>)rv r r rt �r� �as_rst�choicesrN rN rO � _choices_strg 943 s �zEnum._choices_strc C �. | j r d|rdnd nd}d| �|�� |� �S �r� � or %s�`None`r� r� �any of �r� r� �r� r� �nonerN rN rO �_infop 944 � z 945 Enum._infoc C � | j dd�S �NF�r� �r r� rN rN rO r 946 u 947 r� z Enum.infoc C r �NTr r 948 r� rN rN rO �info_rstx 949 r� z Enum.info_rstc C s* z| � d |�W S ty t|� Y S w rQ )rI r9 rx r� rN rN rO r� { 950 s 951 �zEnum.from_stringc C r\ rQ rN r� rN rN rO r� � 952 r^ zEnum.subclass_initc K s dd� | j D �S )r� c S r` rN )r~ )r r4 rN rN rO rb � 953 rc z%Enum.argcompleter.<locals>.<listcomp>)rv r� rN rN rO r� � 954 s zEnum.argcompleter�F)rK rL rM r� r> r� rI r� r r 955 r r� r� r� r8 rN rN r5 rO r$ Y 956 s 957 958 r$ c sF e Zd ZdZef� fdd� Zdd� Zd dd�Zd d 959 � Zd d � Z � Z 960 S )r z4An enum of strings where the case should be ignored.c s t � j|fd|i|�� d S �Nr� r� r� r5 rN rO r� � 961 s zCaselessStrEnum.__init__c C sJ t |t�s | �||� | jD ]}|�� |�� kr | S q| �||� d S rQ )ry r~ r rv r� )r� r� r� r4 rN rN rO rI � 962 s 963 964 �zCaselessStrEnum.validateFc C s0 | j r d|rdnd nd}d| �|�� d|� �S )r� r� r r� r� r z (case-insensitive)r r rN rN rO r � 965 s zCaselessStrEnum._infoc C r r r 966 r� rN rN rO r 967 � 968 r� zCaselessStrEnum.infoc C r r r 969 r� rN rN rO r � 970 r� zCaselessStrEnum.info_rstr ) rK rL rM r� r> r� rI r r 971 r r8 rN rN r5 rO r � 972 s 973 r c sR e Zd ZdZdZdZeddf� fdd� Zdd� Zd dd�Z d d 974 � Z 975 d d � Z � Z S )r* zEAn case-ignoring enum matching choices by unique prefixes/substrings.Fc s( || _ || _t� j|fd|i|�� d S r )�case_sensitive�substring_matchingr. r� )r� rv r� r r r� r5 rN rO r� � 976 s zFuzzyEnum.__init__c s� t �t�s | �|�� | jrdd� ndd� � | j}|r dd� ndd� �� ���| j}� ��fdd�|D �}t|�dkrKt||�D ] 977 \}}|rJ| S q@| �|�� d S ) Nc S r� rQ rN �rF rN rN rO r� � 978 r� z$FuzzyEnum.validate.<locals>.<lambda>c S rP rQ )r� r rN rN rO r� � 979 � c S s | |v S rQ rN �r4 rF rN rN rO r� � 980 r c S s 981 |� | �S rQ )� 982 startswithr rN rN rO r� � 983 � 984 c s g | ] }��� |���qS rN rN )r rF �Z conv_func� 985 match_funcr� rN rO rb � 986 s z&FuzzyEnum.validate.<locals>.<listcomp>r )ry r~ r r r rv �sum�zip)r� r� r� r r� �matchesr4 �mrN r rO rI � 987 s" 988 989 �� �zFuzzyEnum.validatec C sV | j r d|rdnd nd}| jrdnd}| jrdnd}d |� d 990 |� d | �|�� |� �S ) r� r� r r� r� � sensitive� insensitive� substring�prefixz any case-� r )r� r r r� )r� r� r �case�substrrN rN rO r � 991 s zFuzzyEnum._infoc C r r r 992 r� rN rN rO r 993 � 994 r� zFuzzyEnum.infoc C r r r 995 r� rN rN rO r � 996 r� zFuzzyEnum.info_rstr ) rK rL rM r� r r r> r� rI r r 997 r r8 rN rN r5 rO r* � 998 s � 999 r* c s� e Zd ZU dZdZejejeej ej 1000 f e d< dZ ej 1001 e d< e ZdZdZej 1002 e d< def� fdd � Z� fd 1003 d �Zd d � Z� fdd�Zdd� Zdd� Zdd� Zddd�Z� ZS )r z\An instance of a container (list, set, etc.) 1004 1005 To be subclassed by overriding klass. 1006 Nr� rN � _cast_types)�[]�()�_literal_from_string_pairsc s |dur|t u rt|�s|}d}|du r)|�dd�s)td| jj� d�tdd� t }|t u r0d}n!|du r;d}d|d < nt|| j�rE|f}n t d 1007 | jj� d |� ���t|�rmt|t 1008 �ratd td d� t|t 1009 �ri|� n|| _ n |duryt dt |� ��t � jd| j|d�|�� dS )a� Create a container trait type from a list, set, or tuple. 1010 1011 The default value is created by doing ``List(default_value)``, 1012 which creates a copy of the ``default_value``. 1013 1014 ``trait`` can be specified, which restricts the type of elements 1015 in the container to that TraitType. 1016 1017 If only one arg is given and it is not a Trait, it is taken as 1018 ``default_value``: 1019 1020 ``c = List([1, 2, 3])`` 1021 1022 Parameters 1023 ---------- 1024 trait : TraitType [ optional ] 1025 the type for restricting the contents of the Container. If unspecified, 1026 types are not checked. 1027 default_value : SequenceType [ optional ] 1028 The default value for the Trait. Must be list/tuple/set, and 1029 will be cast to the container type. 1030 allow_none : bool [ default False ] 1031 Whether to allow the value to be None 1032 **kwargs : any 1033 further keys for extensions to the Trait (e.g. config) 1034 1035 Nr� F� Specifying �a(default_value=None) for no default is deprecated in traitlets 5.0.5. Use default_value=Undefinedr� r� rN r� �default value of � was r+ r( z'`trait` must be a Trait or None, got %s�r� r )r> r} rZ r r rK rl ry �_valid_defaultsrk rz �_traitr 1036 r. r� r� )r� r� r� r� r r5 rN rO r� � 1037 s: � 1038 1039 � zContainer.__init__c sN t || j�r| jd us J �| �|�}t� �||�}|d u r |S | �||�}|S rQ )ry r# r� r. rI �validate_elementsr� r5 rN rO rI . s 1040 zContainer.validatec C s� g }| j d u s t| j t�r|S |D ]*}z | j �||�}W n ty5 } z | �|||� W Y d }~qd }~ww |�|� q| jd usCJ �| �|�S rQ )r- ry r r� r9 r r� r� )r� r� r� � validatedr4 r rN rN rO r. : s �� 1041 zContainer.validate_elementsc s, t | jt�r | j�|d � t� �||� d S rQ )ry r- r: r� r. r� r5 rN rO r� H s zContainer.class_initc C s t | jt�r| j�|� d S d S rQ )ry r- r: r� r� rN rN rO r� M s �zContainer.subclass_initc C sH t |t�s td|����zt|�}W n ty d}Y nw | �d|�S )� Load value from a single stringzExpected string, got N)ry r~ r9 r r� rI �r� rU r� rN rN rO r� S s 1042 � zContainer.from_stringc s� �j dusJ �t|�dkrR|d ��dkr�jrdS t��dkrRt�fdd��jD ��rR�jr6�jjd }nd }�jdus?J �td 1043 � |�j ��t 1044 � �� t ���S t � �j�}d |jv ra�j� nd�fd d � � �� � fdd�t|�D ��S )ziReturn the value from a list of config strings 1045 1046 This is where we parse CLI configuration 1047 Nr r r� r� c 3 s( � | ]\}}� � |�o� �|�V qd S rQ )r �endswith)r �start�end)�rrN rO r h s 1048 � � 1049 �z-Container.from_string_list.<locals>.<genexpr>rb r� z}--{0}={1} for containers is deprecated in traitlets 5.0. You can pass `--{0} item` ... multiple times to add items to a list.r? c s 1050 � � | �S rQ ��item_from_string)rU r? r� rN rO r� ~ r z,Container.from_string_list.<locals>.<lambda>c s g | ] 1051 \}}� ||d ��qS ))r? rN )r �idxrU r6 rN rO rb � s z.Container.from_string_list.<locals>.<listcomp>rQ )r� r� r� �anyr& r� rK r� r rc r� r rd � signaturer7 � 1052 parameters� enumerate)r� �s_listrJ �sigrN )r7 r5 r� rO �from_string_list] s6 � 1053 �� 1054 �zContainer.from_string_listc C s | j r | j �|�S |S �ziCast a single item from a string 1055 1056 Evaluated when parsing CLI configuration from a string 1057 )r- r� �r� rU r? rN rN rO r7 � s zContainer.item_from_stringrQ )rK rL rM r� r� r| r� r? r~ r< r r� r# � SequenceTypesr, r- r& r> r� rI r. r� r� r� r? r7 r8 rN rN r5 rO r � 1058 s 1059 $ H 1060 'r c sb e Zd ZU dZeZefZej e 1061 d< de de j f� fdd� Zdd� Z� fd d 1062 �Z� fd d �Z� ZS ) r0 z An instance of a Python list.r# Nr c s( || _ || _t� jd||d�|�� dS )a� Create a List trait type from a list, set, or tuple. 1063 1064 The default value is created by doing ``list(default_value)``, 1065 which creates a copy of the ``default_value``. 1066 1067 ``trait`` can be specified, which restricts the type of elements 1068 in the container to that TraitType. 1069 1070 If only one arg is given and it is not a Trait, it is taken as 1071 ``default_value``: 1072 1073 ``c = List([1, 2, 3])`` 1074 1075 Parameters 1076 ---------- 1077 trait : TraitType [ optional ] 1078 the type for restricting the contents of the Container. 1079 If unspecified, types are not checked. 1080 default_value : SequenceType [ optional ] 1081 The default value for the Trait. Must be list/tuple/set, and 1082 will be cast to the container type. 1083 minlen : Int [ default 0 ] 1084 The minimum length of the input list 1085 maxlen : Int [ default sys.maxsize ] 1086 The maximum length of the input list 1087 )r� r� NrN )�_minlen�_maxlenr. r� �r� r� r� �minlen�maxlenr� r5 rN rO r� � s " z List.__init__c C s$ d| j t|�| j| j|f }t|��)Nz_The '%s' trait of %s instance must be of length %i <= L <= %i, but a value of %s was specified.)r� r rC rD r9 r� rN rN rO � length_error� s 1088 ��zList.length_errorc s6 t |�}|| jk s|| jkr| �||� t� �||�S rQ )r� rC rD rH r. r. )r� r� r� �lengthr5 rN rO r. � s zList.validate_elementsc s( t |t�r t� �||g�S t� �||�S rQ )ry r~ r. r� r� r5 rN rO r� � s 1089 zList.set)rK rL rM r� rt r� r� r# r| r r� r> �sys�maxsizer� rH r. r� r8 rN rN r5 rO r0 � s 1090 �& r0 c sD e Zd ZdZeZeefZdZ de 1091 de j f� fdd� Z dd� Z� ZS ) r6 z An instance of a Python set.)r$ r% z{}Nr c s t � j||||fi |�� dS )a� Create a Set trait type from a list, set, or tuple. 1092 1093 The default value is created by doing ``set(default_value)``, 1094 which creates a copy of the ``default_value``. 1095 1096 ``trait`` can be specified, which restricts the type of elements 1097 in the container to that TraitType. 1098 1099 If only one arg is given and it is not a Trait, it is taken as 1100 ``default_value``: 1101 1102 ``c = Set({1, 2, 3})`` 1103 1104 Parameters 1105 ---------- 1106 trait : TraitType [ optional ] 1107 the type for restricting the contents of the Container. 1108 If unspecified, types are not checked. 1109 default_value : SequenceType [ optional ] 1110 The default value for the Trait. Must be list/tuple/set, and 1111 will be cast to the container type. 1112 minlen : Int [ default 0 ] 1113 The minimum length of the input list 1114 maxlen : Int [ default sys.maxsize ] 1115 The maximum length of the input list 1116 Nr� rE r5 rN rO r� � s "z Set.__init__c C s0 t t| �� ��}|dkrdS d|dd� d S )Nr$ zset()�{r r �})r r� r� )r� Z list_reprrN rN rO r � s zSet.default_value_repr)rK rL rM r� r� r� r� rt r# r& r> rJ rK r� r r8 rN rN r5 rO r6 � s �$r6 c sN e Zd ZdZeZefZ� fdd�Zdd� Z dd� Z 1117 � fdd �Z d 1118 d � Z � Z S ) r; z An instance of a Python tuple.c s0 |� dt�}t|�dkr |tu r t|d �s |d }d}|du r5|�dd�s5td| jj� d �td 1119 d � t}|tu r<d}n!|du rGd}d|d< nt || j 1120 �rQ|f}n t d | jj� d |� ���g | _ |D ]}t |t �rstdtd 1121 d � |� }| j �|� qb| j r�|du s�|tu r�d}tt| �jd| j|d�|�� dS )aG Create a tuple from a list, set, or tuple. 1122 1123 Create a fixed-type tuple with Traits: 1124 1125 ``t = Tuple(Int(), Str(), CStr())`` 1126 1127 would be length 3, with Int,Str,CStr for each element. 1128 1129 If only one arg is given and it is not a Trait, it is taken as 1130 default_value: 1131 1132 ``t = Tuple((1, 2, 3))`` 1133 1134 Otherwise, ``default_value`` *must* be specified by keyword. 1135 1136 Parameters 1137 ---------- 1138 *traits : TraitTypes [ optional ] 1139 the types for restricting the contents of the Tuple. If unspecified, 1140 types are not checked. If specified, then each positional argument 1141 corresponds to an element of the tuple. Tuples defined with traits 1142 are of fixed length. 1143 default_value : SequenceType [ optional ] 1144 The default value for the Tuple. Must be list/tuple/set, and 1145 will be cast to a tuple. If ``traits`` are specified, 1146 ``default_value`` must conform to the shape and type they specify. 1147 **kwargs 1148 Other kwargs passed to `Container` 1149 r� r r rN Nr� Fr' r( r� r� r) r* �~Traits should be given as instances, not types (for example, `Int()`, not `Int`) Passing types is deprecated in traitlets 4.1.r+ )ru r> r� r} rZ r r rK rl ry r, rk r< rz r� r. r r� r� )r� r� r� r� r r� r5 rN rO r� s@ � 1150 1151 �"zTuple.__init__c C s( | j r 1152 |t| j �kr |S | j | �|�S r@ )r< r� r� rA rN rN rO r7 X s zTuple.item_from_stringc C s� | j s|S t|�t| j �kr"d| jt|�t| j �t|�f }t|��g }t| j |�D ]+\}}z|�||�}W n tyO } z | �|||� W Y d }~q*d }~ww |� |� q*t 1153 |�S )NzTThe '%s' trait of %s instance requires %i elements, but a value of %s was specified.) r< r� r� r r 1154 r9 r r� r r� r� )r� r� r� rs r/ r� r4 r rN rN rO r. c s$ ���� zTuple.validate_elementsc s8 | j D ] }t|t�r|�|d � qtt| ��||� d S rQ )r< ry r: r� r. r �r� rn r� r� r5 rN rO r� x s 1155 1156 1157 �zTuple.class_initc C s$ | j D ] }t|t�r|�|� qd S rQ )r< ry r: r� �r� rn r� rN rN rO r� ~ s 1158 1159 1160 1161 ��zTuple.subclass_init)rK rL rM r� r� r� rt r# r� r7 r. r� r� r8 rN rN r5 rO r; s M r; c s| e Zd ZdZdZdZdddef� fdd� Zddd�Z� fdd �Z d 1162 d � Z 1163 � fd d �Z dd� Z dd� Z dd� Zdd� Z� ZS )r" a� An instance of a Python dict. 1164 1165 One or more traits can be passed to the constructor 1166 to validate the keys and/or values of the dict. 1167 If you need more detailed validation, 1168 you may use a custom validator method. 1169 1170 .. versionchanged:: 5.0 1171 Added key_trait for validating dict keys. 1172 1173 .. versionchanged:: 5.0 1174 Deprecated ambiguous ``trait``, ``traits`` args in favor of ``value_trait``, ``per_key_traits``. 1175 Nc s� |� dd�}|dur|durtd��|}tdtdd� |� dd�}|dur6|dur-td��|}td tdd� |tu rF|durFt|�sF|}d}|du rV|durVt|�rV|}d}|tu r\i }|du rcd}nt|t�rl|f}nt|t�ru|f}ntd 1176 | ��t|�r�t|t �r�td tdd� |� }|| _ 1177 n |dur�td t |� ��t|�r�t|t �r�td tdd� |� }|| _ n |dur�td t |� ��|| _ t� jdt|d�|�� dS )a Create a dict trait type from a Python dict. 1178 1179 The default value is created by doing ``dict(default_value)``, 1180 which creates a copy of the ``default_value``. 1181 1182 Parameters 1183 ---------- 1184 value_trait : TraitType [ optional ] 1185 The specified trait type to check and use to restrict the values of 1186 the dict. If unspecified, values are not checked. 1187 per_key_traits : Dictionary of {keys:trait types} [ optional, keyword-only ] 1188 A Python dictionary containing the types that are valid for 1189 restricting the values of the dict on a per-key basis. 1190 Each value in this dict should be a Trait for validating 1191 key_trait : TraitType [ optional, keyword-only ] 1192 The type for restricting the keys of the dict. If 1193 unspecified, the types of the keys are not checked. 1194 default_value : SequenceType [ optional, keyword-only ] 1195 The default value for the Dict. Must be dict, tuple, or None, and 1196 will be cast to a dict if not None. If any key or value traits are specified, 1197 the `default_value` must conform to the constraints. 1198 1199 Examples 1200 -------- 1201 a dict whose values must be text 1202 >>> d = Dict(Unicode()) 1203 1204 d2['n'] must be an integer 1205 d2['s'] must be text 1206 >>> d2 = Dict(per_key_traits={"n": Integer(), "s": Unicode()}) 1207 1208 d3's keys must be text 1209 d3's values must be integers 1210 >>> d3 = Dict(value_trait=Integer(), key_trait=Unicode()) 1211 1212 r� NzFFound a value for both `value_trait` and its deprecated alias `trait`.zIKeyword `trait` is deprecated in traitlets 5.0, use `value_trait` insteadr� r� r� zJFound a value for both `per_key_traits` and its deprecated alias `traits`.zMKeyword `traits` is deprecated in traitlets 5.0, use `per_key_traits` insteadz default value of Dict was %srN z-`value_trait` must be a Trait or None, got %sz+`key_trait` must be a Trait or None, got %sr+ rN )ru rk r rl r> r} ry rI rB rz � _value_traitr 1213 � 1214 _key_trait�_per_key_traitsr. r� ) r� � value_traitZper_key_traits� key_traitr� r� r� r� r r5 rN rO r� � s� .�� �� 1215 1216 1217 � 1218 � 1219 � z Dict.__init__�Valuesc C s* |d| j t|�|�� t|�f }t|��)NzN of the '%s' trait of %s instance must be %s, but a value of %s was specified.)r� r r 1220 r 1221 r9 )r� r� �element� validator�siders rN rN rO � element_error s ���zDict.element_errorc s* t � �||�}|d u r |S | �||�}|S rQ )r. rI r. r� r5 rN rO rI s 1222 z Dict.validatec 1223 1224 C s� | j pi }| j}| j}|s|s|s|S i }|D ]H}|| }|r9z|�||�}W n ty8 | �|||d� Y nw |�||�} | r[z| �||�}W n tyZ | �||| d� Y nw |||< q| �|�S )N�KeysrV )rS rR rQ r� r9 rZ rZ r� ) 1225 r� r� r� Zper_key_overriderU rT r/ r] r4 Zactive_value_traitrN rN rO r. & s. 1226 � � 1227 1228 zDict.validate_elementsc sl t | jt�r | j�|d � t | jt�r| j�|d � | jd ur-| j�� D ]}|�|d � q$t� �||� d S rQ )ry rQ r: r� rR rS rv r. rO r5 rN rO r� ? s 1229 zDict.class_initc C s\ t | jt�r | j�|� t | jt�r| j�|� | jd ur*| j�� D ] }|�|� q"d S d S rQ )ry rQ r: r� rR rS rv rP rN rN rO r� I s 1230 �zDict.subclass_initc C s` t |t�stdt|�� dt|�� ���z| �|g�W S ty/ t|�}t |t�r.| Y S � w )r0 z"from_string expects a string, got z of type ) ry r~ rk r rz r? r� rx rI r1 rN rN rO r� T s 1231 1232 �zDict.from_stringc s� t |�dkr|d dkr� jrdS t |�dkr7|d �d�r7|d �d�r7td�� j|d �t� t|d �S i }� fdd �|D �D ]}|� |� qB|S ) 1233 z�Return a dict from a list of config strings. 1234 1235 This is where we parse CLI configuration. 1236 1237 Each item should have the form ``"key=value"``. 1238 1239 item parsing is done in :meth:`.item_from_string`. 1240 r r r� NrL rM z�--{0}={1} for dict-traits is deprecated in traitlets 5.0. You can pass --{0} <key=value> ... multiple times to add items to a dict.c s g | ]}� � |��qS rN r6 )r rU r� rN rO rb x s z)Dict.from_string_list.<locals>.<listcomp>) 1241 r� r� r r2 r rc r� r� r r� )r� r= �combinedrk rN r� rO r? ` s (�� zDict.from_string_listc C sl d|vrt d| jjt|�f ��|�dd�\}}| jr!| j�|�}| jp%i �|| j �}|r2|�|�}||iS )a Cast a single-key dict from a string. 1242 1243 Evaluated when parsing CLI configuration from a string. 1244 1245 Dicts expect strings of the form key=value. 1246 1247 Returns a one-key dictionary, 1248 which will be merged in :meth:`.from_string_list`. 1249 rd z3'%s' options must have the form 'key=value', got %sr ) 1250 r9 r rK r rg rR r� rS rZ rQ )r� rU r] r� rT rN rN rO r7 | s ��� 1251 zDict.item_from_string)rV )rK rL rM r� rQ rR r> r� rZ rI r. r� r� r� r? r7 r8 rN rN r5 rO r" � s" � 1252 1253 r" c @ s( e Zd ZdZdZdZdd� Zdd� ZdS ) r7 zgA trait for an (ip, port) tuple. 1254 1255 This allows for both IPv4 IP addresses as well as hostnames. 1256 )z 127.0.0.1r zan (ip, port) tuplec C s^ t |t�r't|�dkr't |d t�r't |d t�r'|d }|dkr'|dkr'|S | �||� d S )Nr� r r i�� )ry r� r� r~ rB r )r� r� r� �portrN rN rO rI � s 1257 zTCPAddress.validatec C sF | j r |dkr d S d|vrtd| ��|�dd�\}}t|�}||fS )Nr� �:zRequire `ip:port`, got %rr )r� rw rg rB )r� rU �ipr] rN rN rO r� � s zTCPAddress.from_stringN)rK rL rM r� r� r rI r� rN rN rN rO r7 � s r7 c @ � e Zd ZdZdZdd� ZdS )r z�A casting compiled regular expression trait. 1258 1259 Accepts both strings and compiled regular expressions. The resulting 1260 attribute will be a compiled regular expression.za regular expressionc C s. zt �|�W S ty | �||� Y d S w rQ )�re�compiler� r r� rN rN rO rI � s 1261 �zCRegExp.validateN�rK rL rM r� r rI rN rN rN rO r � s r c s� e Zd ZU dZdZejej e d< dZ 1262 d� fdd� Z e fdd�Z e fd d 1263 �Zd d � Zddd�Zddd�Zdd� Zdd� Z� ZS )r@ a� Use a Enum class as model for the data type description. 1264 Note that if no default-value is provided, the first enum-value is used 1265 as default-value. 1266 1267 .. sourcecode:: python 1268 1269 # -- SINCE: Python 3.4 (or install backport: pip install enum34) 1270 import enum 1271 from traitlets import HasTraits, UseEnum 1272 1273 class Color(enum.Enum): 1274 red = 1 # -- IMPLICIT: default_value 1275 blue = 2 1276 green = 3 1277 1278 class MyEntity(HasTraits): 1279 color = UseEnum(Color, default_value=Color.blue) 1280 1281 entity = MyEntity(color=Color.red) 1282 entity.color = Color.green # USE: Enum-value (preferred) 1283 entity.color = "green" # USE: name (as string) 1284 entity.color = "Color.green" # USE: scoped-name (as string) 1285 entity.color = 3 # USE: number (as int) 1286 assert entity.color is Color.green 1287 Nr� z"Trait type adapter to a Enum classc sn t |tj�s J d| ��|�dd�}|d u r!|s!t|j�� �d }t� jdd|i|�� || _ |j 1288 d | _ d S )Nz REQUIRE: enum.Enum, but was: %rr� Fr r� rb rN ) r{ �enumr$ rZ rt � __members__rv r. r� � 1289 enum_classrK � name_prefix)r� rf r� r� r� r5 rN rO r� � s zUseEnum.__init__c C s: t |t�sJ �| jj}|�� D ] }|j|kr| S q|S )z0Selects enum-value by using its number-constant.)ry rB rf re rv r� )r� r� rB � enum_membersZ enum_itemrN rN rO �select_by_number� s 1290 �zUseEnum.select_by_numberc C s: t |t�sJ �|�| j�r|�| jdd�}| jj�||�S )z4Selects enum-value by using its name or scoped-name.r� r )ry r~ r rg �replacerf re rZ )r� r� rB rN rN rO �select_by_name� s zUseEnum.select_by_namec C s| t || j�r|S t |t�r| �|�}|tur|S n t |t�r*| �|�}|tur)|S n |d u r6| jr3d S | jS | � ||� d S rQ ) 1291 ry rf rB ri r> r~ rk r� r� r )r� r� r� �value2rN rN rO rI s" 1292 1293 � 1294 1295 �zUseEnum.validateFc C s0 | j j�� }|rd�dd� |D ��S tt|��S )r� r� c s r� r� rN r� rN rN rO r r� z'UseEnum._choices_str.<locals>.<genexpr>)rf re r r r rt r� rN rN rO r� s zUseEnum._choices_strc C r� r� r r rN rN rO r r z UseEnum._infoc C r r r 1296 r� rN rN rO r 1297 ! r� z UseEnum.infoc C r r r 1298 r� rN rN rO r $ r� zUseEnum.info_rstrQ r )rK rL rM r� r� r| r� rd r$ r� r r� r> ri rk rI r� r r 1299 r r8 rN rN r5 rO r@ � s 1300 1301 1302 1303 r@ c @ r` )r zxA trait which is callable. 1304 1305 Notes 1306 ----- 1307 Classes are callable, as are instances 1308 with a __call__() method.z 1309 a callablec C s t |�r|S | �||� d S rQ )r� r r� rN rN rO rI 2 s zCallable.validateNrc rN rN rN rO r ( s r rQ )pr� r� rd rd rX ra rJ r# �typingr| �astr �warningsr r � utils.bunchr Zutils.descriptionsr r r r 1310 Zutils.getargspecr �utils.importstringr �utils.sentinelr rt r� r� � frozensetrB rz � 1311 ClassTypes�__all__r> r �NoDefaultSpecifiedr� r9 rb �_name_rerS r[ r^ rt rx r} rH r� r� r� rE rC rD r r: r r* r2 r3 r? r~ rF rG rI rB r% r5 rA r! r+ r, r r< r- r( r) r' r8 r r� r. r r1 r r/ r& r r r r r r= r r4 r# r r r$ r r* r r0 r6 r; r" r7 r r@ r rN rN rN rO �<module> s� ) E�� 1312 1313 1314 QC; }$1&X $!) % ' `aY 1315 1316 & 1317 & 1318 06 6A5 a