+ ~viWRt^RIHt^RIt^RIt^RIHt^RIH t ^RI H t H t H t HtHtHtHtHtHtHt^RIHt^RIHt^RIHtHt^R IHtHtHtH t ]PB'd<]PD]PF]PH]P,3,t%M ]Pt%!R R ]&4t'!R R ]'4t(!RR]4t)!RR])4t*]PV!RRR7t,!RR]*4t-R#)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]tRt^(tRtR#)ConfigurableErrorN__name__ __module__ __qualname____firstlineno____static_attributes__r?/usr/lib/python3/dist-packages/traitlets/config/configurable.pyrr(r rc]tRt^,tRtR#)MultipleInstanceErrorrNrrr r!r$r$,r"r r$cTa]tRt^5t]!]R/4t]!RRR7tRV3Rllt] RRl4t RR lt RR R llt ] !R 4]R Rl44tRRlt] R RRll4t] RRRll4t] R RRll4t] RRl4t] R RRll4t] RRl4tRtV;t#)! Configurablez*traitlets.config.configurable.ConfigurableT) allow_nonec V^8dQhRRRR/#)kwargst.AnyreturnNoner)formats"r! __annotate__Configurable.__annotate__9sB.B.B.4B.r c <aaSPRR4pVe*SPRR4fVPSR&W nSPRR4p\SV`!R/SB\ 4oRVV3RllpVPV4VeW0nMVPVP4VPV4SFp\WSV,4K R#)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 V^8dQhRRRR/#r)changerr,r-r)r.s"r!r/+Configurable.__init__..__annotate__as 7 75 7T 7r cd<VPS9dSPVP4R#R#)zjRecord traits set by both config and kwargs. They will need to be overridden again after loading config. N)nameadd)r6config_override_namesr*s&r!notice_config_override5Configurable.__init__..notice_config_overrideas( {{f$%))&++6%r r) popgetr3r2super__init__setr _load_config unobservesetattr)selfr*r2r3r<r9r; __class__s&l @r!rAConfigurable.__init__9s2Hd+  zz(D)1#)==x  KHd+ "6"!$ 7 7 +,  !K   dkk * -.)D Dt -*r cV^8dQhRR/#)r)r,z list[str]r)r.s"r!r/r0s  i r c \VP4Uu.uF:p\V\4'gK\W4'gK.VPNK< up#uupi)zreturn section names as a list)reversed__mro__ issubclassr&r)clscs& r! section_namesConfigurable.section_namessO ckk* *!\* /9#/A AJJ*   sAAAc V^8dQhRRRR/#)r)cfgrr,r+r)r.s"r!r/r0s6er c 8V.pVP'd+VPVPPV44\4pVFJpVP 4F3pVP V4'gKVP WE,4K5 KL V#)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. )r2append_find_my_configrrP _has_sectionmerge)rFrScfgs my_configrOsnames&& r!rVConfigurable._find_my_configszu ;;; KK 33C8 9H A++->>%((OOAH- . r c(V^8dQhRRRRRRRR/#) r)rSrrPzlist[str] | Nonetraitsz)dict[str, TraitType[t.Any, t.Any]] | Noner,r-r)r.s"r!r/r0s233 3(3: 3  3r c  $VfVPRR7pVfVP4pVPV4pVP4;_uu_4VP 4EFwrVWS9dx\ V\ 4'd\W4pVPV4pM-\ V\4'dVPW5,4p\W\V44K\V4'dK\ V\4'dK^RIHp\ V\ 4'd(VP"fQhVP"P$p MRRlp V!WS4p RV RVP&P( R 2p \+V 4^8XdV R V ^, R 2, p MA\+V 4^8d2V R P-R P/\1V 44R7, p V !V 4EK RRR4R# +'giR#;i)z load traits from a Config objectNTr3)get_close_matchesc V^8dQhRRRR/#)r)msgr+r,r-r)r.s"r!r//Configurable._load_config..__annotate__sQQeQQr c<\P!V\^ R7#)  stacklevel)rwarn UserWarning)rcs&r!ri'Configurable._load_config..warns#+==ka#PPr zConfig option `z` not recognized by `z`.z Did you mean `z`?z# Did you mean one of: `{matches}`?, )matches)r^rPrVhold_trait_notificationsitems isinstancergetattr get_valuerrErrrdifflibraLoggingConfigurablelogwarningrGrlenr.joinsorted) rFrSrPr^rZr9 config_valueinitialrarirmrcs &&&& r!rCConfigurable._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- , , ,sB"G>;G>C!G>> H r3c V^8dQhRRRR/#r5r)r.s"r!r/r0sRReRRr c VPRR7pVP4pVPVPW#R7R#)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. Tr`)r^rPN)r^rPrCnew)rFr6r^rPs&& r!_config_changedConfigurable._config_changeds;D) **,  &**VQr c V^8dQhRRRR/#)r)r3rr,r-r)r.s"r!r/r0s " "F "t "r c \VP4VnVPV4VPPV4R#)z%Update config and load the new valuesN)rr3rCrX)rFr3s&&r! update_configConfigurable.update_configs4t{{+  &! &!r c V^8dQhRRRR/#)r)instHasTraits | Noner,strr)r.s"r!r/r0s%%"2%c%r c Ve\W4'gQh.pRPRVP44pVPVP RV R24VP\ V^,4R,4\ VPRR7P44F'wrEVPWQ4pVPV4K) RPV4#) 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. rlc38"TFqPxK R#5iN)r.0ps& r! .Configurable.class_get_help..s C]]s(z ) options-Tr` ) rprx __bases__rUrrwry class_traitsroclass_get_trait_help)rNr 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(V^8dQhRRRRRRRR/#) r)traitTraitType[t.Any, t.Any]rrhelptextz str | Noner,rr)r.s"r!r/r0 s26 6 &6 6  6 6 r c  Ve\W 4'gQh.pRVP RVP 2p\V\\34'dzVP P RR4p\V\4'dRpM+RVPPP4,pVR8Xd V RV R 2pM%V R V R 2pMV R VPP R 2pVPV4Vf VPpVR 8wd6RP\V^L44pVP\V44RVPP9d0VP\RVP4,44Ve=TP\R\Y!P;'gR 4: 244MVVP!4pVeB\%V4^@8dVR,R ,pVP\RV,44RPV4# \"dRpLei;i)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--. multiplicityrUz=z <%s-item-1>=... z=<>rEnumz Choices: %sz Current: N=Nz Default: %s)rprr9rrmetadatar?rGlowerrUrrxrrinforqdefault_value_repr Exceptionrw) rNrrrlinesheaderr 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>yy2!>?H LL) * U__-- - LL  <= >   LL)GD**:J:J,K+N OP Q ..0s8b=c(U*C VMC$789yy  sH55 IIc V^8dQhRRRR/#)r)rrr,r-r)r.s"r!r/r0Es(($4((r c :\VPV44R#)z4Get the help string for a single trait and print it.N)printr)rNrs&&r!class_print_helpConfigurable.class_print_helpDs c  &'r c$V^8dQhRRRRRR/#)r)rrclasseszt.Sequence[type[HasTraits]]r,ztype[Configurable]r)r.s"r!r/r0Js$+6Q r c TpVPfQhVP4FWp\V\4'gKWB9gK#VP RR7P VPR4VJgKUTpKY V#)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`. NTr`)r9mrorMr&class_own_traitsr?)rNrr defining_clsr2s&&& r!_defining_classConfigurable._defining_classIsq( zz%%%ggiF6<00%++4+8<.__annotate__ss 4 4 4 4r cjRP\V^N44pRVPRR4,#)z"return a commented, wrapped block.z z## rz # )rxrreplace)rs&r!rO,Configurable.class_config_section..css- OAr23A199T733 3r rlc3j"TF)p\V\4'gKVPxK+ R#5ir)rMr&rrs& r!r4Configurable.class_config_section..{s!"d}! STVbHc:1::}s33z# rz) configuration description__doc__rTr`rz# Choices: %sz# Default: %srz # See also: rz# c.z = zO#------------------------------------------------------------------------------)rxrrrr? default_valuerqrUryrorrrtypersplit) rNrrObreakerparent_classesrrdescr9r 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!#>7;P;P*QRR MM>>**+, 'q*   vvj(..11r cV^8dQhRR/#)r)r,rr)r.s"r!r/rs  j r c \VP\4'dJVPfQh\P!\ P VPP4#^RIHpVP4#)N)ru) rpr2rtrrrrru traitlets get_logger)rFrus& r! _log_default LoggingConfigurable._log_defaultsQ dkk#6 7 7;;* **66'..$++//: :!~~r cV^8dQhRR/#)r)r,zlogging.Handler | Noner)r.s"r!r/rs"""8"r c VP'gR#\VP\P4'd VPMVPPp\ VRR4'gR#VP ^,#)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. Nhandlers)rurprrloggerrqr)rFrs& r!_get_log_handler$LoggingConfigurable._get_log_handlers]xxx"488W^^< H3))x)>?? 55 "s"AAA AcV^8dQhRR/#)r)r,r-r)r.s"r!r/rs**t*r c VP4'gR#VP4F(p\VPV4'gK!RVnK* R#)z5unset _instance for this class and singleton parents.N) initializedrrp _instancers& r!clear_instance$SingletonConfigurable.clear_instancesA   H(,,c22&*" (r c(V^8dQhRRRRRRRR/#)r)rNztype[CT]argsr+r*r,rr)r.s"r!r/r*s())h)u))")r c (VPf&V!V/VBpVP4F pW4nK \VPV4'd VP#\RVP R\ VP4P 24h)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: )r rrpr$rr)rNrr*rrs&*, r!instanceSingletonConfigurable.instance)s: == ''D MMO%)", cmmS ) )== '.s||n=""&s}}"5">">!?A r cV^8dQhRR/#)r)r,boolr)r.s"r!r/rVsGGDGr c F\VR4;'dVPRJ#)zHas an instance been created?r N)hasattrr )rNs&r!r !SingletonConfigurable.initializedUs"sK(FFS]]$-FFr r) rrrrrr rrrrr rrr r!rrs_I  **))VGGr ).r __future__rrtypingrcopyrtextwraprtraitlets.traitletsrrrrr r r r r rtraitlets.utilsrtraitlets.utils.bunchrtraitlets.utils.textrrloaderrrrr TYPE_CHECKINGUnionrrrrrr$r&rtTypeVarrrrr r!r&s5#   %'8LL ???)>)>quu)EEFJJ   - Y 9Y x .",."bYYt23SG/SGr