i^c@sdZddlZddlZddlZddlZddlZddlZddlZy&ddlmZm Z ee fZ Wne fZ nXddl m Z mZddlZddlmZddlmZddlmZdd lmZeeeefZed d d Zed d dZeZde fdYZ!ddl"m#Z#ej$dZ%dZ&eZ'dZ(dZ)dZ*dZ+dZ,dZ-dZ.dfdYZ/e0dZ1dZ2de3fd YZ4d!e3fd"YZ5e5Z6d#e3fd$YZ7d%e7fd&YZ8d'e3fd(YZ9d)Z:d*e fd+YZ;d,e;fd-YZ<d.Z=d/Z>d0Z?d1Z@d2e7fd3YZAd4eAfd5YZBd6eAfd7YZCd8eAfd9YZDd:ejEe;e3fd;YZFd<ejEe<eFfd=YZGd>e8fd?YZHd@eHfdAYZIdBeHfdCYZJdDe3fdEYZKdFeKeIfdGYZLdHeKeJfdIYZMdJeHfdKYZNdLe8fdMYZOdNe8fdOYZPdPZQdQe8fdRYZRdSeRfdTYZSejTrdUe8fdVYZUdWeUfdXYZVdYe8fdZYZWneReSf\ZUZVeRZWd[e8fd\YZXd]eXfd^YZYd_e8fd`YZZdaeZfdbYZ[dce8fddYZ\dee\fdfYZ]dge8fdhYZ^die^fdjYZ_dke8fdlYZ`dme`fdnYZadoe8fdpYZbdqebfdrYZcdse8fdtYZdduedfdvYZedweJfdxYZfdyeffdzYZgd{egfd|YZhd}effd~YZideJfdYZjde8fdYZkde8fdYZlde8fdYZmdS(s 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 ClassTypet InstanceType(twarnt warn_expliciti(t getargspec(t import_item(tSentinel(tBuncht Undefinedt traitletssA Used in Traitlets to specify that no defaults are set in kwargs tAllsi Used in Traitlets to listen to all types of notification or to notifications from all trait attributes. t TraitErrorcBseZRS((t__name__t __module__(((s2lib/python2.7/site-packages/traitlets/traitlets.pyR Ws(tcast_unicode_py2s[a-zA-Z_][a-zA-Z0-9_]*$cCs*tjrttj|S|jSdS(N(tsixtPY2tboolt_name_retmatcht isidentifier(ts((s2lib/python2.7/site-packages/traitlets/traitlets.pyRbs cCsMtjjd}|r(|dkr(tS|tkrEtj|tStSdS(sZAdd our own checks for too many deprecation warnings. Limit to once per package. tTRAITLETS_ALL_DEPRECATIONSt0N(tostenvirontgettTruet_deprecations_showntaddtFalse(tkeytenv_flag((s2lib/python2.7/site-packages/traitlets/traitlets.pyt _should_warnis  c Csdjd|jd|d|}x0tj|D]}||jkr1|}Pq1q1W|jjddd}||f}t|sdSy2tj|pd }tj |dpd} Wn.t t fk r} t |d | t nXt|t || dS( sShow deprecation warning about a magic method definition. Uses warn_explicit to bind warning to method definition instead of triggering code, which isn't relevant. s?{classname}.{method_name} is deprecated in traitlets 4.1: {msg}t classnamet method_nametmsgt.iiNs s (inspection failed) %s(tformatR tinspecttgetmrot__dict__R tsplitR!t getsourcefiletgetsourcelinestIOErrort TypeErrorRtDeprecationWarningR( tmethodtclsR#R$twarn_msgtparentt package_nameRtfnametlinenote((s2lib/python2.7/site-packages/traitlets/traitlets.pyt_deprecated_methodxs    cCs,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 isinstanceRt string_typest add_articlet __class__R (tobject((s2lib/python2.7/site-packages/traitlets/traitlets.pytclass_ofs 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((s2lib/python2.7/site-packages/traitlets/traitlets.pyR;scCsAt|}tjr-|tkr-|j}nd||f}|S(s] Return a string representation of a value and its type for readable error messages. s%r %r(ttypeRRRR<(tobjtthe_typeR$((s2lib/python2.7/site-packages/traitlets/traitlets.pyt repr_types   cCs+t|tp*t|to*t|tS(sN Returns whether the given value is an instance or subclass of TraitType. (R9t TraitTypeRBt issubclass(tt((s2lib/python2.7/site-packages/traitlets/traitlets.pytis_traitscCs}|tkst|tjr%|gS| s8t|kr?tgSx3|D]+}t|tjsFtd|qFqFW|SdS(sConvert the name argument to a list of names. Examples -------- >>> parse_notifier_name([]) [All] >>> parse_notifier_name('a') ['a'] >>> parse_notifier_name(['a', 'b']) ['a', 'b'] >>> parse_notifier_name(All) [All] snames must be strings, not %rN(R R9RR:R.(tnamestn((s2lib/python2.7/site-packages/traitlets/traitlets.pytparse_notifier_names t _SimpleTestcBs,eZdZdZdZdZRS(cCs ||_dS(N(tvalue(tselfRN((s2lib/python2.7/site-packages/traitlets/traitlets.pyt__init__scCs ||jkS(N(RN(ROttest((s2lib/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|jd|d|dj|jd|dXdS(NiiRJ(RbtsourcettargettsetattrRVtobservet_update_targett_update_source(RORdRe((s2lib/python2.7/site-packages/traitlets/traitlets.pyRPs  -ccs#t|_z dVWdt|_XdS(N(RtupdatingR(RO((s2lib/python2.7/site-packages/traitlets/traitlets.pyt_busy_updatings  cCsE|jr dS|j&t|jd|jd|jWdQXdS(Nii(RjRkRfRetnew(ROtchange((s2lib/python2.7/site-packages/traitlets/traitlets.pyRhs  cCsE|jr dS|j&t|jd|jd|jWdQXdS(Nii(RjRkRfRdRl(RORm((s2lib/python2.7/site-packages/traitlets/traitlets.pyRi%s  cCs^|jdj|jd|jd|jdj|jd|jdd\|_|_dS(NiRJi(NN(Rdt unobserveRhReRitNone(RO((s2lib/python2.7/site-packages/traitlets/traitlets.pytunlink+s$$( R R t__doc__RRjRPt contextlibtcontextmanagerRkRhRiRp(((s2lib/python2.7/site-packages/traitlets/traitlets.pyRcs    tdirectional_linkcBsDeZdZeZddZejdZ dZ dZ RS(sLink the trait of a source object with traits of target objects. Parameters ---------- source : (object, attribute name) pair target : (object, attribute name) pair transform: callable (optional) Data transformation between source and target. Examples -------- >>> c = directional_link((src, 'value'), (tgt, 'value')) >>> src.value = 5 # updates target objects >>> tgt.value = 6 # does not update source object cCs|r |nd|_t|||||_|_z6t|d|d|jt|d|dWd|jdj|jd|jdXdS(NcSs|S(N((tx((s2lib/python2.7/site-packages/traitlets/traitlets.pytEsiiRJ(t _transformRbRdReRfRVRgt_update(RORdRet transform((s2lib/python2.7/site-packages/traitlets/traitlets.pyRPDs %ccs#t|_z dVWdt|_XdS(N(RRjR(RO((s2lib/python2.7/site-packages/traitlets/traitlets.pyRkNs  c CsN|jr dS|j/t|jd|jd|j|jWdQXdS(Nii(RjRkRfReRwRl(RORm((s2lib/python2.7/site-packages/traitlets/traitlets.pyRxVs   cCs:|jdj|jd|jdd\|_|_dS(NiRJi(NN(RdRnRxRoRe(RO((s2lib/python2.7/site-packages/traitlets/traitlets.pyRp]s$N( R R RqRRjRoRPRrRsRkRxRp(((s2lib/python2.7/site-packages/traitlets/traitlets.pyRt1s   tBaseDescriptorcBs,eZdZdZdZdZdZRS(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. cCs||_||_dS(sEPart of the initialization which may depend on the underlying HasDescriptors class. It is typically overloaded for specific types. This method is called by :meth:`MetaHasDescriptors.__init__` passing the class (`cls`) and `name` under which the descriptor has been assigned. N(t this_classRA(ROR1RA((s2lib/python2.7/site-packages/traitlets/traitlets.pyt class_inits cCsdS(sLPart of the initialization which may depend on the underlying HasDescriptors 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((RORC((s2lib/python2.7/site-packages/traitlets/traitlets.pyt instance_inits N(R R RqRoRAR{R|R}(((s2lib/python2.7/site-packages/traitlets/traitlets.pyRzis  RFcBseZdZiZeZeZeZdZ eeddddZ dZ dZ dZdZddZddZd Zd Zd Zd Zd ZdZdZddZdZdZdZRS(s&A base class for all trait types. s any valuec Ks|tk r||_n|r*||_n|d k rB||_n|d k rT|nd|_t|dkrfd}tj}x)|j j dkr|d7}|j }qW|j j dpd} | jddd} td| gt|} t| r td|ftd |nt|jdkrZ|jj|_|jj|qx||_n|jj|_|d k r||jd RRER (RORCRNR7((s2lib/python2.7/site-packages/traitlets/traitlets.pyterroris cCsE|dkrd}nd}td|tdd|jj||S(snDEPRECATED: Get a metadata value. Use .metadata[key] or .metadata.get(key, default) instead. Rs3use the instance .help string directly, like x.helpsduse the instance .metadata dictionary directly, like x.metadata[key] or x.metadata.get(key, default)sDeprecated in traitlets 4.1, Ri(RR/RR(RORtdefaultR$((s2lib/python2.7/site-packages/traitlets/traitlets.pyt get_metadatass   cCsC|dkrd}nd}td|tdd||j|>> Int(0).tag(config=True, sync=True) RRRRscThe following attributes are set in using `tag`, but seem to be constructor keywords arguments: %s Ri(Rtkeyst intersectionRt UserWarningRR(RORtmaybe_constructor_keywords((s2lib/python2.7/site-packages/traitlets/traitlets.pyttags 'cCs t|jS(N(treprR(RO((s2lib/python2.7/site-packages/traitlets/traitlets.pytdefault_value_reprsN(R R RqRRRRRRRRoRPRRRR}RRRRRRRRRRRRR(((s2lib/python2.7/site-packages/traitlets/traitlets.pyRFs2  0      t_CallbackWrappercBs)eZdZdZdZdZRS(sAn object adapting a on_trait_change callback into an observe callback. The comparison operator __eq__ is implemented to enable removal of wrapped callbacks. cCsi||_t|jtjr$dnd}tt|d||_|jdkretdndS(Niiis1a trait changed callback must have 0-4 arguments.(tcbR9RRR]RtnargsR (RORtoffset((s2lib/python2.7/site-packages/traitlets/traitlets.pyRPs  !cCs0t|tr|j|jkS|j|kSdS(N(R9RR(ROR((s2lib/python2.7/site-packages/traitlets/traitlets.pyt__eq__scCs|jdkr|jn|jdkr>|j|jn|jdkrf|j|j|jnb|jdkr|j|j|j|jn4|jdkr|j|j|j|j|jndS(Niiiii(RRRARltoldR(RORm((s2lib/python2.7/site-packages/traitlets/traitlets.pyRRs (R R RqRPRRR(((s2lib/python2.7/site-packages/traitlets/traitlets.pyRs  cCs!t|tr|St|SdS(N(R9R(R((s2lib/python2.7/site-packages/traitlets/traitlets.pyt_callback_wrapperstMetaHasDescriptorscBs)eZdZdZdZdZRS(sA metaclass for HasDescriptors. This metaclass makes sure that any TraitType class attributes are instantiated and sets their name attribute. cCs}x[|jD]M\}}tj|r t|tr tdtdd|||        c Cs2|jtd|d|d|d|dddS(NRARRlRRBRm(RR(RORARR((s2lib/python2.7/site-packages/traitlets/traitlets.pyRms  c Cst|tst|}n|j|j}}g}|j|jj|ij|g|j|jj|ijtg|j|jjtij|g|j|jjtijtgd|}t||r^t |j |}t|t s^t ||j |dt ||}||kr[|j t|q[q^nxf|D]^}t|tr|j}n3t|tr|jdk rt ||j}n||qeWdS(Ns _%s_changeds$use @observe and @unobserve instead.(R9RRARBtextendRRR RRVR<RR8RXRRRRRRo( RORmRARBt callablest magic_namet class_valueRtc((s2lib/python2.7/site-packages/traitlets/traitlets.pyRvs.((((    cCs||jkr,g}i||6|j|||j|krYg}||j|||tkri|_n"y|j|=Wntk r9nXdS(sRemove trait change handlers of any type for the specified name. If name is not specified, removes all trait notifiers.N(R RR(RORA((s2lib/python2.7/site-packages/traitlets/traitlets.pyt unobserve_alls    cCsxd|D]\}d|}t||rt|j|}t|tsct||j|dqcqqWx|D]}||j|Forcibly sets trait attribute, including read-only attributes.s'Class %s does not have a trait named %sN(R<RR R RVR(RORARNR1((s2lib/python2.7/site-packages/traitlets/traitlets.pyR8s  cKst|j|S(sGet a list of all the names of this class' traits. This method is just like the :meth:`trait_names` method, but is unbound. (Rt class_traits(R1R((s2lib/python2.7/site-packages/traitlets/traitlets.pytclass_trait_namesAsc Kstgt|D]}t|dtr|^q}t|dkrN|Si}x|jD]v\}}xg|jD]O\}}t|tjk rt |}n||j j |dszPqzqzW|||ts (RRR(R1R((Rs2lib/python2.7/site-packages/traitlets/traitlets.pytclass_own_traitsmscCstt|j|dtS(s?Returns True if the object has a trait with the specified name.N(R9RVR<RoRF(RORA((s2lib/python2.7/site-packages/traitlets/traitlets.pyRwscKst|j|S(s2Get a list of all the names of this class' traits.(RR_(ROR((s2lib/python2.7/site-packages/traitlets/traitlets.pyR{sc Kstgt|jD]}t|dtr|^q}t|dkrQ|Si}x|jD]v\}}xg|jD]O\}}t|tj k rt |}n||j j |ds}Pq}q}W|||s (RteventsR(R1RA((Rs2lib/python2.7/site-packages/traitlets/traitlets.pytclass_own_trait_eventsscCsi}xt|D]\}}t|tr|dkrG||| type resolution for Type, Instance and This. cCs t|S(sM Resolve a string supplied for a type into an actual object. (R(ROtstring((s2lib/python2.7/site-packages/traitlets/traitlets.pyt_resolve_stringscCst|}tjr4|tkr4d|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.( RBRRRR<R tstrRRoRAR>RR (RORCRNtkindR$R7((s2lib/python2.7/site-packages/traitlets/traitlets.pyRs # (R R RqR&R(((s2lib/python2.7/site-packages/traitlets/traitlets.pyR$s tTypecBsJeZdZeddZdZdZdZdZ dZ 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( RRoR=R'RR9RR:R tklassRR)RP(RORR*Rtnew_default_value((s2lib/python2.7/site-packages/traitlets/traitlets.pyRPs    ! 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( R9RR:R&t ImportErrorR RARGR*R(RORCRN((s2lib/python2.7/site-packages/traitlets/traitlets.pyR$s cCsZt|jtjr!|j}n|jjd|jj}d|}|jrV|dS|S(s$ Returns a description of the trait.R%sa subclass of '%s's or None(R9R*RR:R R R(ROR*R((s2lib/python2.7/site-packages/traitlets/traitlets.pyR4s   cCs$|jtt|j|dS(N(t_resolve_classesRR)R}(RORC((s2lib/python2.7/site-packages/traitlets/traitlets.pyR}?s cCs^t|jtjr-|j|j|_nt|jtjrZ|j|j|_ndS(N(R9R*RR:R&R(RO((s2lib/python2.7/site-packages/traitlets/traitlets.pyR-CscCsE|j}t|tjr%t|Stdj|j|jSdS(Ns{}.{}(RR9RR:RR&R R (RORN((s2lib/python2.7/site-packages/traitlets/traitlets.pyRIs  N( R R RqRRoRPRRR}R-R(((s2lib/python2.7/site-packages/traitlets/traitlets.pyR)s*   tInstancecBs\eZdZdZddddZdZdZdZdZ dZ 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(svConstruct 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 False ] 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(RoR*R'RR9RR:R RRt default_argstdefault_kwargsRR.RP(ROR*RtkwR((s2lib/python2.7/site-packages/traitlets/traitlets.pyRP[s  -    cCs*t||jr|S|j||dS(N(R9R*R(RORCRN((s2lib/python2.7/site-packages/traitlets/traitlets.pyRscCsNt|jtjr!|j}n |jj}t|}|jrJ|dS|S(Ns or None(R9R*RR:R R>R(ROR*R((s2lib/python2.7/site-packages/traitlets/traitlets.pyRs    cCs$|jtt|j|dS(N(R-RR.R}(RORC((s2lib/python2.7/site-packages/traitlets/traitlets.pyR}s cCs1t|jtjr-|j|j|_ndS(N(R9R*RR:R&(RO((s2lib/python2.7/site-packages/traitlets/traitlets.pyR-scCsD|jdkr"|jdkr"dS|j|jp4d|jp@iS(N((R/RoR0R*(RO((s2lib/python2.7/site-packages/traitlets/traitlets.pyRscCst|jS(N(RR(RO((s2lib/python2.7/site-packages/traitlets/traitlets.pyRsN( R R RqRoR*RPRRR}R-RR(((s2lib/python2.7/site-packages/traitlets/traitlets.pyR.Qs.    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%(R{R RR(ROR%tmodname((s2lib/python2.7/site-packages/traitlets/traitlets.pyR&s (R R RqR&(((s2lib/python2.7/site-packages/traitlets/traitlets.pyR2stForwardDeclaredTypecBseZdZRS(s+ Forward-declared version of Type. (R R Rq(((s2lib/python2.7/site-packages/traitlets/traitlets.pyR4stForwardDeclaredInstancecBseZdZRS(s/ Forward-declared version of Instance. (R R Rq(((s2lib/python2.7/site-packages/traitlets/traitlets.pyR5stThiscBs&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(RR6RPRo(ROR((s2lib/python2.7/site-packages/traitlets/traitlets.pyRPscCs6t||js|dkr"|S|j||dS(N(R9R{RoR(RORCRN((s2lib/python2.7/site-packages/traitlets/traitlets.pyRs(R R RqRRPR(((s2lib/python2.7/site-packages/traitlets/traitlets.pyR6s RcBsDeZdZdZdZdZdZdZdZRS(s'A trait type representing a Union type.cKsQ||_djg|jD]}|j^q|_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 N(RRRRRRRP(RORRttt((s2lib/python2.7/site-packages/traitlets/traitlets.pyRPs .cCsAx!|jD]}|j|dq Wtt|j||dS(N(RR|RoRR(ROR1RAt trait_type((s2lib/python2.7/site-packages/traitlets/traitlets.pyR|scCs;x|jD]}|j|q Wtt|j|dS(N(RR}RR(RORCR8((s2lib/python2.7/site-packages/traitlets/traitlets.pyR}sc Cs|jzxr|jD]g}yJ|j||}|jdk r_t|d|jd|jn|SWqtk rzqqXqWWdQX|j||dS(NRR( RRRRARoRfRR R(RORCRNR8R((s2lib/python2.7/site-packages/traitlets/traitlets.pyRs ! cCs;t|tr#t|j|jSt|j|gSdS(N(R9RR(ROR((s2lib/python2.7/site-packages/traitlets/traitlets.pyR scCs]|jtk r|jSx@|jD]5}|jtk r<|jSt|dr |jSq WdS(NR(RRRRR(ROR8((s2lib/python2.7/site-packages/traitlets/traitlets.pyRs( R R RqRPR|R}RRR(((s2lib/python2.7/site-packages/traitlets/traitlets.pyRs    tAnycBseZdZdZdZRS(sA trait which allows any value.s any valueN(R R RqRoRR(((s2lib/python2.7/site-packages/traitlets/traitlets.pyR9"sc Cs|jdk rW||jkrWtdjd|jdt|d|d|jn|jdk r||jkrtdjd|jdt|d|d|jn|S( s Validate that a number to be applied to a trait is between bounds. If value is not between min_bound and max_bound, this raises a TraitError with an error message appropriate for this trait. s}The value of the '{name}' trait of {klass} instance should not be less than {min_bound}, but a value of {value} was specifiedRAR*RNt min_boundsThe value of the '{name}' trait of {klass} instance should not be greater than {max_bound}, but a value of {value} was specifiedt max_boundN(tminRoR R&RAR>tmax(RRCRN((s2lib/python2.7/site-packages/traitlets/traitlets.pyt_validate_bounds(s  tIntcBs2eZdZdZdZeedZdZRS(s An int trait.isan intcKsP|jdd|_|jdd|_tt|jd|d||dS(NR<R=RR(RRoR<R=RR?RP(RORRR((s2lib/python2.7/site-packages/traitlets/traitlets.pyRPFscCs2t|ts"|j||nt|||S(N(R9tintRR>(RORCRN((s2lib/python2.7/site-packages/traitlets/traitlets.pyRLs( R R RqRRRRRPR(((s2lib/python2.7/site-packages/traitlets/traitlets.pyR?@s tCIntcBseZdZdZRS(s#A casting version of the int trait.cCs:yt|}Wn|j||nXt|||S(N(R@RR>(RORCRN((s2lib/python2.7/site-packages/traitlets/traitlets.pyRUs (R R RqR(((s2lib/python2.7/site-packages/traitlets/traitlets.pyRARstLongcBs;eZdZdZdZeedZdZdZ RS(sA long integer trait.isa longcKsP|jdd|_|jdd|_tt|jd|d||dS(NR<R=RR(RRoR<R=RRBRP(RORRR((s2lib/python2.7/site-packages/traitlets/traitlets.pyRPds cCs@t|tr|St|tr,t|S|j||dS(N(R9tlongR@R(RORCRN((s2lib/python2.7/site-packages/traitlets/traitlets.pyt_validate_longks  cCs"|j||}t|||S(N(RDR>(RORCRN((s2lib/python2.7/site-packages/traitlets/traitlets.pyRrs( R R RqRRRRRPRDR(((s2lib/python2.7/site-packages/traitlets/traitlets.pyRB^s  tCLongcBseZdZdZRS(s,A casting version of the long integer trait.cCs:yt|}Wn|j||nXt|||S(N(RCRR>(RORCRN((s2lib/python2.7/site-packages/traitlets/traitlets.pyRzs (R R RqR(((s2lib/python2.7/site-packages/traitlets/traitlets.pyREwstIntegercBs;eZdZdZdZeedZdZdZ RS(sWAn integer trait. Longs that are unnecessary (<= sys.maxint) are cast to ints.is an integercKsP|jdd|_|jdd|_tt|jd|d||dS(NR<R=RR(RRoR<R=RRFRP(RORRR((s2lib/python2.7/site-packages/traitlets/traitlets.pyRPs cCs{t|tr|St|tr,t|Stjdkrgddlm}t||rgt|Sn|j||dS(Ntclii(tInt64(R9R@RCtsystplatformtSystemRHR(RORCRNRH((s2lib/python2.7/site-packages/traitlets/traitlets.pyt _validate_ints  cCs"|j||}t|||S(N(RLR>(RORCRN((s2lib/python2.7/site-packages/traitlets/traitlets.pyRs( R R RqRRRRRPRLR(((s2lib/python2.7/site-packages/traitlets/traitlets.pyRFs  tFloatcBs2eZdZdZdZeedZdZRS(sA float trait.gsa floatcKs]|jdtd |_|jdtd|_tt|jd|d||dS(NR<tinfR=RR(RtfloatR<R=RRMRP(RORRR((s2lib/python2.7/site-packages/traitlets/traitlets.pyRPscCsPt|trt|}nt|ts@|j||nt|||S(N(R9R@RORR>(RORCRN((s2lib/python2.7/site-packages/traitlets/traitlets.pyRs ( R R RqRRRRRPR(((s2lib/python2.7/site-packages/traitlets/traitlets.pyRMs tCFloatcBseZdZdZRS(s%A casting version of the float trait.cCs:yt|}Wn|j||nXt|||S(N(RORR>(RORCRN((s2lib/python2.7/site-packages/traitlets/traitlets.pyRs (R R RqR(((s2lib/python2.7/site-packages/traitlets/traitlets.pyRPstComplexcBs#eZdZdZdZdZRS(sA trait for complex numbers.gysa complex numbercCsFt|tr|St|ttfr2t|S|j||dS(N(R9tcomplexROR@R(RORCRN((s2lib/python2.7/site-packages/traitlets/traitlets.pyRs  y(R R RqRRR(((s2lib/python2.7/site-packages/traitlets/traitlets.pyRQstCComplexcBseZdZdZRS(s.A casting version of the complex number trait.cCs,yt|SWn|j||nXdS(N(RRR(RORCRN((s2lib/python2.7/site-packages/traitlets/traitlets.pyRs(R R RqR(((s2lib/python2.7/site-packages/traitlets/traitlets.pyRSstBytescBs#eZdZdZdZdZRS(sA trait for byte strings.R~sa bytes objectcCs't|tr|S|j||dS(N(R9tbytesR(RORCRN((s2lib/python2.7/site-packages/traitlets/traitlets.pyRs(R R RqRRR(((s2lib/python2.7/site-packages/traitlets/traitlets.pyRTstCBytescBseZdZdZRS(s+A casting version of the byte string trait.cCs,yt|SWn|j||nXdS(N(RUR(RORCRN((s2lib/python2.7/site-packages/traitlets/traitlets.pyRs(R R RqR(((s2lib/python2.7/site-packages/traitlets/traitlets.pyRVstUnicodecBs#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.( R9Rt text_typeRUtdecodetUnicodeDecodeErrorR R&RAR>R(RORCRNR$((s2lib/python2.7/site-packages/traitlets/traitlets.pyRs +(R R RqRRR(((s2lib/python2.7/site-packages/traitlets/traitlets.pyRWstCUnicodecBseZdZdZRS(s'A casting version of the unicode trait.cCs/ytj|SWn|j||nXdS(N(RRZR(RORCRN((s2lib/python2.7/site-packages/traitlets/traitlets.pyR s(R R RqR(((s2lib/python2.7/site-packages/traitlets/traitlets.pyR] st ObjectNamecBsAeZdZdZejr'dZnedZdZRS(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 PythoncCsHt|trDyt|SWqDtk r@|j||qDXn|S(s-In Python 2, coerce ascii-only unicode to str(R9tunicodeR'tUnicodeEncodeErrorR(RORCRN((s2lib/python2.7/site-packages/traitlets/traitlets.pyt coerce_strs  cCs|S(N((RR((s2lib/python2.7/site-packages/traitlets/traitlets.pyRv$scCsH|j||}t|tjr4t|r4|S|j||dS(N(RaR9RR:RR(RORCRN((s2lib/python2.7/site-packages/traitlets/traitlets.pyR&s( R R RqRRRRat staticmethodR(((s2lib/python2.7/site-packages/traitlets/traitlets.pyR^s   tDottedObjectNamecBseZdZdZRS(sFA string holding a valid dotted object name in Python, such as A.b3._ccCs[|j||}t|tjrGtd|jdDrG|S|j||dS(Ncss|]}t|VqdS(N(R(Rta((s2lib/python2.7/site-packages/traitlets/traitlets.pys 2sR%(RaR9RR:tallR*R(RORCRN((s2lib/python2.7/site-packages/traitlets/traitlets.pyR/s (R R RqR(((s2lib/python2.7/site-packages/traitlets/traitlets.pyRc-stBoolcBs#eZdZeZdZdZRS(sA boolean (True, False) trait.s a booleancCs't|tr|S|j||dS(N(R9RR(RORCRN((s2lib/python2.7/site-packages/traitlets/traitlets.pyR>s(R R RqRRRR(((s2lib/python2.7/site-packages/traitlets/traitlets.pyRf8stCBoolcBseZdZdZRS(s'A casting version of the boolean trait.cCs,yt|SWn|j||nXdS(N(RR(RORCRN((s2lib/python2.7/site-packages/traitlets/traitlets.pyRGs(R R RqR(((s2lib/python2.7/site-packages/traitlets/traitlets.pyRgDstEnumcBs,eZdZedZdZdZRS(s0An enum whose value must be in a given sequence.cKsM||_|jdtr0|tkr0d}ntt|j||dS(NR(RRRRRoRRhRP(RORRR((s2lib/python2.7/site-packages/traitlets/traitlets.pyRPQs  cCs'||jkr|S|j||dS(N(RR(RORCRN((s2lib/python2.7/site-packages/traitlets/traitlets.pyRWscCs(dt|j}|jr$|dS|S(s$ Returns a description of the trait.sany of s or None(RRR(ROR((s2lib/python2.7/site-packages/traitlets/traitlets.pyR\s (R R RqRRPRR(((s2lib/python2.7/site-packages/traitlets/traitlets.pyRhNs  tCaselessStrEnumcBs#eZdZedZdZRS(s4An enum of strings where the case should be ignored.cKsBg|D]}t|^q}tt|j|d||dS(NR(RRRiRP(RORRRRN((s2lib/python2.7/site-packages/traitlets/traitlets.pyRPfscCst|trt|}nt|tjsC|j||nx-|jD]"}|j|jkrM|SqMW|j||dS(N(R9R'RRR:RRR@(RORCRNR((s2lib/python2.7/site-packages/traitlets/traitlets.pyRjs(R R RqRRPR(((s2lib/python2.7/site-packages/traitlets/traitlets.pyRics t ContainercBsbeZdZdZdZeZdZdddZ dZ dZ dZ dZ dZRS( 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|trtdt ddnt|tr|n||_ n%|dk rtdt |nt t |jd|jd||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 **kwargs : any further keys for extensions to the Trait (e.g. config) sdefault value of %s was %ssTraits should be given as instances, not types (for example, `Int()`, not `Int`). Passing types is deprecated in traitlets 4.1.Ris'`trait` must be a Trait or None, got %sR*RN((RoRIR9t_valid_defaultsR.R<R RBRR/t_traitRERRjRPR*(RORRRR((s2lib/python2.7/site-packages/traitlets/traitlets.pyRPs !     $ 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.(RAR>RRER (RORCtelementt validatorR7((s2lib/python2.7/site-packages/traitlets/traitlets.pyt element_errors(cCset||jr$|j|}ntt|j||}|dkrO|S|j||}|S(N(R9t _cast_typesR*RRjRRotvalidate_elements(RORCRN((s2lib/python2.7/site-packages/traitlets/traitlets.pyRs cCsg}|jdks't|jtr+|Sx^|D]V}y|jj||}Wn'tk rz|j|||jq2X|j|q2W|j|S(N( RlRoR9R9RR RoRXR*(RORCRNt validatedR((s2lib/python2.7/site-packages/traitlets/traitlets.pyRqs!  cCsEt|jtr(|jj|dntt|j||dS(N(R9RlRFR|RoRRj(ROR1RA((s2lib/python2.7/site-packages/traitlets/traitlets.pyR|scCs?t|jtr%|jj|ntt|j|dS(N(R9RlRFR}RRj(RORC((s2lib/python2.7/site-packages/traitlets/traitlets.pyR}sN((R R RqRoR*Rpt SequenceTypesRkRlRPRoRRqR|R}(((s2lib/python2.7/site-packages/traitlets/traitlets.pyRjus7  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 RRN(t_minlent_maxlenRRtRP(RORRtminlentmaxlenR((s2lib/python2.7/site-packages/traitlets/traitlets.pyRPs  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.(RAR>RuRvR (RORCRNR7((s2lib/python2.7/site-packages/traitlets/traitlets.pyt length_error s%cCsVt|}||jks*||jkr=|j||ntt|j||S(N(R]RuRvRyRRtRq(RORCRNtlength((s2lib/python2.7/site-packages/traitlets/traitlets.pyRq s cCs1tt|j||}|j||}|S(N(RRtRRq(RORCRN((s2lib/python2.7/site-packages/traitlets/traitlets.pyR sN(R R RqRR*RRpRoRItmaxsizeRPRyRqR(((s2lib/python2.7/site-packages/traitlets/traitlets.pyRts $  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(RR|RP(RORRRwRxR((s2lib/python2.7/site-packages/traitlets/traitlets.pyRP s N( R R RqRR*RRRpRoRIR{RP(((s2lib/python2.7/site-packages/traitlets/traitlets.pyR| s tTuplecBsAeZdZeZefZdZdZdZ dZ RS(sAn instance of a Python tuple.cOsW|jdt}t|dkrT|tkrTt|d rT|d}d }n|tkrid }n:t||jr|f}ntd|jj|fg|_ xa|D]Y}t|t rt dt ddnt|t r|n|}|j j |qW|j r.|d kr.d }ntt|jd|jd ||d S( s Create 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, ``default_value`` must conform to the shape and type they specify. Riisdefault value of %s was %ss~Traits should be given as instances, not types (for example, `Int()`, not `Int`) Passing types is deprecated in traitlets 4.1.RiR*RN(((RRR]RIR9RkR.R<R t_traitsRBRR/RXRoRRjRPR*(ROR_RRRRRH((s2lib/python2.7/site-packages/traitlets/traitlets.pyRPG 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~R]RAR>RER tzipRRoRXR(RORCRNR7RrRHR((s2lib/python2.7/site-packages/traitlets/traitlets.pyRq s + cCsSx3|jD](}t|tr |j|dq q Wtt|j||dS(N(R~R9RFR|RoRRj(ROR1RAR((s2lib/python2.7/site-packages/traitlets/traitlets.pyR| scCsMx0|jD]%}t|tr |j|q q Wtt|j|dS(N(R~R9RFR}RRj(RORCR((s2lib/python2.7/site-packages/traitlets/traitlets.pyR} s( R R RqRR*RRpRPRqR|R}(((s2lib/python2.7/site-packages/traitlets/traitlets.pyR}B s  9  tDictcBsSeZdZdZddedZdZdZdZ dZ dZ RS(sAn instance of a Python dict.cKsO|tkr6|dk r6t|s6|}d}q6n|tkrKi}n|dkr`d}nFt|tr{|f}n+t|tr|f}ntd|t|rt|trtdt ddnt|tr|n||_ n%|dk r tdt |n||_ t t|jdtd||dS( sCreate a dict trait type from a Python dict. The default value is created by doing ``dict(default_value)``, which creates a copy of the ``default_value``. Parameters ---------- trait : TraitType [ optional ] The specified trait type to check and use to restrict contents of the Container. If unspecified, trait types are not checked. traits : Dictionary of trait types [ optional ] A Python dictionary containing the types that are valid for restricting the content of the Dict Container 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~Traits should be given as instances, not types (for example, `Int()`, not `Int`) Passing types is deprecated in traitlets 4.1.Ris'`trait` must be a Trait or None, got %sR*RN(RRoRIR9RRsR.RBRR/RlRER~RRRP(RORR_RRR((s2lib/python2.7/site-packages/traitlets/traitlets.pyRP 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.(RAR>RRER (RORCRmRnR7((s2lib/python2.7/site-packages/traitlets/traitlets.pyRo s(cCsAtt|j||}|dkr+|S|j||}|S(N(RRRRoRq(RORCRN((s2lib/python2.7/site-packages/traitlets/traitlets.pyR s  c Cst|j}|jpt}| r;t|tr;|Si}x|D]}|rs||jkrs|j|}n|}y2||}t|ts|j||}nWn$tk r|j|||qHX|||R;RERIRLRMRoR\RbR=RcRttdlinkRzRFRRRRRgRRRRRRRtwith_metaclassRR^R$R)R.R2R4R5R6RR9R>R?RARRBRERFRMRPRQRSRTRVRWR]R^RcRfRgRhRiRjRtR|R}RRRR(((s2lib/python2.7/site-packages/traitlets/traitlets.pyt#s                     300 # '   +   """Z[ D   "        i;)^o