NXc@sLdZddlZddlZddlZddlZddlZddlmZy&ddlmZmZee fZ Wne fZ nXddl m Z ddl mZddlmZmZdd lmZdd lmZdd lmZeeeefZed d dZeZdefdYZ dZ!dZ"dZ#dZ$dZ%dfdYZ&e'dZ(dZ)de*fdYZ+de*fdYZ,e,Z-de*fdYZ.d e.fd!YZ/d"e fd#YZ0d$ej1e0e*fd%YZ2d&e/fd'YZ3d(e3fd)YZ4d*e3fd+YZ5d,e*fd-YZ6d.e6e4fd/YZ7d0e6e5fd1YZ8d2e3fd3YZ9d4e/fd5YZ:d6e/fd7YZ;d8e/fd9YZ<d:e<fd;YZ=ej>r8e<e=f\Z?Z@e<ZAnBd<e/fd=YZ?d>e?fd?YZ@d@e/fdAYZAdBe/fdCYZBdDeBfdEYZCdFe/fdGYZDdHeDfdIYZEdJe/fdKYZFdLeFfdMYZGdNe/fdOYZHdPeHfdQYZIdRe/fdSYZJdTeJfdUYZKdVe/fdWYZLdXeLfdYYZMdZe/fd[YZNd\eNfd]YZOd^e5fd_YZPd`ePfdaYZQdbeQfdcYZRddePfdeYZSdfe5fdgYZTdhe/fdiYZUdje/fdkYZVdS(ls A lightweight Traits like module. This is designed to provide a lightweight, simple, pure Python version of many of the capabilities of enthought.traits. This includes: * Validation * Type specification with defaults * Static and dynamic notification * Basic predefined types * An API that is similar to enthought.traits We don't support: * Delegation * Automatic GUI generation * A full set of trait types. Most importantly, we don't provide container traits (list, dict, tuple) that can trigger notifications if their contents change. * API compatibility with enthought.traits There are also some important difference in our design: * enthought.traits does not validate default values. We do. We choose to create this module because we need these capabilities, but we need them to be pure Python so they work in all Python implementations, including Jython and IronPython. Inheritance diagram: .. inheritance-diagram:: traitlets.traitlets :parts: 3 iN(t FunctionType(t ClassTypet InstanceType(twarn(t py3compat(t iteritemst string_typesi(t getargspec(t import_item(tSentinelt Undefinedt traitletssA Used in Traitlets to specify that no defaults are set in kwargs t TraitErrorcBseZRS((t__name__t __module__(((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyR NscCs,t|tjrt|St|jjS(s 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'). (t isinstanceRRt add_articlet __class__R (tobject((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pytclass_ofVs cCs&|d jdkrd|Sd|S(st Returns a string containing the correct indefinite article ('a' or 'an') prefixed to the specified string. itaeiousan sa (tlower(tname((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRascCsBt|}tj r.|tkr.|j}nd||f}|S(s] Return a string representation of a value and its type for readable error messages. s%r %r(ttypeRtPY3RR(tobjtthe_typetmsg((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyt repr_typeks   cCs+t|tp*t|to*t|tS(sN Returns whether the given value is an instance or subclass of TraitType. (Rt TraitTypeRt issubclass(tt((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pytis_traitwscCsrt|tr|gS|dkr)dgSt|ttfrnx)|D]!}t|tsEtdqEW|SdS(sConvert the name argument to a list of names. Examples -------- >>> parse_notifier_name('a') ['a'] >>> parse_notifier_name(['a','b']) ['a', 'b'] >>> parse_notifier_name(None) ['anytrait'] tanytraitsnames must be stringsN(RRtNonetlistttupletAssertionError(Rtn((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pytparse_notifier_name~s   t _SimpleTestcBs,eZdZdZdZdZRS(cCs ||_dS(N(tvalue(tselfR)((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyt__init__scCs ||jkS(N(R)(R*ttest((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyt__call__scCs d|jS(Ns>> c = link((src, 'value'), (tgt, 'value')) >>> src.value = 5 # updates other objects as well cCst|||||_|_z-t|d|dt|d|dWd|dj|j|d|dj|j|dXdS(Nii(R?tsourcettargettsetattrR1ton_trait_changet_update_targett_update_source(R*RARB((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyR+s  -ccs#t|_z dVWdt|_XdS(N(tTruetupdatingtFalse(R*((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyt_busy_updatings  cCsB|jr dS|j#t|jd|jd|WdQXdS(Nii(RHRJRCRB(R*Rtoldtnew((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyREs  cCsB|jr dS|j#t|jd|jd|WdQXdS(Nii(RHRJRCRA(R*RRKRL((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRFs  cCsd|jdj|j|jddt|jdj|j|jddtd\|_|_dS(Niitremove(NN(RARDRERGRBRFR"(R*((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pytunlinks''( R Rt__doc__RIRHR+t contextlibtcontextmanagerRJRERFRN(((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyR@s    tdirectional_linkcBsAeZdZeZdZejdZdZ dZ RS(szLink the trait of a source object with traits of target objects. Parameters ---------- source : (object, attribute name) pair target : (object, attribute name) pair Examples -------- >>> c = directional_link((src, 'value'), (tgt, 'value')) >>> src.value = 5 # updates target objects >>> tgt.value = 6 # does not update source object cCsvt|||||_|_z-t|d|dt|d|dWd|jdj|j|jdXdS(Nii(R?RARBRCR1RDt_update(R*RARB((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyR+s  -ccs#t|_z dVWdt|_XdS(N(RGRHRI(R*((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRJ s  cCsB|jr dS|j#t|jd|jd|WdQXdS(Nii(RHRJRCRB(R*RRKRL((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRSs  cCs=|jdj|j|jddtd\|_|_dS(NiiRM(NN(RARDRSRGR"RB(R*((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRNs'( R RRORIRHR+RPRQRJRSRN(((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRRs   tBaseDescriptorcBs#eZdZdZdZdZRS(sBase descriptor class Notes ----- This implements Python's descriptor prototol. This class is the base class for all such descriptors. The only magic we use is a custom metaclass for the main :class:`HasTraits` class that does the following: 1. Sets the :attr:`name` attribute of every :class:`BaseDescriptor` instance in the class dict to the name of the attribute. 2. Sets the :attr:`this_class` attribute of every :class:`BaseDescriptor` instance in the class dict to the *class* that declared the trait. This is used by the :class:`This` trait to allow subclasses to accept superclasses for :class:`This` values. cCsdS(sGPart of the initialization which may depend on the underlying HasTraits instance. It is typically overloaded for specific types. This method is called by :meth:`HasTraits.__new__` and in the :meth:`BaseDescriptor.instance_init` method of descriptors holding other descriptors. N((R*R((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyt instance_init9s N(R RROR"Rt this_classRU(((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRT#sRcBseZdZiZeZeZdZeddZ dZ dZ dZ dZdZddZd Zd Zd Zd Zd ZdZddZdZRS(s&A base class for all trait types. s any valuecKs|tk r||_n|dk r0||_nd|krItdnt|dkrt|jdkr|jj|_|jj |q||_n |j|_|j dS(sDeclare a traitlet. If *allow_none* is True, None is a valid value in addition to any values that are normally valid. The default is up to the subclass, but most trait types have ``allow_none=False`` by default. Extra information about the traitlet can be passed in as keyword arguments (``**metadata``). For instance, the config system uses 'config' and 'help' keywords. tdefaultsFParameter 'default' passed to TraitType. Did you mean 'default_value'?iN( R t default_valueR"t allow_noneRR9tmetadatatcopyt _metadatatupdatetinit(R*RXRYRZ((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyR+Os        cCsdS(N((R*((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyR^qscCstddd|jS(snDEPRECATED: Retrieve the static default value for this trait. Use self.default_value instead sAget_default_value is deprecated: use the .default_value attributet stackleveli(RRX(R*((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pytget_default_valuets cCs9tddd|j||j}||j|j<|S(sEDEPRECATED: Set the static default value for the trait type. sBinit_default_value is deprecated, and may be removed in the futureR_i(Rt _validateRXt _trait_valuesR(R*RR)((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pytinit_default_value}s  cCs||jrlt|j}d|j}xA||j|jd D]"}||jkrCt||SqCWnt|ddS(s=Retrieve a callable to calculate the default for this traitlet. This looks for: - obj._{name}_default() on the class with the traitlet, or a subclass that obj belongs to. - trait.make_dynamic_default, which is defined by Instance If neither exist, it returns None s _%s_defaultitmake_dynamic_defaultN(RRtmrotindexRVt__dict__R1R"(R*RRet meth_nametcls((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyt_dynamic_default_callables  !cCsb|j|dkr^|jtk r^|j||j}|jdk r^||j|jt|d|j}|||}n|S(Ns _%s_validate(RwRR1(R*RR)tcross_validate((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRyscCs7t|tr#t|g|jSt||gSdS(N(RtUniont trait_types(R*tother((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyt__or__scCs|jS(N(t info_text(R*((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pytinfoscCsl|dk r:d|jt||jt|f}n"d|j|jt|f}t|dS(NsJThe '%s' trait of %s instance must be %s, but a value of %s was specified.s;The '%s' trait must be %s, but a value of %r was specified.(R"RRRRR (R*RR)te((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyterrors cCst|dij||S(NR\(R1tget(R*R7RW((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyt get_metadatascCs|t|di|qsiRq(RxRGRqR#tkeysRwR1RCR titemsR RbtpopRIRttypest MethodTypeRgR"tvalues(R*RqRRRzRR)Rk((RRsK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRNs<     -   c Cs_g}|j|jj|g|j|jjdgyt|d|}WnnX|j|x|D]}t|rKt|}t|d}t|t j rd} nd} || dkr|qW|| dkr||qW|| dkr|||qW|| dkr<||||qWt dqst d qsWdS( NR!s _%s_changediiiiis1a trait changed callback must have 0-3 arguments.s*a trait changed callback must be callable.( textendRRR1R3tcallableRR9RRRR ( R*RRsRrt callablestcbtctargspectnargstoffset((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRqs2       cCsR||jkr%g}||j|s (RRR(RiRZ((RsK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pytclass_own_traitsscCstt|j|dtS(s?Returns True if the object has a trait with the specified name.N(RR1RR"R(R*R((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyt has_trait"scKs|j|jS(s2Get a list of all the names of this class' traits.(R<R(R*RZ((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyt trait_names&sc Kstgt|jD]}t|dtr|^q}t|dkrQ|Sx?|jD]1\}}t|tk r^t ||| type resolution for Type, Instance and This. cCs t|S(sM Resolve a string supplied for a type into an actual object. (R(R*tstring((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyt_resolve_stringnscCst|}tj r5|tkr5d|jj}n#dt|dd!t|f}|dk rd|j t ||j |f}nd|j |j |f}t |dS(Nsclass %ss %s (i.e. %s)iisJThe '%s' trait of %s instance must be %s, but a value of %s was specified.s;The '%s' trait must be %s, but a value of %r was specified.( RRRRRR tstrtreprR"RRRR (R*RR)tkindRR((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRts # (R RRORR(((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRhs tTypecBsAeZdZeddZdZdZdZdZ RS(s<A trait whose value must be a subclass of a specified class.cKs|tkr'|dkrtn|}n|}|dkrc|dksQ|tkrZt}qc|}ntj|pt|tjstdn||_ t t |j ||dS(sConstruct a Type trait A Type trait specifies that its values must be subclasses of a particular class. If only ``default_value`` is given, it is used for the ``klass`` as well. If neither are given, both default to ``object``. Parameters ---------- default_value : class, str or None The default value must be a subclass of klass. If an str, the str must be a fully specified class name, like 'foo.bar.Bah'. The string is resolved into real class, when the parent :class:`HasTraits` class is instantiated. klass : class, str [ default object ] Values of this trait must be a subclass of klass. The klass may be specified in a string like: 'foo.bar.MyClass'. The string is resolved into real class, when the parent :class:`HasTraits` class is instantiated. allow_none : bool [ default False ] Indicates whether None is allowed as an assignable value. s"A Type trait must specify a class.N( R R"RRRRRRR tklassRRR+(R*RXRRZtnew_default_value((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyR+s    ! cCst|tjrXy|j|}WqXtk rTtd|j||fqXXnyt||jrq|SWnnX|j ||dS(s4Validates that the value is a valid object instance.sJThe '%s' trait of %s instance must be a type, but %r could not be importedN( RRRRt ImportErrorR RRRR(R*RR)((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRvs cCsZt|jtjr!|j}n|jjd|jj}d|}|jrV|dS|S(s$ Returns a description of the trait.t.sa subclass of '%s's or None(RRRRRR RY(R*RR((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRs   cCs$|jtt|j|dS(N(t_resolve_classesRRRU(R*R((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRUs cCs^t|jtjr-|j|j|_nt|jtjrZ|j|j|_ndS(N(RRRRRRX(R*((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRsN( R RROR R"R+RvRRUR(((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRs *  tInstancecBsSeZdZdZddddZdZdZdZdZ dZ RS(sA trait whose value must be an instance of a specified class. The value can also be an instance of a subclass of the specified class. Subclasses can declare default classes by overriding the klass attribute cKs|dkr|j}n|dk rQtj|sEt|tjrQ||_ntd||dk rt|t rtdn|dk rt|t  rtdn||_ ||_ t t |j|dS(ssConstruct an Instance trait. This trait allows values that are instances of a particular class or its subclasses. Our implementation is quite different from that of enthough.traits as we don't allow instances to be used for klass and we handle the ``args`` and ``kw`` arguments differently. Parameters ---------- klass : class, str The class that forms the basis for the trait. Class names can also be specified as strings, like 'foo.bar.Bar'. args : tuple Positional arguments for generating the default value. kw : dict Keyword arguments for generating the default value. allow_none : bool [default True] Indicates whether None is allowed as a value. Notes ----- If both ``args`` and ``kw`` are None, then the default value is None. If ``args`` is a tuple and ``kw`` is a dict, then the default is created as ``klass(*args, **kw)``. If exactly one of ``args`` or ``kw`` is None, the None is replaced by ``()`` or ``{}``, respectively. s+The klass attribute must be a class not: %rs)The 'kw' argument must be a dict or None.s,The 'args' argument must be a tuple or None.N(R"RRRRRRR RR$t default_argstdefault_kwargsRRR+(R*RRRRZ((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyR+s  -    cCs*t||jr|S|j||dS(N(RRR(R*RR)((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRvscCsNt|jtjr!|j}n |jj}t|}|jrJ|dS|S(Ns or None(RRRRR RRY(R*RR((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRs    cCs$|jtt|j|dS(N(RRRRU(R*R((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRU"s cCs1t|jtjr-|j|j|_ndS(N(RRRRR(R*((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyR&scCsD|jdkr"|jdkr"dS|j|jp4d|jp@iS(N((RR"RR(R*((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRd*sN( R RROR"RR+RvRRURRd(((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRs.   tForwardDeclaredMixincBseZdZdZRS(sC Mixin for forward-declared versions of Instance and Type. cCs%|jj}tdj||gS(s Find the specified class name by looking for it in the module in which our this_class attribute was defined. R(RVRRtjoin(R*Rtmodname((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyR5s (R RROR(((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyR1stForwardDeclaredTypecBseZdZRS(s+ Forward-declared version of Type. (R RRO(((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyR>stForwardDeclaredInstancecBseZdZRS(s/ Forward-declared version of Instance. (R RRO(((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyREstThiscBs&eZdZdZdZdZRS(sA trait for instances of the class containing this trait. Because how how and when class bodies are executed, the ``This`` trait can only have a default value of None. This, and because we always validate default values, ``allow_none`` is *always* true. s4an instance of the same type as the receiver or NonecKstt|jd|dS(N(RRR+R"(R*RZ((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyR+VscCs6t||js|dkr"|S|j||dS(N(RRVR"R(R*RR)((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRvYs(R RRORR+Rv(((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRLs R{cBs2eZdZdZdZdZdZRS(s'A trait type representing a Union type.cKsa||_djg|jD]}|j^q|_|jdj|_tt|j|dS(s'Construct a Union trait. This trait allows values that are allowed by at least one of the specified trait types. A Union traitlet cannot have metadata on its own, besides the metadata of the listed types. Parameters ---------- trait_types: sequence The list of trait types of length at least 1. Notes ----- Union([Float(), Bool(), Int()]) attempts to validate the provided values with the validation function of Float, then Bool, and finally Int. s or iN(R|RRRXRR{R+(R*R|RZttt((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyR+fs +cCsGx*|jD]}|j|_|j|q Wtt|j|dS(N(R|RVRURR{(R*Rt trait_type((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRU|s cCsexN|jD]C}y&|j||}|j|_|SWq tk rLq q Xq W|j||dS(N(R|RaR\R R(R*RR)RRk((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRvs   cCs;t|tr#t|j|jSt|j|gSdS(N(RR{R|(R*R}((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyR~s(R RROR+RURvR~(((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyR{cs    tAnycBseZdZdZdZRS(sA trait which allows any value.s any valueN(R RROR"RXR(((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRstIntcBs2eZdZdZdZeddZdZRS(s An int trait.isan intcKsP|jdd|_|jdd|_tt|jd|d||dS(NtmintmaxRXRY(RR"RRRRR+(R*RXRYtkwargs((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyR+scCst|ts"|j||n|jdk rk||jkrktd|jt||j|fn|jdk r||jkrtd|jt||j|fn|S(NsiThe value of the '%s' trait of %s instance should not be greater than %s, but a value of %s was specifiedsfThe value of the '%s' trait of %s instance should not be less than %s, but a value of %s was specified( RtintRRR"R RRR(R*RR)((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRvsN( R RRORXRR R"R+Rv(((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRs  tCIntcBseZdZdZRS(s#A casting version of the int trait.cCs,yt|SWn|j||nXdS(N(RR(R*RR)((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRvs(R RRORv(((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRstLongcBs#eZdZdZdZdZRS(sA long integer trait.isa longcCs@t|tr|St|tr,t|S|j||dS(N(RtlongRR(R*RR)((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRvs  (R RRORXRRv(((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRstCLongcBseZdZdZRS(s,A casting version of the long integer trait.cCs,yt|SWn|j||nXdS(N(RR(R*RR)((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRvs(R RRORv(((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRstIntegercBs#eZdZdZdZdZRS(sWAn integer trait. Longs that are unnecessary (<= sys.maxint) are cast to ints.is an integercCs{t|tr|St|tr,t|Stjdkrgddlm}t||rgt|Sn|j||dS(Ntclii(tInt64(RRRtsystplatformtSystemRR(R*RR)R((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRvs  (R RRORXRRv(((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRstFloatcBs2eZdZdZdZeddZdZRS(sA float trait.gsa floatcKs]|jdtd |_|jdtd|_tt|jd|d||dS(NRtinfRRXRY(RtfloatRRRRR+(R*RXRYR((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyR+scCst|trt|}nt|ts@|j||n||jks^||jkrtd|jt||j|j|fn|S(NsgThe value of the '%s' trait of %s instance should be between %s and %s, but a value of %s was specified( RRRRRRR RR(R*RR)((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRvsN( R RRORXRR R"R+Rv(((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRs  tCFloatcBseZdZdZRS(s%A casting version of the float trait.cCs,yt|SWn|j||nXdS(N(RR(R*RR)((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRvs(R RRORv(((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRstComplexcBs#eZdZdZdZdZRS(sA trait for complex numbers.gysa complex numbercCsFt|tr|St|ttfr2t|S|j||dS(N(RtcomplexRRR(R*RR)((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRvs  y(R RRORXRRv(((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRstCComplexcBseZdZdZRS(s.A casting version of the complex number trait.cCs,yt|SWn|j||nXdS(N(RR(R*RR)((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRv)s(R RRORv(((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyR&stBytescBs#eZdZdZdZdZRS(sA trait for byte strings.tsa bytes objectcCs't|tr|S|j||dS(N(RtbytesR(R*RR)((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRv8s(R RRORXRRv(((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyR2stCBytescBseZdZdZRS(s+A casting version of the byte string trait.cCs,yt|SWn|j||nXdS(N(RR(R*RR)((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRvAs(R RRORv(((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyR>stUnicodecBs#eZdZdZdZdZRS(sA trait for unicode strings.usa unicode stringcCst|tjr|St|trzy|jddSWqztk rvd}t|j||jt |qzXn|j ||dS(Ntasciitstricts<Could not decode {!r} for unicode trait '{}' of {} instance.( RRt unicode_typeRtdecodetUnicodeDecodeErrorR tformatRRR(R*RR)R((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRvNs +(R RRORXRRv(((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRHstCUnicodecBseZdZdZRS(s'A casting version of the unicode trait.cCs/ytj|SWn|j||nXdS(N(RRR(R*RR)((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRv]s(R RRORv(((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRZst ObjectNamecBsAeZdZdZejr-edZn dZdZRS(s{A string holding a valid object name in this version of Python. This does not check that the name exists in any scope.s#a valid object identifier in PythoncCs|S(N((t_ts((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRlscCsHt|trDyt|SWqDtk r@|j||qDXn|S(s-In Python 2, coerce ascii-only unicode to str(RtunicodeRtUnicodeEncodeErrorR(R*RR)((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyt coerce_strps  cCsH|j||}t|tr4tj|r4|S|j||dS(N(RRRRt isidentifierR(R*RR)((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRvys( R RRORRRt staticmethodRRv(((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRds   tDottedObjectNamecBseZdZdZRS(sFA string holding a valid dotted object name in Python, such as A.b3._ccCsN|j||}t|tr:tj|dtr:|S|j||dS(Ntdotted(RRRRRRGR(R*RR)((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRvs$(R RRORv(((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRstBoolcBs#eZdZeZdZdZRS(sA boolean (True, False) trait.s a booleancCs't|tr|S|j||dS(N(RRpR(R*RR)((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRvs(R RRORIRXRRv(((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRstCBoolcBseZdZdZRS(s'A casting version of the boolean trait.cCs,yt|SWn|j||nXdS(N(RpR(R*RR)((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRvs(R RRORv(((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRstEnumcBs,eZdZedZdZdZRS(s0An enum whose value must be in a given sequence.cKsM||_|jdtr0|tkr0d}ntt|j||dS(NRY(RRRIR R"RR R+(R*RRXRZ((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyR+s  cCs'||jkr|S|j||dS(N(RR(R*RR)((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRvscCs(dt|j}|jr$|dS|S(s$ Returns a description of the trait.sany of s or None(RRRY(R*R((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRs (R RROR R+RvR(((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyR s  tCaselessStrEnumcBseZdZdZRS(s4An enum of strings where the case should be ignored.cCsit|tjs%|j||nx-|jD]"}|j|jkr/|Sq/W|j||dS(N(RRRRRR(R*RR)Rk((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRvs (R RRORv(((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyR st ContainercBsYeZdZdZdZeZdZdddZ dZ dZ dZ dZ RS(s\An instance of a container (list, set, etc.) To be subclassed by overriding klass. cKs|dkr(t| r(|}d}n|dkr=d}n:t||jr[|f}ntd|jj|ft|rt|tr|n||_n%|dk rtdt |nt t |j d|j d||dS(sCreate a container trait type from a list, set, or tuple. The default value is created by doing ``List(default_value)``, which creates a copy of the ``default_value``. ``trait`` can be specified, which restricts the type of elements in the container to that TraitType. If only one arg is given and it is not a Trait, it is taken as ``default_value``: ``c = List([1,2,3])`` Parameters ---------- trait : TraitType [ optional ] the type for restricting the contents of the Container. If unspecified, types are not checked. default_value : SequenceType [ optional ] The default value for the Trait. Must be list/tuple/set, and will be cast to the container type. allow_none : bool [ default False ] Whether to allow the value to be None **metadata : any further keys for extensions to the Trait (e.g. config) sdefault value of %s was %ss'`trait` must be a Trait or None, got %sRRN((R"R Rt_valid_defaultsR:RR Rt_traitRRR R+R(R*RRXRZR((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyR+s!     $ cCs;d|jt||jt|f}t|dS(NsUElement of the '%s' trait of %s instance must be %s, but a value of %s was specified.(RRRRR (R*Rtelementt validatorR((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyt element_errors(cCset||jr$|j|}ntt|j||}|dkrO|S|j||}|S(N(Rt _cast_typesRRR RvR"tvalidate_elements(R*RR)((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRvs cCsg}|jdks't|jtr+|Sx^|D]V}y|jj||}Wn'tk rz|j|||jq2X|j|q2W|j|S(N( R R"RRRaR RR3R(R*RR)t validatedRk((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRs!  cCsNt|jtr4|j|j_|jj|ntt|j|dS(N(RR RRVRURR (R*R((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRUsN((R RROR"RRt SequenceTypesR R R+RRvRRU(((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyR s3  tListcBsPeZdZeZefZdddej dZ dZ dZ dZ RS(sAn instance of a Python list.icKs8||_||_tt|jd|d||dS(sCreate a List trait type from a list, set, or tuple. The default value is created by doing ``list(default_value)``, which creates a copy of the ``default_value``. ``trait`` can be specified, which restricts the type of elements in the container to that TraitType. If only one arg is given and it is not a Trait, it is taken as ``default_value``: ``c = List([1,2,3])`` Parameters ---------- trait : TraitType [ optional ] the type for restricting the contents of the Container. If unspecified, types are not checked. default_value : SequenceType [ optional ] The default value for the Trait. Must be list/tuple/set, and will be cast to the container type. minlen : Int [ default 0 ] The minimum length of the input list maxlen : Int [ default sys.maxsize ] The maximum length of the input list RRXN(t_minlent_maxlenRRR+(R*RRXtminlentmaxlenRZ((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyR+'s  cCs8d|jt||j|j|f}t|dS(Ns_The '%s' trait of %s instance must be of length %i <= L <= %i, but a value of %s was specified.(RRRRR (R*RR)R((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyt length_errorKs%cCsVt|}||jks*||jkr=|j||ntt|j||S(N(R9RRRRRR(R*RR)tlength((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRPs cCs1tt|j||}|j||}|S(N(RRRvR(R*RR)((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRvWsN(R RROR#RR$RR"RtmaxsizeR+RRRv(((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyR"s $  tSetcBs8eZdZeZeefZddde j dZ RS(sAn instance of a Python set.icKs&tt|j|||||dS(sCreate a Set trait type from a list, set, or tuple. The default value is created by doing ``set(default_value)``, which creates a copy of the ``default_value``. ``trait`` can be specified, which restricts the type of elements in the container to that TraitType. If only one arg is given and it is not a Trait, it is taken as ``default_value``: ``c = Set({1,2,3})`` Parameters ---------- trait : TraitType [ optional ] the type for restricting the contents of the Container. If unspecified, types are not checked. default_value : SequenceType [ optional ] The default value for the Trait. Must be list/tuple/set, and will be cast to the container type. minlen : Int [ default 0 ] The minimum length of the input list maxlen : Int [ default sys.maxsize ] The maximum length of the input list N(RRR+(R*RRXRRRZ((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyR+cs N( R RROtsetRR$R#RR"RRR+(((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyR]s tTuplecBs8eZdZeZefZdZdZdZ RS(sAn instance of a Python tuple.c Os2|jdd}t|dkrT|dkrTt|d rT|d}d}n|dkrid }n:t||jr|f}ntd|jj|fg|_ x<|D]4}t|t r|n|}|j j |qW|j r |dkr d}nt t |jd|jd||dS( sCreate a tuple from a list, set, or tuple. Create a fixed-type tuple with Traits: ``t = Tuple(Int, Str, CStr)`` would be length 3, with Int,Str,CStr for each element. If only one arg is given and it is not a Trait, it is taken as default_value: ``t = Tuple((1,2,3))`` Otherwise, ``default_value`` *must* be specified by keyword. Parameters ---------- `*traits` : TraitTypes [ optional ] the types for restricting the contents of the Tuple. If unspecified, types are not checked. If specified, then each positional argument corresponds to an element of the tuple. Tuples defined with traits are of fixed length. default_value : SequenceType [ optional ] The default value for the Tuple. Must be list/tuple/set, and will be cast to a tuple. If `traits` are specified, the `default_value` must conform to the shape and type they specify. RXiisdefault value of %s was %sRRN(((RR"R9R RR R:RR t_traitsRR3RR R+R(R*R<RZRXRRR((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyR+s /        cCs|js |St|t|jkred|jt|t|jt|f}t|ng}xjt|j|D]V\}}y|j||}Wn$tk r|j|||q~X|j |q~Wt |S(NsTThe '%s' trait of %s instance requires %i elements, but a value of %s was specified.( R R9RRRR tzipRaRR3R$(R*RR)RRRRk((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRs + cCsYx<|jD]1}t|tr |j|_|j|q q Wtt|j|dS(N(R RRRVRURR (R*RR((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRUs  ( R RROR$RR#RR+RRU(((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRs   6 tDictcBsJeZdZdZddedZdZdZdZ dZ RS(sAn instance of a Python dict.cKs*|tkr6|dk r6t|s6|}d}q6n|tkrKi}n|dkr`d}nFt|tr{|f}n+t|tr|f}ntd|t|rt|tr|n||_n%|dk rtdt |n||_ t t |j dtd||dS(sCreate a dict trait type from a dict. The default value is created by doing ``dict(default_value)``, which creates a copy of the ``default_value``. trait : TraitType [ optional ] The type for restricting the contents of the Container. If unspecified, types are not checked. traits : Dictionary of trait types [optional] The type for restricting the content of the Dictionary for certain keys. default_value : SequenceType [ optional ] The default value for the Dict. Must be dict, tuple, or None, and will be cast to a dict if not None. If `trait` is specified, the `default_value` must conform to the constraints it specifies. sdefault value of Dict was %ss'`trait` must be a Trait or None, got %sRRN(R R"R RRRR:RR RR RR"R+(R*RR<RXRZR((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyR+s&         $  cCs;d|jt||jt|f}t|dS(NsUElement of the '%s' trait of %s instance must be %s, but a value of %s was specified.(RRRRR (R*RRRR((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRs(cCsAtt|j||}|dkr+|S|j||}|S(N(RR"RvR"R(R*RR)((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRvs  cCs@|jdk rWxE|jD]7}||krtd||jt|fqqWn|jdkr|jdkst|jtr|Si}x|D]}||}yS|jdk r||jkr|j|j||}n|jj||}Wn'tk r$|j |||jqX|||stCRegExpcBseZdZdZdZRS(sA casting compiled regular expression trait. Accepts both strings and compiled regular expressions. The resulting attribute will be a compiled regular expression.sa regular expressioncCs/ytj|SWn|j||nXdS(N(tretcompileR(R*RR)((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyRvXs(R RRORRv(((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyR%Ps(WRORPRR&RRRRRRt ClassTypestwarningsRtipython_genutilsRtipython_genutils.py3compatRRtutils.getargspecRtutils.importstringRtutils.sentinelR R#R$Rt frozensetRR tNoDefaultSpecifiedRmR RRRR R'R(R"R8R?RR@RRtdlinkRTRRtwith_metaclassR;RRRRRRRR{RRRRRRRRRRRRRRRRRRRR R R RRRR"R#R%(((sK/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/traitlets.pyt#s            3+#&"BSX 4            a;)Vb