+ ~viRt^RIHt^RIt^RIt^RIt^RIt^RIt^RIt^RI t ^RI t ^RI H t Ht^RIHt^RIHt^RIHt^RIHt^RIHtHt^R IHtHtHtHtHtH t H!t!^R I"H#t#H$t$H%t%H&t&H't'H(t(H)t)H*t*H+t+H,t,^R I-H.t.^R I/H0t0^R I1H2t2H3t3^RI4H5t5^RI6H7t7RPq4t9RPq4t:];!] R4'g R.] n<Rt=]P|PRR4t@]@P4R+9dRtBM']@P4R,9dRtBM]C!R]@,4h] P;'d] PPR4tF] P!R] PR] P3,R7tJ] P]PR3,tM] PH]N] P3,tO] P] PN]N,,tQ] PN] P],,tSRRltT!R R!]U4tV!R"R#]P4tX!R$R%]4tY]YPt[]YPt]R-R&R'llt^R(R)lt_]`R*8Xd]YP4R#R#).z,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_ERRORTFzUnsupported 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 V^8dQhRRRR/#)methodr%return)formats">/usr/lib/python3/dist-packages/traitlets/config/application.py __annotate__r.jsqQc~a\P!S4RV3Rll4p\P!\V4#)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(V^8dQhRRRRRRRR/#)r(app Applicationargst.Anykwargsr*r+)r,s"r-r.(catch_config_error..__annotate__ts(;u%r/c<S!V.VO5/VB# \\3d_pTPPRT4TPP RTP 4TP ^4Rp?R#Rp?ii;i)z0Bad config encountered during initialization: %szConfig at the time: %sN)rr logfataldebugconfigexit)r2r4r6er)s&*, r-inner!catch_config_error..innerssi #/// /M*  GGMMLa P GGMM2CJJ ? HHQKK s A>AA99A>) functoolswrapstcastr%)r)r?sf r-catch_config_errorrEjs3__V 66!U r/c]tRt^tRtR#)ApplicationErrorr+N)__name__ __module__ __qualname____firstlineno____static_attributes__r+r/r-rGrGsr/rGcNa]tRt^tRt]P tRtRV3Rllt Rt V;t #)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 V^8dQhRRRR/#)r(recordzlogging.LogRecordr*strr+)r,s"r-r.LevelFormatter.__annotate__s&&.&3&r/c <VPVP8d$VPVP,VnMRVn\ SV`V4#)r#)levelnohighlevel_limithighlevel_format__dict__ highlevelsuperr,)selfrP __class__s&&r-r,LevelFormatter.formatsC >>T11 1#44vFF !F w~f%%r/r+) rHrIrJrK__doc__loggingWARNrUrVr,rL __classcell__r[s@r-rNrNs#llO)&&r/rNca]tRt^t$Rt]!R4tR]R&]!R4tR]R&]!] 4t R]R&]!] 4t R]R&]!] 4t R]R &] t ]t]!4tR]R &.tR ]R &RR Rllt]!R4tR]R&]!4tR]R&]!]4t]!R]P6RR7P9RR7t]t]!RRR7P9RR7t ]!RRR7P9RR7t!RRlt"]#!RRR R!4R"R#l4t$]#!R$R%R&7R'R(l4t%R)R*lt&]'!R$4R+R,l4t(])!R-R7P9RR7t*R.R//t+R0]R1&R2RR ]PX//R33R4RR5R//R63R7RR8R//R93/t-R0]R:&])!4t.R;]R<&]/!R=RR>7t0]!]!44t1]/!]2R/R?R7t3]!4t4R@]RA&]!RBR7P9RR7t5]!RCR7P9RR7t6]#!R84RDREl4t7]#!R54RFRGl4t8RHRIlt9]#!RJ4]:RKV3RLll44t;]RQRRlt?RSRTlt@RURVltARWRXltBRYRZltCR[R\ltDR]R^ltER_R`ltFRaRbltGRcRdltHRReRflltIRRgRhlltJRiRjltKRkRlltLRmRnltMRoRpltNRqRrltORsRtltP]D33<<=?doot//   ''W * '5 : :z"y! r/rrrlogging_configc V^8dQhRRRR/#r(changerr*Noner+)r,s"r-r.ros""e""r/c VPp\V\4'd/\P!\ \ \V44VnVP4R#N) r isinstancerQrCrDintgetattrr^_configure_logging)rZrrs&& r-_observe_logging_change#Application._observe_logging_changes?NN i % %VVC))DEDN !r/r9r)typec V^8dQhRRRR/#rr+)r,s"r-r.ros""u""r/c &VP4R#r)rrZrs&&r-_observe_logging_default$Application._observe_logging_defaults !r/cV^8dQhRR/#r(r*rr+)r,s"r-r.ro"s((D(r/c VP4p\YP;'g/4\V4RVnR#)TN)rrrr_logging_configuredrs& r-rApplication._configure_logging"s6002f1177R86#' r/cV^8dQhRR/#)r(r* AnyLoggerr+)r,s"r-r.ro*s  i r/c \P!VPP4pRVnTpVe8VP 'dV#VP'gV#VP pK;V#)z#Start logging for this application.F)r^ getLoggerr[rH propagaterrx)rZr9_logs& r- _log_defaultApplication._log_default)s_ 7 78 }}} >>> ;;D r/a! 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_levelraliasesr;z5Set log-level to debug, for the most verbose logging.z show-config show_configz>%%'C||v%#LL1 }d3148 (  IIfcjjdD Q JJ  T "   $ $ $ ( )..dQh/ GI!,L ) &*!T&BN#L1 $/I;c&..*Q.*Q)RST2(r/cV^8dQhRR/#rr+)r,s"r-r.ros11$1r/c V\RPVP444R#)z"Print the alias parts of the help.rN)rjoinemit_alias_helprs&r-print_alias_helpApplication.print_alias_helps dii,,./0r/cV^8dQhRR/#r(r*t.Generator[str, None, None]r+)r,s"r-r.ros$$!=$r/c# "VP'gR#/pVPFYpVP4RR F?p\P!\P \ ,V4WP&KA K[ VPP4EFwrE\V\4'dVwrVMRpVPR4R RwrxVR,V,pW,pVPRR7V,p VPWR7P4p \V\4'gV3p\V\ R7pRP#RV44pV ^,P%R V,V4V ^&T RjxL \'R V,4xEK R#L \(d#p TP*P-R YK4hRp ? ii;i5i)z+Yield the lines for alias part of the help.NrTr~)helptextkey, c3X"TF p\V4^8dRMRV,xK" R#5iz--%sz-%sNlen.0ms& r- .Application.emit_alias_help..&!WQVASVaZ6Ua"G"GQV(*--zEquivalent to: [--%s]z7Failed collecting help-message for alias %r, due to: %s)rrkrsrCrDTyper rHitemsrtuplesplit class_traitsclass_get_trait_help splitlinesrr rreplacer Exceptionr9error) rZ classdictrrwaliaslongnamefhelprrtrait fhelp_linesexs & r-rApplication.emit_alias_helps||| 35 <GG  G#cV^8dQhRR/#rr+)r,s"r-r.ro(s000r/c V\RPVP444R#)z Print the flag part of the help.rN)rremit_flag_helprs&r-print_flag_helpApplication.print_flag_help(s dii++-./r/cV^8dQhRR/#rr+)r,s"r-r.ro,s <r/c# B"VP'gR#VPP4Fwpwr#\V\4'gV3p\ V\ R7pRP RV44pVx\\VP444xRP RVP444pRV,p\\V44xK R# \d#pTPPRY4hRp?ii;i5i) z.Yield the lines for the flag part of the help.Nrrc3X"TF p\V4^8dRMRV,xK" R#5ir r rs& r-r-Application.emit_flag_help..6rr c3n"TF+wrVP4Fwr4RV RV RV 2xK K- R#5i)rr=N)r)rclname props_dictpropvals& r-rr29sE$.9*%/%5%5%7 $q.%7/.9s35zEquivalent to: [%s]z6Failed collecting help-message for flag %r, due to: %s) rrrrrr rrrstripr r9r!)rZrcfgr%cfg_listcfg_txtr(s& r-r,Application.emit_flag_help,szzz #'::#3#3#5 E.sW;Va//11;Vs)rryrs&r-document_config_options#Application.document_config_optionss" yyW4;T;T;VWWWr/cV^8dQhRR/#rr+)r,s"r-r.ros2242r/c V\RPVP444R#)z"Print the application description.rN)rrrdrs&r-print_descriptionApplication.print_descriptions dii--/01r/cV^8dQhRR/#rr+)r,s"r-r.ros">r/c# "\VP;'gVP;'gR4F pVxRxK R#5i)z-Yield lines with the application description.r#N)rrer])rZrHs& r-rdApplication.emit_descriptions9 !1!1!G!GT\\!G!GRHAGHIs ,AAcV^8dQhRR/#rr+)r,s"r-r.ros///r/c V\RPVP444R#)z1Print usage and examples (see `emit_examples()`).rN)rrrgrs&r-print_examplesApplication.print_exampless dii**,-.r/cV^8dQhRR/#rr+)r,s"r-r.ros  ; r/c# "VP'dARxRxRx\\VPP444xRxR#R#5i)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)rirrr:rs&r-rgApplication.emit_examplessH ===  H 3 3 567 7H sAAcV^8dQhRR/#rr+)r,s"r-r.rostr/c 0\VP4R#)zPrint the version string.N)rr{rs&r- print_versionApplication.print_versions dllr/c$V^8dQhRRRRRR/#)r(rRrQr"rr*rr+)r,s"r-r.ros!%%#%X%%r/c VPPV4pVfQhVwrE\V\4'd \ V4p\V\ 4'dI\ V\4'd3VPP4VPVR7Vn M1\V4'dV!V4Vn M\RV,4hVPPV4R#)z"Initialize a subcommand with argv.N)rxz%Invalid mappings for subcommand '%s'!)rgetrrQr!rrtr3r[clear_instanceinstancercallableAssertionErrorr)rZrRr"r9rrSs&&& r-initialize_subcommand!Application.initialize_subcommands""4(  fc " " (F fd # # 6;(G(G NN ) ) + ///6DK f   ,DK !H4!OP P t$r/cV^8dQhRR/#)r(r*z)tuple[dict[str, t.Any], dict[str, t.Any]]r+)r,s"r-r.ros99H9r/c \\4pVPFJpVPpVP 4^RF$pWP,P V4K& KL /pVP P4Fwrg\V\4'dVwrxVPR^4wr)W,p \V 4^8Xd V ^,p\V\4'gV3pVFp RPW).4W[&K K /p VPP4Fwp wr/pVP4FMwppW,p \V 4^8Xd V ^,pVV9dVV,PV4KHVVV&KO \V \4'gV 3p V F pVV3V V&K K W3#)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. rr)rlistrkrHrsappendrrrrrr rrupdate)rZmro_treerclsnamerxrr#r$rSr&childrenalrrflagdictr}newflagsubdictks& r- flatten_flagsApplication.flatten_flagsst$<CL''0#*GCL!1c5))f#T?a&8"~r/c ,V^8dQhRRRRRRRRRR /#) r(r"zlist[str] | Nonerrrrkrnr*rr+)r,s"r-r.ros<         $   r/c  H\WW4VPVPR7#))rkr9r)rr9r)rZr"rrrks&&&&&r-_create_loaderApplication._create_loaders$& 5txxTM]M]  r/c V^8dQhRRRR/#)r(check_argcompleterWr* list[str]r+)r,s"r-r.rosdyr/c V'd,R\P9d^RIHpV!4pVfQhV#\ P# \\ 3d\ P#i;i)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`. _ARGCOMPLETE)get_argcomplete_cwords)osenviron#traitlets.config.argcomplete_configr ImportErrorModuleNotFoundErrorrr")rrrcwordss&& r- _get_sys_argvApplication._get_sys_argvsa 2::!= V/1))) xx !45 xx sAA'&A'cV^8dQhRR/#rr+)r,s"r-r.ro5s4r/c R\P9dR#^RIHpV!4R# \\ 3dR#i;i)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. rN)increment_argcomplete_index)rrrrrr)rrs& r-"_handle_argcomplete_for_subcommand.Application._handle_argcomplete_for_subcommand4s9  +   W ' )01   s (==c V^8dQhRRRR/#rr+)r,s"r-r.roIs0,0,x0,40,r/c a \V\4'dQhVf-VP\VP4R7R,pVUu.uFp\ V4NK upVnV'd V^,R8XdVR,R.,pVP'dp\V4^8d`V^,VR,rC\P!RV4'd2W0P9d"VP4VPW44#VRVPR4o \;QJdV 3RlR4F 'gK R M R M!V 3RlR44'd&VPR S 94VP!^4R S 9gR S 9d"VP#4VP!^4VP%4wrV\'VP)44pVP+WWWR7p\-VP/44VnTP5TP04TP6TnR#uupi \dTo EL4i;i \2dhi;i)z!Parse the command line arguments.N)r:r NNr}-hz ^\w(\-?\w)*$rc3,<"TF qS9xK R#5irr+)rxinterpreted_argvs& r-r1Application.parse_command_line..esM.L$$.Ls --help-allTFz --versionz-Vr^)rrz--help)rrQrrWrr r"r rematchrrindex ValueErroranyr`r=rrrrerr load_config cli_config SystemExit update_config extra_args) rZr"argrRsubargvrrrkloaderrs && @r-rApplication.parse_command_lineHsdC(((( <%%T=M=M8N%OPRSD267$3\#&$7 DGv%8tf$D    D A  GT"X'xx..4;K;K3K77911$@@  $#$6djj&67  3M.LM333M.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 &33CC|H/ "JH_c deshA#G?&AG?'F&7)G?%&G?G?B G?& G<1G?3G<<G< G<G<$G<8G?;G<<G?cV^8dQhRR/#)r(r*rr+)r,s"r-r.ros,,Y,r/c (VPR,#)z$Currently loaded configuration files:NNN)rrs&r-loaded_config_filesApplication.loaded_config_filess((++r/c$V^8dQhRRRRRR/#)r(rrQrrr*rr+)r,s"r-r.ros$'''#F' 'r/c \PPV4wr\4pVP VVVP VP R7FCwrVVPV4W`P9gK(VPPV4KE VPVP4VPV4R#)z'Load config files by filename and path.)rr9rN) rrsplitextr rr9rmergerrrr)rZrrext new_configr<fnames&&& r-load_config_fileApplication.load_config_files ((2 X !44 %)%B%B 5 MF   V $666))007  ) :&r/cV^8dQhRR/#rr+)r,s"r-r.ros''T'r/c .VPP4PRR4p\4pVPP RV4\ PP4Fvwr4VPV4'gKVPP RW44VPR4EvrVpTpVF p W,pK \W\V44Kx VPVP4VPV4R#)z!Load config files by environment.-rSz1Looping through config variables with prefix "%s"zSeeing environ "%s"="%s"__N)rdupperrr r9r;rrr startswithrsetattrrrrr) rZPREFIXrrvrSrrsectionrHs & r-load_config_environApplication.load_config_environs"**34X  JFSJJ$$&DA||F##91@!" #$A%jG&:1&=>' ) :&r/c V^8dQhRRRR/#rmr+)r,s"r-r.ros(()( 4(r/c# Paa"Vf VPp\RVPV444oRV3RlloSP4p\V3RlSP 444oSV8XgK=SP 4Fwr4T'gKTxK R#5i)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. Nc3\"TF"pV\VPRR743xK$ R#5i)Tr~N)rWclass_own_traits)rrs& r-r:Application._classes_with_config_traits..s/$ 9$s++4+89 :9s*,c V^8dQhRRRR/#)r(rr5r*rWr+)r,s"r-r.=Application._classes_with_config_traits..__annotate__s W W W$ Wr/c<\;QJd)V3RlVP4F 'gK R# R#!V3RlVP44#)c3N<"TFqS9;'d SV,xK R#5irr+)rb cls_to_configs& r-rZApplication._classes_with_config_traits..is_any_parent_included..s$V 1M)>>mA.>> %%TF)r __bases__)rrs&r-is_any_parent_includedGApplication._classes_with_config_traits..is_any_parent_includeds43V V33 V3 V3V VV Vr/c3N<"TFwrY;'g S!V43xK R#5irr+)rrinc_yesrs& r-rrs+($9LC<  #  r/c \RVP,.pVPR4VPR4VPR4Vf VPMTp\VP V44pVF#pVPVP V44K% RP V4#)z/generate default config file from Configurablesz# Configuration file for %s.r#rzc = get_config() #noqa)rdrrkrreclass_config_sectionr)rZrklinesconfig_classesrs&& r-generate_config_file Application.generate_config_files/$));< R 34 R")/$,,wd>>wGH!C LL11.A B"yyr/cV^8dQhRR/#rr+)r,s"r-r.ros---r/c \VRR4'dWVPPF3p\\4;_uu_4VP 4RRR4K5 RVnR#R# +'giKS;i)rFN)rr9rrr closer)rZhandlers& r-close_handlersApplication.close_handlerss_ 4. 6 6 88,,i((MMO)(-(-D $ 7 )((s A,, A= c V^8dQhRRRR/#)r( exit_statuszint | str | Noner*rr+)r,s"r-r.ro$s 0r/c VPPRVP4VP4\P !V4R#)zExiting application: %sN)r9r;rdrrr=)rZrs&&r-r=Application.exit$s1 0$))<  r/cV^8dQhRR/#rr+)r,s"r-r.ro)sr/c &VP4R#r)rrs&r-__del__Application.__del__)s r/c$V^8dQhRRRRRR/#)r(r"rr6r5r*rr+)r,s"r-r.ro-s!8er/c lVP!R/VBpVPV4VP4R#)ztLaunch a global instance of this Application If a global instance already exists, this reinitializes and starts it Nr+)rrr)rr"r6r2s&&, r-launch_instanceApplication.launch_instance,s* ll$V$ t r/) rrr"rkrrrrrrr) r (2rINFOr_ERRORCRITICALr+)F)NF)r)erHrIrJrKr]rrd__annotations__rerfrgrhrrrrrirkryr{rr"rr$rrr^r_tagrrNrrrrrrrrrrrrrrrrrrrr rrrrrrrrrrErrrrrr-r,rBrArMrLrZr`r_rorsrdrzrgrrrr classmethodrrrrpropertyrrrrerrr=r"r&rLr`ras@r-r3r3suB-4M,BD )B4;;T3UK0U:ABT:U7UEF\>];]!3318 H-9G[!.07u~G ,=#'&D ( $$QRMll 2 cc  ( G cc - * cc 1f ]L+7GH"I" U#"$"( U^  . 0` ccan$%<=GW=    D   !4   K   &   A  #E7@81true>r#0false)r#r#)br] __future__rrArr^rrrrtypingrC collectionsrr contextlibrrrlogging.configrtextwraprtraitlets.config.configurabler r traitlets.config.loaderr r r rrrrtraitlets.traitletsrrrrrrrrrrtraitlets.utils.bunchrtraitlets.utils.nested_updatertraitlets.utils.textrrutilsr utils.importstringr!r:rfrghasattrr"rhrr_envvarlowerr$r executableendswithrTypeVarCallableAnyr%UnionLoggerrrQrOptionalrrrjrEr rG FormatterrNr3rdefault_aliasesr default_flagsr;r?rHr&r+r/r-ras2#  0%M   (78 ,   EG   EG sFtCH **..H" M ==?m#481 ]]_**491  h    ^^ F F 7 7 F IIcCJ/0 GGGNN$BB C &&aee  ::affSk "ffQVVL)* * y &W&&&*\'\F%%!! L> z!r/