6i,FUdZddlmZddlmZddlmZddlmZddl Z ddl Z ddl m Z m Z mZmZmZmZmZmZmZmZmZmZdd lmZerdd lmZed Zed Zd ZGddeZej@Z!d dZ"d!dZ#e jHe jJe jLe jNe jPdZ)d"dZ*d#dZ+d$dZ,d$dZ-e,e-dZ.de/d<ed%dZ0GddeeefZ1GddZ2e2Z3de/d<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__tokenV/home/azureuser/techstart-app/venv/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_boolr5DsM % ++-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_implementationr5)r3s r"convert_tracing_enabledr8^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_levelsgetr1r2join)r3r4levels r"convert_loggingrFys]&% ++-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.rstrnamer1r2rDkeys)r3cloud azure_cloudss r"convert_azure_cloudrMs%% %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_spanrP ImportErrorrOs r"_get_opencensus_spanrSs&     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_spanrWrRrVs r"_get_opentelemetry_spanrYs&  ! rT) 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)_unsetr r!r"z&convert_tracing_impl..sr!z7Cannot convert {} to AbstractSpan, valid values are: {}r?) r.rHr0r\rCr`r1r2rD)r3get_wrapper_class wrapper_classs r"convert_tracing_implrds{  } 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"raz-PrioritizedSetting.__init__..(sqr!)_name_env_var _system_hook_default_convertr` _user_value)selfrIenv_var system_hookdefaultconvert noop_converts r"__init__zPrioritizedSetting.__init__s:  ' -8 V]7co :@r!c d|jzS)NzPrioritizedSetting(%r))rjrps 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) rnr.rorrkosenvironrlrm RuntimeErrorrjrpr3s r"__call__zPrioritizedSetting.__call__/s  ==' '$**F3==!1!12 2 ==T]]bjj8==DMM!:; ;   ==!2!2!45 5$--0==/ /E RSSr!c|Sr_r )rpinstanceowners r"__get__zPrioritizedSetting.__get__Os r!c&|j|yr_) set_value)rprr3s r"__set__zPrioritizedSetting.__set__Rs 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)ror~s r"rzPrioritizedSetting.set_valueUs !r!ct|_y)z>Unset the previous user value such that the priority is reset.N)r`rorxs r" unset_valuezPrioritizedSetting.unset_value`s !r!c|jSr_)rkrxs r"rqzPrioritizedSetting.env_vard }}r!c|jSr_)rmrxs r"rszPrioritizedSetting.defaulthrr!) rIrHrq Optional[str]rrz&Optional[Callable[[], ValidInputType]]rsUnion[ValidInputType, _Unset]rtz;Optional[Callable[[Union[ValidInputType, str]], ValueType]])returnrHr_)r3zOptional[ValidInputType]rr)rr rz Optional[Any]rz-PrioritizedSetting[ValidInputType, ValueType])rr r3rrNone)r3rrrrr)rr)rr)rrr__doc__r`rvryrrrrrpropertyrqrsr r!r"rfrfs#P"&>B17OS AAA< A / A M A"5T@ !"r!rfc6eZdZUdZddZeddZejddZeddZeddZ 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_onlyrxs r"rvzSettings.__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. rrxs 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.rfrs_config)rpkvpropss 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 )rrconfigrxs 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.rfupdater)rpkwargsrrrs r"rzSettings.configs`'+nn&=&=&C&C&EkFQTUWiIjACkk V||E""ls A0 A0c\t|j}td|}|di|S)NConfigr )listrJr)rprrJrs r"rzSettings._configs*uzz|,Hd+r! log_levelAZURE_LOG_LEVEL)rqrtrsz(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_cloud AZURE_CLOUDz8PrioritizedSetting[Union[str, AzureClouds], AzureClouds]r)rr/)r3r/rr)rTuple[Any, ...])rr rr)rzMapping[str, Any]rr)rrrrrvrrsetterrrrrrfrFloggingr<r__annotations__r8rrdr7rMrAZURE_PUBLIC_CLOUDrr r!r"rrmsL\*##$$###$ ;M! ;I7M_'' MOI  2$  M_#.. MKIr!rr)r3zUnion[str, bool]rr/)r3zOptional[Union[str, bool]]rr/)r3zUnion[str, int]rr@)r3zUnion[str, AzureClouds]rr)rOptional[Type[AbstractSpan]])r3z(Optional[Union[str, Type[AbstractSpan]]]rr)4r __future__r collectionsrenumr functoolsrrr{typingrrr r r r r rrrrr _azure_cloudsrazure.core.tracingrrr__all__rrr`r5r8r9r:r;r<r=rBrFrMrSrYr\rrdrfrrr r!r"rs#4""     '/)* K  #T I4&  ]] LL ]]  <G,  "',WS Bu!:;uphhVZ(r!