pjWdZddlmZddlZddlZddlmZddlm Z ddl m Z m Z m Z mZmZmZmZmZmZmZddlmZddlmZdd lmZmZd d lmZmZmZm Z ejBrdd l"m#Z#ejBr'ejHejJejzZ&n ejZ&Gd de'Z(Gdde(Z)GddeZ*Gdde*Z+Gdde+Z,y)z/A base class for objects that are configurable.) annotationsN)deepcopy)dedent) Any ContainerDict HasTraitsInstance TraitTypedefaultobserveobserve_compatvalidate)warnings)Bunch)indentwrap_paragraphs)ConfigDeferredConfigLazyConfigValue_is_section_key)Selfc eZdZy)ConfigurableErrorN__name__ __module__ __qualname__n/workspace/moltex-experiments/.pixi/envs/default/lib/python3.12/site-packages/traitlets/config/configurable.pyrr+r!rc eZdZy)MultipleInstanceErrorNrr r!r"r%r%/r#r!r%c@eZdZeediZeddZdfd ZeddZ ddZ d ddZ e d e dd Zdd Zeddd Ze d dd ZedddZe ddZedddZeddZxZS) Configurabler z*traitlets.config.configurable.ConfigurableT) allow_nonec jdd}|'jd|jd<||_jdd}t |dit dfd }|j||||_n|j|j|j|D]}t|||y)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. parentNconfigcZ|jvrj|jyy)zRecord 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_overridez5Configurable.__init__..notice_config_overrideds( {{f$%))&++6%r!r r/rreturnNone) popgetr+r*super__init__setr _load_config unobservesetattr)selfr1r*r+r2r-r0 __class__s ` @r"r9zConfigurable.__init__<s2Hd+  zz(#+#)==x  DKHd+ "6"!$ 7 +,  !DK   dkk * -.)D D$t -*r!ct|jDcgc]*}t|trt||r |j,c}Scc}w)zreturn section names as a list)reversed__mro__ issubclassr'r)clscs r" section_nameszConfigurable.section_namessI ckk* *!\*z#q/A JJ*   s/A c|g}|jr*|j|jj|t}|D]=}|j D](}|j |s|j ||*?|S)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_configrrF _has_sectionmerge)r>cfgcfgs my_configrEsnames r"rIzConfigurable._find_my_configswu ;; KK 33C8 9H A++->>%(OOAeH- . r!c ||jd}||j}|j|}|j5|j D]S\}}||vrit |t rt||}|j|}n$t |tr|j||}t||t|tt|rt |trddlm}t |t r%|j"J|j"j$} ndd} |||} d|d|j&j(d } t+| d k(r | d | dd z } n;t+| d k\r-| d j-dj/t1| z } | | V dddy#1swYyxYw)z load traits from a Config objectNTr+r)get_close_matchesc:tj|tdS)N  stacklevel)rwarn UserWarning)msgs r"rWz'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)rYt.Anyr4r5)traitsrFrIhold_trait_notificationsitems isinstancergetattr get_valuerr=rrrdifflibrRLoggingConfigurablelogwarningr?rlenformatjoinsorted) r>rLrFr]rNr- config_valueinitialrRrWr[rYs r"r;zConfigurable._load_configs >[[[-F   ..0M((-  * * ,&/oo&7"l6>!,@#*$"5'3'='=g'F #L.A'3'='=fTl'K D$(>?(.z,PV7W9!$(;<#xx333#xx//Q0f=G+D61Ft~~G^G^F__abC7|q(!1'!*R@@W*DKK$(IIfWo$> L IE'8- , ,sBF:F:*CF::Gr+c|jd}|j}|j|j||y)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. TrQ)r]rFN)r]rFr;new)r>r/r]rFs r"_config_changedzConfigurable._config_changeds=D) **,  &**V=Qr!ct|j|_|j||jj|y)z%Update config and load the new valuesN)rr+r;rK)r>r+s r" update_configzConfigurable.update_configs4t{{+  &! &!r!c|t||sJg}djd|jD}|j|jd|d|jt |ddzt |jdjD](\}}|j||}|j|*d j|S) 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. rZc34K|]}|jywN)r.0ps r" z.Configurable.class_get_help..s C]]s(z ) optionsr-TrQ ) r`ri __bases__rHrrgrj class_traitsr_class_get_trait_help)rDinst final_help base_classes_vhelps r"class_get_helpzConfigurable.class_get_helps|z$444 yy CS]] CC S\\N!L>CD#jm,s233++4+8>>@ADAq++At4D   d #Byy$$r!c |t||sJg}d|jd|j}t|ttfrn|j j dd}t|trd}n(d|jjjd}|dk(r |d |d }n%|d |d }n|d |jjd }|j|| |j}|dk7r5djt|d}|jt|d|jjvr+|jtd|j|6|jtdt||jxsdnF |j!}|3t%|dkDr|ddd z}|jtd|dj|S#t"$rd}YSwxYw)aGet 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--. multiplicityrHz==... z=<> LEnumz Choices: z Current: @=z Default: r{)r`rr-rrmetadatar7r?lowerrHrrirrinforadefault_value_repr Exceptionrg) rDtraitrhelptextlinesheaderr sample_valuedvrs r"r~z!Configurable.class_get_trait_helps|z$444cll^1UZZL1 ei. / >>--nhGL%&2 !"5??#;#;#A#A#C"DHM x'"81\N#6"81\N#6xr%//":":!;1=F V  zzH r>{{?8R#@AH LL) * U__-- - LL)EJJL> :; <   LL)GD%**:J,K+N OP Q ..0s8b=cr(U*C Viu$567yy  s$G:: HHc8t|j|y)z4Get the help string for a single trait and print it.N)printr)rDrs r"class_print_helpzConfigurable.class_print_helpGs c  &'r!c|}|jJ|jD]I}t|ts||vs|j dj |jd|usH|}K|S)a7Get 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`. NTrQ)r-mrorCr'class_own_traitsr7)rDrclasses defining_clsr*s r"_defining_classzConfigurable._defining_classLsp( zz%%%ggiF6<0g%++4+8<.cvs- OAr23A199T733 3r!zO#------------------------------------------------------------------------------rZc3VK|]!}t|ts|j#ywrt)rCr'rrus r"rxz4Configurable.class_config_section..~s "d}! STVbHc1::}s))z# ryz) configuration description__doc__rTrQrz # Choices: z # Default: r{rrz # See also: rz# c.z = )rstrr4r)rir|rr}r7 default_valuerarHrjr_rrrtypersplit) rDrrEbreakerparent_classesrrdescr-r default_reprdefining_classs r"class_config_sectionz!Configurable.class_config_sectionks 4!"ds}}"dda/ ?!W%!%%m4 %%D3 2.D  LL4 ! LL !#"2"2$"2"?"E"E"GHKD% 335L!$!4!4UG!D!$$::LL5::/T%[111LL< ~!>? |L>:;::LL5::#3#3D!#proposals r" _validate_logz!LoggingConfigurable._validate_logsn(..7>>7;P;P*QR MM>>**+, 'q*   vvj(..11r!ct|jtrF|jJtjt j |jjSddlm}|jS)Nr)re) r`r*rdrrrrre traitlets get_logger)r>res r" _log_defaultz LoggingConfigurable._log_defaultsN dkk#6 7;;* **66'..$++//: :!~~r!c|jsyt|jtjr |jn|jj}t |ddsy|j dS)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)rer`rrloggerrar)r>rs r"_get_log_handlerz$LoggingConfigurable._get_log_handlersUxx"488W^^? 55 "s AA AAc|jsy|jD] }t|j|sd|_"y)z5unset _instance for this class and singleton parents.N) initializedrr` _instancers r"clear_instancez$SingletonConfigurable.clear_instances;  H(,,c2&*" (r!c|j$||i|}|jD] }||_ t|j|r |jStd|jdt |jj)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: )rrr`r%rr)rDargsr1rrs r"instancezSingletonConfigurable.instance)s: == ''D MMO%)", cmmS )== '.s||n=""&s}}"5">">!?A r!c:t|dxr|jduS)zHas an instance been created?rN)hasattrr)rDs r"rz!SingletonConfigurable.initializedUssK(FS]]$-FFr!)r4z4t.Generator[type[SingletonConfigurable], None, None])r4r5)rr\r1r\r4r)r4bool) rrrrrrrrrrr r!r"rrs_I  **))VGGr!r)-r __future__rrtypingrcopyrtextwraprtraitlets.traitletsrrrr r r r r rrtraitlets.utilsrtraitlets.utils.bunchrtraitlets.utils.textrrloaderrrrr TYPE_CHECKINGtyping_extensionsrrrrrrr%r'rdrr r!r"rs5#   %'8LL??& ??'"7"7">>JJ   - Y 9Y x .",."bSG/SGr!