]j;SrSSKJr SSKrSSKrSSKrSSKrSSKrSSKrSSK r SSK r SSK J r Jr SSKJr SSKJr SSKJr SSKJr SS KJrJr SS KJrJrJrJrJrJ r J!r! SS K"J#r#J$r$J%r%J&r&J'r'J(r(J)r)J*r*J+r+J,r, SS K-J.r. SS K/J0r0 SSK1J2r2J3r3 SSK4J5r5 SSK6J7r7 SRq5r9SRq5r:\;"\ S5(dS/\ l<Sr=\R|RSS5r@\@R5S;aSrBO"\@R5S;aSrBO \C"S\@-5e\ R=(a \ RRS5rF\ R"S\ RS\ R4S 9rJ\ R\RS!4rM\ RH\N\ R4rO\ R\ RN\NrQ\ RN\ R\rSS,S"jrT"S#S$\U5rV"S%S&\R5rX"S'S(\5rY\YRr[\YRr]S-S.S)jjr^S/S*jr_\`S+:Xa\YR5 gg)0z,A base class for a configurable application.) annotationsN) OrderedDict defaultdict)suppress)deepcopy) dictConfig)dedent) ConfigurableSingletonConfigurable) ArgumentErrorConfigConfigFileNotFoundDeferredConfigStringJSONFileConfigLoaderKVArgParseConfigLoaderPyFileConfigLoader) BoolDictEnumInstanceList TraitErrorUnicodedefaultobserveobserve_compat)Bunch) nested_update)indentwrap_paragraphs) cast_unicode) import_itemz The options below are convenience aliases to configurable class-options, as listed in the "Equivalent to" description-line of the aliases. To see all configurable class-options for some , use: --help-all z The command-line option below sets the respective configurable class-parameter: --Class.parameter=value This line is evaluated in Python, so simple expressions are allowed. For instance, to set `C.a=[0,1,2]`, you may type this: --C.a='range(3)' argvzp Subcommands are launched as `{app} cmd [args]`. For information on using subcommand 'cmd', do: `{app} cmd -h`. -TRAITLETS_APPLICATION_RAISE_CONFIG_FILE_ERROR>1trueT>r%0falseFzUnsupported value for environment variable: 'TRAITLETS_APPLICATION_RAISE_CONFIG_FILE_ERROR' is set to '%s' which is none of {'0', '1', 'false', 'true', ''}.z pythonw.exeT.)boundzlogging.LoggerAdapter[t.Any]c|^[R"T5SU4Sjj5n[R"[U5$)aMethod decorator for catching invalid config (Trait/ArgumentErrors) during init. On a TraitError (generally caused by bad config), this will print the trait's message, and exit the app. For use on init methods, to prevent invoking excepthook on invalid input. c>T"U/UQ70UD6$![[4a]nURRSU5 URR SUR 5 UR S5 SnAgSnAff=f)Nz0Bad config encountered during initialization: %szConfig at the time: %s)rr logfataldebugconfigexit)appargskwargsemethods Y/home/mande/repo/quber/.venv/lib/python3.13/site-packages/traitlets/config/application.pyinner!catch_config_error..innerssi #/// /M*  GGMMLa P GGMM2CJJ ? HHQKK s A<AA77A<)r5 Applicationr6t.Anyr7r>returnr>) functoolswrapstcastr+)r9r;s` r:catch_config_errorrDjs3__V 66!U c\rSrSrSrg)ApplicationErrorN)__name__ __module__ __qualname____firstlineno____static_attributes__rIrEr:rGrGsrErGcL^\rSrSrSr\R rSrSU4Sjjr Sr U=r $)LevelFormatterzFormatter with additional `highlevel` record This field is empty if log level is less than highlevel_limit, otherwise it is formatted with self.highlevel_format. Useful for adding 'WARNING' to warning messages, without adding 'INFO' to info, etc. z %(levelname)s |c>URUR:aURUR-UlOSUl[ TU]U5$)Nr%)levelnohighlevel_limithighlevel_format__dict__ highlevelsuperformat)selfrecord __class__s r:rYLevelFormatter.formatsC >>T11 1#44vFF !F w~f%%rErI)r[zlogging.LogRecordr?str) rJrKrLrM__doc__loggingWARNrTrUrYrN __classcell__r\s@r:rPrPs#llO)&&rErPc$^\rSrSr%Sr\"S5rS\S'\"S5rS\S'\"\ 5r S\S'\"\ 5r S\S '\"\ 5r S\S '\ r \r\"5rS\S '/rS \S 'SiSjSjjr\"S5rS\S'\"5rS\S'\"\5r\"S\R6SS9R9SS9r\r\"SSS9R9SS9r \"SSS9R9SS9r!SkSjr"\#"SS S!S"5SlS#j5r$\#"S$S%S&9SlS'j5r%SmS(jr&\'"S$5SnS)j5r(\)"S*S9R9SS9r*S+S,0r+S\S-'SS!\RX00S.4SS/S00S04SS1S00S24S3.r-S\S4'\)"5r.S5\S6'\/"S7SS89r0\"\"55r1\/"\2S90S:S9r3\"5r4S;\S<'\"S=S9R9SS9r5\"S>S9R9SS9r6\#"S15SlS?j5r7\#"S/5SlS@j5r8SoSAjr9\#"SB5\:SlU4SCjj55r;\SmSFjr?SmSGjr@SqSHjrASmSIjrBSqSJjrCSmSKjrDSqSLjrESmSMjrFSqSNjrGSrSOjrHSsStSPjjrISsSrSQjjrJSuSRjrKSmSSjrLSqSTjrMSmSUjrNSqSVjrOSmSWjrP\D33<<=?#oo#//  ''$!* * ).5 : :z"y! rErrrlogging_configcURn[U[5(a.[R"[ [ [U55UlUR5 gN) r isinstancer^rBrCintgetattrr`_configure_logging)rZchangers r:_observe_logging_change#Application._observe_logging_changes?NN i % %VVC))DEDN !rEr0r)typec$UR5 gr)rrZrs r:_observe_logging_default$Application._observe_logging_defaults !rEcUR5n[XR=(d 05 [U5 SUlg)NT)rrrr_logging_configuredrs r:rApplication._configure_logging"s3002f117R86#' rEc[R"URR5nSUlUnUb8UR (aU$UR(dU$UR nUbM8U$)z#Start logging for this application.F)r` getLoggerr\rJ propagaterrw)rZr0_logs r: _log_defaultApplication._log_default)se 7 78 }} >> ;;D   rEa! Configure additional log handlers. The default stderr logs handler is configured by the log_level, log_datefmt and log_format settings. This configuration can be used to configure additional handlers (e.g. to output the log to a file) or for finer control over the default handlers. If provided this should be a logging configuration dictionary, for more information see: https://docs.python.org/3/library/logging.config.html#logging-config-dictschema This dictionary is merged with the base logging configuration which defines the following: * A logging formatter intended for interactive use called ``console``. * A logging handler that writes to stderr called ``console`` which uses the formatter ``console``. * A logger with the name of this application set to ``DEBUG`` level. This example adds a new handler that writes to a file: .. code-block:: python c.Application.logging_config = { "handlers": { "file": { "class": "logging.FileHandler", "level": "DEBUG", "filename": "", } }, "loggers": { "": { "level": "DEBUG", # NOTE: if you don't list the default "console" # handler here then it will be disabled "handlers": ["console", "file"], }, }, } z log-levelzApplication.log_levelaliasesz5Set log-level to debug, for the most verbose logging. show_configz[TU]U5 URRSUR5 g)NzConfig changed: %r)rX_config_changedr0r2r)rZrr\s r:rApplication._config_changeds) ' +VZZ8rEc&URU5 g)z=Do the basic steps to configure me. Override in subclasses. N)parse_command_line)rZr$s r: initializeApplication.initializes %rEcURb;[UR[5(deURR5$g)z1Start the app mainloop. Override in subclasses. N)subapprr=rrZs r:rApplication.starts= ;; "dkk;77 77;;$$& & #rEc &URR5nURR5HGnURU;dMXRnUR SS5 UR SS5 MI UR (aJ[R"U[RSS[S9 [RRS5 gUR(a6[S5 URHn[S U-5 M [5 [U5HanXnU(dM[U5 [!S SS 9n[U5H-nXhn [S US ["R$"U 40UD635 M/ Mc g)z,start function used when show_config is TruerNrr/T)r sort_keysr zLoaded config files:z )rcompactz .z = )r3copyr\rrrJpoprjsondumpsysstdoutreprwriterprintsorteddictpprintpformat) rZr3r cls_configf classname class_configpformat_kwargs traitnamevalues r:rApplication.start_show_configs5!!#>>%%'C||v%#LL1 }d3148 (  IIfcjjdD Q JJ  T "   $ $ ( )..dQh/ GI!,L ) &*!T&BN#L1 $/I;c&..*Q.*Q)RST2(rEcT[SRUR555 g)z"Print the alias parts of the help.rN)rjoinemit_alias_helprs r:print_alias_helpApplication.print_alias_helps dii,,./0rEc#h# UR(dg0nURHUnUR5SSH;n[R"[R [ U5XR'M= MW URR5HupE[U[5(aUupVOSnURS5SSupxUS-U-nXnURSS9Un URXS9R5n [U[5(dU4n[U[ S9nS R#S U55nU S R%S U-U5U S 'U ShvN ['S U-5v M gN![(a"n UR*R-SXK5 eSn A ff=f7f)z+Yield the lines for alias part of the help.NrTr)helptextkey, c3N# UHn[U5S:aSOSU-v M g7fr/z--%sz-%sNlen.0ms r: .Application.emit_alias_help..#!WQVASVaZ6Ua"GQV#%r--zEquivalent to: [--%s]z7Failed collecting help-message for alias %r, due to: %s)rrnrrrBrCTyper rJitemsrtuplesplit class_traitsclass_get_trait_help splitlinesrrrreplacer Exceptionr0error) rZ classdictrrvaliaslongnamefhelprrtrait fhelp_linesexs r:rApplication.emit_alias_helps|| 35 <.6rr c3p# UH,upUR5Hup4SUSUSU3v M M. g7f)rr=N)r )rclname props_dictpropvals r:rr 9sE$.9*%/%5%5%7 $q.%7/.9s46zEquivalent to: [%s]z6Failed collecting help-message for flag %r, due to: %s) rr rr rrrrr striprr0r)rZrcfgrcfg_listcfg_txtrs r:rApplication.emit_flag_help,szz #'::#3#3#5 E.sW;Va//11;Vs)rrxrs r:document_config_options#Application.document_config_optionss" yyW4;T;T;VWWWrEcT[SRUR555 g)z"Print the application description.rN)rrrIrs r:print_descriptionApplication.print_descriptions dii--/01rEc## [UR=(d UR=(d S5H nUv Sv M g7f)z-Yield lines with the application description.r%N)r rhr_)rZr4s r:rIApplication.emit_descriptions3 !1!1!GT\\!GRHAGHIsAAcT[SRUR555 g)z1Print usage and examples (see `emit_examples()`).rN)rrrLrs r:print_examplesApplication.print_exampless dii**,-.rEc## UR(a?Sv Sv Sv [[URR555v Sv gg7f)zYield lines with the usage and examples. This usage string goes at the end of the command line help string and should contain examples of the application's usage. Examplesz--------r%N)rlrr r(rs r:rLApplication.emit_examplessF ==  H 3 3 567 7H sAAc.[UR5 g)zPrint the version string.N)rrzrs r: print_versionApplication.print_versions dllrEcURRU5nUceUupE[U[5(a [ U5n[U[ 5(aD[ U[5(a/URR5 URUS9Ul O,[U5(aU"U5Ul O[SU-5eURRU5 g)z"Initialize a subcommand with argv.N)rwz%Invalid mappings for subcommand '%s'!)rgetrr^r#rrsr=r\clear_instanceinstancercallableAssertionErrorr)rZr<r$r'rr=s r:initialize_subcommand!Application.initialize_subcommands""4(  fc " " (F fd # # 6;(G(G NN ) ) + ///6DK f   ,DK !H4!OP P t$rEcZ[[5nURHFnURnUR 5SSH nXRR U5 M" MH 0nUR R5Hupg[U[5(aUupxURSS5up)Xn [U 5S:XaU Sn[U[5(dU4nUHn SRX)/5X['M M 0n URR5Hun up0nUR5H?unnXn [U 5S:XaU SnUU;aUURU5 M:UUU'MA [U [5(dU 4n U H nUU4U U'M M X4$)aFlatten flags and aliases for loaders, so cl-args override as expected. This prevents issues such as an alias pointing to InteractiveShell, but a config file setting the same trait in TerminalInteraciveShell getting inappropriate priority over the command-line arg. Also, loaders expect ``(key: longname)`` and not ``key: (longname, help)`` items. Only aliases with exactly one descendent in the class list will be promoted. r/rrr)rlistrnrJrrappendrr rr r rrrupdate)rZmro_treerclsnamerwrrrr=rchildrenalrrflagdictrnewflagsubdictks r: flatten_flagsApplication.flatten_flagsst$<CL''0#*GCL!1c5))f#T?a&8"~rEc B[XX4URURS9$)N)rnr0r)rr0r)rZr$rrrns r:_create_loaderApplication._create_loaders$& 5txxTM]M]  rEcU(a)S[R;aSSKJn U"5nUceU$[ R$![[ 4a [ R$f=f)a7Get `sys.argv` or equivalent from `argcomplete` `argcomplete`'s strategy is to call the python script with no arguments, so ``len(sys.argv) == 1``, and run until the `ArgumentParser` is constructed and determine what completions are available. On the other hand, `traitlet`'s subcommand-handling strategy is to check ``sys.argv[1]`` and see if it matches a subcommand, and if so then dynamically load the subcommand app and initialize it with ``sys.argv[1:]``. This helper method helps to take the current tokens for `argcomplete` and pass them through as `argv`. _ARGCOMPLETEr)get_argcomplete_cwords)osenviron#traitlets.config.argcomplete_configr~ ImportErrorModuleNotFoundErrorrr$)rcheck_argcompleter~cwordss r: _get_sys_argvApplication._get_sys_argvsa 2::!= V/1))) xx !45 xx sAA#"A#cvS[R;agSSKJn U"5 g![[ 4a gf=f)aHelper for `argcomplete` to recognize `traitlets` subcommands `argcomplete` does not know that `traitlets` has already consumed subcommands, as it only "sees" the final `argparse.ArgumentParser` that is constructed. (Indeed `KVArgParseConfigLoader` does not get passed subcommands at all currently.) We explicitly manipulate the environment variables used internally by `argcomplete` to get it to skip over the subcommand tokens. r}Nr)increment_argcomplete_index)rrrrrr)rrs r:"_handle_argcomplete_for_subcommand.Application._handle_argcomplete_for_subcommand4s9  +   W ' )01   s %88c>^ [U[5(aeUc%UR[UR5S9SSnUVs/sHn[ U5PM snUlU(aUSS:Xa USSS/-nUR(ad[U5S:aUUSUSSpC[R"SU5(a0X0R;a!UR5 URX45$USURS5m [U 4S jS 55(a%URS T ;5 UR!S5 S T ;dS T ;a!UR#5 UR!S5 UR%5upV['UR)55nUR+XXWS9n[-UR/55UlUR5UR05 UR6Ulgs snf![a Um GNf=f![2a ef=f)z!Parse the command line arguments.N)rr/rr-hz ^\w(\-?\w)*$rc3,># UH oT;v M g7frrI)rxinterpreted_argvs r:r1Application.parse_command_line..esM.L$$.Ls)r --help-allz--helprz --versionz-VrD)rr^rboolrr"r$rrematchrriindex ValueErroranyrFr4rarwrlrJrzr load_config cli_config SystemExit update_config extra_args) rZr$argr<subargvrrrnloaderrs @r:rApplication.parse_command_lineHsdC(((( <%%T=M=M8N%OPQPRSD267$3\#&$7 DGv%8tf$D   D A  GT!"X'xx..4;K;K3K77911$@@  $#$6djj&67  M.LM M M OOL,<< = IIaL * *d6F.F    IIaL++-t779:$$TE$K &v'9'9';%>v%F %:##KK!@@F$,$*$8$8$(JJz!$DA"5K"#7#788MM&)$$V%9%9:A1&* e &33C|H/ "JH_c desIB9H<F3 (H8&H"H+BH3 H=H?>H=HHHc URSS$)z$Currently loaded configuration filesN)rrs r:loaded_config_filesApplication.loaded_config_filess((++rEc[RRU5up[5nUR UUUR UR S9HBupVURU5 X`R;dM'URRU5 MD URUR5 URU5 g)z'Load config files by filename and path.)rr0rN) rrsplitextr rr0rmergerrmrr)rZrrext new_configr3fnames r:load_config_fileApplication.load_config_files ((2 X !44 %)%B%B 5 MF   V $666))007  ) :&rEc"URR5RSS5n[5nURR SU5 [ RR5Hqup4URU5(dMURR SX45 URS5GtpVnUnUHn XnM [X[U55 Ms URUR5 URU5 g)z!Load config files by environment.-r=z1Looping through config variables with prefix "%s"zSeeing environ "%s"="%s"__N)rgupperrr r0r2rrr  startswithr setattrrrrr) rZPREFIXrrvvr=rrsectionr4s r:load_config_environApplication.load_config_environs"**34X  JFSJJ$$&DA||F##91@!" #$A%jG&:1&=>' ) :&rEc#F^^# Uc URn[SURU555mSU4SjjmTR5n[U4SjTR 555mTU:XaOM<TR 5Hup4U(dMUv M g7f)a Yields only classes with configurable traits, and their subclasses. :param classes: The list of classes to iterate; if not set, uses :attr:`classes`. Thus, produced sample config-file will contain all classes on which a trait-value may be overridden: - either on the class owning the trait, - or on its subclasses, even if those subclasses do not define any traits themselves. Nc3V# UHnU[URSS954v M! g7f)TrN)rclass_own_traits)rrs r:r:Application._classes_with_config_traits..s/$ 9$s++4+89 :9s')cB>[U4SjUR55$)Nc3D># UHoT;=(a TUv M g7frrI)rb cls_to_configs r:rZApplication._classes_with_config_traits..is_any_parent_included..s!V 1M)>mA.>> s )r __bases__)rrs r:is_any_parent_includedGApplication._classes_with_config_traits..is_any_parent_includedsV VV VrEc3L># UHupX=(d T"U54v M g7frrI)rrinc_yesrs r:rrs(($9LCr?r)rnrrxrr )rZrn to_incl_origclrrrs @@r:rJ'Application._classes_with_config_traitss ?llG#$ 009$   W (--/L'($1$7$7$9(M ,)..0KBw1s BB! B!cRSUR-/nURS5 URS5 URS5 Uc UROUn[UR U55nUH#nURUR U55 M% SR U5$)z/generate default config file from Configurablesz# Configuration file for %s.r%zc = get_config() #noqar)rgrmrnrlrJclass_config_sectionr)rZrnlinesconfig_classesrs r:generate_config_file Application.generate_config_files/$));< R 34 R")/$,,wd>>wGH!C LL11.A B"yyrEc[USS5(aMURRH+n[[5 UR 5 SSS5 M- SUlgg!,(df  MG=f)NrF)rr0rrrcloser)rZhandlers r:close_handlersApplication.close_handlerssY 4. 6 6 88,,i(MMO)(-(-D $ 7 )(s A!! A0 cURRSUR5 UR5 [R "U5 g)NzExiting application: %s)r0r2rgrrr4)rZ exit_statuss r:r4Application.exit&s1 0$))<  rEcv[[5 UR5 SSS5 g!,(df  g=fr)rrrrs r:__del__Application.__del__+s$i    !! s* 8c jUR"S0UD6nURU5 UR5 g)ztLaunch a global instance of this Application If a global instance already exists, this reinitializes and starts it NrI)rfrr)rr$r7r5s r:launch_instanceApplication.launch_instance2s* ll$V$ t rE) rrr$rnrrrrrrr)rnClassesType | Noner?z+t.Generator[type[Configurable], None, None])r?r)rrr?None)r?r)r? AnyLogger)r7r>r?r)r$ArgvTyper?r)r?t.Generator[str, None, None])rnrr?r)F)rnrr?r)r?r^)r<r^r$rr?r)r?z)tuple[dict[str, t.Any], dict[str, t.Any]]) r$zlist[str] | Nonerrrrrnrr?r)rrr? list[str])NF) rr^r#str | t.Sequence[str | None] | Noner0zAnyLogger | Nonerrr?zt.Generator[t.Any, None, None])r?r)rr^rrr?r)rnrr?r^)r)rzint | str | Noner?r)r$rr7r>r?r)erJrKrLrMr_rrg__annotations__rhrirjrkrrrrrlrnrxrzrr$rr&rrr`ratagrrPrrrrrrrrrrrrrrrrrrrr rrrrrrrrrrDrrrrrrrr/r.r8r7rArFrErSrVrIr[rLrarirwrz classmethodrrrrpropertyrrrrJrrr4rrrNrbrcs@r:r=r=sB-4M,BD )B4;;T3UK0U:ABT:U7UEF\>];]!3318 H-9G[-1!)! 4!.07u~G ,=#'&D ( $$QRMll 2 cc  ( G cc - * cc 1f ]L+7GH"I" U#"$"( U^  . 0` ccan$%<=GW=   D  !4   K  &   A  #E7@8r&s2#  0%M   (78 ,   EG   EG sFtCH **..H" M ==?m#481 ]]_**491  h    ^^ F 7 7 F IIcCJ/0 GGGNN$BB C &&aee  ::affSk "ffQVVL)* * y &W&&&*b'bR%%!! L> z!rE