U -e@sdZddlmZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl m Z mZddlmZddlmZddlmZddlmZdd lmZmZdd lmZmZmZmZmZm Z dd l!m"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/ddl0m1Z1m2Z2ddl3m4Z4ddl5m6Z6d7Z8d7Z9e:e dsTdge _;dZddZ?e?@dkrzdZAn e?@dkrdZAn eBde?e jCoe jCDdZEe jFde jGde jHfd ZIe jJejKejLfZMe j#eNe jHfZOe jPe j&eNZQe j&e jReZSddd!d"d#ZTGd$d%d%eUZVGd&d'd'ejWZXGd(d)d)eZYeYjZZ[eYj\Z]d4d*d*d*d*d+d,d-d.Z^d/d0d1d2Z_e`d3kreYadS)5z,A base class for a configurable application.) annotationsN) OrderedDict defaultdict)suppress)deepcopy) dictConfig)dedent) ConfigurableSingletonConfigurable) ArgumentErrorConfigConfigFileNotFoundJSONFileConfigLoaderKVArgParseConfigLoaderPyFileConfigLoader) 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>true1T>r$false0FzUnsupported 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.)bound)methodreturncs.tdddddfdd }tt|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. Applicationt.Any)appargskwargsr-c sfz|f||WSttfk r`}z,|jd||jd|j|dW5d}~XYnXdS)Nz0Bad config encountered during initialization: %szConfig at the time: %s)rr logfataldebugconfigexit)r0r1r2er,]/var/www/html/Darija-Ai-Train/env/lib/python3.8/site-packages/traitlets/config/application.pyinnerrs z!catch_config_error..inner) functoolswrapstcastr*)r,r=r;r:r<catch_config_erroris rBc@s eZdZdS)ApplicationErrorN)__name__ __module__ __qualname__r;r;r;r<rC~srCcs2eZdZdZejZdZdddfdd ZZ 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 |zlogging.LogRecordstr)recordr-cs.|j|jkr|j|j|_nd|_t|S)Nr$)levelnohighlevel_limithighlevel_format__dict__Z highlevelsuperformat)selfrI __class__r;r<rOs zLevelFormatter.format) rDrErF__doc__loggingWARNrKrLrO __classcell__r;r;rQr<rGs rGcseZdZUdZedZded<edZded<eeZded<ee Z ded<ee Z ded <e Z e ZeZded <gZd ed <ddddddZedZded<eZeeZedejddjddZeZedddjddZedddjddZ dd d!d"Z!e"d#d$d%d&d'd(d)d*d+Z#e"d,d-d.d'd(d)d/d0Z$d(d d1d2Z%e&d,d3d d4d5Z'e(d6djddZ)d7d8iZ*ded9<dd%ej+iid:fdd;diidfd?Z,ded@<e(Z-dAedB<e.dCddDZ/eeZ0e.e1dEidFdZ2eZ3edGdjddZ4edHdjddZ5e"d=d'd(d)dIdJZ6e"d;d'd(d)dKdLZ7dMd(dNdOdPZ8e"dQe9d'd(d)fdRdS Z:e;ddTd(dUdVdWZd(d d\d]Z?d^d d_d`Z@d(d dadbZAd^d dcddZBd(d dedfZCd^d dgdhZDd(d didjZEd^d dkdlZFdmd^ddndoZGddmd(ddqdrZHddmd^ddsdtZIdud dvdwZJd(d dxdyZKd^d dzd{ZLd(d d|d}ZMd^d d~dZNd(d ddZOe;ddudTd(dddZPdd ddZQddddddddZReSddmddddZTeSd(d ddZUe;ddTd(dUddZVeSddudddmddddZWeXdd ddZYe;ddudd(dddZZddddddZ[dddudddZ\d(d ddZ]ddd(dddZ^d(d ddZ_eSddTdMd(dddZ`ZaS)r.z8A singleton application with full configuration support.Z applicationzstr | Unicode[str, str | bytes]namezThis is an application. descriptionoption_descriptionkeyvalue_descriptionsubcommand_descriptionexamples ClassesTypeclassesNzClassesType | Nonez+t.Generator[type[Configurable], None, None])r^r-ccsV|dkr|j}t}|D]8}t|D]&}t|tr(||kr(|||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)r^setreversedmro issubclassr add)rPr^seencparentr;r;r<_classes_inc_parentss  z Application._classes_inc_parentsz0.0version) r (2DEBUGINFOrUERRORCRITICALz#Set the log level by value or name.) default_valuehelpTr7z%Y-%m-%d %H:%M:%Sz:The date format used by logging formatters for %(asctime)s)rsz#[%(name)s]%(highlevel)s %(message)szThe Logging format templateStrDictr-cCslddddt|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. r3consolezlogging.StreamHandlerzext://sys.stderr)class formatterlevelstream.)rxrOdatefmtrn)rzhandlersF)rhr~ formattersloggersdisable_existing_loggersr~r) rT getLevelName log_level_log_formatter_clsrErD log_format log_datefmtrR IS_PYTHONWrPr7r;r;r<get_default_logging_configs2   z&Application.get_default_logging_configrrrlogging_configrNone)changer-cCs(|j}t|trtt||_|dSN)r isinstancerHgetattrrT_configure_logging)rPrrr;r;r<_observe_logging_changes  z#Application._observe_logging_changer4r)typecCs |dSr)rrPrr;r;r<_observe_logging_defaultsz$Application._observe_logging_defaultcCs*|}t||jpit|d|_dS)NT)rrrr_logging_configuredrr;r;r<r szApplication._configure_logging AnyLoggercCs<t|jj}d|_|}|r8|jr&|S|js0q8q|j}q|S)z#Start logging for this application.F)rT getLoggerrRrD propagater~rf)rPr4_logr;r;r< _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_configzsz.Application.emit_alias_help..r--zEquivalent to: [--%s]z7Failed collecting help-message for alias %r, due to: %s)rr^rar@rATyper rDitemsrtuplesplitZ class_traitsZclass_get_trait_help splitlinesrrrreplacer Exceptionr4error) rP classdictrrealiaslongnamefhelprrtraitZ fhelp_linesexr;r;r<rs4       zApplication.emit_alias_helpcCstd|dS)z Print the flag part of the help.rN)rremit_flag_helprr;r;r<print_flag_help'szApplication.print_flag_helpc cs|js dS|jD]\}\}}zzt|ts2|f}t|td}ddd|D}|Vtt| Vddd|D}d|}tt|VWqt k r}z|j d ||W5d}~XYqXqdS) z.Yield the lines for the flag part of the help.Nrrcss&|]}t|dkrdnd|VqdSrrrr;r;r<r5sz-Application.emit_flag_help.. css:|]2\}}|D] \}}d|d|d|VqqdS)rr|=N)r)rZclnameZ props_dictpropvalr;r;r<r8s zEquivalent to: [%s]z6Failed collecting help-message for flag %r, due to: %s) rrrrrrrrrstriprr4r)rPrcfgrZcfg_listZcfg_txtrr;r;r<r+s$   zApplication.emit_flag_helpcCstd|dS)z#Print the options part of the help.rN)rremit_options_helprr;r;r< print_optionsCszApplication.print_optionsccsj|js|jsdSd}|Vdt|Vt|jD]}|VdVq2|EdH|EdHdVdS)z1Yield the lines for the options part of the help.NOptionsrr$)rrrrrYrr)rPheaderpr;r;r<rGs zApplication.emit_options_helpcCstd|dS)z&Print the subcommand part of the help.rN)rremit_subcommands_helprr;r;r<print_subcommandsVszApplication.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)r0r$) rrrr[rOrWrrrr)rPrrsubc_rsr;r;r<rZsz!Application.emit_subcommands_helpboolccs|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$Nr;rPr^r;r;r<emit_help_epiloguekszApplication.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. rr^N)rr emit_helprr;r;r< print_helptszApplication.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_traitsrrZZclass_get_help emit_examplesr)rPr^Z help_classesrrr;r;r<r{s  zApplication.emit_helprHcCsddd|DS)zwGenerate rST format documentation for the config options this application Returns a multiline string. rcss|]}|VqdSr)Zclass_config_rst_doc)rrer;r;r<rsz6Application.document_config_options..)rrgrr;r;r<document_config_optionssz#Application.document_config_optionscCstd|dS)z"Print the application description.rN)rrrrr;r;r<print_descriptionszApplication.print_descriptionccs*t|jp|jpdD]}|VdVqdS)z-Yield lines with the application description.r$N)rrXrS)rPrr;r;r<rszApplication.emit_descriptioncCstd|dS)z1Print usage and examples (see `emit_examples()`).rN)rrrrr;r;r<print_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)r\rrrrr;r;r<rs zApplication.emit_examplescCst|jdS)zPrint the version string.N)rrhrr;r;r< print_versionszApplication.print_version)rr#r-cCs|j|}|dk st|\}}t|tr2t|}t|tr`t|tr`|j |j |d|_ n t |rt|||_ n td||j |dS)z"Initialize a subcommand with argv.N)rfz%Invalid mappings for subcommand '%s'!)rgetrrrHr"rrbr.rRZclear_instanceinstancercallabler)rPrr#rrrr;r;r<initialize_subcommands      z!Application.initialize_subcommandz)tuple[dict[str, t.Any], dict[str, t.Any]]cCsftt}|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}||kr(|||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. r3rr|r)rlistr^rDraappendrrrrrrrrupdate)rPZmro_treerclsnamerfrrrrrchildrenalrrZflagdictrsZnewflagZsubdictkr;r;r< flatten_flagss@       zApplication.flatten_flagszlist[str] | Noner)r#rrr^r-cCst|||||j|jdS)N)r^r4r)rr4r)rPr#rrr^r;r;r<_create_loaderszApplication._create_loaderz list[str])check_argcompleter-c CsR|rLdtjkrLz$ddlm}|}|dk s.t|WSttfk rJYnXtjS)aGet `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_cwordsN) osenviron#traitlets.config.argcomplete_configrr ImportErrorModuleNotFoundErrorrr#)rrrcwordsr;r;r< _get_sys_argvs  zApplication._get_sys_argvc CsBdtjkrdSzddlm}|Wnttfk r<YnXdS)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. rNr)increment_argcomplete_index)rrrrrr)rrr;r;r<"_handle_argcomplete_for_subcommand3s   z.Application._handle_argcomplete_for_subcommandcst|trt|dkr0|jt|jddd}dd|D|_|rb|ddkrb|dddg}|jrt|dkr|d|dd}}t d |r||jkr| | ||Sz|d| d Wnt k r|YnXtfd d d Dr|dk|ddks(dkr:||d|\}}t|}|j||||d}zt||_Wntk rYnX||j|j|_dS)z!Parse the command line arguments.N)rr3cSsg|] }t|qSr;r )rargr;r;r< Msz2Application.parse_command_line..rrs-hz ^\w(\-?\w)*$rc3s|]}|kVqdSrr;)rxZinterpreted_argvr;r<rdsz1Application.parse_command_line..)r --help-allz--helpr z --versionz-Vr)rrHrrrrr#rrematchrrindex ValueErroranyrr8rr rrrr load_config cli_config SystemExit update_config extra_args)rPr#rZsubargvrrr^loaderr;rr<rGs<       zApplication.parse_command_linez#str | t.Sequence[str | None] | NonezAnyLogger | Nonezt.Generator[t.Any, None, None]) basefilenamepathr4raise_config_file_errorsr-c cs^t|ts|dkr|g}t|D]6}|j|d||d}|rT|d||pPt|j|d||d}g}g} ||fD]} d} z | } WnJt k rYnJt k r| j p|} |r|r|j d| ddYnX|r|d | j | rxt | |D]:\} } | | }|r|r|d | | j tj|d d q| | j fV|| | | j qxq dS) zeLoad config files (py,json) by filename and path. yield each config object in turn. Nz.py)r-r4zLooking for %s in %sz.jsonz&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)rrHr`python_config_loader_classr6rgetcwdjson_config_loader_classr&r rZ full_filenamerzip collisionswarningrOrdumpsr)rr,r-r4r.currentZpyloaderZ jsonloaderZloaded filenamesr+r7filenameZearlier_configr4r;r;r<_load_config_fileszsJ        zApplication._load_config_filescCs|jddS)z$Currently loaded configuration filesN)rrr;r;r<loaded_config_filesszApplication.loaded_config_files)r9r-r-cCsptj|\}}t}|j|||j|jdD](\}}||||jkr,|j |q,||j | |dS)z'Load config files by filename and path.)r-r4r.N) rr-splitextr r:r4r.mergerrr'r))rPr9r-extZ new_configr7fnamer;r;r<load_config_files  zApplication.load_config_filec#s|dkr|j}tdd||Ddddfdd }tfd dD|kr:qhq:D]\}}|rp|VqpdS) 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)TrtN)rZclass_own_traits)rrr;r;r<rsz:Application._classes_with_config_traits..r/r)rr-cstfdd|jDS)Nc3s|]}|ko|VqdSrr;)rb cls_to_configr;r<rszZApplication._classes_with_config_traits..is_any_parent_included..)r% __bases__)rrBr;r<is_any_parent_includedszGApplication._classes_with_config_traits..is_any_parent_includedc3s"|]\}}||p|fVqdSrr;)rrinc_yes)rEr;r<rs)r^rrgrr)rPr^Z to_incl_origclrFr;)rCrEr<rs z'Application._classes_with_config_traitscCsnd|jg}|d|d|d|dkr8|jn|}t||}|D]}|||qNd|S)z/generate default config file from Configurablesz# Configuration file for %s.r$zc = get_config() #noqaNr)rWrr^rrZclass_config_sectionr)rPr^linesZconfig_classesrr;r;r<generate_config_files    z Application.generate_config_filec Cs@t|ddr<|jjD] }tt|W5QRXqd|_dS)NrF)rr4r~rrcloser)rPhandlerr;r;r<close_handlerss    zApplication.close_handlersrzint | str | None) exit_statusr-cCs(|jd|j|t|dS)NzExiting application: %s)r4r6rWrLrr8)rPrMr;r;r<r8 szApplication.exitcCs |dSr)rLrr;r;r<__del__szApplication.__del__)r#r2r-cKs"|jf|}|||dS)zLaunch a global instance of this Application If a global instance already exists, this reinitializes and starts it N)rrr)rr#r2r0r;r;r<launch_instances  zApplication.launch_instance)N)N)F)F)N)F)N)NF)N)N)N)r)N)brDrErFrSrrW__annotations__rXrYrZr[rr0rr2r\r^rgrhrr#rr%r.rrTrUtagrrGrrrrrrrrrrrrrrnrrrrr*r r'rrrrrrrrrBrrrrrrrrrrrrrrrrrrrrrr r classmethodrrrr:propertyr;r@rrIrLr8rNrOrVr;r;rQr<r.s&  3  07         !&  ; 27*  r.rHru)rW configurableset_help unset_helpr-cCsV|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=Falser|TFzno-)r)rWrTrUrVrrsetterZunsetterr;r;r< boolean_flag(s     rXr rvcCstrtjStSdS)z|Get the config object for the global Application instance, if there is one otherwise return an empty config object N)r.Z initializedrr7r r;r;r;r< get_configGs rY__main__)r$r$)brS __future__rr>rrTrrr!rtypingr@ collectionsrr contextlibrrrlogging.configrtextwraprZtraitlets.config.configurabler r Ztraitlets.config.loaderr r r rrrZtraitlets.traitletsrrrrrrrrrrZtraitlets.utils.bunchrZtraitlets.utils.nested_updaterZtraitlets.utils.textrrutilsr!Zutils.importstringr"rrYrZhasattrr#r[rrZ_envvarlowerr%r$ executableendswithrTypeVarCallableAnyr*UnionLogger LoggerAdapterrrHruOptionalrrr]rBrrC FormatterrGr.rZdefault_aliasesrZ default_flagsrXrYrDrOr;r;r;r<sx      0