i^c@sqdZddlmZddlmZddlZddlZddlZddlZddl Z ddl m Z m Z ddl m Z ddlmZmZddlmZmZmZmZmZmZdd lmZmZmZmZmZmZmZm Z m!Z!m"Z"dd l#m$Z$dd l%m&Z&m'Z'm(Z(dd l)m*Z*ddl+Z+d j,Z-dj,Z.e/e d rdge _0ndZ1ej2j3ddZ4e4j5ddhkre6Z7n4e4j5dddhkre8Z7ne9de4e dZ:de;fdYZ<dej=fdYZ>defdYZ?dddZ@d ZAdS(!s,A base class for a configurable application.i(tprint_function(tdeepcopyN(t defaultdictt OrderedDict(t decorator(t ConfigurabletSingletonConfigurable(tKVArgParseConfigLoadertPyFileConfigLoadertConfigt ArgumentErrortConfigFileNotFoundtJSONFileConfigLoader( tBooltUnicodetListtEnumtDicttInstancet TraitErrortobservetobserve_compattdefault(t import_item(tindenttwrap_paragraphstdedent(t py3compats 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`. t-TRAITLETS_APPLICATION_RAISE_CONFIG_FILE_ERRORt1ttruet0tfalsesUnsupported value for environment variable: 'TRAITLETS_APPLICATION_RAISE_CONFIG_FILE_ERROR' is set to '%s' which is none of {'0', '1', 'false', 'true', ''}.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((s;lib/python2.7/site-packages/traitlets/config/application.pytcatch_config_errorMs  tApplicationErrorcBseZRS((t__name__t __module__(((s;lib/python2.7/site-packages/traitlets/config/application.pyR0`stLevelFormattercBs&eZdZejZdZdZRS(s 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. s %(levelname)s |cCsG|j|jkr(|j|j|_n d|_tt|j|S(NR(tlevelnothighlevel_limitthighlevel_formatt__dict__t highleveltsuperR3tformat(tselftrecord((s;lib/python2.7/site-packages/traitlets/config/application.pyR:ps (R1R2t__doc__tloggingtWARNR5R6R:(((s;lib/python2.7/site-packages/traitlets/config/application.pyR3ds t Applicationc BseZdZedZedZeeZeeZeeZe Z e Z eZ gZdZedZeZeeZed=dejddjdeZededZeZ edddjdeZ!edddjdeZ"eddedZ#e$ddZ%e&idd 6Z'e&Z(ed!ed"Z)e&Z*e+d#d$eZ,eeZ-e+e.d>idd%Z/eZ0d&Z1eded'Z2e3d?d(Z5d)Z6d*Z7d+Z8d,Z9d-Z:e;d.Z<d/Z=d0Z>d1Z?d2Z@e3d?d3ZAd4ZBe3d?d5ZCeDd?d?e;d6ZEeFd7ZGe3d?d8ZHd9ZId:ZJdd;ZKeDd?d<ZLRS(@s8A 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(R;tseentctparent((s;lib/python2.7/site-packages/traitlets/config/application.pyt_classes_inc_parentss   u0.0ii iii(i2tDEBUGtINFOR?tERRORtCRITICALt default_valuethelps#Set the log level by value or name.R(t log_levelcCsJ|j}t|tjr6tt|}||_n|jj|dS(s+Adjust the log level when log_level is set.N( tnewt isinstancetsixt string_typestgetattrR>RQR$tsetLevel(R;tchangeRR((s;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)ss#[%(name)s]%(highlevel)s %(message)ssThe Logging format templatet log_datefmtt log_formatcCs?|jjd}|jd|jd|j}|j|dS(s0Change the log formatter when log_format is set.itfmttdatefmtN(R$thandlerst_log_formatter_clsR[RZt setFormatter(R;RXt _log_handlert_log_formatter((s;lib/python2.7/site-packages/traitlets/config/application.pyt_log_format_changedsR$cCstj|jj}|j|jt|_|}x-|rc|jrJ|S|jsWPq7|j }q7Wt j rt 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.exetwR\R](R>t getLoggert __class__R1RWRQtFalset propagateR^RItsyst executabletendswitht StreamHandlertopentostdevnullR_R[RZR`t addHandler(R;R$t_logRaRb((s;lib/python2.7/site-packages/traitlets/config/application.pyt _log_defaults"        sApplication.log_levels log-leveltflagscCs|j}x|jD]\}}t|dksJtd||ft|dttfsytd||ft|dtjstd||fqWdS(sensure flags dict is validisBad flag: %r:%siiN( RRtitemstlentAssertionErrorRStdictR RTRU(R;RXRRtkeytvalue((s;lib/python2.7/site-packages/traitlets/config/application.pyt_flags_changeds  (/s(traitlets.config.application.Applicationt allow_nonesThe subset of our configuration that came from the command-line We re-load this configuration after loading config files, to ensure that it maintains highest priority. cKsmtj|||j}||jkri|j|jkrP|g|j|_qi|jjd|jndS(Ni(Rt__init__RfRBtinsert(R;R-tcls((s;lib/python2.7/site-packages/traitlets/config/application.pyR|s  cCsCtt|j||jjd|jjt|jdS(NsConfig changed:(R9R@t_config_changedR$R'treprRR(R;RX((s;lib/python2.7/site-packages/traitlets/config/application.pyRscCs|j|dS(sMDo the basic steps to configure me. Override in subclasses. N(tparse_command_line(R;R((s;lib/python2.7/site-packages/traitlets/config/application.pyt initialize#scCs |jdk r|jjSdS(sAStart the app mainloop. Override in subclasses. N(tsubapptNonetstart(R;((s;lib/python2.7/site-packages/traitlets/config/application.pyR,sc CsB|js dSg}i}x9|jD].}x%|jd D]}|||js(RRJ(R;((s;lib/python2.7/site-packages/traitlets/config/application.pytdocument_config_optionss cCs/x(t|jD]}t|tqWdS(s"Print the application description.N(Rt descriptionR(R;R((s;lib/python2.7/site-packages/traitlets/config/application.pyRs 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(R;((s;lib/python2.7/site-packages/traitlets/config/application.pyRs    cCst|jdS(sPrint the version string.N(Rtversion(R;((s;lib/python2.7/site-packages/traitlets/config/application.pyt print_versionscCso|jj|\}}t|tjr9t|}n|jj|jd||_ |j j |dS(s"Initialize a subcommand with argv.RIN( RtgetRSRTRURRftclear_instancetinstanceRR(R;RRRRP((s;lib/python2.7/site-packages/traitlets/config/application.pytinitialize_subcommands  cCswtt}xL|jD]A}|j}x/|jdd!D]}||jj|q9WqWi}xw|jjD]f\}}|jdd\}}||} t | dkr| d}ndj ||g||ss --help-alls--helps --versions-VRRRsR$N(s-hs --help-alls--help(RRiRRt cast_unicodeRRutretmatchRtindext ValueErrortanyR#R)RRRR$Rt load_configt cli_configt update_configt extra_args(R;RtargRtsubargvRsRtloader((Rs;lib/python2.7/site-packages/traitlets/config/application.pyRs0%!   c cst|ts|g}nx|dddD]}|j|dd|d|}|r||jd||putjn|j|dd|d|}g}g}xD||gD]6} d} y| j} Wn[t k rngt k r-| j p|} |r n|rJ|j d| d t qJnX|rJ|jd | j n| rxit||D]X\} } | j| } | r`|r`|jd j| | j tj| d d q`q`W| | j fV|j| |j| j qqWq/WdS(seLoad config files (py,json) by filename and path. yield each config object in turn. Nis.pytpathR$sLooking for %s in %ss.jsons&Exception while loading config file %stexc_infosLoaded config file: %ssMCollisions detected in {0} and {1} config files. {1} has higher priority: {2}Ri(RSRtpython_config_loader_classR'Rntgetcwdtjson_config_loader_classRRR t Exceptiont full_filenameterrorRtzipt collisionstwarningR:tjsontdumpsR(R~t basefilenameRR$traise_config_file_errorstpyloadert jsonloadertloadedt filenamesRR(tfilenametearlier_configR((s;lib/python2.7/site-packages/traitlets/config/application.pyt_load_config_filessB "     ) cCs|jS(s$Currently loaded configuration files(t_loaded_config_files(R;((s;lib/python2.7/site-packages/traitlets/config/application.pytloaded_config_filesOscCstjj|\}}t}xd|j|d|d|jd|jD];\}}|j|||jkrI|jj |qIqIW|j|j |j |dS(s'Load config files by filename and path.RR$RN( RnRtsplitextR RR$RtmergeRRRR(R;RRtextt new_configR(((s;lib/python2.7/site-packages/traitlets/config/application.pytload_config_fileTs  c#std|jDfdxHtruj}tfdjD|kr.Pq.q.Wx(jD]\}}|r|VqqWdS(s[ Yields only classes with own traits, and their subclasses. 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. css-|]#}|t|jdtfVqdS(R(N(tbooltclass_own_traitsR(RR~((s;lib/python2.7/site-packages/traitlets/config/application.pys oscstfd|jDS(Nc3s%|]}|ko|VqdS(N((Rtb(t cls_to_config(s;lib/python2.7/site-packages/traitlets/config/application.pys ts(Rt __bases__(R~(R(s;lib/python2.7/site-packages/traitlets/config/application.pytis_any_parent_includedssc3s-|]#\}}||p!|fVqdS(N((RR~tinc_yes(R(s;lib/python2.7/site-packages/traitlets/config/application.pys {sN(RRJRtcopyRt(R;t to_incl_origtclR((RRs;lib/python2.7/site-packages/traitlets/config/application.pyt_classes_in_config_sampleds    cCsTd|jg}|jdx'|jD]}|j|jq*Wdj|S(s/generate default config file from Configurabless# Configuration file for %s.Rs (RRRtclass_config_sectionR(R;RR~((s;lib/python2.7/site-packages/traitlets/config/application.pytgenerate_config_files  cCs(|jjd|jtj|dS(NsExiting application: %s(R$R'RRiR)(R;t exit_status((s;lib/python2.7/site-packages/traitlets/config/application.pyR)scKs*|j|}|j||jdS(sLaunch a global instance of this Application If a global instance already exists, this reinitializes and starts it N(RRR(R~RR-R+((s;lib/python2.7/site-packages/traitlets/config/application.pytlaunch_instances ( ii iii(i2RKRLR?RMRN(N(MR1R2R=RRRRRRRRR RRRBRJRRRR RRRR>R?ttagRRQRRRYR3R_RZR[RcRRrRRRsRzRRRRR RRR|RR/RRRRRRRRgR#RRRRRRRt classmethodRtpropertyRRRRR)R(((s;lib/python2.7/site-packages/traitlets/config/application.pyR@xs                                   -*/  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=FalseRsno-(RRRg(Rt configurabletset_helpt unset_helpR~Rtsettertunsetter((s;lib/python2.7/site-packages/traitlets/config/application.pyt boolean_flags cCs$tjrtjjStSdS(s|Get the config object for the global Application instance, if there is one otherwise return an empty config object N(R@t initializedRR(R (((s;lib/python2.7/site-packages/traitlets/config/application.pyt get_configs  (BR=t __future__RRRRR>RnRRit collectionsRRRttraitlets.config.configurableRRttraitlets.config.loaderRRR R R R ttraitlets.traitletsR RRRRRRRRRtipython_genutils.importstringRtipython_genutils.textRRRtipython_genutilsRRTRRRthasattrRRtenvironRt_envvartlowerRRRgRR/RR0t FormatterR3R@RR (((s;lib/python2.7/site-packages/traitlets/config/application.pytsF     .F     (!