o i,F@srUdZddlmZddlmZddlmZddlmZddl Z ddl Z ddl m Z m Z mZmZmZmZmZmZmZmZmZmZdd lmZerMdd lmZed Zed Zd ZGdddeZej Z!d2ddZ"d3ddZ#e j$e j%e j&e j'e j(dZ)d4ddZ*d5d d!Z+d6d#d$Z,d6d%d&Z-e,e-d'Z.d(e/d)<ed7d+d,Z0Gd-d.d.eeefZ1Gd/d0d0Z2e2Z3d0e/d1<dS)8zIProvide access to settings for globally used Azure configuration values. ) annotations) namedtuple)Enum)cacheN) TypeOptionalCallableUnionDictAnyTypeVarTupleGenericMappingList TYPE_CHECKING) AzureClouds) AbstractSpanValidInputType ValueType)settingsSettingsc@seZdZdZdS)_UnsetrN)__name__ __module__ __qualname__tokenrrJ/home/app/Keep/.python/lib/python3.10/site-packages/azure/core/settings.pyr=srvalueUnion[str, bool]returnboolcCs<t|tr|S|}|dvrdS|dvrdStd|)aConvert a string to True or False If a boolean is passed in, it is returned as-is. Otherwise the function maps the following strings, ignoring case: * "yes", "1", "on" -> True " "no", "0", "off" -> False :param value: the value to convert :type value: str or bool :returns: A boolean value matching the intent of the input :rtype: bool :raises ValueError: If conversion to bool fails )yes1ontrueTrueT)no0offfalseFalseFz"Cannot convert {} to boolean value) isinstancer#lower ValueErrorformat)r valrrr convert_boolDs r3Optional[Union[str, bool]]cCs |dur tr dSdSt|S)aConvert tracing value to bool with regard to tracing implementation. :param value: the value to convert :type value: str or bool or None :returns: A boolean value matching the intent of the input :rtype: bool :raises ValueError: If conversion to bool fails NTF)rtracing_implementationr3)r rrrconvert_tracing_enabled^s  r6)CRITICALERRORWARNINGINFODEBUGUnion[str, int]intcCs>t|tr|S|}t|}|std|dt|S)aConvert a string to a Python logging level If a log level is passed in, it is returned as-is. Otherwise the function understands the following strings, ignoring case: * "critical" * "error" * "warning" * "info" * "debug" :param value: the value to convert :type value: str or int :returns: A log level as an int. See the logging module for details. :rtype: int :raises ValueError: If conversion to log level fails z4Cannot convert {} to log level, valid values are: {}, )r.r=upper_levelsgetr0r1join)r r2levelrrrconvert_loggingys  rDUnion[str, AzureClouds]rcCs^t|tr|St|tr(ddtD}||vr||Std|d|td|)zConvert a string to an Azure Cloud :param value: the value to convert :type value: string :returns: An AzureClouds enum value :rtype: AzureClouds :raises ValueError: If conversion to AzureClouds fails cSsi|]}|j|qSr)name).0cloudrrr sz'convert_azure_cloud..z6Cannot convert {} to Azure Cloud, valid values are: {}r>z Cannot convert {} to Azure Cloud)r.rstrr0r1rBkeys)r Z azure_cloudsrrrconvert_azure_clouds  rLOptional[Type[AbstractSpan]]cC(z ddlm}|WStyYdSw)zReturns the OpenCensusSpan if the opencensus tracing plugin is installed else returns None. :rtype: type[AbstractSpan] or None :returns: OpenCensusSpan type or None rOpenCensusSpanN)Z&azure.core.tracing.ext.opencensus_spanrP ImportErrorrOrrr_get_opencensus_span   rRcCrN)zReturns the OpenTelemetrySpan if the opentelemetry tracing plugin is installed else returns None. :rtype: type[AbstractSpan] or None :returns: OpenTelemetrySpan type or None rOpenTelemetrySpanN)Z)azure.core.tracing.ext.opentelemetry_spanrUrQrTrrr_get_opentelemetry_spanrSrV)Z opencensusZ opentelemetryz5Dict[str, Callable[[], Optional[Type[AbstractSpan]]]]_tracing_implementation_dict(Optional[Union[str, Type[AbstractSpan]]]cCsZ|durdSt|ts |S|}t|dd}|}|tur+td|dt|S)aoConvert a string to AbstractSpan If a AbstractSpan is passed in, it is returned as-is. Otherwise the function understands the following strings, ignoring case: * "opencensus" * "opentelemetry" :param value: the value to convert :type value: string :returns: AbstractSpan :raises ValueError: If conversion to AbstractSpan fails NcSstSN)_unsetrrrrz&convert_tracing_impl..z7Cannot convert {} to AbstractSpan, valid values are: {}r>) r.rJr/rWrArZr0r1rB)r Zget_wrapper_classZ wrapper_classrrrconvert_tracing_impls  r]c@seZdZdZddedfd*d dZd+ddZd,d-ddZd,d.ddZd/d d!Z d0d"d#Z d1d$d%Z e d2d&d'Z e d3d(d)ZdS)4PrioritizedSettingaReturn a value for a global setting according to configuration precedence. The following methods are searched in order for the setting: 4. immediate values 3. previously user-set value 2. environment variable 1. system setting 0. implicit default If a value cannot be determined, a RuntimeError is raised. The ``env_var`` argument specifies the name of an environment to check for setting values, e.g. ``"AZURE_LOG_LEVEL"``. If a ``convert`` function is provided, the result will be converted before being used. The optional ``system_hook`` can be used to specify a function that will attempt to look up a value for the setting from system-wide configurations. If a ``convert`` function is provided, the hook result will be converted before being used. The optional ``default`` argument specified an implicit default value for the setting that is returned if no other methods provide a value. If a ``convert`` function is provided, ``default`` will be converted before being used. A ``convert`` argument may be provided to convert values before they are returned. For instance to concert log levels in environment variables to ``logging`` module values. If a ``convert`` function is provided, it must support str as valid input type. :param str name: the name of the setting :param str env_var: the name of an environment variable to check for the setting :param callable system_hook: a function that will attempt to look up a value for the setting :param default: an implicit default value for the setting :type default: any :param callable convert: a function to convert values before they are returned NrFrJenv_var Optional[str] system_hook&Optional[Callable[[], ValidInputType]]defaultUnion[ValidInputType, _Unset]convert;Optional[Callable[[Union[ValidInputType, str]], ValueType]]cCs8||_||_||_||_dd}|r|n||_t|_dS)NcS|SrYr)xrrrr[(r\z-PrioritizedSetting.__init__..)_name_env_var _system_hook_default_convertrZ _user_value)selfrFr_rarcreZ noop_convertrrr__init__s  zPrioritizedSetting.__init__r"cCs d|jS)NzPrioritizedSetting(%r))rirorrr__repr__, zPrioritizedSetting.__repr__r Optional[ValidInputType]rcCs|dur ||St|jts||jS|jr'|jtjvr'|tj|jS|jr1||St|jts=||jSt d|j )a Return the setting value according to the standard precedence. :param value: value :type value: str or int or float or None :returns: the value of the setting :rtype: str or int or float :raises RuntimeError: if no value can be determined Nz(No configured value found for setting %r) rmr.rnrrjosenvironrkrl RuntimeErrorriror rrr__call__/s     zPrioritizedSetting.__call__instancer owner Optional[Any]-PrioritizedSetting[ValidInputType, ValueType]cCrgrYr)rorzr{rrr__get__OszPrioritizedSetting.__get__rNonecCs||dSrY) set_value)rorzr rrr__set__RszPrioritizedSetting.__set__cCs ||_dS)aSpecify a value for this setting programmatically. A value set this way takes precedence over all other methods except immediate values. :param value: a user-set value for this setting :type value: str or int or float N)rnrxrrrrUs zPrioritizedSetting.set_valuecCs t|_dS)z>Unset the previous user value such that the priority is reset.N)rZrnrqrrr unset_value` zPrioritizedSetting.unset_valuecC|jSrY)rjrqrrrr_dzPrioritizedSetting.env_varcCrrY)rlrqrrrrchrzPrioritizedSetting.default) rFrJr_r`rarbrcrdrerf)r"rJrY)r rtr"r)rzr r{r|r"r})rzr r rr"r)r rr"rr"r)r"r`)r"rd)rrr__doc__rZrprrryr~rrrpropertyr_rcrrrrr^s"(      r^c@seZdZUdZd&ddZed'ddZejd(d dZed)d d Zed)ddZ d*ddZ d+ddZ e dde ejdZded<e ddeddZded<e d d!eddZd"ed <e d#d$eejdZd%ed#<dS),ra] Settings for globally used Azure configuration values. You probably don't want to create an instance of this class, but call the singleton instance: .. code-block:: python from azure.core.settings import settings settings.log_level = log_level = logging.DEBUG The following methods are searched in order for a setting: 4. immediate values 3. previously user-set value 2. environment variable 1. system setting 0. implicit default An implicit default is (optionally) defined by the setting attribute itself. A system setting value can be obtained from registries or other OS configuration for settings that support that method. An environment variable value is obtained from ``os.environ`` User-set values many be specified by assigning to the attribute: .. code-block:: python settings.log_level = log_level = logging.DEBUG Immediate values are (optionally) provided when the setting is retrieved: .. code-block:: python settings.log_level(logging.DEBUG()) Immediate values are most often useful to provide from optional arguments to client functions. If the argument value is not None, it will be returned as-is. Otherwise, the setting searches other methods according to the precedence rules. Immutable configuration snapshots can be created with the following methods: * settings.defaults returns the base defaultsvalues , ignoring any environment or system or user settings * settings.current returns the current computation of settings including prioritization of configuration sources, unless defaults_only is set to True (in which case the result is identical to settings.defaults) * settings.config can be called with specific values to override what settings.current would provide .. code-block:: python # return current settings with log level overridden settings.config(log_level=logging.DEBUG) :cvar log_level: a log level to use across all Azure client SDKs (AZURE_LOG_LEVEL) :type log_level: PrioritizedSetting :cvar tracing_enabled: Whether tracing should be enabled across Azure SDKs (AZURE_TRACING_ENABLED) :type tracing_enabled: PrioritizedSetting :cvar tracing_implementation: The tracing implementation to use (AZURE_SDK_TRACING_IMPLEMENTATION) :type tracing_implementation: PrioritizedSetting :Example: >>> import logging >>> from azure.core.settings import settings >>> settings.log_level = logging.DEBUG >>> settings.log_level() 10 >>> settings.log_level(logging.WARN) 30 r"rcCs d|_dS)NFZ_defaults_onlyrqrrrrprszSettings.__init__r#cCr)zWhether to ignore environment and system settings and return only base default values. :rtype: bool :returns: Whether to ignore environment and system settings and return only base default values. rrqrrr defaults_onlyszSettings.defaults_onlyr cCs ||_dSrYrrxrrrrrTuple[Any, ...]cCs dd|jjD}||S)zReturn implicit default values for all settings, ignoring environment and system. :rtype: namedtuple :returns: The implicit default values for all settings cSs"i|] \}}t|tr||jqSr)r.r^rcrGkvrrrrI"z%Settings.defaults..) __class____dict__items_config)ropropsrrrdefaultss zSettings.defaultscCs|jr|jS|S)zReturn the current values for all settings. :rtype: namedtuple :returns: The current values for all settings )rrconfigrqrrrcurrentszSettings.currentkwargsr cKs*dd|jjD}||||S)aReturn the currently computed settings, with values overridden by parameter values. :rtype: namedtuple :returns: The current values for all settings, with values overridden by parameter values Examples: .. code-block:: python # return current settings with log level overridden settings.config(log_level=logging.DEBUG) cSs"i|] \}}t|tr||qSr)r.r^rrrrrIrz#Settings.config..)rrrupdater)rorrrrrrs  zSettings.configrMapping[str, Any]cCs$t|}td|}|di|S)NConfigr)listrKr)rorrKrrrrrs  zSettings._config log_levelZAZURE_LOG_LEVEL)r_rercz(PrioritizedSetting[Union[str, int], int]tracing_enabledZAZURE_TRACING_ENABLEDNz4PrioritizedSetting[Optional[Union[str, bool]], bool]r5Z AZURE_SDK_TRACING_IMPLEMENTATIONzZPrioritizedSetting[Optional[Union[str, Type[AbstractSpan]]], Optional[Type[AbstractSpan]]] azure_cloudZ AZURE_CLOUDz8PrioritizedSetting[Union[str, AzureClouds], AzureClouds]r)r"r#)r r#r"r)r"r)rr r"r)rrr"r)rrrrrprrsetterrrrrr^rDloggingr:r__annotations__r6rr]r5rLrZAZURE_PUBLIC_CLOUDrrrrrrmsL  N        rr)r r!r"r#)r r4r"r#)r r<r"r=)r rEr"r)r"rM)r rXr"rM)4r __future__r collectionsrenumr functoolsrrrutypingrrrr r r r r rrrrZ _azure_cloudsrZazure.core.tracingrrr__all__rrrZr3r6r7r8r9r:r;r@rDrLrRrVrWrr]r^rrrrrrsL    8        !x,