]jWSrSSKJr SSKrSSKrSSKJr SSKJ r SSK J r J r J r JrJrJrJrJrJrJr SSKJr SSKJr SS KJrJr S S KJrJrJrJ r \RB(a3\RD\RF\RH\R4r%O \Rr%"S S \&5r'"SS\'5r("SS\5r)"SS\)5r*\RV"SSS9r,"SS\*5r-g)z/A base class for objects that are configurable.) annotationsN)deepcopy)dedent) Any ContainerDict HasTraitsInstance TraitTypedefaultobserveobserve_compatvalidate)warnings)Bunch)indentwrap_paragraphs)ConfigDeferredConfigLazyConfigValue_is_section_keyc\rSrSrSrg)ConfigurableError(N__name__ __module__ __qualname____firstlineno____static_attributes__rZ/home/mande/repo/quber/.venv/lib/python3.13/site-packages/traitlets/config/configurable.pyrr(r#rc\rSrSrSrg)MultipleInstanceError,rNrrr#r$r'r',r%r#r'cf^\rSrSr\"\S05r\"SSS9rSU4Sjjr\ SSj5r SSjr SSS jjr \ "S 5\SS j55rSS jr\ SSS jj5r\ SSSjj5r\ SSSjj5r\ SSj5r\ SS Sjj5r\ S!Sj5rSrU=r$)" Configurable5rz*traitlets.config.configurable.ConfigurableT) allow_nonec >^^TRSS5nUb(TRSS5cURTS'X lTRSS5n[TU]"S0TD6 [ 5mSUU4SjjnURU5 UbX0lOURUR5 URU5 THn[XTU5 M g)aCreate a configurable given a config config. Parameters ---------- config : Config If this is empty, default values are used. If config is a :class:`Config` instance, it will be used to configure the instance. parent : Configurable instance, optional The parent Configurable instance of this object. Notes ----- Subclasses of Configurable must call the :meth:`__init__` method of :class:`Configurable` *before* doing anything else and using :func:`super`:: class MyConfigurable(Configurable): def __init__(self, config=None): super(MyConfigurable, self).__init__(config=config) # Then any other code you need to finish initialization. This ensures that instances will be configured properly. parentNconfigc^>URT;aTRUR5 gg)zjRecord traits set by both config and kwargs. They will need to be overridden again after loading config. N)nameadd)changeconfig_override_nameskwargss r$notice_config_override5Configurable.__init__..notice_config_overrideas( {{f$%))&++6%r#rr3rreturnNone) popgetr/r.super__init__setr _load_config unobservesetattr)selfr5r.r/r6r1r4 __class__s ` @r$r>Configurable.__init__9s2Hd+  zz(D)1#)==x  KHd+ "6"!$ 7 7 +,  !K   dkk * -.)D Dt -*r#c[UR5Vs/sH8n[U[5(dM[X5(dM,URPM: sn$s snf)zreturn section names as a list)reversed__mro__ issubclassr*r)clscs r$ section_namesConfigurable.section_namessO ckk* *!\* /9#/A AJJ*   sAAAc,U/nUR(a*URURRU55 [5nUHEnUR 5H.nUR U5(dMUR XE5 M0 MG U$)aextract my config from a global Config object will construct a Config object of only the config values that apply to me based on my mro(), as well as those of my parent(s) if they exist. If I am Bar and my parent is Foo, and their parent is Tim, this will return merge following config sections, in this order:: [Bar, Foo.Bar, Tim.Foo.Bar] With the last item being the highest priority. )r.append_find_my_configrrL _has_sectionmerge)rCcfgcfgs my_configrKsnames r$rPConfigurable._find_my_configsxu ;; KK 33C8 9H A++->>%((OOAH- . r#c UcURSS9nUcUR5nURU5nUR5 UR 5GHmupVXS;aq[ U[ 5(a[X5nURU5nO([ U[5(aURX55n[X[U55 M|[U5(aM[ U[5(aMSSKJn [ U[ 5(a&UR"ceUR"R$n OSSjn U"XS5n SUSUR&R(S 3n [+U 5S :Xa U S U SS 3- n O9[+U 5S :a*U S R-SR/[1U 55S9- n U "U 5 GMp SSS5 g!,(df  g=f)z load traits from a Config objectNTr/r)get_close_matchesc6[R"U[SS9$)N  stacklevel)rwarn UserWarning)msgs r$r_'Configurable._load_config..warns#+==ka#PPr#zConfig option `z` not recognized by `z`.rz Did you mean `z`?z# Did you mean one of: `{matches}`?, )matches)rat.Anyr9r:)traitsrLrPhold_trait_notificationsitems isinstancergetattr get_valuerrBrrrdifflibrZLoggingConfigurablelogwarningrDrlenformatjoinsorted) rCrSrLrfrUr1 config_valueinitialrZr_rdras r$r@Configurable._load_configs >[[[-F   ..0M((-  * * ,&/oo&7">!,@@#*$"5'3'='=g'F #L.AA'3'='=fl'K D(>?(..z,PV7W7W9!$(;<<#xx333#xx//Q0=G+D61Ft~~G^G^F__abC7|q(!1'!*R@@W*DKK$(IIfWo$> L IE'8- , ,sBG&G=C G G!r/cvURSS9nUR5nURURX#S9 g)zUpdate all the class traits having ``config=True`` in metadata. For any class trait with a ``config`` metadata attribute that is ``True``, we update the trait with the value of the corresponding config entry. TrY)rfrLN)rfrLr@new)rCr3rfrLs r$_config_changedConfigurable._config_changeds;D) **,  &**VQr#c[UR5UlURU5 URRU5 g)z%Update config and load the new valuesN)rr/r@rR)rCr/s r$ update_configConfigurable.update_configs4t{{+  &! &!r#cUb[X5(de/nSRSUR55nURURSUS35 UR[ US5S-5 [ URSS9R55H'upEURXQ5nURU5 M) S RU5$) zGet the help string for this class in ReST format. If `inst` is given, its current trait values will be used in place of class defaults. rcc38# UHoRv M g7fN)r.0ps r$ .Configurable.class_get_help..s C]]s(z ) optionsr-TrY ) rirr __bases__rOrrprs class_traitsrhclass_get_trait_help)rJinst final_help base_classes_vhelps r$class_get_helpConfigurable.class_get_helps|z$4444 yy CS]] CC S\\N!L>CD#jm,s233++4+8>>@ADA++A4D   d #Byy$$r#c NUb[X 5(de/nSURSUR3n[U[[45(asUR R SS5n[U[5(aSnO'SURRR5-nUS:Xa USUS 3nO%US US 3nOUS URRS 3nURU5 Uc URnUS :wa5SR[US55nUR[U55 SURR;a+UR[SUR5-55 Ub;UR[S[X!R=(d S 5<355 OHUR!5nUb4[%U5S:aUSSS -nUR[SU-55 SRU5$!["a SnNVf=f)zGet the helptext string for a single trait. :param inst: If given, its current trait values will be used in place of the class default. :param helptext: If not given, uses the `help` attribute of the current trait. Nz--. multiplicityrOz=z <%s-item-1>=... z=<> LEnumz Choices: %sz Current: @=z Default: %sr)rirr1rrmetadatar<rDlowerrOrrrrrinforjdefault_value_repr Exceptionrp) rJtraitrhelptextlinesheaderr sample_valuedvrs r$r!Configurable.class_get_trait_help s|z$4444cll^1UZZL1 ei. / / >>--nhGL%&&2 ,u/G/G/M/M/OO x'"81\N#6"81\N#6xr%//":":!;1=F V  zzH r>{{?8R#@AH LL) * U__-- - LL  <= >   LL)GD**:J,K+N OP Q ..0s8b=cr(U*C VMC$789yy  s=H H$#H$c8[URU55 g)z4Get the help string for a single trait and print it.N)printr)rJrs r$class_print_helpConfigurable.class_print_helpDs c  &'r#cUnURceUR5HQn[U[5(dMXB;dM!UR SS9R URS5ULdMOUnMS U$)aGet the class that defines a trait For reducing redundant help output in config files. Returns the current class if: - the trait is defined on this class, or - the class where it is defined would not be in the config file Parameters ---------- trait : Trait The trait to look for classes : list The list of other classes to consider for redundancy. Will return `cls` even if it is not defined on `cls` if the defining class is not in `classes`. NTrY)r1mrorIr*class_own_traitsr<)rJrclasses defining_clsr.s r$_defining_classConfigurable._defining_classIsq( zz%%%ggiF6<00%++4+8<.css- OAr23A199T733 3r#zO#------------------------------------------------------------------------------rcc3h# UH(n[U[5(dMURv M* g7fr)rIr*rrs r$r4Configurable.class_config_section..{s!"d}! STVbHc:1::}s22z# rz) configuration description__doc__rTrYrz# Choices: %sz# Default: %srrrz # See also: rz# c.z = )rstrr9r)rrrrrr< default_valuerjrOrsrhrrrtypersplit) rJrrKbreakerparent_classesrrdescr1r default_reprdefining_classs r$class_config_section!Configurable.class_config_sectionhs 4!"ds}}"dda/ ?W%!%%m4 %%D3 2.D  LL4 ! LL !#"2"2$"2"?"E"E"GHKD 335L!$!4!4U!D!$$::LL5::/T%[111LL!1EJJL!@A - <=::LL5::#3#3D!# classmethodrLrPr@r rryr|rrrrrrr" __classcell__)rDs@r$r*r*5sZ fb" %F Bt TFB.P  8+/<@ 3 3(3: 3  3j XRR " %% "&# 6 &6 6  6 6 6 p((+6Q <9 9 v) ) r#r*cp\rSrSrSr\"SSS9r\"S5S Sj5r\ "S5S Sj5r SS jr S r g )rmizA parent class for Configurables that log. Subclasses have a log trait, and the default behavior is to get the logger from the currently running Application. z Logger or LoggerAdapter instanceF)rr,rnc:[UR[R[R45(d>[ R "URRSURS3[SS9 [R"[UR5$)Nz..log should be a Logger or LoggerAdapter, got rr]) rivalueloggingLogger LoggerAdapterrr_rDrr`tcast LoggerType)rCproposals r$ _validate_log!LoggingConfigurable._validate_logsq(..7>>7;P;P*QRR MM>>**+, 'q*   vvj(..11r#c[UR[5(aHURce[R"[ R URR5$SSKJn UR5$)Nr)rn) rir.rmrrrrrn traitlets get_logger)rCrns r$ _log_default LoggingConfigurable._log_defaultsQ dkk#6 7 7;;* **66'..$++//: :!~~r#cUR(dg[UR[R5(a UROURRn[ USS5(dgUR S$)zReturn the default Handler Returns None if none can be found Deprecated, this now returns the first log handler which may or may not be the default one. Nhandlersr)rnrirrloggerrjr)rCrs r$_get_log_handler$LoggingConfigurable._get_log_handlers[xx"488W^^< g7f)zVWalk the cls.mro() for parent classes that are also singletons For use in instance() N)rrIrrJsubclasss r$ _walk_mroSingletonConfigurable._walk_mros> H3))x)>?? 55 "s"AAA AcUR5(dgUR5H'n[URU5(dM SUlM) g)z5unset _instance for this class and singleton parents.N) initializedrri _instancers r$clear_instance$SingletonConfigurable.clear_instancesA   H(,,c22&*" (r#c$URc%U"U0UD6nUR5H nX4lM [URU5(a UR$[SURS[ UR5R35e)aReturns a global instance of this class. This method create a new instance if none have previously been created and returns a previously created instance is one already exists. The arguments and keyword arguments passed to this method are passed on to the :meth:`__init__` method of the class upon instantiation. Examples -------- Create a singleton class using instance, and retrieve it:: >>> from traitlets.config.configurable import SingletonConfigurable >>> class Foo(SingletonConfigurable): pass >>> foo = Foo.instance() >>> foo == Foo.instance() True Create a subclass that is retrieved using the base class instance:: >>> class Bar(SingletonConfigurable): pass >>> class Bam(Bar): pass >>> bam = Bam.instance() >>> bam == Bar.instance() True zAn incompatible sibling of 'z(' is already instantiated as singleton: )rrrir'rr)rJargsr5rrs r$instanceSingletonConfigurable.instance)s: == ''D MMO%)", cmmS ) )== '.s||n=""&s}}"5">">!?A r#cD[US5=(a URSL$)zHas an instance been created?rN)hasattrr)rJs r$r!SingletonConfigurable.initializedUssK(FS]]$-FFr#r)r9z4t.Generator[type[SingletonConfigurable], None, None])r9r:)rJztype[CT]rrer5rer9r)r9bool) rrr r!rrrrrrrr"rr#r$rrs_I  **))VGGr#).r __future__rrtypingrcopyrtextwraprtraitlets.traitletsrrrr r r r r rrtraitlets.utilsrtraitlets.utils.bunchrtraitlets.utils.textrrloaderrrrr TYPE_CHECKINGUnionrrrrrr'r*rmTypeVarrrrr#r$rs5#   %'8LL ??)>)>quu)EEFJJ   - Y 9Y x .",."bYYt23SG/SGr#