a lc@sdZddlZddlZddlZddlZddlZddlZddlZddlZ ddl m Z m Z ddl mZddlmZddlmZddlmZddlmZmZdd lmZmZmZmZmZmZdd lm Z m!Z!m"Z"m#Z#m$Z$m%Z%m&Z&m'Z'm(Z(m)Z)dd l*m+Z+dd l,m-Z-m.Z.d dl/m0Z0d dl1m2Z2d3Z4d3Z5e6edsde;ej?oej?@dZAddZBGdddeCZDGd d!d!ejEZFGd"d#d#eZGeGjHZIeGjJZKd)d$d%ZLd&d'ZMeNd(kreGOdS)*z,A base class for a configurable application.N) OrderedDict defaultdict)suppress)deepcopy) dictConfig)dedent) ConfigurableSingletonConfigurable) ArgumentErrorConfigConfigFileNotFoundJSONFileConfigLoaderKVArgParseConfigLoaderPyFileConfigLoader) BoolDictEnumInstanceList TraitErrorUnicodedefaultobserveobserve_compat) 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>falser"0FzUnsupported value for environment variable: 'TRAITLETS_APPLICATION_RAISE_CONFIG_FILE_ERROR' is set to '%s' which is none of {'0', '1', 'false', 'true', ''}.z pythonw.execstfdd}|S)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 snz|g|Ri|WSttfyh}z4|jd||jd|j|dWYd}~n d}~00dS)Nz0Bad config encountered during initialization: %szConfig at the time: %s)rr logfataldebugconfigexit)appargskwargsemethodX/var/www/html/django/DPS/env/lib/python3.9/site-packages/traitlets/config/application.pyinnerks z!catch_config_error..inner) functoolswraps)r3r6r4r2r5catch_config_errorbs r9c@s eZdZdS)ApplicationErrorN)__name__ __module__ __qualname__r4r4r4r5r:wsr:cs*eZdZdZejZdZfddZZ S)LevelFormattera Formatter 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 |cs.|j|jkr|j|j|_nd|_t|S)Nr")levelnohighlevel_limithighlevel_format__dict__Z highlevelsuperformat)selfrecord __class__r4r5rDs zLevelFormatter.format) r;r<r=__doc__loggingWARNr@rArD __classcell__r4r4rGr5r>{s r>cseZdZUdZedZejeefe d<edZ ejeefe d<ee Z ejeefe d<ee Z ejeefe d<ee Z ejeefe d<eZeZeZejeefe d <gZejejeje d <dd d ZedZejeefe d<eZejejeefe d<eeZejeefe d<edej ddj!ddZ"ejee#efe d<e$Z%edddj!ddZ&ejeefe d<edddj!ddZ'ejeefe d<dd Z(e)dddd!d"d#Z*e)d$d%d&d'd(Z+d)d*Z,e-d$d+d,Z.e/d-dj!ddZ0d.d/iZ1ej/eejfe d0<ddej2iid1fdd2diid3fdd4diid5fd6Z3ej/eejfe d7<e/Z4ejej/eej5eeffe/fe d8<e6d9dd:Z7eeZ8ejejeefe d;<e6e9ddj!ddZe)d2dBdCZ?dDdEZ@e)dFeAfdGdHZBeCddIdJZDdKdLZEdMdNZFdOdPZGdQdRZHdSdTZIdUdVZJdWdXZKdYdZZLd[d\ZMd]d^ZNd_d`ZOddbdcZPddddeZQdfdgZRdhdiZSdjdkZTdldmZUdndoZVdpdqZWeCddrdsZXdtduZYdvdwZZeCddxdyZ[e\ddzd{Z]e^d|d}Z_eCdd~dZ`dddZadddZbddZcdddZdddZee\dddZfZgS) Applicationz8A singleton application with full configuration support.Z applicationnamezThis is an application. descriptionoption_descriptionkeyvalue_descriptionsubcommand_descriptionexamplesclassesNccsV|dur|j}t}|D]8}t|D]&}t|tr(||vr(|||Vq(qdS)aIterate through configurable classes, including configurable parents :param classes: The list of classes to iterate; if not set, uses :attr:`classes`. Children should always be after parents, and each class should only be yielded once. N)rTsetreversedmro issubclassradd)rErTseencparentr4r4r5_classes_inc_parentss  z Application._classes_inc_parentsz0.0versionr!raise_config_file_errors) r (2DEBUGINFOrKERRORCRITICALz#Set the log level by value or name.) default_valuehelpTr, log_levelz%Y-%m-%d %H:%M:%Sz:The date format used by logging formatters for %(asctime)s)rj log_datefmtz#[%(name)s]%(highlevel)s %(message)szThe Logging format template log_formatcCslddddt|jddid|jjd|jj|j|jdi|jjddgd id d }t rh|d =|d =|S)aReturn the base logging configuration. The default is to log to stderr using a StreamHandler, if no default handler already exists. The log handler level starts at logging.WARN, but this can be adjusted by setting the ``log_level`` attribute. The ``logging_config`` trait is merged into this allowing for finer control of logging. r(consolezlogging.StreamHandlerzext://sys.stderr)class formatterlevelstream.)rprDdatefmtre)rrhandlersF)r^rv formattersloggersdisable_existing_loggersrvrx) rJ getLevelNamerl_log_formatter_clsr<r;rnrmrH IS_PYTHONWrEr,r4r4r5get_default_logging_configs6    z&Application.get_default_logging_configlogging_configcCs(|j}t|trtt||_|dSN)rl isinstancestrgetattrrJ_configure_logging)rEchangerlr4r4r5_observe_logging_change s  z#Application._observe_logging_changer)r)typecCs |dSr)rrErr4r4r5_observe_logging_defaultsz$Application._observe_logging_defaultcCs*|}t||jpit|d|_dS)NT)r~rrr_logging_configuredr}r4r4r5rszApplication._configure_loggingcCs<t|jj}d|_|}|r8|jr&|S|js0q8q|j}q|S)z#Start logging for this application.F)rJ getLoggerrHr; propagatervr\)rEr)_logr4r4r5 _log_default szApplication._log_defaulta  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|g|j|_n|jd|jdS)Nr)r __init__rHrTinsert)rEr0clsr4r4r5rs   zApplication.__init__r,cs t||jd|jdS)NzConfig changed: %r)rC_config_changedr)r+rrrGr4r5rs zApplication._config_changedcCs||dS)zMDo the basic steps to configure me. Override in subclasses. N)parse_command_line)rEr!r4r4r5 initializeszApplication.initializecCs|jdur|jSdS)zAStart the app mainloop. Override in subclasses. N)subapprrEr4r4r5rs zApplication.startc Cs|j}|jD]0}|j|vr||j}|dd|ddq|jrrtj|t j ddt dt j ddS|j rtd|j D]}td |qtt|D]Z}||}|sqt|td dd }t|D]*}||} td |tj| fi|qqdS) z,start function used when show_config is TruerNrr(T)r sort_keysr zLoaded config files:z )rcompactz .{} = {})r,copyrHrWr;poprjsondumpsysstdoutreprwrite_loaded_config_filesprintsorteddictrDpprintpformat) rEr,rZ cls_configf classnameZ class_configZpformat_kwargs traitnamevaluer4r4r5rs:         zApplication.start_show_configcCstd|dS)z"Print the alias parts of the help.rN)rjoinemit_alias_helprr4r4r5print_alias_helpszApplication.print_alias_helpc csV|js dSi}|jD]$}|ddD]}|||j<q(q|jD] \}}zt|trd|\}}nd}|ddd\}}|d|}||}|jdd|} |j | |d }t|ts|f}t |t d}d d d |D}|d d |||d <|EdHtd|VWqDtyN} z|jd|| WYd} ~ qDd} ~ 00qDdS)z+Yield the lines for alias part of the help.NrtTrk)Zhelptextkey, css&|]}t|dkrdnd|VqdSr(z--%sz-%sNlen.0mr4r4r5 z.Application.emit_alias_help..r--zEquivalent to: [--%s]z7Failed collecting help-message for alias %r, due to: %s)rrTrWr;itemsrtuplesplitZ class_traitsZclass_get_trait_help splitlinesrrrreplacer Exceptionr)error) rE classdictrr[aliaslongnamefhelprrtraitexr4r4r5rs4       zApplication.emit_alias_helpcCstd|dS)z Print the flag part of the help.rN)rremit_flag_helprr4r4r5print_flag_help!szApplication.print_flag_helpc cs|js dS|jD]\}\}}zzt|ts2|f}t|td}ddd|D}|Vtt| Vddd|D}d|}tt|VWqt y}z|j d ||WYd}~qd}~00qdS) z.Yield the lines for the flag part of the help.Nrrcss&|]}t|dkrdnd|VqdSrrrr4r4r5r/rz-Application.emit_flag_help.. css:|]2\}}|D] \}}d|d|d|VqqdS)rrt=N)r)rZclnameZ props_dictpropvalr4r4r5r2szEquivalent to: [%s]z6Failed collecting help-message for flag %r, due to: %s) rrrrrrrrrstriprr)r)rErcfgrZcfg_listZcfg_txtrr4r4r5r%s$   zApplication.emit_flag_helpcCstd|dS)z#Print the options part of the help.rN)rremit_options_helprr4r4r5 print_options=szApplication.print_optionsccsj|js|jsdSd}|Vdt|Vt|jD]}|VdVq2|EdH|EdHdVdS)z1Yield the lines for the options part of the help.NOptionsrr")rrrrrPrr)rEheaderpr4r4r5rAs zApplication.emit_options_helpcCstd|dS)z&Print the subcommand part of the help.rN)rremit_subcommands_helprr4r4r5print_subcommandsPszApplication.print_subcommandsccs|js dSd}|Vdt|Vt|jj|jdD]}|VdVq6|jD](\}\}}|V|rRtt| VqRdVdS)z4Yield the lines for the subcommand part of the help.NZ Subcommandsr)r.r") rrrrRrDrNrrrr)rErrsubc_rjr4r4r5rTsz!Application.emit_subcommands_helpccs|sdVdVdS)zzYield the very bottom lines of the help message. If classes=False (the default), print `--help-all` msg. z5To see all available configurables, use `--help-all`.r"Nr4rErTr4r4r5emit_help_epilogueeszApplication.emit_help_epilogueFcCstd|j|ddS)zPrint the help for each Configurable class in self.classes. If classes=False (the default), only flags and aliases are printed. rrTN)rr emit_helprr4r4r5 print_helpnszApplication.print_helpccs|EdH|EdH|EdH|r||}|rbdVdVt|jD]}|VdVqP|D]}|VdVqf|EdH||EdHdS)zYield the help-lines for each Configurable class in self.classes. If classes=False (the default), only flags and aliases are printed. Nz Class optionsz =============r") emit_descriptionrr_classes_with_config_traitsrrQZclass_get_help emit_examplesr)rErTZ help_classesrrr4r4r5rus  zApplication.emit_helpcCsddd|DS)zwGenerate rST format documentation for the config options this application Returns a multiline string. rcss|]}|VqdSr)Zclass_config_rst_doc)rr[r4r4r5rrz6Application.document_config_options..)rr]rr4r4r5document_config_optionssz#Application.document_config_optionscCstd|dS)z"Print the application description.rN)rrrrr4r4r5print_descriptionszApplication.print_descriptionccs*t|jp|jpdD]}|VdVqdS)z-Yield lines with the application description.r"N)rrOrI)rErr4r4r5rszApplication.emit_descriptioncCstd|dS)z1Print usage and examples (see `emit_examples()`).rN)rrrrr4r4r5print_examplesszApplication.print_examplesccs6|jr2dVdVdVtt|jVdVdS)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. ZExamplesz--------r"N)rSrrrrr4r4r5rs zApplication.emit_examplescCst|jdS)zPrint the version string.N)rr^rr4r4r5 print_versionszApplication.print_versioncCs|j|}|dusJ|\}}t|tr2t|}t|tr`t|tr`|j |j |d|_ n t |rt|||_ n t d||j |dS)z"Initialize a subcommand with argv.N)r\z%Invalid mappings for subcommand '%s'!)rgetrrr rrXrMrHZclear_instanceinstancercallableAssertionErrorr)rErr!rrrr4r4r5initialize_subcommands      z!Application.initialize_subcommandcCsftt}|jD]0}|j}|ddD]}||j|q(qi}|jD]r\}}t|t rh|\}}| dd\}} ||} t | dkr| d}t|t s|f}|D]} d || g|| <qqNi} |j D]\} \}}i}|D]H\}}||} t | dkr| d}||vr(|||q|||<qt| t sD| f} | D]}||f| |<qHq| |fS)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(rrtr)rlistrTr;rWappendrrrrrrrrupdate)rEZmro_treerclsnamer\rrrrrchildrenalrrZflagdictrjZnewflagZsubdictkr4r4r5 flatten_flagss@       zApplication.flatten_flagscCst|||||jdS)N)rTr))rr))rEr!rrrTr4r4r5_create_loaderszApplication._create_loadercst|trJ|dur$tjddn|}dd|D|_|rZ|ddkrZ|dddg}|jrt|dkr|d|dd}}td|r||jvr|||Sz|d| d Wnt y|Yn0t fd d d Dr| d v| ddvsdvr(|| d|\}}t|}|j||||d}zt||_WntyzYn0||j|j|_dS)z!Parse the command line arguments.Nr(cSsg|] }t|qSr4r)rargr4r4r5 rz2Application.parse_command_line..rrj-hz ^\w(\-?\w)*$rc3s|]}|vVqdSrr4)rxZinterpreted_argvr4r5r&rz1Application.parse_command_line..)r --help-allz--helprz --versionz-Vr)rrrr!rrrematchrindex ValueErroranyrr-rrrrrr load_config cli_config SystemExit update_configr)rEr!rZsubargvrrrTloaderr4rr5r s8        zApplication.parse_command_linec csRt|ts|g}t|D]2}|j|d||d}|rL|d||pHt|j|d||d}g}g} ||fD]} d} z | } WnFt yYnHt y| j p|} |r|r|j d| ddYn0|r|d | j | rpt | |D]:\} } | | }|r|r|d | | j tj|d d q| | j fV|| | | j qpqdS) zeLoad config files (py,json) by filename and path. yield each config object in turn. z.py)pathr)zLooking for %s in %sz.jsonNz&Exception while loading config file %sT)exc_infozLoaded config file: %szMCollisions detected in {0} and {1} config files. {1} has higher priority: {2}r)r)rrrVpython_config_loader_classr+osgetcwdjson_config_loader_classr r rZ full_filenamerzip collisionswarningrDrdumpsr)rZ basefilenamerr)r_currentZpyloaderZ jsonloaderZloaded filenamesrr,filenameZearlier_configrr4r4r5_load_config_files<sJ          zApplication._load_config_filescCs|jddS)z$Currently loaded configuration filesN)rrr4r4r5loaded_config_filesoszApplication.loaded_config_filescCsptj|\}}t}|j|||j|jdD](\}}||||jvr,|j |q,||j | |dS)z'Load config files by filename and path.)rr)r_N) rrsplitextr rr)r_mergerrrr)rErrextZ new_configr,fnamer4r4r5load_config_filets  zApplication.load_config_filec#s|dur|j}tdd||Dfdd}tfddD|kr2q`q2D]\}}|rh|VqhdS)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. Ncss"|]}|t|jddfVqdS)TrkN)boolZclass_own_traits)rrr4r4r5rsz:Application._classes_with_config_traits..cstfdd|jDS)Nc3s|]}|vo|VqdSrr4)rb cls_to_configr4r5rrzZApplication._classes_with_config_traits..is_any_parent_included..)r  __bases__)rr(r4r5is_any_parent_includedszGApplication._classes_with_config_traits..is_any_parent_includedc3s"|]\}}||p|fVqdSrr4)rrinc_yes)r+r4r5rs)rTrr]rr)rErTZ to_incl_origclr,r4)r)r+r5rs  z'Application._classes_with_config_traitscCsnd|jg}|d|d|d|dur8|jn|}t||}|D]}|||qNd|S)z/generate default config file from Configurablesz# Configuration file for %s.r"zc = get_config() # noqaNr)rNrrTrrZclass_config_sectionr)rErTlinesZconfig_classesrr4r4r5generate_config_files    z Application.generate_config_filec CsTt|ddrP|jjD]4}tt|Wdq1s>0Yqd|_dS)NrF)rr)rvrrcloser)rEhandlerr4r4r5close_handlerss    (zApplication.close_handlersrcCs(|jd|j|t|dS)NzExiting application: %s)r)r+rNr2rr-)rEZ exit_statusr4r4r5r-szApplication.exitcCs |dSr)r2rr4r4r5__del__szApplication.__del__cKs&|jfi|}|||dS)zLaunch a global instance of this Application If a global instance already exists, this reinitializes and starts it N)rrr)rr!r0r.r4r4r5launch_instances zApplication.launch_instance)N)N)F)F)N)N)NNF)N)N)N)r)N)hr;r<r=rIrrNtUnionr__annotations__rOrPrQrRrrr rrSrTrTypeAnyr]r^r!rr#r_r&rrJrKtagrlintr>r{rmrnr~rrrrrrrrrrerrTuplerrrr rrrrrrrrrr9rrrrrrrrrrrrrrrrrrrrrrrr classmethodrpropertyr r%rr/r2r-r3r4rLr4r4rGr5rMs  3     05    , "     &%    ; 0 2   (  rMcCsV|p d|}|pd|}|d\}}||dii}||dii}|||fd|||fiS)aHelper for building basic --trait, --no-trait flags. Parameters ---------- name : str The name of the flag. configurable : str The 'Class.trait' string of the trait to be set/unset with the flag set_help : unicode help string for --name flag unset_help : unicode help string for --no-name flag Returns ------- cfg : dict A dict with two keys: 'name', and 'no-name', for setting and unsetting the trait, respectively. z set %s=Truez set %s=FalsertTFzno-)r)rNZ configurableZset_helpZ unset_helprrsetterZunsetterr4r4r5 boolean_flags     r@cCstrtjStSdS)z|Get the config object for the global Application instance, if there is one otherwise return an empty config object N)rMZ initializedrr,r r4r4r4r5 get_configs rA__main__)r"r")PrIr7rrJrrrrtypingr5 collectionsrr contextlibrrrlogging.configrtextwraprZtraitlets.config.configurablerr Ztraitlets.config.loaderr r r r rrZtraitlets.traitletsrrrrrrrrrrZtraitlets.utils.nested_updaterZtraitlets.utils.textrrutilsrZutils.importstringr rrPrQhasattrr!rRenvironrZ_envvarlowerr#r  executableendswithr|r9rr: Formatterr>rMrZdefault_aliasesrZ default_flagsr@rAr;r4r4r4r4r5sh     0     S