]h FUdZddlmZddlmZddlmZddlZddlZddl m Z m Z m Z m Z mZmZmZmZmZmZmZmZddlmZerdd lmZed Zed Zd ZGd deZej<ZddZ d dZ!ejDejFejHejJejLdZ'd!dZ(d"dZ)d#dZ*d#dZ+e*e+dZ,de-d<d$dZ.GddeeefZ/GddZ0e0Z1de-d<y)%zIProvide access to settings for globally used Azure configuration values. ) annotations) namedtuple)EnumN) TypeOptionalCallableUnionDictAnyTypeVarTupleGenericMappingList TYPE_CHECKING) AzureClouds) AbstractSpanValidInputType ValueType)settingsSettingsceZdZdZy)_UnsetrN)__name__ __module__ __qualname__tokenY/var/www/core.comfia.cic-ware.com/crm/lib/python3.12/site-packages/azure/core/settings.pyrr<s Er rct|tr|S|j}|dvry|dvrytdj |)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) isinstanceboollower ValueErrorformat)valuevals r! convert_boolr4CsM % ++-C 00 22 9@@G HHr cH|tjryyt|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 TF)rtracing_implementationr4)r2s r!convert_tracing_enabledr7]s( }  * * ,  r )CRITICALERRORWARNINGINFODEBUGct|tr|S|j}tj |}|s.t dj |djt|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-intupper_levelsgetr0r1join)r2r3levels r!convert_loggingrExs]&% ++-C KK E OVVW\^b^g^gho^pqrr Lr c Bt|tr|St|tr_tDcic]}|j|}}||vr||St dj |dj |jt dj |cc}w)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 z6Cannot convert {} to Azure Cloud, valid values are: {}r>z Cannot convert {} to Azure Cloud)r-rstrnamer0r1rCkeys)r2cloud azure_cloudss r!convert_azure_cloudrLs%% %7BCe E)C C L & & D K KESWS\S\]i]n]n]pSq r   7>>uE FF DsBc2 ddlm}|S#t$rYywxYw)zReturns the OpenCensusSpan if the opencensus tracing plugin is installed else returns None. :rtype: type[AbstractSpan] or None :returns: OpenCensusSpan type or None rOpenCensusSpanN)&azure.core.tracing.ext.opencensus_spanrO ImportErrorrNs r!_get_opencensus_spanrRs&     c2 ddlm}|S#t$rYywxYw)zReturns the OpenTelemetrySpan if the opentelemetry tracing plugin is installed else returns None. :rtype: type[AbstractSpan] or None :returns: OpenTelemetrySpan type or None rOpenTelemetrySpanN))azure.core.tracing.ext.opentelemetry_spanrVrQrUs r!_get_opentelemetry_spanrXs&  ! rS) opencensus opentelemetryz5Dict[str, Callable[[], Optional[Type[AbstractSpan]]]]_tracing_implementation_dictc|yt|ts|S|j}tj |d}|}|t ur.t dj|djt|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 NctSN)_unsetrr r!z&convert_tracing_impl..sr z7Cannot convert {} to AbstractSpan, valid values are: {}r>) r-rGr/r[rBr_r0r1rC)r2get_wrapper_class wrapper_classs r!convert_tracing_implrcs{ } eS ! KKME488OARATM E L Ltyy!=>   r ceZdZdZddedf d dZd dZdddZdddZddZ ddZ dd Z e dd Z e dd Zy)PrioritizedSettingaReturn 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 Ncn||_||_||_||_d}|r|n||_t |_y)Nc|Sr^r)xs r!r`z-PrioritizedSetting.__init__..&sqr )_name_env_var _system_hook_default_convertr_ _user_value)selfrHenv_var system_hookdefaultconvert noop_converts r!__init__zPrioritizedSetting.__init__s:  ' -8 V]7co :@r c d|jzS)NzPrioritizedSetting(%r))riros r!__repr__zPrioritizedSetting.__repr__*s'$**44r c*||j|St|jts|j|jS|jrH|jt j vr,|jt j |jS|jr|j|jSt|jts|j|jStd|jz)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 z(No configured value found for setting %r) rmr-rnrrjosenvironrkrl RuntimeErrorriror2s r!__call__zPrioritizedSetting.__call__-s  ==' '$**F3==!1!12 2 ==T]]bjj8==DMM!:; ;   ==!2!2!45 5$--0==/ /E RSSr c|Sr^r)roinstanceowners r!__get__zPrioritizedSetting.__get__Ms r c&|j|yr^) set_value)rorr2s r!__set__zPrioritizedSetting.__set__Ps ur c||_y)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)rnr}s r!rzPrioritizedSetting.set_valueSs !r ct|_y)z>Unset the previous user value such that the priority is reset.N)r_rnrws r! unset_valuezPrioritizedSetting.unset_value^s !r c|jSr^)rjrws r!rpzPrioritizedSetting.env_varb }}r c|jSr^)rlrws r!rrzPrioritizedSetting.defaultfrr ) rHrGrp Optional[str]rqz&Optional[Callable[[], ValidInputType]]rrUnion[ValidInputType, _Unset]rsz;Optional[Callable[[Union[ValidInputType, str]], ValueType]])returnrGr^)r2zOptional[ValidInputType]rr)rr rz Optional[Any]rz-PrioritizedSetting[ValidInputType, ValueType])rr r2rrNone)r2rrrrr)rr)rr)rrr__doc__r_rurxr~rrrrpropertyrprrrr r!reres#P"&>B17OS AAA< A / A M A"5T@ !"r rec6eZdZUdZddZeddZejddZeddZeddZ ddZ ddZ e d d e ej Zd ed <e d ded Zded <e dded Zded<e ddeej0 Zded<y)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 cd|_y)NF_defaults_onlyrws r!ruzSettings.__init__s $)r c|jS)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. rrws r! defaults_onlyzSettings.defaults_onlys"""r c||_yr^rr}s r!rzSettings.defaults_onlys #r c|jjjDcic]#\}}t|ts||j %}}}|j |Scc}}w)zReturn implicit default values for all settings, ignoring environment and system. :rtype: namedtuple :returns: The implicit default values for all settings ) __class____dict__itemsr-rerr_config)rokvpropss r!defaultszSettings.defaultssV-1NN,C,C,I,I,Kq&1azZ[]oOpAIIqq||E""rs A$A$cR|jr |jS|jS)zReturn the current values for all settings. :rtype: namedtuple :returns: The current values for all settings )rrconfigrws r!currentzSettings.currents#   == {{}r c |jjjDcic]\}}t|ts|| }}}|j ||j |Scc}}w)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) )rrrr-reupdater)rokwargsrrrs r!rzSettings.configs`'+nn&=&=&C&C&EkFQTUWiIjACkk V||E""ls A0 A0c\t|j}td|}|di|S)NConfigr)listrIr)rorrIrs r!rzSettings._configs*uzz|,Hd+r log_levelAZURE_LOG_LEVEL)rprsrrz(PrioritizedSetting[Union[str, int], int]tracing_enabledAZURE_TRACING_ENABLEDNz4PrioritizedSetting[Optional[Union[str, bool]], bool]r6 AZURE_SDK_TRACING_IMPLEMENTATIONzZPrioritizedSetting[Optional[Union[str, Type[AbstractSpan]]], Optional[Type[AbstractSpan]]] azure_cloud AZURE_CLOUDz8PrioritizedSetting[Union[str, AzureClouds], AzureClouds]r)rr.)r2r.rr)rTuple[Any, ...])rr rr)rzMapping[str, Any]rr)rrrrrurrsetterrrrrrerEloggingr;r__annotations__r7rrcr6rLrAZURE_PUBLIC_CLOUDrrr r!rrksL\*##$$###$ ;M! ;I7M_'' MOI  2$  M_#.. MKIr rr)r2zUnion[str, bool]rr.)r2zOptional[Union[str, bool]]rr.)r2zUnion[str, int]rr?)r2zUnion[str, AzureClouds]rr)rOptional[Type[AbstractSpan]])r2z(Optional[Union[str, Type[AbstractSpan]]]rr)2r __future__r collectionsrenumrrrztypingrrrr r r r r rrrr _azure_cloudsrazure.core.tracingrrr__all__rrr_r4r7r8r9r:r;r<rArErLrRrXr[rrcrerrrr r!rs4""     '/)* K  #T I4&  ]] LL ]]  <G,  "',WS Bu!:;uphhVZ(r