NXc@sdZddlmZddlZddlZddlZddlZddlZddlm Z ddl m Z ddl m Z ddl mZmZddlmZmZmZmZmZmZdd lmZmZmZmZmZmZdd lmZdd l m!Z!m"Z"m#Z#dd l$m%Z%dd l&m'Z'm(Z(dj)Z*dj)Z+e,ed r}dge_-ndZ.e dZ/de0fdYZ1dej2fdYZ3defdYZ4dddZ5dZ6dS(s,A base class for a configurable application.i(tprint_functionN(tdeepcopy(t defaultdict(t decorator(t ConfigurabletSingletonConfigurable(tKVArgParseConfigLoadertPyFileConfigLoadertConfigt ArgumentErrortConfigFileNotFoundtJSONFileConfigLoader(tUnicodetListtEnumtDicttInstancet TraitError(t import_item(tindenttwrap_paragraphstdedent(t py3compat(t string_typest iteritemss Arguments that take values are actually convenience aliases to full Configurables, whose aliases are listed on the help line. For more information on full configurables, see '--help-all'. s Parameters are set from command-line arguments of the form: `--Class.trait=value`. This line is evaluated in Python, so simple expressions are allowed, e.g.:: `--C.a='range(3)'` For setting C.a=[0,1,2]. targvtsp Subcommands are launched as `{app} cmd [args]`. For information on using subcommand 'cmd', do: `{app} cmd -h`. cOsy||||SWnlttfk r}|j|jjd|jjt||jjd|j|jdnXdS(sMethod 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. s-Bad config encountered during initialization:sConfig at the time: %siN( RR t print_helptlogtfataltstrtdebugtconfigtexit(tmethodtapptargstkwargste((sT/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/config/application.pytcatch_config_errorAs  tApplicationErrorcBseZRS((t__name__t __module__(((sT/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/config/application.pyR(TstLevelFormattercBs&eZdZejZdZdZRS(sFormatter 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. s %(levelname)s |cCsG|j|jkr(|j|j|_n d|_tt|j|S(NR(tlevelnothighlevel_limitthighlevel_formatt__dict__t highleveltsuperR+tformat(tselftrecord((sT/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/config/application.pyR2cs (R)R*t__doc__tloggingtWARNR-R.R2(((sT/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/config/application.pyR+Ws t Applicationc Bs^eZdZedZedZeeZeeZeeZe Z e Z eZ gZdZedZeZed7dejdeddZdZeZeddeddZdZeddeddZdZeej Z!dZ"e#idd6Z$e#Z%dZ&e#Z'edd eZ(eeZ)d!Z*d"Z+e,d8d#Z.d$Z/d%Z0d&Z1d'Z2d(Z3e4d)Z5d*Z6d+Z7d,Z8d-Z9d.Z:e,d8d/Z;d0Z<e,d8d1Z=e>d8d8d2Z?e,d8d3Z@d4ZAdd5ZBe>d8d6ZCRS(9s8A singleton application with full configuration support.u applicationuThis is an application.ccsnt}x^|jD]S}xJt|jD]6}t|tr,||kr,|j||Vq,q,WqWdS(sIterate through configurable classes, including configurable parents Children should always be after parents, and each class should only be yielded once. N(tsettclassestreversedtmrot issubclassRtadd(R3tseentctparent((sT/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/config/application.pyt_classes_inc_parentss   u0.0ii iii(i2tDEBUGtINFOR7tERRORtCRITICALt default_valueR thelps#Set the log level by value or name.cCs>t|tr*tt|}||_n|jj|dS(s+Adjust the log level when log_level is set.N(t isinstanceRtgetattrR6t log_levelRtsetLevel(R3tnametoldtnew((sT/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/config/application.pyt_log_level_changeds s%Y-%m-%d %H:%M:%Ss:The date format used by logging formatters for %(asctime)scCs|jd|j|jdS(Nt log_format(t_log_format_changedRQ(R3RMRNRO((sT/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/config/application.pyt_log_datefmt_changedss#[%(name)s]%(highlevel)s %(message)ssThe Logging format templatecCs<|jjd}|jd|d|j}|j|dS(s0Change the log formatter when log_format is set.itfmttdatefmtN(Rthandlerst_log_formatter_clst log_datefmtt setFormatter(R3RMRNROt _log_handlert_log_formatter((sT/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/config/application.pyRRscCstj|jj}|j|jt|_|}x-|rc|jrJ|S|jsWPq7|j }q7Wt j j drtj ttjd}n tj }|jd|jd|j}|j||j||S(s Start logging for this application. The default is to log to stderr using a StreamHandler, if no default handler already exists. The log level starts at logging.WARN, but this can be adjusted by setting the ``log_level`` attribute. s pythonw.exetwRTRU(R6t getLoggert __class__R)RLRKtFalset propagateRVRAtsyst executabletendswitht StreamHandlertopentostdevnullRWRQRXRYt addHandler(R3Rt_logRZR[((sT/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/config/application.pyt _log_defaults"        sApplication.log_levels log-levelcCsxt|D]\}}t|dksAtd||ft|dttfsptd||ft|dts td||fq WdS(sensure flags dict is validisBad flag: %r:%siiN(RtlentAssertionErrorRItdictRR(R3RMRNROtkeytvalue((sT/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/config/application.pyt_flags_changeds(/s(traitlets.config.application.Applicationt allow_nonecKs?tj|||j|jkr;|jjd|jndS(Ni(Rt__init__R^R:tinsert(R3R%((sT/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/config/application.pyRrscCs@tj|||||jjd|jjt|dS(NsConfig changed:(Rt_config_changedRRtrepr(R3RMRNRO((sT/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/config/application.pyRtscCs|j|dS(sMDo the basic steps to configure me. Override in subclasses. N(tparse_command_line(R3R((sT/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/config/application.pyt initializescCs |jdk r|jjSdS(sAStart the app mainloop. Override in subclasses. N(tsubapptNonetstart(R3((sT/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/config/application.pyRzsc CsB|js dSg}i}x9|jD].}x%|jd D]}|||jws(RRB(R3((sT/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/config/application.pytdocument_config_optionsrs cCs/x(t|jD]}t|tqWdS(s"Print the application description.N(Rt descriptionR(R3R((sT/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/config/application.pyR{s cCsQ|jrMtdtdtttt|jjtndS(sPrint 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. tExampless--------N(texamplesRRRR(R3((sT/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/config/application.pyRs    cCst|jdS(sPrint the version string.N(Rtversion(R3((sT/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/config/application.pyt print_versionscCs)t|j}|j|||_dS(s2Fire the traits events when the config is updated.N(RR tmerge(R3R t newconfig((sT/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/config/application.pyt update_configs cCso|jj|\}}t|tr6t|}n|jj|jd|j|_ |j j |dS(s"Initialize a subcommand with argv.R N( RtgetRIRRR^tclear_instancetinstanceR RxRw(R3RRRxRH((sT/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/config/application.pytinitialize_subcommands  cCswtt}xL|jD]A}|j}x/|jdd!D]}||jj|q9WqWi}xwt|jD]f\}}|jdd\}}||} t | dkr| d}ndj ||g||ss --help-alls--helps --versions-VRR|RRN(s-hs --help-alls--help(RyRaRRt cast_unicodeRRktretmatchRtindext ValueErrortanyRR!RRRRt load_configRt extra_args( R3RtargRtsubargvRR|tloaderR ((RsT/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/config/application.pyRvs0%!     c csbt|ts|g}nx:|dddD]%}|j|dd|d|}|rp|jd||n|j|dd|d|}|r|jd||nd}x||gD]}y|j}WnOtk rn[tk r%|j p|}|rB|j d |d t qBnX|rB|jd |j n|r|VqqWq/Wt dS( seLoad config files (py,json) by filename and path. yield each config object in turn. Nis.pytpathRs/Attempting to load config file %s.py in path %ss.jsons1Attempting to load config file %s.json in path %ss&Exception while loading config file %stexc_infosLoaded config file: %s( RIRtpython_config_loader_classRtjson_config_loader_classRyRR t Exceptiont full_filenameterrorRt StopIteration( Rt basefilenameRRtpyloadert jsonloaderR Rtfilename((sT/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/config/application.pyt_load_config_filess2    cCstjj|\}}g}x@|j|d|d|jD] }|j||j|q=Wt|dkr|dj|d}|r|jj dj |t j |ddqndS( s'Load config files by filename and path.RRiisZCollisions detected in {0}.py and {0}.json config files. {0}.json has higher priority: {1}RiN( RfRtsplitextRRRRRkt collisionstwarningR2tjsontdumps(R3RRtexttloadedR R((sT/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/config/application.pytload_config_file+s% cCsTd|jg}|jdx'|jD]}|j|jq*Wdj|S(s/generate default config file from Configurabless# Configuration file for %s.Rs (RMRRBtclass_config_sectionR(R3RR((sT/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/config/application.pytgenerate_config_file<s  cCs(|jjd|jtj|dS(NsExiting application: %s(RRRMRaR!(R3t exit_status((sT/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/config/application.pyR!DscKs*|j|}|j||jdS(sLaunch a global instance of this Application If a global instance already exists, this reinitializes and starts it N(RRwRz(RRR%R#((sT/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/config/application.pytlaunch_instanceHs ( ii iii(i2sDEBUGsINFOsWARNsERRORRFN(DR)R*R5R RMRRRRRRR RRR:RBRR RRR6R7RRKRPR+RWRXRSRQRRRtLoggerRRjRR|RRpRRxRRrRtR'RyRwRzRRRRR_RRRRRRRRRvt classmethodRRRR!R(((sT/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/config/application.pyR8ksz                                -*'  cCs|p d|}|pd|}|jd\}}iit|6|6}iit|6|6}i||f|6||fd|6S(sHelper 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. s set %s=Trues set %s=FalseR{sno-(R}RR_(RMt configurabletset_helpt unset_helpRRtsettertunsetter((sT/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/config/application.pyt boolean_flagVs cCs$tjrtjjStSdS(sGet the config object for the global Application instance, if there is one otherwise return an empty config object N(R8t initializedRR R(((sT/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/config/application.pyt get_configws  (7R5t __future__RRR6RfRRatcopyRt collectionsRRttraitlets.config.configurableRRttraitlets.config.loaderRRRR R R ttraitlets.traitletsR R RRRRtipython_genutils.importstringRtipython_genutils.textRRRtipython_genutilsRtipython_genutils.py3compatRRRRRthasattrRRR'RR(t FormatterR+R8RR(((sT/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/config/application.pyts8     ..  !