]jSSKJr SSKrSSKrSSKrSSKJr S S SjjrS SjrS Sjr S SSjjr SSjr g)) annotationsN)Anyc[U[5(aUR5n[R"U5(d[ U5R nO UR nU(a[U5U-nUS:Xd UGc^[R"U5(GdBUbUSU3nUb [USU5$U$Sn[R"U5(a UR nO[U[R5(aUR nSnO[U[R5(aURR nSnO^[ U5R[R[ R4;aS[[!U55-nSnO [#U5nSnU(a[U5U-nU(aUR%S5n['XX#US9$US;dUcUcU$[USU5$[)S U-5e) 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'')nameverbosecapital)aanzAThe 'article' argument should be 'the', 'a', 'an', or None not %r) isinstancestrlowerinspectisclasstype__name___prefix add_articletypes FunctionType MethodType__func____repr__objecthexidreprjoindescribe ValueError)articlevaluerr r typenameresult tick_wraps Y/home/mande/repo/quber/.venv/lib/python3.13/site-packages/traitlets/utils/descriptions.pyr 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  c[U[R5(a[SURSS9S-nU$[ R "U5nUb!URS:waURS-nU$SnU$)NT)r .builtins)r rrr __self__r getmoduler)r#rmodules r'rrzsw%))**ennd;cA K ""5)  &//Z"???S(D KD Kr(c[R"U5(a[UR5$[ [ U55$)zkReturns a string of the value's type with an indefinite article. For example 'an Image' or 'a PlotValue'. )rrrrclass_ofr)r#s r'r1r1s1 u5>>**U $$r(cU(aSU-nOH[R"S5RSU5nUSSR5S;aSU-nOSU-nU(aUS R 5USS-$U$) 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_]+r,Naeiouzan za r)recompilesubrupper)rdefiniter r% first_letterss r'rrsy"$ 9-11"d; !  " " $ /T\FD[Fay 6!":-- r(c*[U5nU<SU<3$)zUReturn a string representation of a value and its type for readable error messages. r)r)objthe_types r' repr_typer>s CyHWAh\ ""r()NFF) r" str | Noner#rrr?r boolr r@returnr)r#rrAr)r#rrAr)FF)rrr9r@r r@rAr)r<rrAr) __future__rrr5rtypingrr rr1rr>r(r'rEsx"   n n n  n  n  n  n b %>#r(