3 ˆdv'ã@s¤dZddlZddlZddlZddlmZddlmZmZmZddl m Z ddl m Z e efZeefZeefZeeeee eeefZdZd ZdZGd d „d eƒZeƒZdZGd d „d eƒZeƒZGdd„deƒZ e ƒZ Gdd„deƒZ!e!ƒZ!dd„Z"eeeefZ#dd„Z$dd„Z%dd„Z&dd„Z'dd„Z(da)dd„Z*d d!„Z+d9d#d$„Z,d:d%d&„Z-efd'd(„Z.d)d*„Z/d+d,„Z0Gd-d.„d.eƒZ1d/d0„Z2d1d2„Z3d3d4„Z4d5d6„Z5d7d8„Z6dS);zF Defines common, low-level capabilities needed by the Traits package. éN)Úgetcwd)ÚdirnameÚexistsÚjoin)Úrefé)Ú ETSConfigZ__trait_notifier__Z_traits_cache_c@s(eZdZdZdd„Zdd„Zdd„ZdS) Ú_Uninitializedzò The singleton value of this class represents the uninitialized state of a trait and is specified as the 'old' value in the trait change notification that occurs when the value of a trait is read before being set. cCstdk r tStj|ƒ}|SdS)N)Ú UninitializedÚobjectÚ__new__)ÚclsÚself©rú3/tmp/pip-build-7vycvbft/traits/traits/trait_base.pyr :s z_Uninitialized.__new__cCsdS)Nzr)rrrrÚ__repr__Asz_Uninitialized.__repr__cCstffS)N)r )rÚprotocolrrrÚ __reduce_ex__Dsz_Uninitialized.__reduce_ex__N)Ú__name__Ú __module__Ú __qualname__Ú__doc__r rrrrrrr 3sr c@s@eZdZdZdd„Zdd„Zdd„Zdd „Zd d „Zd d „Z dS)Ú _UndefinedzS Singleton 'Undefined' object (used as undefined trait name and/or value). cCstdk r tStj|ƒ}|SdS)N)Ú Undefinedr r )r rrrrr Zs z_Undefined.__new__cCsdS)Nz r)rrrrrasz_Undefined.__repr__cCstffS)N)r)rrrrrrdsz_Undefined.__reduce_ex__cCst|ƒt|ƒkS)N)Útype)rÚotherrrrÚ__eq__gsz_Undefined.__eq__cCs tt|ƒƒS)N)Úhashr)rrrrÚ__hash__jsz_Undefined.__hash__cCst|ƒt|ƒk S)N)r)rrrrrÚ__ne__msz_Undefined.__ne__N) rrrrr rrrrrrrrrrUsrc@seZdZdZdd„ZdS)ÚMissingzJ Singleton 'Missing' object (used as missing method argument marker). cCsdS)Nz r)rrrrr~szMissing.__repr__N)rrrrrrrrrr zsr c@seZdZdZdd„ZdS)ÚSelfzM Singleton 'Self' object (used as object reference to current 'object'). cCsdS)Nzr)rrrrr‹sz Self.__repr__N)rrrrrrrrrr!‡sr!cCst|tƒrt|ƒSt‚dS)zq Wraps the built-in str() function to raise a TypeError if the argument is not of a type in StringTypes. N)Ú isinstanceÚ StringTypesÚstrÚ TypeError)ÚargrrrÚstrx“s r'cCs|S)zE Item validator which accepts any item and returns it unaltered. r)ÚitemrrrÚ_validate_everything¢sr)c Cs>t|tjƒrt|tjƒsdSy||kStk r8dSXdS)a Perform "in" containment check, allowing for TypeErrors. This is required because in some circumstances ``x in y`` can raise a TypeError. In these cases we make the (reasonable) assumption that the value is _not_ contained in the container. FN)r"ÚenumÚEnumMetaÚEnumr%)ÚvalueÚ containerrrrÚ safe_contains¨s  r/cCst|tƒrt|ƒSt|jjƒS)z§ Returns a string containing the class name of an object with the correct indefinite article ('a' or 'an') preceding it (e.g., 'an Image', 'a PlotValue'). )r"r$Ú add_articleÚ __class__r)r rrrÚclass_of»s r2cCs$|dd…jƒdkrd|Sd|S)zt Returns a string containing the correct indefinite article ('a' or 'an') prefixed to the specified string. NrZaeiouzan za )Úlower)Únamerrrr0Æsr0cCsN|jddƒ}d}d}x0|D](}|jƒr2|r2|d7}|jƒ}||7}qW|jƒS)zÞ Returns a "user-friendly" version of a string, with the first letter capitalized and with underscore characters replaced by spaces. For example, ``user_name_for('user_name_for')`` returns ``'User name for'``. Ú_ú ÚF)ÚreplaceÚisupperÚislowerÚ capitalize)r4ÚresultZ last_lowerÚcrrrÚ user_name_forÐs    r>cCstdkrtttjdƒƒatS)z1 Gets the path to the Traits home directory. NZtraits)Ú _traits_homeÚ verify_pathrrZapplication_datarrrrÚ traits_homeåsrAc Cs(t|ƒs$ytj|ƒWn YnX|S)z] Verify that a specified path exists, and try to create it if it does not exist. )rÚosÚmkdir)Úpathrrrr@ðs r@écCstj|ƒjjddƒS)zL Returns the name of the module that the caller's caller is located in. rÚ__main__)ÚsysÚ _getframeÚ f_globalsÚget)ÚlevelrrrÚget_module_nameýsrLc Csütj|ƒjjddƒ}d}|dkrHytttjj|ƒdƒƒ}Wn YnX|dkrxx&ttjdƒtƒgD]}t |ƒrfPqfWttddƒ}|røt tdƒrštj }n:|d kr®t j d }n&|dkrÆt jjtjƒ}nt jjtjƒ}d|krø|jdƒ\}}t jj||ƒ}|S)z@Returns a resource path calculated from the caller's stack. rrFNÚ__file__rÚfrozenFÚ_MEIPASSZ macosx_appZ RESOURCEPATHÚdllÚ windows_exeÚ console_exez.zip/)rPrQrR)rGrHrIrJrÚgetattrÚmodulesÚargvrrÚhasattrrOrBÚenvironrDÚ executableÚsplitr)rKÚmodulerDrNÚrootÚzippathZ image_pathrrrÚget_resource_paths0   r]cCsr|jdƒ}x@|dd…D]0}|tkr0t||ƒ}qt||dƒ}|dkr|SqW|tkrbt||dƒSt||d|ƒS)zj Returns the value of an extended object attribute name of the form: name[.name2[.name3...]]. Ú.Nréÿÿÿÿr_r_)rYrrS)r ÚxnameÚdefaultÚnamesr4rrrÚxgetattr1s   rccCs>|jdƒ}x|dd…D]}t||ƒ}qWt||d|ƒdS)zg Sets the value of an extended object attribute name of the form: name[.name2[.name3...]]. r^Nrr_r_)rYrSÚsetattr)r r`r-rbr4rrrÚxsetattrDs recs‡‡fdd„}|S)Ncs ˆƒ}|dk r|jˆtdƒdS)N)Ztrait_property_changedr)Z value_refr )r4Ú object_refrrÚ _value_freedRsz0_make_value_freed_callback.._value_freedr)rfr4rgr)r4rfrÚ_make_value_freed_callbackQsrhc@seZdZdd„ZdS)Ú HandleWeakRefcCs.t|ƒ}t||ƒ}||_||_t||ƒ|_dS)N)rrhr r4r-)rr r4r-rfrgrrrÚ__init__[s  zHandleWeakRef.__init__N)rrrrjrrrrriZsricCs|dkS)Nr)r-rrrÚis_nonecsrkcCs|dk S)Nr)r-rrrÚnot_nonegsrlcCs|dk S)NFr)r-rrrÚ not_falseksrmcCs|dkS)NÚeventr)r-rrrÚ not_eventosrocCs t|tƒS)N)r"r$)r-rrrÚis_strssrp)rE)rE)7rr*rBrGrÚos.pathrrrÚweakrefrZ etsconfig.apirÚlistÚtupleZ SequenceTypesÚfloatÚintZ ComplexTypesZ RangeTypesr$ÚcomplexÚdictÚboolZ TypeTypesZ TraitNotifierZ TraitsCacher r r rrr r!r'r#r)r/r2r0r>r?rAr@rLr]rcrerhrirkrlrmrorprrrrÚ sf   "        .