Ibn6ddlZddlmZmZmZ ddlmZGddeZ Gdd eZ y#e$rddlZddlZddl Z d dZd dZ Y2wxYw) N)ClassBasedTraitType Undefinedwarn)describect|tr|j}tj|st |j }n |j }|rt||z}|dk(s|8tj|s"||d|}| t|d|S|Sd}tj|r |j }nt|tjr|j }d}nt|tjr|jj }d}nUt |jtjt jfvrdt|dd}d}n t!|}d}|rt||z}|r|j#d}t%||||| S|d vs|||St|d|St'd |) aReturn string that describes a value Parameters ---------- article : str or None A definite or indefinite article. If the article is indefinite (i.e. "a" or "an") the appropriate one will be infered. Thus, the arguments of ``describe`` can themselves represent what the resulting string will actually look like. If None, then no article will be prepended to the result. For non-articled description, values that are instances are treated definitely, while classes are handled indefinitely. value : any The value which will be named. name : str or None (default: None) Only applies when ``article`` is "the" - this ``name`` is a definite reference to the value. By default one will be infered from the value's type and repr methods. verbose : bool (default: False) Whether the name should be concise or verbose. When possible, verbose names include the module, and/or class name where an object was defined. capital : bool (default: False) Whether the first letter of the article should be capitalized or not. By default it is not. Examples -------- Indefinite description: >>> describe("a", object()) 'an object' >>> describe("a", object) 'an object' >>> describe("a", type(object)) 'a type' Definite description: >>> describe("the", object()) "the object at '0x10741f1b0'" >>> describe("the", object) "the type 'object'" >>> describe("the", type(object)) "the type 'type'" Definitely named description: >>> describe("the", object(), "I made") 'the object I made' >>> describe("the", object, "I will use") 'the object I will use' the TFzat 'x'z'')nameverbosecapital)aanz?The 'article' argument should be 'the', 'a', 'an', or None not ) isinstancestrlowerinspectisclasstype__name___prefix add_articletypes FunctionType MethodType__func____repr__objectidreprjoinr ValueError)articlevaluer r rtypenameresult tick_wraps 5/usr/lib/python3/dist-packages/notebook/traittypes.pyrrsb gs #mmoGu%E{++H~~H u~0H e 8N$:Qtf-&&vtW==!M! ??5) >>Du'9'9: >>D $Iu'7'78 >>22D $I%[))foot}}-MM!"U)Aa0D#G;D#G"5>D0D99T?DT#W66  #wx8 8QRYQ\] c|rd|z}nEtjdjd|}|ddjdvrd|z}nd|z}|r|d j |ddzS|S) aReturns the string with a prepended article. The input does not need to begin with a charater. Parameters ---------- definite : bool (default: False) Whether the article is definite or not. Indefinite articles being 'a' and 'an', while 'the' is definite. capital : bool (default: False) Whether the added article should have its first letter capitalized or not. zthe z[\W_]+Naeiouzan za r)recompilesubrupper)r definiterr' first_letterss r)rrssy d]FJJy155b$?MRa &&(G3 !9??$vabz1 1Mr*cPeZdZdZedffd ZdZdZdZfdZ dZ d Z xZ S) TypeFromClasseszQA trait whose value must be a subclass of a class in a specified list of classes.Nc H|tur |tn|}n|}|||turtg}n|g}t|ttt fs t d|D]3}tj|rt|tr*t d||_ t|0|fi|y)a0Construct a Type trait A Type trait specifies that its values must be subclasses of a class in a list of possible classes. If only ``default_value`` is given, it is used for the ``klasses`` 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. klasses : list of 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. NzA`klasses` must be a list of class names (type is str) or classes.z1A OneOfType trait must specify a list of classes.) rrrlisttupleset TraitErrorrrrklassessuper__init__)self default_valuer<kwargsnew_default_valueklass __class__s r)r>zTypeFromClasses.__init__s* I %+2?  -  ?%=I+E!((/'D%#56`a a VEOOE*j.D !TUU V   *5f5r*c@tfd|jDS)CCheck that a given class is a subclasses found in the klasses list.c36K|]}t|ywN) issubclass.0rCr%s r) z8TypeFromClasses.subclass_from_klasses..Q:eU+Qanyimportable_klassesr?r%s `r)subclass_from_klassesz%TypeFromClasses.subclass_from_klassesQ9P9PQQQr*c  t|tr |j|} |j |r|S |j||y#t$r t d|j d|d|dwxYw#t$rYJwxYw)z4Validates that the value is a valid object instance.zThe 'z ' trait of z instance must be a type, but z could not be importedN) rr_resolve_string ImportErrorr;r rS Exceptionerrorr?objr%s r)validatezTypeFromClasses.validates eS ! ,,U3  ))%0 1 3  DII;k#7 )#9;    sA A7 )A47 BBcd}|jD]6}t|ts|jdz|jz}||dz }8|j d}|j r|dzS|S)z#Returns a description of the trait.za subclass of . or  or None)r<rr __module__rstrip allow_noner?r'rCs r)infozTypeFromClasses.infost!\\ %EeS)((3.? tn $F % f% ??J& & r*cD|jt| |yrH_resolve_classesr= instance_initr?r[rDs r)rizTypeFromClasses.instance_init  c"r*cg|_|jD][}t|tr. |j |}|jj |A|jj |]t|jtr!|j |j|_yy#t |dtYxYwNz$ is not importable. Is it installed?) rQr<rrrVappendr ImportWarningr@r?rCs r)rhz TypeFromClasses._resolve_classess"$\\ 6E%%X 007E++2259''..u5 6 d((# .!%!5!5d6H6H!ID  / XE7"FGWs ,B..Cc|j}t|tr t|St|jd|j S)Nr^)r@rrr!rarrRs r)default_value_reprz"TypeFromClasses.default_value_reprsC"" eS !; 5++,Aenn-=>? ?r*) rra __qualname____doc__rr>rSr\rerirhrr __classcell__rDs@r)r6r6s2[%.+6ZR$ #J @r*r6cXeZdZdZd fd ZdZdZdZfdZdZ dZ d Z d Z xZ S) InstanceFromClasseszA trait whose value must be an instance of a class in a specified list of classes. The value can also be an instance of a subclass of the specified classes. Subclasses can declare default classes by overriding the klass attribute c |||_n,td|Dr||_ntdt|t |t s td|t |t s td||_||_t|(di|y)aConstruct 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 ---------- klasses : list of classes or class_names (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. Nc3jK|]+}tj|xst|t-ywrH)rrrr)rKks r)rLz/InstanceFromClasses.__init__..s(Ka#9z!S'99Ks13zDThe klasses attribute must be a list of class names or classes not: z)The 'kw' argument must be a dict or None.z,The 'args' argument must be a tuple or None.) r<allr;rCrdictr9 default_argsdefault_kwargsr=r>)r?r<argskwrArDs r)r>zInstanceFromClasses.__init__s2 ?"DL K7K K"DLVW\V_`  NJr4$8HI I  ju&=KL L   "6"r*c@tfd|jDS)rFc36K|]}t|ywrH)rrJs r)rLzGInstanceFromClasses.instance_from_importable_klasses..1rMrNrOrRs `r) instance_from_importable_klassesz4InstanceFromClasses.instance_from_importable_klasses/rTr*cN|j|r|S|j||yrH)rrYrZs r)r\zInstanceFromClasses.validate3s#  0 0 7L JJsE "r*cd}|jD],}t|tr||z }n|td|z }|dz }.|j d}|j r|dz }|S)Nzan instance of rr_r`)r<rrrrbrcrds r)rezInstanceFromClasses.info9sn"\\ E%%%(3.. f F   f% ?? j F r*cD|jt| |yrHrgrjs r)riz!InstanceFromClasses.instance_initFrkr*cg|_|jD][}t|tr. |j |}|jj |A|jj |]y#t |dtYvxYwrm)rQr<rrrVrnrrorps r)rhz$InstanceFromClasses._resolve_classesJs"$\\ 6E%%X 007E++2259''..u5 6 XE7"FGWs ,A33B c|j |jy|j|jxsdi|jxsiS)Nr|)rrrCr?s r)make_dynamic_defaultz(InstanceFromClasses.make_dynamic_defaultWsO    %D,?,?,GtzzD--39!006B9 9r*c4t|jSrH)r!rrs r)rrz&InstanceFromClasses.default_value_repr]sD--/00r*ct|SrH)_safe_literal_eval)r?ss r) from_stringzInstanceFromClasses.from_string`s !!$$r*)NNN)rrarsrtr>rr\rerirhrrrrrurvs@r)rxrxs7+#ZR# # 69 1%r*rx)NFF)FF) r traitletsrrrtraitlets.utils.descriptionsrrWr/rrr6rxr|r*r)rsc::A5Fl@)l@^d%-d%c _DOs-A A