h9EUdZddlmZddlmZddlmZddlZddlZddl Z ddl m Z m Z m Z mZmZmZmZmZmZmZmZddlmZdd lmZed Zed Zd ZGd deZej<Zd dZ ejBejDejFejHejJdZ&d!dZ'd"dZ(d#dZ)d#dZ*d#dZ+d#dZ,e)e*dZ-de.d<d$dZ/GddeeefZ0GddZ1e1Z2de.d<y)%zIProvide access to settings for globally used Azure configuration values. ) annotations) namedtuple)EnumN) TypeOptionalCallableUnionDictAnyTypeVarTupleGenericMappingList) AbstractSpan) AzureCloudsValidInputType ValueType)settingsSettingsceZdZdZy)_UnsetrN)__name__ __module__ __qualname__tokenM/var/www/html/engine/venv/lib/python3.12/site-packages/azure/core/settings.pyrr:s Errct|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_boolr3AsM % ++-C 00 22 9@@G HHr)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_levelsgetr/r0join)r1r2levels r convert_loggingrAds]&% ++-C KK E OVVW\^b^g^gho^pqrr Lrc 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,rstrnamer/r0r?keys)r1cloud azure_cloudss r convert_azure_cloudrHs%% %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_spanrK ImportErrorrJs r _get_opencensus_spanrNs&     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_spanrRrMrQs r _get_opentelemetry_spanrTs&  ! rOc<dtjvrytS)N opencensus)sysmodulesrNrrr ._get_opencensus_span_if_opencensus_is_importedrYs3;;&  !!rc<dtjvrytS)N opentelemetry)rWrXrTrrr 4_get_opentelemetry_span_if_opentelemetry_is_importedr\sckk) " $$r)rVr[z5Dict[str, Callable[[], Optional[Type[AbstractSpan]]]]_tracing_implementation_dictc"|txs tSt|ts|S|j }t j |d}|}|tur.tdj|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 ctSN)_unsetrrr z&convert_tracing_impl..srz7Cannot convert {} to AbstractSpan, valid values are: {}r:) r\rYr,rCr.r]r>rar/r0r?)r1get_wrapper_class wrapper_classs r convert_tracing_implres } @ B vFtFv  eS ! KKME488OARATM E L Ltyy!=>   rceZdZdZddedf 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 rbz-PrioritizedSetting.__init__.. sqr)_name_env_var _system_hook_default_convertra _user_value)selfrDenv_var system_hookdefaultconvert noop_converts r __init__zPrioritizedSetting.__init__s:  ' -8 V]7co :@rc d|jzS)NzPrioritizedSetting(%r))rkrqs r __repr__zPrioritizedSetting.__repr__$s'$**44rc*||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) ror,rprrlosenvironrmrn RuntimeErrorrkrqr1s r __call__zPrioritizedSetting.__call__'s  ==' '$**F3==!1!12 2 ==T]]bjj8==DMM!:; ;   ==!2!2!45 5$--0==/ /E RSSrc|Sr`r)rqinstanceowners r __get__zPrioritizedSetting.__get__Gs rc&|j|yr`) set_value)rqrr1s r __set__zPrioritizedSetting.__set__Js urc||_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)rprs r rzPrioritizedSetting.set_valueMs !rct|_y)z>Unset the previous user value such that the priority is reset.N)rarprys r unset_valuezPrioritizedSetting.unset_valueXs !rc|jSr`)rlrys r rrzPrioritizedSetting.env_var\ }}rc|jSr`)rnrys r rtzPrioritizedSetting.default`rr) rDrCrr Optional[str]rsz&Optional[Callable[[], ValidInputType]]rtUnion[ValidInputType, _Unset]ruz;Optional[Callable[[Union[ValidInputType, str]], ValueType]])returnrCr`)r1zOptional[ValidInputType]rr)rr rz Optional[Any]rz-PrioritizedSetting[ValidInputType, ValueType])rr r1rrNone)r1rrrrr)rr)rr)rrr__doc__rarwrzrrrrrpropertyrrrtrrr rgrgs#P"&>B17OS AAA< A / A M A"5T@ !"rrgc6eZdZUdZddZeddZejddZeddZeddZ 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_onlyrys r rwzSettings.__init__s $)rc|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. rrys r defaults_onlyzSettings.defaults_onlys"""rc||_yr`rrs r rzSettings.defaults_onlys #rc|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,rgrt_config)rqkvpropss 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 )rrconfigrys r currentzSettings.currents#   == {{}rc |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,rgupdater)rqkwargsrrrs r rzSettings.configs`'+nn&=&=&C&C&EkFQTUWiIjACkk V||E""ls A0 A0c\t|j}td|}|di|S)NConfigr)listrEr)rqrrErs r rzSettings._configs*uzz|,Hd+r log_levelAZURE_LOG_LEVEL)rrrurtz(PrioritizedSetting[Union[str, int], int]tracing_enabledAZURE_TRACING_ENABLEDFz*PrioritizedSetting[Union[str, bool], bool]tracing_implementation AZURE_SDK_TRACING_IMPLEMENTATIONNzZPrioritizedSetting[Optional[Union[str, Type[AbstractSpan]]], Optional[Type[AbstractSpan]]] azure_cloud AZURE_CLOUDz8PrioritizedSetting[Union[str, AzureClouds], AzureClouds]r)rr-)r1r-rr)rTuple[Any, ...])rr rr)rzMapping[str, Any]rr)rrrrrwrrsetterrrrrrgrAloggingr7r__annotations__r3rrerrHrAZURE_PUBLIC_CLOUDrrrr rresL\*##$$###$ ;M! ;I7CU' CO?  2$  M_#.. MKIrrr)r1zUnion[str, bool]rr-)r1zUnion[str, int]rr;)r1zUnion[str, AzureClouds]rr)rOptional[Type[AbstractSpan]])r1z(Optional[Union[str, Type[AbstractSpan]]]rr)3r __future__r collectionsrenumrrr|rWtypingrrrr r r r r rrrazure.core.tracingr _azure_cloudsrrr__all__rrrar3r4r5r6r7r8r=rArHrNrTrYr\r]rrergrrrrr rs4""     ,&)* K  #T I6  ]] LL ]]  <G,   " %',WS Fu!:;uphhVZ(r