i^c@sGdZddlZddlZddlZddlZddlZddlZddlZddlm Z ddl m Z ddl m Z ddlmZddlmZddlmZmZmZd efd YZd efd YZd efdYZdefdYZdejfdYZdefdYZdZdefdYZde fdYZ!de!fdYZ"de"fdYZ#de"fdYZ$d e!fd!YZ%ej&d"Z'ej&d#Z(d$e%fd%YZ)d&e%fd'YZ*d(e*fd)YZ+d*Z,dS(+sA simple configuration system.iN(t literal_eval(tfilefind(t py3compat(tDEFAULT_ENCODING(t text_type(t HasTraitstListtAnyt ConfigErrorcBseZRS((t__name__t __module__(((s6lib/python2.7/site-packages/traitlets/config/loader.pyRstConfigLoaderErrorcBseZRS((R R (((s6lib/python2.7/site-packages/traitlets/config/loader.pyR stConfigFileNotFoundcBseZRS((R R (((s6lib/python2.7/site-packages/traitlets/config/loader.pyR !st ArgumentErrorcBseZRS((R R (((s6lib/python2.7/site-packages/traitlets/config/loader.pyR $stArgumentParsercBs,eZdZddZejjje_RS(s?Simple argparse subclass that prints help to stdout by default.cCs.|dkrtj}ntt|j|S(N(tNonetsyststdouttsuperRt print_help(tselftfile((s6lib/python2.7/site-packages/traitlets/config/loader.pyR4s  N(R R t__doc__RRtargparseR(((s6lib/python2.7/site-packages/traitlets/config/loader.pyR1s tLazyConfigValuecBseZdZd ZeZeZdZdZ dZ eZ dZ e ZdZdZdZdZRS( sProxy object for exposing methods on configurable containers Exposes: - append, extend, insert on lists - update on dicts - update, add on sets cCs|jj|dS(N(t_extendtappend(Rtobj((s6lib/python2.7/site-packages/traitlets/config/loader.pyROscCs|jj|dS(N(Rtextend(Rtother((s6lib/python2.7/site-packages/traitlets/config/loader.pyRRscCs||jd*dS(s#like list.extend, but for the frontiN(t_prepend(RR((s6lib/python2.7/site-packages/traitlets/config/loader.pytprependUscCs8t|tstdn|jj||fdS(NsAn integer is required(t isinstancetintt TypeErrort_insertsR(RtindexR((s6lib/python2.7/site-packages/traitlets/config/loader.pytinsertZscCsM|jdkr9t|tr*i|_q9t|_n|jj|dS(N(t_updateRR tdicttsettupdate(RR((s6lib/python2.7/site-packages/traitlets/config/loader.pyR)bs  cCs|j|hdS(N(R)(RR((s6lib/python2.7/site-packages/traitlets/config/loader.pytaddkscCs|jdk r|jStj|}t|tr~x'|jD]\}}|j||q>W|j|d*|j |j n\t|t r|j r|j |j qn.t|tr|j r|j |j qn||_|S(svconstruct the value from the initial one after applying any insert / extend / update changes iN(t_valueRtcopytdeepcopyR tlistR#R%RRRR'R&R)R((RtinitialtvaluetidxR((s6lib/python2.7/site-packages/traitlets/config/loader.pyt get_valuens     cCsni}|jr|j|dIs a Config key a section name (does it start with a capital)?it_N(tuppert startswithtTruetFalse(tkey((s6lib/python2.7/site-packages/traitlets/config/loader.pyt_is_section_keys0tConfigcBseZdZdZdZdZdZdZdZeZ dZ dZ d Z d Z d Zd Zd ZdZdZRS(s1An attribute based dict that can do smart merges.cOs!tj||||jdS(N(R't__init__t_ensure_subconfig(Rtargstkwds((s6lib/python2.7/site-packages/traitlets/config/loader.pyR>scCscx\|D]T}||}t|rt|trt|t rt||t|qqWdS(sensure that sub-dicts that should be Config objects are casts dicts that are under section keys to Config objects, which is necessary for constructing Config objects from dict literals. N(R<R R'R=tsetattr(RR;R((s6lib/python2.7/site-packages/traitlets/config/loader.pyR?s    cCs|j|dS(s$deprecated alias, use Config.merge()N(tmerge(RR((s6lib/python2.7/site-packages/traitlets/config/loader.pyt_mergescCsi}xs|jD]e\}}||kr8|||R?RDRCRJRPthas_keyRSR,RURYRZR\R`RcRd(((s6lib/python2.7/site-packages/traitlets/config/loader.pyR=s"            t ConfigLoadercBs5eZdZdZddZdZdZRS(s1A object for loading configurations from just about anywhere. The resulting configuration is packaged as a :class:`Config`. Notes ----- A :class:`ConfigLoader` does one thing: load a config from a source (file, command line arguments) and returns the data as a :class:`Config` object. There are lots of things that :class:`ConfigLoader` does not do. It does not implement complex logic for finding config files. It does not handle default values or merge multiple configs. These things need to be handled elsewhere. cCsddlm}|S(Ni(t get_logger(t traitlets.logRh(RRh((s6lib/python2.7/site-packages/traitlets/config/loader.pyt _log_default@scCsE|j|dkr8|j|_|jjdn ||_dS(seA base class for config loaders. log : instance of :class:`logging.Logger` to use. By default loger of :meth:`traitlets.config.application.Application.instance()` will be used Examples -------- >>> cl = ConfigLoader() >>> config = cl.load_config() >>> config {} sUsing default loggerN(tclearRRjtlogtdebug(RRl((s6lib/python2.7/site-packages/traitlets/config/loader.pyR>Ds   cCst|_dS(N(R=tconfig(R((s6lib/python2.7/site-packages/traitlets/config/loader.pyRkZscCs|j|jS(sLoad a config from somewhere, return a :class:`Config` instance. Usually, this will cause self.config to be set and then returned. However, in most cases, :meth:`ConfigLoader.clear` should be called to erase any previous state. (RkRn(R((s6lib/python2.7/site-packages/traitlets/config/loader.pyt load_config]s N(R R RRjRR>RkRo(((s6lib/python2.7/site-packages/traitlets/config/loader.pyRg1s     tFileConfigLoadercBs#eZdZddZdZRS(sA base class for file based configurations. As we add more file based config loaders, the common logic should go here. cKs5tt|j|||_||_d|_dS(s.Build a config loader for a filename and path. Parameters ---------- filename : str The file name of the config file. path : str, list, tuple The path to search for the config file on, or a sequence of paths to try in order. tN(RRpR>tfilenametpatht full_filename(RRrRstkw((s6lib/python2.7/site-packages/traitlets/config/loader.pyR>os   cCst|j|j|_dS(s,Try to find the file by searching the paths.N(RRrRsRt(R((s6lib/python2.7/site-packages/traitlets/config/loader.pyt _find_filesN(R R RRR>Rv(((s6lib/python2.7/site-packages/traitlets/config/loader.pyRphs tJSONFileConfigLoadercBs;eZdZdZdZdZdZdZRS(sA JSON file loader for config Can also act as a context manager that rewrite the configuration file to disk on exit. Example:: with JSONFileConfigLoader('myapp.json','/home/jupyter/configurations/') as c: c.MyNewConfigurable.new_value = 'Updated' cCse|jy|jWn%tk r?}tt|nX|j}|j||_|jS(s=Load the config from a file and return it as a Config object.(RkRvtIOErrorR tstrt_read_file_as_dictt_convert_to_configRn(RRbtdct((s6lib/python2.7/site-packages/traitlets/config/loader.pyRos  cCs)t|j}tj|SWdQXdS(N(topenRttjsontload(Rtf((s6lib/python2.7/site-packages/traitlets/config/loader.pyRzscCsVd|kr|jd}nd}|dkr:t|Stdjd|dS(Ntversionis.Unknown version of JSON config file: {version}(tpopR=R^tformat(Rt dictionaryR((s6lib/python2.7/site-packages/traitlets/config/loader.pyR{s    cCs|j|jS(N(RoRn(R((s6lib/python2.7/site-packages/traitlets/config/loader.pyt __enter__s cCsPd|j_tj|jdd}t|jd}|j|WdQXdS(s Exit the context manager but do not handle any errors. In case of any error, we do not want to write the potentially broken configuration to disk. itindentitwN(RnRR~tdumpsR}Rttwrite(Rtexc_typet exc_valuet tracebackt json_configR((s6lib/python2.7/site-packages/traitlets/config/loader.pyt__exit__s (R R RRoRzR{RR(((s6lib/python2.7/site-packages/traitlets/config/loader.pyRws    tPyFileConfigLoadercBs,eZdZdZddZdZRS(sA config loader for pure python files. This is responsible for locating a Python config file by filename and path, then executing it to construct a Config object. cCsQ|jy|jWn%tk r?}tt|nX|j|jS(s=Load the config from a file and return it as a Config object.(RkRvRxR RyRzRn(RRb((s6lib/python2.7/site-packages/traitlets/config/loader.pyRos  cCsb|dkr|j}n|j||}y|j}Wntk rMnX|jj|dS(s5Injected into config file namespace as load_subconfigN(RRst __class__RoR RnRC(RtfnameRstloadert sub_config((s6lib/python2.7/site-packages/traitlets/config/loader.pytload_subconfigs   c sqfd}tdjdjd|dj}tjpHd}jj|}tj||dS(s>Load the config file into self.config, with recursive loading.csjS(sKUnnecessary now, but a deprecation warning is more trouble than it's worth.(Rn((R(s6lib/python2.7/site-packages/traitlets/config/loader.pyt get_configsR]RRt__file__tasciiN( R'RnRRtRtgetfilesystemencodingtencodeRtexecfile(RRt namespacet fs_encodingt conf_filename((Rs6lib/python2.7/site-packages/traitlets/config/loader.pyRzs   N(R R RRoRRRz(((s6lib/python2.7/site-packages/traitlets/config/loader.pyRs tCommandLineConfigLoadercBs eZdZdZdZRS(sA config loader for command line arguments. As we add more command line based loaders, the common logic should go here. cBsUejj|}ye|}Wn eeefk rD|}nXd|dUdS(s0execute self.config. = * expands ~ with expanduser * tries to assign with literal_eval, otherwise assigns with just the string, allowing `--C.a=foobar` and `--C.a="foobar"` to be equivalent. *Not* equivalent are `--C.a=4` and `--C.a='4'`. uself.config.%s = valueN(tosRst expanduserRt NameErrort SyntaxErrorR^(RtlhstrhsR0((s6lib/python2.7/site-packages/traitlets/config/loader.pyt_exec_config_strs  cCs]t|ttfrIxA|jD] \}}|j|j|q"Wntd|dS(s=update self.config from a flag, which can be a dict or ConfigsInvalid flag: %rN(R R'R=RERnR)R"(RtcfgtsecR]((s6lib/python2.7/site-packages/traitlets/config/loader.pyt _load_flags(R R RRR(((s6lib/python2.7/site-packages/traitlets/config/loader.pyRs s#\-\-[A-Za-z][\w\-]*(\.[\w\-]+)*\=.*s\-\-?\w+[\-\w]*$tKeyValueConfigLoadercBsGeZdZddddZdZddZddddZRS(sA config loader that loads key value pairs from the command line. This allows command line options to be gives in the following form:: ipython --profile="foo" --InteractiveShell.autocall=False cKs]tt|j||dkr2tjd}n||_|pDi|_|pSi|_dS(sCreate a key value pair config loader. Parameters ---------- argv : list A list that has the form of sys.argv[1:] which has unicode elements of the form u"key=value". If this is None (default), then sys.argv[1:] will be used. aliases : dict A dict of aliases for configurable traits. Keys are the short aliases, Values are the resolved trait. Of the form: `{'alias' : 'Configurable.trait'}` flags : dict A dict of flags, keyed by str name. Vaues can be Config objects, dicts, or "key=value" strings. If Config or dict, when the flag is triggered, The flag is loaded as `self.config.update(m)`. Returns ------- config : Config The resulting Config object. Examples -------- >>> from traitlets.config.loader import KeyValueConfigLoader >>> cl = KeyValueConfigLoader() >>> d = cl.load_config(["--A.name='brian'","--B.number=0"]) >>> sorted(d.items()) [('A', {'name': 'brian'}), ('B', {'number': 0})] iN(RRR>RRtargvtaliasestflags(RRRRRu((s6lib/python2.7/site-packages/traitlets/config/loader.pyR>+s   cCs tt|jg|_dS(N(RRRkt extra_args(R((s6lib/python2.7/site-packages/traitlets/config/loader.pyRkSscCs^g}|dkrt}nx<|D]4}t|tsI|j|}n|j|q"W|S(sGdecode argv if bytes, using stdin.encoding, falling back on default encN(RRR RtdecodeR(RRtenctuargvtarg((s6lib/python2.7/site-packages/traitlets/config/loader.pyt _decode_argvXs   c Cs |j|d kr"|j}n|d kr:|j}n|d krR|j}n|j|}xt|D]\}}|jd}|dkr|jj ||dPnt j |rN|j dd\}} ||kr||}nd|kr|j jd|ny|j|| Wqtk rJtd|qXqntj |r||kr||\} } |j| qtd|qn|jdrd|} t j | rtd || fqtd|qn|jj|qnW|jS( sParse the configuration and generate the Config object. After loading, any arguments that are not key-value or flags will be stored in self.extra_args - a list of unparsed command-line arguments. This is used for arguments such as input files or subcommands. Parameters ---------- argv : list, optional A list that has the form of sys.argv[1:] which has unicode elements of the form u"key=value". If this is None (default), then self.argv will be used. aliases : dict A dict of aliases for configurable traits. Keys are the short aliases, Values are the resolved trait. Of the form: `{'alias' : 'Configurable.trait'}` flags : dict A dict of flags, keyed by str name. Values can be Config objects or dicts. When the flag is triggered, The config is loaded as `self.config.update(cfg)`. t-s--it=RNs:Unrecognized alias: '%s', it will probably have no effect.sInvalid argument: '%s'sUnrecognized flag: '%s's*Invalid argument: '%s', did you mean '%s'?N(RkRRRRRt enumeratetlstripRRt kv_patterntmatchRORltwarningRt ExceptionR t flag_patternRR8RRn( RRRRRR1trawtitemRRRthelptkv((s6lib/python2.7/site-packages/traitlets/config/loader.pyRoesF              N(R R RRR>RkRRo(((s6lib/python2.7/site-packages/traitlets/config/loader.pyR#s (  tArgParseConfigLoadercBsneZdZdddddZddddZdZdddZdddZdZ dZ RS( sEA loader that uses the argparse module to load from the command line.cOstt|jd||j|dkr?tjd}n||_|pQi|_|p`i|_||_ |j dd|_ t dt j}|j|||_dS(szCreate a config loader for use with argparse. Parameters ---------- argv : optional, list If given, used to read command-line arguments from, otherwise sys.argv[1:] is used. parser_args : tuple A tuple of positional arguments that will be passed to the constructor of :class:`argparse.ArgumentParser`. parser_kw : dict A tuple of keyword arguments that will be passed to the constructor of :class:`argparse.ArgumentParser`. Returns ------- config : Config The resulting Config object. RliRtargument_defaultN(RRR>RkRRRRRt parser_argsRRR'RtSUPPRESSR)t parser_kw(RRRRRlRRtkwargs((s6lib/python2.7/site-packages/traitlets/config/loader.pyR>s     cCs|j|dkr"|j}n|dkr:|j}n|dkrR|j}n|j|||j||j|jS(sCParse command line arguments and return as a Config object. Parameters ---------- args : optional, list If given, a list with the structure of sys.argv[1:] to parse arguments from. If not given, the instance's self.argv attribute (given at construction time) is used.N( RkRRRRt_create_parsert _parse_argsR{Rn(RRRR((s6lib/python2.7/site-packages/traitlets/config/loader.pyRos         cCst|dr|jSgSdS(NR(thasattrR(R((s6lib/python2.7/site-packages/traitlets/config/loader.pytget_extra_argsscCs,t|j|j|_|j||dS(N(RRRtparsert_add_arguments(RRR((s6lib/python2.7/site-packages/traitlets/config/loader.pyRscCstddS(Ns(subclasses must implement _add_arguments(tNotImplementedError(RRR((s6lib/python2.7/site-packages/traitlets/config/loader.pyRscCsMt}g|D]}tj||^q }|jj|\|_|_dS(sself.parser->self.parsed_dataN(RRt cast_unicodeRtparse_known_argst parsed_dataR(RR@Rtatuargs((s6lib/python2.7/site-packages/traitlets/config/loader.pyRs%cBs>x7e|jjD] \}}d|eeUqWdS(sself.parsed_data->self.configsself.config.%s = vN(tvarsRREtlocalstglobals(RRGRH((s6lib/python2.7/site-packages/traitlets/config/loader.pyR{s"N( R R RRR>RoRRRRR{(((s6lib/python2.7/site-packages/traitlets/config/loader.pyRs%  tKVArgParseConfigLoadercBs&eZdZdddZdZRS(s A config loader that loads aliases and flags with argparse, but will use KVLoader for the rest. This allows better parsing of common args, such as `ipython -c 'print 5'`, but still gets arbitrary config with `ipython --InteractiveShell.use_readline=False`c Csi|_|dkr!|j}n|dkr9|j}n|jj}x|jD]\}}||krsd}nd}t|dkr|d|d|dtd|d|qR|d|dtd|d|qRWx|jD]\}\}}||jkr!||j|j|self.config, parse unrecognized extra args via KVLoader.RRlN(RRRRERRRRRRRRlRoRnRC(RtsubcsRGRHtsubct sub_parser((s6lib/python2.7/site-packages/traitlets/config/loader.pyR{)s  "   N(R R RRRR{(((s6lib/python2.7/site-packages/traitlets/config/loader.pyRscCsjt}xZ|D]R}t|d|}y|j}Wntk rKqqX|j|qW|S(sLoad multiple Python config files, merging each of them in turn. Parameters ========== config_files : list of str List of config files names to load and merge into the config. path : unicode The full path to the location of the config files. Rs(R=RRoR RC(t config_filesRsRntcfRt next_config((s6lib/python2.7/site-packages/traitlets/config/loader.pytload_pyconfig_filesDs   (-RRR,tloggingRtreRR~tastRtipython_genutils.pathRtipython_genutilsRtipython_genutils.encodingRtsixRttraitlets.traitletsRRRRRR R R RRR<R'R=tobjectRgRpRwRRtcompileRRRRRR(((s6lib/python2.7/site-packages/traitlets/config/loader.pyts@        W 781-W=