]j[N*UdZddlmZddlmZddlmZddlmZddl Z ddl Z ddl m Z m Z mZmZmZmZmZmZmZmZmZmZdd lmZerdd lmZed Zed Ze j<eZ d Z!GddeZ"e"jFZ$d dZ%d!dZ&e jNe jPe jRe jTe jVdZ,d"dZ-d#dZ.d$dZ/d$dZ0e/e0dZ1de2d<ed%dZ3GddeeefZ4GddZ5e5Z6de2d<y)&zIProvide access to settings for globally used Azure configuration values. ) annotations) namedtuple)Enum)cacheN) TypeOptionalCallableUnionDictAnyTypeVarTupleGenericMappingList TYPE_CHECKING) AzureClouds) AbstractSpanValidInputType ValueType)settingsSettingsceZdZdZy)_UnsetrN)__name__ __module__ __qualname__token=/root/env/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_boolr5FsM % ++-C 00 22 9@@G HHr!c|tjryy t|S#t$r/tj d|tjrYyYywxYw)aConvert tracing value to bool with regard to tracing implementation. If the value cannot be converted to a bool, a warning is logged and the default behavior is used (auto-detect based on whether a tracing implementation is configured). :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 TFzInvalid value %r for AZURE_TRACING_ENABLED; falling back to default behavior. Valid values are: 'true'/'false', 'yes'/'no', '1'/'0', 'on'/'off' (case-insensitive).)rtracing_implementationr5r1_LOGGERwarning)r3s r"convert_tracing_enabledr:`se }  * * , E""  d   * * ,s %3AA)CRITICALERRORWARNINGINFODEBUGct|tr|S|j}|dk(rd}tj |}|:t j d|djttjS|S)a#Convert 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" * "verbose" (treated as "debug") If the value cannot be converted, a warning is logged and ``logging.INFO`` is returned. :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 VERBOSEr?zUInvalid log level %r for AZURE_LOG_LEVEL; falling back to INFO. Valid values are: %s., ) r.intupper_levelsgetr8r9joinloggingr>)r3r4levels r"convert_loggingrJso,% ++-C i KK E } c  IIg  || 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: {}rBz Cannot convert {} to Azure Cloud)r.rstrnamer1r2rGkeys)r3cloud azure_cloudss r"convert_azure_cloudrQs%% %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_spanrT ImportErrorrSs r"_get_opencensus_spanrWs&     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_spanr[rVrZs r"_get_opentelemetry_spanr]s&  ! rX) opencensus opentelemetryz5Dict[str, Callable[[], Optional[Type[AbstractSpan]]]]_tracing_implementation_dictc|yt|ts|S|j}tj |d}|}|t ur+t jd|djty|S)aConvert 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" If the value cannot be converted, a warning is logged and ``None`` is returned. :param value: the value to convert :type value: string :returns: AbstractSpan NctSN)_unsetr r!r"z&convert_tracing_impl..sr!z}Invalid tracing implementation %r for AZURE_SDK_TRACING_IMPLEMENTATION; falling back to default (None). Valid values are: %s.rB) r.rLr0r`rFrdr8r9rG)r3get_wrapper_class wrapper_classs r"convert_tracing_implrhsu" } eS ! KKME488OARATM $  II2 3   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|Srcr )xs r"rez-PrioritizedSetting.__init__..Dsqr!)_name_env_var _system_hook_default_convertrd _user_value)selfrMenv_var system_hookdefaultconvert noop_converts r"__init__zPrioritizedSetting.__init__7s:  ' -8 V]7co :@r!c d|jzS)NzPrioritizedSetting(%r))rnrts r"__repr__zPrioritizedSetting.__repr__Hs'$**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) rrr.rsrroosenvironrprq RuntimeErrorrnrtr3s r"__call__zPrioritizedSetting.__call__Ks  ==' '$**F3==!1!12 2 ==T]]bjj8==DMM!:; ;   ==!2!2!45 5$--0==/ /E RSSr!c|Srcr )rtinstanceowners r"__get__zPrioritizedSetting.__get__ks r!c&|j|yrc) set_value)rtrr3s r"__set__zPrioritizedSetting.__set__ns 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)rsrs r"rzPrioritizedSetting.set_valueqs !r!ct|_y)z>Unset the previous user value such that the priority is reset.N)rdrsr|s r" unset_valuezPrioritizedSetting.unset_value|s !r!c|jSrc)ror|s r"ruzPrioritizedSetting.env_var }}r!c|jSrc)rqr|s r"rwzPrioritizedSetting.defaultrr!) rMrLru Optional[str]rvz&Optional[Callable[[], ValidInputType]]rwUnion[ValidInputType, _Unset]rxz;Optional[Callable[[Union[ValidInputType, str]], ValueType]])returnrLrc)r3zOptional[ValidInputType]rr)rr rz Optional[Any]rz-PrioritizedSetting[ValidInputType, ValueType])rr r3rrNone)r3rrrrr)rr)rr)rrr__doc__rdrzr}rrrrrpropertyrurwr r!r"rjrjs#P"&>B17OS AAA< A / A M A"5T@ !"r!rjc6eZdZUdZddZeddZejddZeddZeddZ 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 :cvar azure_cloud: The Azure cloud environment to use (AZURE_SDK_CLOUD_CONF) :type azure_cloud: PrioritizedSetting The following environment variables are used by the settings: * ``AZURE_LOG_LEVEL`` - Logging level. Accepted values: ``CRITICAL``, ``ERROR``, ``WARNING``, ``INFO``, ``DEBUG``, ``VERBOSE`` (case-insensitive). ``VERBOSE`` is treated as ``DEBUG``. If the value is invalid, a warning is logged and ``INFO`` is used. Default: ``INFO``. * ``AZURE_TRACING_ENABLED`` - Enable/disable tracing. Accepted values: ``true``/``false``, ``yes``/``no``, ``1``/``0``, ``on``/``off`` (case-insensitive). If the value is invalid, a warning is logged and the default is used. Default: auto-detected based on whether a tracing implementation is configured. * ``AZURE_SDK_TRACING_IMPLEMENTATION`` - Tracing implementation. Accepted values: ``opentelemetry``. If the value is invalid, a warning is logged and the default is used. Default: None. * ``AZURE_SDK_CLOUD_CONF`` - Azure cloud environment. Accepted values: ``AZURE_PUBLIC_CLOUD``, ``AZURE_CHINA_CLOUD``, ``AZURE_US_GOVERNMENT``. Default: ``AZURE_PUBLIC_CLOUD``. :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_onlyr|s r"rzzSettings.__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. rr|s r" defaults_onlyzSettings.defaults_onlys"""r!c||_yrcrrs 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.rjrw_config)rtkvpropss 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 )rrconfigr|s 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.rjupdater)rtkwargsrrrs r"rzSettings.configs`'+nn&=&=&C&C&EkFQTUWiIjACkk V||E""ls A0 A0c\t|j}td|}|di|S)NConfigr )listrNr)rtrrNrs r"rzSettings._config!s*uzz|,Hd+r! log_levelAZURE_LOG_LEVEL)rurxrwz(PrioritizedSetting[Union[str, int], int]tracing_enabledAZURE_TRACING_ENABLEDNz4PrioritizedSetting[Optional[Union[str, bool]], bool]r7 AZURE_SDK_TRACING_IMPLEMENTATIONzZPrioritizedSetting[Optional[Union[str, Type[AbstractSpan]]], Optional[Type[AbstractSpan]]] azure_cloudAZURE_SDK_CLOUD_CONFz8PrioritizedSetting[Union[str, AzureClouds], AzureClouds]r)rr/)r3r/rr)rTuple[Any, ...])rr rr)rzMapping[str, Any]rr)rrrrrzrrsetterrrrrrjrJrHr>r__annotations__r:rrhr7rQrAZURE_PUBLIC_CLOUDrr r!r"rrs^@*##$$###$ ;M! ;I7M_'' MOI  2$  M_&#.. MKIr!rr)r3zUnion[str, bool]rr/)r3zOptional[Union[str, bool]]rr/)r3zUnion[str, int]rrC)r3zUnion[str, AzureClouds]rr)rOptional[Type[AbstractSpan]])r3z(Optional[Union[str, Type[AbstractSpan]]]rr)7r __future__r collectionsrenumr functoolsrrHrtypingrrr r r r r rrrrr _azure_cloudsrazure.core.tracingrrr getLoggerrr8__all__rrrdr5r:r;r<r=r>r?rErJrQrWr]r`rrhrjrrr r!r"rs74""     '/)* K '  H % #T I4@  ]] LL ]]  %PG,  "',WS !!Hu!:;upzzzZ(r!