σ έ²k^c@`sGdZddlmZmZmZddlZddlZddlZddlZddl m Z ddl m Z m Z ddlmZmZddlmZdd lmZdd lmZejeƒZe d „ƒZe d „ƒZd efd„ƒYZdefd„ƒYZdefd„ƒYZdefd„ƒYZdS(s˜A specialized map implementation to manage configuration and context information. Features: * Uses YAML configuration files * Use environment variables to override configs * Can pass a list of required parameters at initialization * Works with encrypted files * Accepts multiple config files * Can query information from consul * Does type coercion on strings * Composable configs * Ordered merge: downstream configs will override upstream * Reload from sources on SIGHUP Available source types: * Environment variables * Yaml file on file system * Yaml file in S3 * Consul * Hashicorp Vault Notes: * Keys are case-insensitive. i(tabsolute_importtdivisiontprint_functionNi(t string_types(tmemoizet memoizemethod(tAssignmentErrort NotFoundError(t PackageFile(tlistify(ttypifycC`sA|jddƒjddƒ}tdjd„||fDƒƒƒS(s7Creates an environment key-equivalent for the given keyt-t_t cs`s|]}|jƒVqdS(N(tupper(t.0tx((sAlib/python2.7/site-packages/conda/_vendor/auxlib/configuration.pys 0s(treplacetstrtjoin(tapp_nametkey((sAlib/python2.7/site-packages/conda/_vendor/auxlib/configuration.pyt make_env_key,scC`sK|jƒd}|j|ƒs7tdj||ƒƒ‚|t|ƒjƒS(NR s#{0} is not a(n) {1} environment key(Rt startswithtAssertionErrortformattlentlower(RRtapp((sAlib/python2.7/site-packages/conda/_vendor/auxlib/configuration.pytreverse_env_key3s't ConfigurationcB`sΧeZdZdddd„Zd„Zd„Zedd„Zd„Z d„Z d„Z ed„Z e d „ƒZd „Zdd „Zd „Zd „Zd„Zed„Zd„Zd„Zd„Zd„ZRS(s3A map implementation to manage configuration and context information. Values can be accessed (read, not assigned) as either a dict lookup (e.g. `config[key]`) or as an attribute (e.g. `config.key`). This class makes the foundational assumption of a yaml configuration file, as values in yaml are typed. This class allows overriding configuration keys with environment variables. Given an app name `foo` and a config parameter `bar: 15`, setting a `FOO_BAR` environment variable to `22` will override the value of `bar`. The type of `22` remains `int` because the underlying value of `15` is used to infer the type of the `FOO_BAR` environment variable. When an underlying parameter does not exist in a config file, the type is intelligently guessed. Args: app_name (str) config_sources (str or list, optional) required_parameters (iter, optional) Raises: InitializationError: on instantiation, when `required_parameters` are not found warns: on instantiation, when a given `config_file` cannot be read NotFoundError: when requesting a key that does not exist Examples: >>> for (key, value) in [('FOO_BAR', 22), ('FOO_BAZ', 'yes'), ('FOO_BANG', 'monkey')]: ... os.environ[key] = str(value) >>> context = Configuration('foo') >>> context.bar, context.bar.__class__ (22, <... 'int'>) >>> context['baz'], type(context['baz']) (True, <... 'bool'>) >>> context.bang, type(context.bang) ('monkey', <... 'str'>) cC`s||_|ptj|ƒj|_t|_tƒ|_t ƒ|_ t ƒ|_ t t |ƒƒ|_ttdƒr‚|jƒn|jƒ|j|ƒdS(NtSIGHUP(tappnametinspectt getmodulet __package__tpackagetTruet_Configuration__initial_loadtlistt_Configuration__sourcestdictt _config_maptsett_registered_env_keysR t_required_keysthasattrtsignalt%_Configuration__set_up_sighup_handlert%_Configuration__load_environment_keystappend_sources(tselfR tconfig_sourcestrequired_parametersR$((sAlib/python2.7/site-packages/conda/_vendor/auxlib/configuration.pyt__init__`s       cC`s1t}x$t|ƒD]}|j||ƒqWdS(N(R%R t_Configuration__append_source(R3R4t force_reloadtsource((sAlib/python2.7/site-packages/conda/_vendor/auxlib/configuration.pyR2wscC`s|jjt|ƒƒdS(N(R-tupdateR (R3R5((sAlib/python2.7/site-packages/conda/_vendor/auxlib/configuration.pytappend_required|scC`s6||_|j||ƒ||_|jj|ƒdS(N(t parent_configt_Configuration__load_sourcet parent_sourceR(tappend(R3R9R8t_parent_source((sAlib/python2.7/site-packages/conda/_vendor/auxlib/configuration.pyt__append_sources  cC`s|jƒ|S(N(t$_Configuration__ensure_required_keys(R3((sAlib/python2.7/site-packages/conda/_vendor/auxlib/configuration.pytverify…s cC`s=t|ƒtjt|j|ƒ<|jj|ƒ|jƒdS(sΞSets environment variables by prepending the app_name to `key`. Also registers the environment variable with the instance object preventing an otherwise-required call to `reload()`. N(RtostenvironRR R,taddt_clear_memoization(R3Rtvalue((sAlib/python2.7/site-packages/conda/_vendor/auxlib/configuration.pytset_env‰scC`s=tjjt|j|ƒdƒ|jj|ƒ|jƒdS(sSRemoves an environment variable using the prepended app_name convention with `key`.N( RDREtpopRR tNoneR,tdiscardRG(R3R((sAlib/python2.7/site-packages/conda/_vendor/auxlib/configuration.pyt unset_env’scC`sGtƒ|_tƒ|_|j|ƒ|jƒ|jƒ|jƒdS(sΰReloads the configuration from the file and environment variables. Useful if using `os.environ` instead of this class' `set_env` method, or if the underlying configuration file is changed externally. N(R)R*R+R,t_Configuration__reload_sourcesR1RCRG(R3tforce((sAlib/python2.7/site-packages/conda/_vendor/auxlib/configuration.pyt_reload˜s      cC`s’|jƒ}||jkrmtjt|j|ƒƒ}|jj|ƒ}t||dk rft |ƒndƒSy|j|SWnt k r}t |ƒ‚nXdS(N( RR,RDtgetenvRR R*tgetR RKttypetKeyErrorR(R3Rtfrom_envt from_sourceste((sAlib/python2.7/site-packages/conda/_vendor/auxlib/configuration.pyt __getitem__€s %cC`s||S(N((R3R((sAlib/python2.7/site-packages/conda/_vendor/auxlib/configuration.pyt __getattr__±scC`s%y ||SWntk r |SXdS(N(RT(R3Rtdefault((sAlib/python2.7/site-packages/conda/_vendor/auxlib/configuration.pyRR΄s  cG`s tƒ‚dS(N(R(R3targs((sAlib/python2.7/site-packages/conda/_vendor/auxlib/configuration.pyt __setitem__Ίscc`s0x)|jt|jjƒƒBD] }|VqWdS(N(R,R+R*tkeys(R3R((sAlib/python2.7/site-packages/conda/_vendor/auxlib/configuration.pyt__iter__½s#cc`s$x|D]}|||fVqWdS(N((R3R((sAlib/python2.7/site-packages/conda/_vendor/auxlib/configuration.pytitemsΑs c C`s|r|jrdS|j|ƒ}|jrPt|jƒj|ƒ rPtƒ‚n|jddƒ}t|t ƒrƒ|j dƒ}n|j tt |ƒƒO_ |jddƒ}|j j|ƒ|rxI|D]>}|jƒ\}}tƒ||} |j| ||ƒqΝWndS(Ntadditional_requirementst,tadditional_sources(R>tdumptprovidesR+tissubsettNotImplementedErrorRJRKt isinstanceRtsplitR-R R*R:tpopitemtglobalsR7( R3R9R8R_R`Rbtsrct class_nametkwargstadditional_source((sAlib/python2.7/site-packages/conda/_vendor/auxlib/configuration.pyt __load_sourceΕs "  cC`sY|jjƒd}x?tjD]4}|j|ƒr|jjt|j|ƒƒqqWdS(NR (R RRDRERR,RFR(R3t app_prefixtenv_key((sAlib/python2.7/site-packages/conda/_vendor/auxlib/configuration.pyt__load_environment_keysέscC`sQ|jt|jjƒƒB}|j|}|rMtdjt|ƒƒƒ‚ndS(NsXRequired key(s) not found in environment or configuration sources. Missing Keys: {0}(R,R+R*R]R-tEnvironmentErrorRR'(R3tavailable_keyst missing_keys((sAlib/python2.7/site-packages/conda/_vendor/auxlib/configuration.pyt__ensure_required_keysζs   cC`s|jjddƒdS(Nt_memoized_results(t__dict__RJRK(R3((sAlib/python2.7/site-packages/conda/_vendor/auxlib/configuration.pyRGξsc`s;‡fd†}tjtjƒˆ_tjtj|ƒdS(Nc`sF|tjkrdSˆjtƒtˆjƒrBˆj||ƒndS(N(R/RRPR%tcallablet'_Configuration__previous_sighup_handler(tsignumtframe(R3(sAlib/python2.7/site-packages/conda/_vendor/auxlib/configuration.pytsighup_handlerςs  (R/t getsignalRRz(R3R}((R3sAlib/python2.7/site-packages/conda/_vendor/auxlib/configuration.pyt__set_up_sighup_handlerρsN(t__name__t __module__t__doc__RKR6R2R;tFalseR7RCRIRMRPRRXRYRRR\R^R_R=R1RBRGR0(((sAlib/python2.7/site-packages/conda/_vendor/auxlib/configuration.pyR:s($             tSourcecB`seZdZdZdZed„ƒZed„ƒZd„Z e d„Z ed„ƒZ e j d„ƒZ ed„ƒZej d„ƒZRS( cC`s|jS(N(t _provides(R3((sAlib/python2.7/site-packages/conda/_vendor/auxlib/configuration.pyRdscC`s |jƒS(N(Rc(R3((sAlib/python2.7/site-packages/conda/_vendor/auxlib/configuration.pyR_scC`s tƒ‚dS(sMust return a key, value dictN(Rf(R3((sAlib/python2.7/site-packages/conda/_vendor/auxlib/configuration.pytload scC`s.|jdks|r'|jƒ|_n|jS(N(t_itemsRKR†(R3R8((sAlib/python2.7/site-packages/conda/_vendor/auxlib/configuration.pyRc scC`s|jS(N(t_parent_config(R3((sAlib/python2.7/site-packages/conda/_vendor/auxlib/configuration.pyR<scC`s ||_dS(N(Rˆ(R3R<((sAlib/python2.7/site-packages/conda/_vendor/auxlib/configuration.pyR<scC`s|jS(N(R@(R3((sAlib/python2.7/site-packages/conda/_vendor/auxlib/configuration.pyR>scC`s ||_dS(N(R@(R3R>((sAlib/python2.7/site-packages/conda/_vendor/auxlib/configuration.pyR>sN(R€RRKR‡R…R@tpropertyRdR_R†RƒRcR<tsetterR>(((sAlib/python2.7/site-packages/conda/_vendor/auxlib/configuration.pyR„όs  t YamlSourcecB`seZdd„Zd„ZRS(cC`s"||_|r|nd|_dS(N(t _locationRKR…(R3tlocationRd((sAlib/python2.7/site-packages/conda/_vendor/auxlib/configuration.pyR6%s c`spt|j|jjƒR}ddl}|j|ƒ‰|jdkrIˆSt‡fd†|jDƒƒSWdQXdS(Nic3`s|]}|ˆ|fVqdS(N((RR(tcontents(sAlib/python2.7/site-packages/conda/_vendor/auxlib/configuration.pys 0s( RRŒR<R$tyamlR†RdRKR)(R3tfhR((RŽsAlib/python2.7/site-packages/conda/_vendor/auxlib/configuration.pyR†)s  N(R€RRKR6R†(((sAlib/python2.7/site-packages/conda/_vendor/auxlib/configuration.pyR‹#s tEnvironmentMappedSourcecB`s eZdZd„Zd„ZRS(sELoad a full Source object given the value of an environment variable.cC`s||_||_dS(N(t_envvart _sourcemap(R3tenvvart sourcemap((sAlib/python2.7/site-packages/conda/_vendor/auxlib/configuration.pyR66s cC`s3|j|j|j}|j|_|jƒ}|S(N(R“R<R’R†(R3t mapped_sourcetparams((sAlib/python2.7/site-packages/conda/_vendor/auxlib/configuration.pyR†:s  (R€RR‚R6R†(((sAlib/python2.7/site-packages/conda/_vendor/auxlib/configuration.pyR‘3s ( R‚t __future__RRRR!tloggingRDR/tcompatRt decoratorsRRt exceptionsRRtpathRt type_coercionR R t getLoggerR€tlogRRtobjectRR„R‹R‘(((sAlib/python2.7/site-packages/conda/_vendor/auxlib/configuration.pyts$    Β'