HEX

File: //lib/python3/dist-packages/botocore/__pycache__/configprovider.cpython-310.pyc
o

<&�aQY�
@sdZddlZddlZddlmZe�e�Ziddddgddf�dd�d	d
�dd�d
d�dddidf�dd�ddddef�ddddef�dd�dd�ddddej	f�ddddej	f�d d d!dej	f�d"d#�d$d$d%dej	f�d&d'�d(d)d*efd+d,d-d.d/d0defd1��Z
d2d3ddej	fd4ddej	fd5ddej	fd6d7gd8dej	fd9d:gd;ddfd<d=dej	fd>�Zd?d@dAddejfdB�Z
dCdD�ZdEdF�ZGdGdH�dHe�ZGdIdJ�dJe�ZGdKdL�dLe�ZGdMdN�dNe�ZGdOdP�dPe�ZGdQdR�dRe�ZGdSdT�dTe�ZGdUdV�dVe�ZGdWdX�dXe�ZdS)YzOThis module contains the inteface for controlling how configuration
is loaded.
�N)�utils�profile�AWS_DEFAULT_PROFILE�AWS_PROFILE�region)r�AWS_DEFAULT_REGIONNN�	data_path)r�
AWS_DATA_PATHNN�config_file)N�AWS_CONFIG_FILEz
~/.aws/configN�	ca_bundle)r�
AWS_CA_BUNDLENN�api_versions�credentials_file)N�AWS_SHARED_CREDENTIALS_FILEz~/.aws/credentialsN�metadata_service_timeout�AWS_METADATA_SERVICE_TIMEOUT��metadata_service_num_attempts�!AWS_METADATA_SERVICE_NUM_ATTEMPTS�ec2_metadata_service_endpoint)r�!AWS_EC2_METADATA_SERVICE_ENDPOINTNN�"ec2_metadata_service_endpoint_mode)r�&AWS_EC2_METADATA_SERVICE_ENDPOINT_MODENN�
imds_use_ipv6�AWS_IMDS_USE_IPV6F�use_dualstack_endpoint�AWS_USE_DUALSTACK_ENDPOINT�use_fips_endpoint�AWS_USE_FIPS_ENDPOINT�parameter_validation)r NTN�csm_enabled�AWS_CSM_ENABLED�csm_host)r#�AWS_CSM_HOSTz	127.0.0.1N�csm_port�AWS_CSM_PORTiy)�
csm_client_id�AWS_CSM_CLIENT_ID�N)�endpoint_discovery_enabled�AWS_ENDPOINT_DISCOVERY_ENABLED�autoN)�sts_regional_endpoints�AWS_STS_REGIONAL_ENDPOINTS�legacyN)�
retry_mode�AWS_RETRY_MODEr/N�max_attempts�AWS_MAX_ATTEMPTS)r%r'r*r-r0r2))�s3�addressing_styleNNN)r4�use_accelerate_endpoint)r4r)r4�payload_signing_enabled�s3_use_arn_region)r4�use_arn_region�AWS_S3_USE_ARN_REGION�s3_us_east_1_regional_endpoint)r4�us_east_1_regional_endpoint�"AWS_S3_US_EAST_1_REGIONAL_ENDPOINT)r4�$s3_disable_multiregion_access_points�(AWS_S3_DISABLE_MULTIREGION_ACCESS_POINTS)r5r6rr7r9r<r>)�proxy_ca_bundleNNN)�proxy_client_certNNN�proxy_use_forwarding_for_https)r@rArBcCsDt|d�}t|t�}td|t|t��|d<td|t|t��|d<|S)N)�sessionr4�proxies_config)�ConfigChainFactory�_create_config_chain_mapping�!BOTOCORE_DEFAUT_SESSION_VARIABLES�SectionConfigProvider�DEFAULT_S3_CONFIG_VARS�DEFAULT_PROXIES_CONFIG_VARS)rC�
chain_builder�config_mapping�rM�9/usr/lib/python3/dist-packages/botocore/configprovider.py�&create_botocore_default_config_mapping�s
�����rOcCsBi}|��D]\}}|j||d|d|d|dd�||<q|S)Nrr��)�
instance_name�
env_var_names�config_property_names�default�conversion_func)�items�create_config_chain)rK�config_variables�mapping�logical_name�configrMrMrNrF�s�rFc@s:eZdZdZddd�Z			ddd�Zdd�Zd	d
�ZdS)
rEaFactory class to create our most common configuration chain case.

    This is a convenience class to construct configuration chains that follow
    our most common pattern. This is to prevent ordering them incorrectly,
    and to make the config chain construction more readable.
    NcCs||_|dur
tj}||_dS)aInitialize a ConfigChainFactory.

        :type session: :class:`botocore.session.Session`
        :param session: This is the session that should be used to look up
            values from the config file.

        :type environ: dict
        :param environ: A mapping to use for environment variables. If this
            is not provided it will default to use os.environ.
        N)�_session�os�environ�_environ)�selfrCr_rMrMrN�__init__�s
zConfigChainFactory.__init__cCstg}|dur|�t||jd��|dur|�|�|��|dur(|�|�|��|dur4|�t|d��t||d�S)a�Build a config chain following the standard botocore pattern.

        In botocore most of our config chains follow the the precendence:
        session_instance_variables, environment, config_file, default_value.

        This is a convenience function for creating a chain that follow
        that precendence.

        :type instance_name: str
        :param instance_name: This indicates what session instance variable
            corresponds to this config value. If it is None it will not be
            added to the chain.

        :type env_var_names: str or list of str or None
        :param env_var_names: One or more environment variable names to
            search for this value. They are searched in order. If it is None
            it will not be added to the chain.

        :type config_property_names: str/tuple or list of str/tuple or None
        :param config_property_names: One of more strings or tuples
            representing the name of the key in the config file for this
            config option. They are searched in order. If it is None it will
            not be added to the chain.

        :type default: Any
        :param default: Any constant value to be returned.

        :type conversion_func: None or callable
        :param conversion_func: If this value is None then it has no effect on
            the return type. Otherwise, it is treated as a function that will
            conversion_func our provided type.

        :rvalue: ConfigChain
        :returns: A ConfigChain that resolves in the order env_var_names ->
            config_property_name -> default. Any values that were none are
            omitted form the chain.
        N)�instance_varrC)�value)�	providersrV)�append�InstanceVarProviderr]�extend�_get_env_providers�_get_scoped_config_providers�ConstantProvider�
ChainProvider)rarRrSrTrUrVrerMrMrNrX�s((����z&ConfigChainFactory.create_config_chaincC�6g}t|t�s
|g}|D]}|�t||jd��q|S)N)�name�env)�
isinstance�listrf�EnvironmentProviderr`)rarS�env_var_providers�env_var_namerMrMrNris
�z%ConfigChainFactory._get_env_providerscCrm)N)�config_var_namerC)rprqrf�ScopedConfigProviderr])rarT�scoped_config_providers�config_property_namerMrMrNrjs
��z/ConfigChainFactory._get_scoped_config_providers�N)NNNNN)�__name__�
__module__�__qualname__�__doc__rbrXrirjrMrMrMrNrE�s

�>
rEc@s:eZdZdZd
dd�Zdd�Zdd�Zd	d
�Zdd�ZdS)�ConfigValueStorez8The ConfigValueStore object stores configuration values.NcCs:i|_i|_|dur|��D]\}}|�||�qdSdS)aNInitialize a ConfigValueStore.

        :type mapping: dict
        :param mapping: The mapping parameter is a map of string to a subclass
            of BaseProvider. When a config variable is asked for via the
            get_config_variable method, the corresponding provider will be
            invoked to load the value.
        N)�
_overrides�_mappingrW�set_config_provider)rarZr[�providerrMrMrNrb(s	�zConfigValueStore.__init__cCs4||jvr
|j|S||jvrdS|j|}|��S)a
        Retrieve the value associeated with the specified logical_name
        from the corresponding provider. If no value is found None will
        be returned.

        :type logical_name: str
        :param logical_name: The logical name of the session variable
            you want to retrieve.  This name will be mapped to the
            appropriate environment variable name for this session as
            well as the appropriate config file entry.

        :returns: value of variable or None if not defined.
        N)rr��provide�rar[r�rMrMrN�get_config_variable7s



z$ConfigValueStore.get_config_variablecC�||j|<dS)a�Set a configuration variable to a specific value.

        By using this method, you can override the normal lookup
        process used in ``get_config_variable`` by explicitly setting
        a value.  Subsequent calls to ``get_config_variable`` will
        use the ``value``.  This gives you per-session specific
        configuration values.

        ::
            >>> # Assume logical name 'foo' maps to env var 'FOO'
            >>> os.environ['FOO'] = 'myvalue'
            >>> s.get_config_variable('foo')
            'myvalue'
            >>> s.set_config_variable('foo', 'othervalue')
            >>> s.get_config_variable('foo')
            'othervalue'

        :type logical_name: str
        :param logical_name: The logical name of the session variable
            you want to set.  These are the keys in ``SESSION_VARIABLES``.

        :param value: The value to associate with the config variable.
        N)r)rar[rdrMrMrN�set_config_variableLsz$ConfigValueStore.set_config_variablecCs|j�|d�dS)z�Remove an override config variable from the session.

        :type logical_name: str
        :param logical_name: The name of the parameter to clear the override
            value from.
        N)r�pop)rar[rMrMrN�clear_config_variablefsz&ConfigValueStore.clear_config_variablecCr�)a;Set the provider for a config value.

        This provides control over how a particular configuration value is
        loaded. This replaces the provider for ``logical_name`` with the new
        ``provider``.

        :type logical_name: str
        :param logical_name: The name of the config value to change the config
            provider for.

        :type provider: :class:`botocore.configprovider.BaseProvider`
        :param provider: The new provider that should be responsible for
            providing a value for the config named ``logical_name``.
        N)r�r�rMrMrNr�osz$ConfigValueStore.set_config_providerry)	rzr{r|r}rbr�r�r�r�rMrMrMrNr~&s
	r~c@seZdZdZdd�ZdS)�BaseProviderz�Base class for configuration value providers.

    A configuration provider has some method of providing a configuration
    value.
    cCstd��)zProvide a config value.r�)�NotImplementedError�rarMrMrNr��szBaseProvider.provideN)rzr{r|r}r�rMrMrMrNr��sr�c@s2eZdZdZddd�Zdd�Zdd�Zd	d
�ZdS)rlz�This provider wraps one or more other providers.

    Each provider in the chain is called, the first one returning a non-None
    value is then returned.
    NcCs|durg}||_||_dS)a�Initalize a ChainProvider.

        :type providers: list
        :param providers: The initial list of providers to check for values
            when invoked.

        :type conversion_func: None or callable
        :param conversion_func: If this value is None then it has no affect on
            the return type. Otherwise, it is treated as a function that will
            transform provided value.
        N)�
_providers�_conversion_func)rarerVrMrMrNrb�s
zChainProvider.__init__cCs.|jD]}|��}|dur|�|�SqdS)a*Provide the value from the first provider to return non-None.

        Each provider in the chain has its provide method called. The first
        one in the chain to return a non-None value is the returned from the
        ChainProvider. When no non-None value is found, None is returned.
        N)r�r��
_convert_type)rar�rdrMrMrNr��s
�zChainProvider.providecCs|jdur
|�|�S|Sry)r��rardrMrMrNr��s

zChainProvider._convert_typecCsdd�dd�|jD��S)Nz[%s]z, cSsg|]}t|��qSrM)�str)�.0�prMrMrN�
<listcomp>�sz*ChainProvider.__repr__.<locals>.<listcomp>)�joinr�r�rMrMrN�__repr__�szChainProvider.__repr__)NN)rzr{r|r}rbr�r�r�rMrMrMrNrl�s

rlc@�(eZdZdZdd�Zdd�Zdd�ZdS)	rgz>This class loads config values from the session instance vars.cC�||_||_dS)a>Initialize InstanceVarProvider.

        :type instance_var: str
        :param instance_var: The instance variable to load from the session.

        :type session: :class:`botocore.session.Session`
        :param session: The botocore session to get the loaded configuration
            file variables from.
        N��
_instance_varr])rarcrCrMrMrNrb�s

zInstanceVarProvider.__init__cCs|j��}|�|j�}|S)z6Provide a config value from the session instance vars.)r]�instance_variables�getr�)ra�
instance_varsrdrMrMrNr��s
zInstanceVarProvider.providecC�d|j|jfS)Nz0InstanceVarProvider(instance_var=%s, session=%s)r�r�rMrMrNr����zInstanceVarProvider.__repr__N�rzr{r|r}rbr�r�rMrMrMrNrg�s

rgc@s$eZdZdd�Zdd�Zdd�ZdS)rvcCr�)a2Initialize ScopedConfigProvider.

        :type config_var_name: str or tuple
        :param config_var_name: The name of the config variable to load from
            the configuration file. If the value is a tuple, it must only
            consist of two items, where the first item represents the section
            and the second item represents the config var name in the section.

        :type session: :class:`botocore.session.Session`
        :param session: The botocore session to get the loaded configuration
            file variables from.
        N��_config_var_namer])rarurCrMrMrNrb�s
zScopedConfigProvider.__init__cCsP|j��}t|jt�r"|�|jd�}t|t�sdS|�|jd�S|�|j�S)z,Provide a value from a config file property.rNr)r]�get_scoped_configrpr��tupler��dict)ra�
scoped_config�section_configrMrMrNr��s

zScopedConfigProvider.providecCr�)Nz4ScopedConfigProvider(config_var_name=%s, session=%s)r�r�rMrMrNr��r�zScopedConfigProvider.__repr__N)rzr{r|rbr�r�rMrMrMrNrv�s
rvc@r�)	rrz:This class loads config values from environment variables.cCr�)aInitialize with the keys in the dictionary to check.

        :type name: str
        :param name: The key with that name will be loaded and returned.

        :type env: dict
        :param env: Environment variables dictionary to get variables from.
        N��_name�_env)rarnrorMrMrNrb�s	
zEnvironmentProvider.__init__cCs|j|jvr|j|jSdS)z0Provide a config value from a source dictionary.Nr�r�rMrMrNr�szEnvironmentProvider.providecCr�)Nz$EnvironmentProvider(name=%s, env=%s)r�r�rMrMrNr�szEnvironmentProvider.__repr__Nr�rMrMrMrNrr�s
rrc@s*eZdZdZd	dd�Zdd�Zdd�ZdS)
rHz�Provides a dictionary from a section in the scoped config

    This is useful for retrieving scoped config variables (i.e. s3) that have
    their own set of config variables and resolving logic.
    NcCs:||_||_t|j|j�|_||_|jduri|_dSdSry)�
_section_namer]rv�_scoped_config_provider�_override_providers)ra�section_namerC�override_providersrMrMrNrbs�

�zSectionConfigProvider.__init__cCsh|j��}|rt|t�st�d|j|�dS|j��D]\}}|��}|dur1|dur-i}|||<q|S)NzEThe %s config key is not a dictionary type, ignoring its value of: %s)	r�r�rpr��logger�debugr�r�rW)rar��section_config_varr��provider_valrMrMrNr�s
��zSectionConfigProvider.providecCsd|j|j|jfS)NzISectionConfigProvider(section_name=%s, session=%s, override_providers=%s))r�r]r�r�rMrMrNr�-s���zSectionConfigProvider.__repr__ryr�rMrMrMrNrHs

	rHc@r�)	rkz(This provider provides a constant value.cCs
||_dSry��_valuer�rMrMrNrb9�
zConstantProvider.__init__cCs|jS)z7Provide the constant value given during initialization.r�r�rMrMrNr�<szConstantProvider.providecCs
d|jS)NzConstantProvider(value=%s)r�r�rMrMrNr�@r�zConstantProvider.__repr__Nr�rMrMrMrNrk7s
rk)r}�loggingr^�botocorer�	getLoggerrzr��int�ensure_booleanrGrI�normalize_booleanrJrOrF�objectrEr~r�rlrgrvrrrHrkrMrMrMrN�<module>s�
������
�������!��%��)��-�1
��3�
4
�G
�
�
�������
��
m[-"(