+ ~viz^RIHt^RIt^RIt^RIt^RIHtRRRlltRRltRR lt RR R llt R R lt R#)) annotationsN)Anyc 0V^8dQhRRRRRRRRRRR R /#) articlez str | Nonevaluernameverboseboolcapitalreturnstr)formats">/usr/lib/python3/dist-packages/traitlets/utils/descriptions.py __annotate__r sLn n n n  n  n  n  n cZ\V\4'dVP4p\P!V4'g\ V4P pM VP pV'd\V4V,pVR8Xg#VEfs\P!V4'EgVVeV RV 2pVe\VRV4#V#Rp\P!V4'dVP pM\V\P4'dVP pRpM\V\P4'dVPP pRpMc\ V4P\P\ P39dR\\!V44,pRpM \#V4pRpV'd\V4V,pV'dVP%R4p\'WW#VR7#VR 9gVfVfV#\VRV4#\)RV,4h) aAReturn 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 inferred. 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 inferred 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 '...'" >>> describe("the", object) 'the object 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 '%s'z'')r r r zAThe 'article' argument should be 'the', 'a', 'an', or None not %r)aan) isinstancerlowerinspectisclasstype__name___prefix add_articletypes FunctionType MethodType__func____repr__objecthexidreprjoindescribe ValueError)rrr r r typenameresult tick_wraps&&&&& rr+r+ s|'3--/ ??5 ! !;''>>5>H,%GOGOOE4J4J   z4&)F""6499 Iu%%~~E5#5#566~~ E5#3#344~~.. e%% *!3r%y>1E{u~,yyGPWX X K 7? ?O8UG44 ORY Y  rc V^8dQhRRRR/#)rrrr rr)rs"rrrzs  3 3 rc \V\P4'd"\RVPRR7R,pV#\ P !V4pVe'VPR8wdVPR,pV#RpV#)NT)r .builtins)rr!r#r+__self__r getmoduler)rr modules& rrrzsw%))**ennd;cA K ""5)  &//Z"???S(D KD Krc V^8dQhRRRR/#)rrrr r)rs"rrrs%%C%C%rc\P!V4'd\VP4#\ \ V44#)zkReturns a string of the value's type with an indefinite article. For example 'an Image' or 'a PlotValue'. )rrr rclass_ofr)rs&rr:r:s1 u5>>**U $$rc(V^8dQhRRRRRRRR/#)rr rdefiniter r r r)rs"rrrs(cTDSrc.V'd RV,pMU\P!R4PRV4pVR,P4R9d RV,pM RV,pV'd&V^,P 4VR,,#V#) aReturns the string with a prepended article. The input does not need to begin with a character. Parameters ---------- name : str Name to which to prepend an article 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_]+r4:NNaeiouzan za :r>NN)recompilesubrupper)r r<r r. first_letterss&&& rr r su"$ 9-11"d;   " " $ /T\FD[Fay 6":-- rc V^8dQhRRRR/#)robjrr rr)rs"rrrs##3#3#rc*\V4pV: RV: 2#)zUReturn a string representation of a value and its type for readable error messages. r)r)rFthe_types& r repr_typerIs CyHWAh\ ""r)NFF)FF) __future__rrr@r!typingrr+rr:r rIrrrrLs/" n b %>#r