py2docfx 0.1.21rc2249766__py3-none-any.whl → 0.1.22__py3-none-any.whl

py2docfx/convert_prepare/generate_conf.py

@@ -35,7 +35,14 @@ def generate_conf(package: PackageInfo, output: str, template_dir: str):
     extension_config = []
     if hasattr(package, "extension_config"):
         for key, value in package.extension_config.items():
-            extension_config.append(" = ".join([key, json.dumps(value)]))
+            # Convert JSON boolean strings to Python boolean string representations
+            if value == True:
+                formatted_value = "True"
+            elif value == False:
+                formatted_value = "False"
+            else:
+                formatted_value = json.dumps(value)
+            extension_config.append(" = ".join([key, formatted_value]))
         params["EXTENSION_CONFIG"] = "\n".join(extension_config)
 
     # Write the final conf.py file.

py2docfx/docfx_yaml/process_doctree.py

@@ -12,16 +12,8 @@ from utils import transform_string
 from enum import EnumMeta
 from importlib import import_module
 from logger import get_package_logger
+from type_mapping import map_type_transformations, PACKAGE, METHOD, FUNCTION, DATA, MODULE, CLASS, EXCEPTION, ATTRIBUTE, PROPERTY, PYDANTIC_MODEL, PYDANTIC_FIELD, PYDANTIC_SETTINGS, PYDANTIC_VALIDATOR, PYDANTIC_CONFIG
 
-PACKAGE = 'package'
-METHOD = 'method'
-FUNCTION = 'function'
-DATA = 'data'
-MODULE = 'module'
-CLASS = 'class'
-EXCEPTION = 'exception'
-ATTRIBUTE = 'attribute'
-PROPERTY = 'property'
 REFMETHOD = 'meth'
 REFFUNCTION = 'func'
 REF_PATTERN = ':(py:)?(func|class|meth|mod|ref):`~?[a-zA-Z_\.<> ]*?`'
@@ -151,10 +143,10 @@ def getpositionalOnlyParameters(signature):
                 except KeyError:
                     # if the default value is not available, set it to inspect._empty
                     default_value = "<class 'inspect._empty'>"
-                
+
                 if default_value != "<class 'inspect._empty'>":
                     positional_only_param[count]['defaultValue'] = default_value
-                
+
                 count += 1
     return positional_only_param
 
@@ -180,7 +172,7 @@ def _create_datam(app, cls, module, name, _type, obj, lines=None):
     positional_only_params = []
     try:
         if _type in [CLASS, METHOD, FUNCTION]:
-            if not (_type  == CLASS and isinstance(type(obj).__call__, type(EnumMeta.__call__))):       
+            if not (_type  == CLASS and isinstance(type(obj).__call__, type(EnumMeta.__call__))):
                 signature = inspect.signature(obj)
                 args = getParameterArgs(signature)
                 keyword_only_args = getKeywordOnlyParameters(signature)
@@ -329,10 +321,10 @@ def insert_children_on_package(app, _type, datam):
     if datam[MODULE] not in app.env.docfx_yaml_packages:
         return
     insert_package = app.env.docfx_yaml_packages[datam[MODULE]]
-    
+
     for obj in insert_package:
         if obj['type'] == PACKAGE and obj['uid'] == datam[MODULE]:
-            if _type in [CLASS, EXCEPTION]:               
+            if _type in [CLASS, EXCEPTION]:
                 obj['children'].append(datam['uid'])
                 break
             if _type in [FUNCTION, DATA]:
@@ -388,11 +380,8 @@ def process_docstring(app, _type, name, obj, options, lines):
                 return PACKAGE
         return _type
 
-    if _type == EXCEPTION:
-        _type = CLASS
-
-    if _type == PROPERTY:
-        _type = ATTRIBUTE
+    # Apply type transformations using shared mapping function
+    _type = map_type_transformations(_type)
 
     _type = check_convert_package_type(obj, _type)
     cls, module = _get_cls_module(_type, name)
@@ -451,4 +440,4 @@ def process_docstring(app, _type, name, obj, options, lines):
     insert_children_on_class(app, _type, datam)
     insert_children_on_function(app, _type, datam)
 
-    app.env.docfx_info_uid_types[datam['uid']] = _type
+    app.env.docfx_info_uid_types[datam['uid']] = _type

py2docfx/docfx_yaml/translator.py

@@ -15,16 +15,15 @@ from sphinx.util.docfields import _is_single_paragraph
 from collections import OrderedDict
 from nodes import remarks
 from logger import get_package_logger
+from type_mapping import (
+    translator_type_mapping, CLASS_TYPE, EXCEPTION_TYPE, ATTRIBUTE_TYPE,
+    PYDANTIC_MODEL_TYPE, PYDANTIC_SETTINGS_TYPE, PYDANTIC_FIELD_TYPE, PYDANTIC_CONFIG_TYPE,
+    types_contain_constructor, types_contain_attributes, attribute_types
+)
 
 TYPE_SEP_PATTERN = '(\[|\]|, |\(|\))'
 PARAMETER_NAME = "[*][*](.*?)[*][*]"
 PARAMETER_TYPE = "[(]((?:.|\n)*)[)]"
-CLASS_TYPE = 'class'
-EXCEPTION_TYPE = 'exception'
-ATTRIBUTE_TYPE = 'attribute'
-
-types_contain_constructor = {CLASS_TYPE, EXCEPTION_TYPE}
-types_contain_attributes = {CLASS_TYPE, EXCEPTION_TYPE}
 
 def translator(app, docname, doctree):
 
@@ -45,15 +44,6 @@ def translator(app, docname, doctree):
         else:
             return para_field.astext()
 
-    def type_mapping(type_name):
-        mapping = {
-            "staticmethod": "method",
-            "classmethod": "method",
-            "exception": "class",
-        }
-
-        return mapping[type_name] if type_name in mapping else type_name
-
     def _get_uid_and_type_from_desc(node):
         assert node.tagname == 'desc'
         if node.attributes['domain'] != 'py':
@@ -78,7 +68,7 @@ def translator(app, docname, doctree):
             return True
 
         return False
-    
+
     def extract_exception_desc(exception_fieldbody_node):
         def extract_exception_type(exception_node):
             _type_without_xref = transform_node(exception_node).strip(" \n\r\t")
@@ -90,7 +80,7 @@ def translator(app, docname, doctree):
             else:
                 exception_type = _type_without_xref
             return exception_type
-            
+
         extractedExceptions = []
         for pararaph_node in exception_fieldbody_node.traverse(nodes.paragraph):
             for exception_node in pararaph_node:
@@ -148,8 +138,8 @@ def translator(app, docname, doctree):
             if fieldtype == 'Raises':
                 if data['exceptions']:
                     data['exceptions'].extend(extract_exception_desc(fieldbody))
-                else:    
-                    data['exceptions'] = extract_exception_desc(fieldbody)   
+                else:
+                    data['exceptions'] = extract_exception_desc(fieldbody)
 
             if fieldtype == 'Returns':
                 returnvalue_ret = transform_node(content[0])
@@ -239,14 +229,14 @@ def translator(app, docname, doctree):
         signature_child = extract_sig_child_from_attribute_desc_node(node)
         content_child = extract_content_child_from_attribute_desc_node(node)
         curuid = signature_child.get('module', '') + '.' + signature_child.get('fullname', '')
-        addedData = {}                
+        addedData = {}
         name = signature_child.children[0].astext()
-        if isinstance(signature_child, desc_signature) and any(isinstance(n, addnodes.desc_annotation) for n in signature_child):                
-            signature_child_ids = signature_child.get('ids', [''])                
-            
+        if isinstance(signature_child, desc_signature) and any(isinstance(n, addnodes.desc_annotation) for n in signature_child):
+            signature_child_ids = signature_child.get('ids', [''])
+
             if len(curuid) > 0:
                 parent = curuid[:curuid.rfind('.')]
-                
+
                 if curuid in attribute_map:
                     # ensure the order of docstring attributes and real attributes is fixed
                     if len(signature_child_ids) == 0:
@@ -254,7 +244,7 @@ def translator(app, docname, doctree):
                             ' ' + signature_child.astext())
                         # concat the description of duplicated nodes
                     else:
-                        attribute_map[curuid]['syntax']['content'] = signature_child.astext() 
+                        attribute_map[curuid]['syntax']['content'] = signature_child.astext()
                         + ' ' + attribute_map[curuid]['syntax']['content']
                 else:
                     ancestor_class_content_node = find_ancestor_class_content_node(signature_child['class'], signature_child['module'], signature_child['ids'], class_nodes)
@@ -292,14 +282,14 @@ def translator(app, docname, doctree):
                 raise Exception('ids of node: ' + repr(signature_child) + ' is missing.')
                  # no ids and no duplicate or uid can not be generated.
 
-        # Currently only utilize summary to avoid code repetition, 
-        # if we need to change other attribute generator logic, 
+        # Currently only utilize summary to avoid code repetition,
+        # if we need to change other attribute generator logic,
         # better to get from extracted_content_data below too
-        
+
         extracted_content_data = extract_content(content_child, ATTRIBUTE_TYPE, module_name)
         if not addedData:
             # If current attribute doesn't have correct signature child, fill in basic information
-            # TODO: append fullName here, currently when fallback to here, 
+            # TODO: append fullName here, currently when fallback to here,
             # information like fullname, name of attribute comes from process_docstring
             addedData = {
                 'uid': curuid,
@@ -351,9 +341,9 @@ def translator(app, docname, doctree):
                 if (first_child.astext().strip(" \n\r\t") == 'property'):
                     return None # Don't generate signature for property
                 elif (first_child.astext().strip(" \n\r\t") in annotation_to_skip):
-                    # Don't include 'class' declaration for constructors, 
+                    # Don't include 'class' declaration for constructors,
                     # don't include 'classmethod' front of signature (To keep behavior consistent)
-                    included_child_start = 1 
+                    included_child_start = 1
                     isClass = True
             for included_child in node.children[included_child_start:]:
                 # Skip class name when write signature (To keep same behavior as before signature async support)
@@ -416,15 +406,15 @@ def translator(app, docname, doctree):
                     # Because summary can contain code examples,
                     # need to allow summary line to contain punctuation ony
                     if len(content) > 0:
-                        summary.append(content) 
-        
+                        summary.append(content)
+
         if "desctype" in node.parent and node.parent["desctype"] == CLASS_TYPE:
             # Make sure class doesn't have 'exceptions' field.
             data.pop('exceptions', '')
 
         if summary:
             data['summary'] = '\n\n'.join(summary)
-        
+
         return data
 
 
@@ -434,24 +424,24 @@ def translator(app, docname, doctree):
             if (desc_node['desctype'] in types_contain_attributes):
                 class_nodes.append(desc_node)
         return class_nodes
-    
+
     class_nodes = extract_class_nodes_from_doctree(doctree)
     class_added_attributes = {}
     class_data = {}
-    for node in doctree.traverse(addnodes.desc):   
+    for node in doctree.traverse(addnodes.desc):
         (uid, module_name, node_type) = _get_uid_and_type_from_desc(node)
         data = {}
         signature_child = node.children[node.first_child_matching_class(addnodes.desc_signature)]
         content_child = node.children[node.first_child_matching_class(addnodes.desc_content)]
-        if node_type == ATTRIBUTE_TYPE:
+        if node_type in attribute_types:
             attribute_sig_child = extract_sig_child_from_attribute_desc_node(node)
 
             if content_child.astext().startswith('alias of'):
                 # Ignore alias attribute
-                # e.g. azure.cognitiveservices.speech.intent.IntentRecognizer.IntentsIte (alias of Iterable[Tuple[Union[str, azure.cognitiveservices.speech.intent.LanguageUnderstandingModel], str]]) 
+                # e.g. azure.cognitiveservices.speech.intent.IntentRecognizer.IntentsIte (alias of Iterable[Tuple[Union[str, azure.cognitiveservices.speech.intent.LanguageUnderstandingModel], str]])
                 continue
 
-            if attribute_sig_child['class']: 
+            if attribute_sig_child['class']:
                 attribute_class = attribute_sig_child['module'] + '.' + attribute_sig_child['class']
                 class_added_attributes.setdefault(attribute_class, OrderedDict())
                 # TODO: Merge attribute_data if same uid
@@ -470,19 +460,19 @@ def translator(app, docname, doctree):
             else:
                 raise Exception('Attribute doesn\'t have class information. Attribute_name: {0}'.format(attribute_sig_child['fullname']))
             continue
-        
+
         data.update(extract_content(content_child, node_type, module_name))
         data['content'] = extract_signature(signature_child)
 
-        data['type'] = type_mapping(node_type) if node_type else 'unknown'
+        data['type'] = translator_type_mapping(node_type) if node_type else 'unknown'
         if _is_property_node(signature_child):
             data['type'] = ATTRIBUTE_TYPE
-        
+
         # Don't include empty data
         for key, val in data.copy().items():
             if not val:
                 del data[key]
-        
+
         if uid in app.env.docfx_info_field_data:
             # Sphinx autodoc already provides method signature, skip declaration in RST comments (py:class/py:method)
             sig_id = signature_child.get('ids', [''])[0].lower()
@@ -502,7 +492,7 @@ def translator(app, docname, doctree):
     for class_name, added_attributes in class_added_attributes.items():
         if not added_attributes:
             # `class_added_attributes` Maybe be in default value []
-            # Indicates that all doctree attribute desc nodes under this class 
+            # Indicates that all doctree attribute desc nodes under this class
             # are skipped attributes/properties (like alias)
             continue
 

py2docfx/docfx_yaml/type_mapping.py

@@ -0,0 +1,102 @@
+# -*- coding: utf-8 -*-
+#
+# ---------------------------------------------------------
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# ---------------------------------------------------------
+
+"""
+Type mapping utilities for converting various documentation types to standardized forms.
+"""
+
+# Standard types
+PACKAGE = 'package'
+METHOD = 'method'
+FUNCTION = 'function'
+DATA = 'data'
+MODULE = 'module'
+CLASS = 'class'
+EXCEPTION = 'exception'
+ATTRIBUTE = 'attribute'
+PROPERTY = 'property'
+
+# Pydantic specific types
+PYDANTIC_MODEL = 'pydantic_model'
+PYDANTIC_FIELD = 'pydantic_field'
+PYDANTIC_SETTINGS = 'pydantic_settings'
+PYDANTIC_VALIDATOR = 'pydantic_validator'
+PYDANTIC_CONFIG = 'pydantic_config'
+
+# Translator-style constants (for compatibility)
+CLASS_TYPE = 'class'
+EXCEPTION_TYPE = 'exception'
+ATTRIBUTE_TYPE = 'attribute'
+PYDANTIC_MODEL_TYPE = "pydantic_model"
+PYDANTIC_SETTINGS_TYPE = "pydantic_settings"
+PYDANTIC_FIELD_TYPE = "pydantic_field"
+PYDANTIC_CONFIG_TYPE = "pydantic_config"
+
+# Type groupings for translator functionality
+types_contain_constructor = {
+    CLASS_TYPE,
+    PYDANTIC_MODEL_TYPE,
+    PYDANTIC_SETTINGS_TYPE,
+    EXCEPTION_TYPE,
+    PYDANTIC_CONFIG_TYPE,
+}
+
+types_contain_attributes = {
+    CLASS_TYPE,
+    PYDANTIC_MODEL_TYPE,
+    PYDANTIC_SETTINGS_TYPE,
+    EXCEPTION_TYPE,
+    PYDANTIC_CONFIG_TYPE,
+}
+
+attribute_types = {PYDANTIC_FIELD_TYPE, ATTRIBUTE_TYPE}
+
+
+def map_type_transformations(type_name):
+    """
+    Apply type transformations to convert various documentation types to standardized forms.
+    Used by process_doctree.py for initial type processing.
+    
+    Args:
+        type_name (str): The original type name
+        
+    Returns:
+        str: The transformed type name
+    """
+    # Type transformations
+    if type_name == EXCEPTION or type_name in {PYDANTIC_MODEL, PYDANTIC_SETTINGS, PYDANTIC_CONFIG}:
+        return CLASS
+    elif type_name == PROPERTY or type_name == PYDANTIC_FIELD:
+        return ATTRIBUTE
+    elif type_name == PYDANTIC_VALIDATOR:
+        return METHOD
+    
+    # Return original type if no transformation needed
+    return type_name
+
+
+def translator_type_mapping(type_name):
+    """
+    Apply type mapping transformations for translator processing.
+    Used by translator.py for docstring processing.
+    Includes both original translator mappings and process_doctree transformations.
+    
+    Args:
+        type_name (str): The original type name
+        
+    Returns:
+        str: The mapped type name
+    """
+    # First apply the process_doctree style transformations
+    transformed_type = map_type_transformations(type_name)
+    
+    # Then apply the original translator mappings
+    mapping = {
+        "staticmethod": "method",
+        "classmethod": "method",
+    }
+
+    return mapping[transformed_type] if transformed_type in mapping else transformed_type

py2docfx/venv/basevenv/Lib/site-packages/certifi/__init__.py

@@ -1,4 +1,4 @@
 from .core import contents, where
 
 __all__ = ["contents", "where"]
-__version__ = "2025.08.03"
+__version__ = "2025.10.05"

py2docfx/venv/basevenv/Lib/site-packages/markupsafe/__init__.py

@@ -214,14 +214,14 @@ class Markup(str):
             if (end := value.find("-->", start)) == -1:
                 break
 
-            value = f"{value[:start]}{value[end + 3:]}"
+            value = f"{value[:start]}{value[end + 3 :]}"
 
         # remove tags using the same method
         while (start := value.find("<")) != -1:
             if (end := value.find(">", start)) == -1:
                 break
 
-            value = f"{value[:start]}{value[end + 1:]}"
+            value = f"{value[:start]}{value[end + 1 :]}"
 
         # collapse spaces
         value = " ".join(value.split())
@@ -388,6 +388,7 @@ def __getattr__(name: str) -> t.Any:
             "The '__version__' attribute is deprecated and will be removed in"
             " MarkupSafe 3.1. Use feature detection, or"
             ' `importlib.metadata.version("markupsafe")`, instead.',
+            DeprecationWarning,
             stacklevel=2,
         )
         return importlib.metadata.version("markupsafe")

py2docfx/venv/basevenv/Lib/site-packages/yaml/__init__.py

@@ -8,7 +8,7 @@ from .nodes import *
 from .loader import *
 from .dumper import *
 
-__version__ = '6.0.2'
+__version__ = '6.0.3'
 try:
     from .cyaml import *
     __with_libyaml__ = True

py2docfx/venv/venv1/Lib/site-packages/azure/identity/_credentials/default.py

@@ -172,7 +172,8 @@ class DefaultAzureCredential(ChainedTokenCredential):
 
         process_timeout = kwargs.pop("process_timeout", 10)
         require_envvar = kwargs.pop("require_envvar", False)
-        if require_envvar and not os.environ.get(EnvironmentVariables.AZURE_TOKEN_CREDENTIALS):
+        token_credentials_env = os.environ.get(EnvironmentVariables.AZURE_TOKEN_CREDENTIALS, "").strip().lower()
+        if require_envvar and not token_credentials_env:
             raise ValueError(
                 "AZURE_TOKEN_CREDENTIALS environment variable is required but is not set or is empty. "
                 "Set it to 'dev', 'prod', or a specific credential name."
@@ -274,18 +275,16 @@ class DefaultAzureCredential(ChainedTokenCredential):
                 ManagedIdentityCredential(
                     client_id=managed_identity_client_id,
                     _exclude_workload_identity_credential=exclude_workload_identity_credential,
+                    _enable_imds_probe=token_credentials_env != "managedidentitycredential",
                     **kwargs,
                 )
             )
         if not exclude_shared_token_cache_credential and SharedTokenCacheCredential.supported():
-            try:
-                # username and/or tenant_id are only required when the cache contains tokens for multiple identities
-                shared_cache = SharedTokenCacheCredential(
-                    username=shared_cache_username, tenant_id=shared_cache_tenant_id, authority=authority, **kwargs
-                )
-                credentials.append(shared_cache)
-            except Exception as ex:  # pylint:disable=broad-except
-                _LOGGER.info("Shared token cache is unavailable: '%s'", ex)
+            # username and/or tenant_id are only required when the cache contains tokens for multiple identities
+            shared_cache = SharedTokenCacheCredential(
+                username=shared_cache_username, tenant_id=shared_cache_tenant_id, authority=authority, **kwargs
+            )
+            credentials.append(shared_cache)
         if not exclude_visual_studio_code_credential:
             credentials.append(VisualStudioCodeCredential(tenant_id=vscode_tenant_id))
         if not exclude_cli_credential:

py2docfx/venv/venv1/Lib/site-packages/azure/identity/_credentials/imds.py

@@ -82,6 +82,10 @@ def _check_forbidden_response(ex: HttpResponseError) -> None:
 
 class ImdsCredential(MsalManagedIdentityClient):
     def __init__(self, **kwargs: Any) -> None:
+        # If set to True/False, _enable_imds_probe forces whether or not the credential
+        # probes for the IMDS endpoint before attempting to get a token. If None (the default),
+        # the credential probes only if it's part of a ChainedTokenCredential chain.
+        self._enable_imds_probe = kwargs.pop("_enable_imds_probe", None)
         super().__init__(retry_policy_class=ImdsRetryPolicy, **dict(PIPELINE_SETTINGS, **kwargs))
         self._config = kwargs
 
@@ -102,9 +106,9 @@ class ImdsCredential(MsalManagedIdentityClient):
 
     def _request_token(self, *scopes: str, **kwargs: Any) -> AccessTokenInfo:
 
-        if within_credential_chain.get() and not self._endpoint_available:
-            # If within a chain (e.g. DefaultAzureCredential), we do a quick check to see if the IMDS endpoint
-            # is available to avoid hanging for a long time if the endpoint isn't available.
+        do_probe = self._enable_imds_probe if self._enable_imds_probe is not None else within_credential_chain.get()
+        if do_probe and not self._endpoint_available:
+            # Probe to see if the IMDS endpoint is available to avoid hanging for a long time if it's not.
             try:
                 client = ManagedIdentityClient(_get_request, **dict(PIPELINE_SETTINGS, **self._config))
                 client.request_token(*scopes, connection_timeout=1, retry_total=0)

py2docfx/venv/venv1/Lib/site-packages/azure/identity/_credentials/managed_identity.py

@@ -76,6 +76,7 @@ class ManagedIdentityCredential:
         user_identity_info = validate_identity_config(client_id, identity_config)
         self._credential: Optional[SupportsTokenInfo] = None
         exclude_workload_identity = kwargs.pop("_exclude_workload_identity_credential", False)
+        self._enable_imds_probe = kwargs.pop("_enable_imds_probe", None)
         managed_identity_type = None
 
         if os.environ.get(EnvironmentVariables.IDENTITY_ENDPOINT):
@@ -136,7 +137,12 @@ class ManagedIdentityCredential:
             managed_identity_type = "IMDS"
             from .imds import ImdsCredential
 
-            self._credential = ImdsCredential(client_id=client_id, identity_config=identity_config, **kwargs)
+            self._credential = ImdsCredential(
+                client_id=client_id,
+                identity_config=identity_config,
+                _enable_imds_probe=self._enable_imds_probe,
+                **kwargs,
+            )
 
         if managed_identity_type:
             log_msg = f"{self.__class__.__name__} will use {managed_identity_type}"

py2docfx/venv/venv1/Lib/site-packages/azure/identity/_credentials/shared_cache.py

@@ -198,9 +198,9 @@ class _SharedTokenCacheCredential(SharedTokenCacheBase):
                 return token
             except Exception as e:  # pylint: disable=broad-except
                 if within_dac.get():
-                    raise CredentialUnavailableError(  # pylint: disable=raise-missing-from
+                    raise CredentialUnavailableError(
                         message=getattr(e, "message", str(e)), response=getattr(e, "response", None)
-                    )
+                    ) from e
                 raise
 
         raise CredentialUnavailableError(message=NO_TOKEN.format(account.get("username")))

py2docfx/venv/venv1/Lib/site-packages/azure/identity/_internal/interactive.py

@@ -203,7 +203,7 @@ class InteractiveCredential(MsalCredential, ABC):
             return token
         except Exception as ex:  # pylint:disable=broad-except
             if not (isinstance(ex, AuthenticationRequiredError) and allow_prompt):
-                _LOGGER.warning(
+                _LOGGER.warning(  # pylint: disable=do-not-log-raised-errors
                     "%s.%s failed: %s",
                     self.__class__.__name__,
                     base_method_name,
@@ -225,7 +225,7 @@ class InteractiveCredential(MsalCredential, ABC):
             # this may be the first authentication, or the user may have authenticated a different identity
             self._auth_record = _build_auth_record(result)
         except Exception as ex:
-            _LOGGER.warning(
+            _LOGGER.warning(  # pylint: disable=do-not-log-raised-errors
                 "%s.%s failed: %s",
                 self.__class__.__name__,
                 base_method_name,

py2docfx/venv/venv1/Lib/site-packages/azure/identity/_internal/msal_managed_identity_client.py

@@ -61,7 +61,7 @@ class MsalManagedIdentityClient(abc.ABC):  # pylint:disable=client-accepts-api-v
             )
         error_desc = ""
         if result and "error" in result:
-            error_desc = cast(str, result["error"])
+            error_desc = f"Token request error: ({result['error']}) {result.get('error_description', '')}"
         error_message = self.get_unavailable_message(error_desc)
         raise CredentialUnavailableError(error_message)
 

py2docfx/venv/venv1/Lib/site-packages/azure/identity/_version.py

@@ -2,4 +2,4 @@
 # Copyright (c) Microsoft Corporation.
 # Licensed under the MIT License.
 # ------------------------------------
-VERSION = "1.25.0"
+VERSION = "1.25.1"

py2docfx/venv/venv1/Lib/site-packages/azure/identity/aio/_credentials/default.py

@@ -144,7 +144,8 @@ class DefaultAzureCredential(ChainedTokenCredential):
 
         process_timeout = kwargs.pop("process_timeout", 10)
         require_envvar = kwargs.pop("require_envvar", False)
-        if require_envvar and not os.environ.get(EnvironmentVariables.AZURE_TOKEN_CREDENTIALS):
+        token_credentials_env = os.environ.get(EnvironmentVariables.AZURE_TOKEN_CREDENTIALS, "").strip().lower()
+        if require_envvar and not token_credentials_env:
             raise ValueError(
                 "AZURE_TOKEN_CREDENTIALS environment variable is required but is not set or is empty. "
                 "Set it to 'dev', 'prod', or a specific credential name."
@@ -235,18 +236,16 @@ class DefaultAzureCredential(ChainedTokenCredential):
                 ManagedIdentityCredential(
                     client_id=managed_identity_client_id,
                     _exclude_workload_identity_credential=exclude_workload_identity_credential,
+                    _enable_imds_probe=token_credentials_env != "managedidentitycredential",
                     **kwargs,
                 )
             )
         if not exclude_shared_token_cache_credential and SharedTokenCacheCredential.supported():
-            try:
-                # username and/or tenant_id are only required when the cache contains tokens for multiple identities
-                shared_cache = SharedTokenCacheCredential(
-                    username=shared_cache_username, tenant_id=shared_cache_tenant_id, authority=authority, **kwargs
-                )
-                credentials.append(shared_cache)
-            except Exception as ex:  # pylint:disable=broad-except
-                _LOGGER.info("Shared token cache is unavailable: '%s'", ex)
+            # username and/or tenant_id are only required when the cache contains tokens for multiple identities
+            shared_cache = SharedTokenCacheCredential(
+                username=shared_cache_username, tenant_id=shared_cache_tenant_id, authority=authority, **kwargs
+            )
+            credentials.append(shared_cache)
         if not exclude_visual_studio_code_credential:
             credentials.append(VisualStudioCodeCredential(tenant_id=vscode_tenant_id))
         if not exclude_cli_credential:

py2docfx/venv/venv1/Lib/site-packages/azure/identity/aio/_credentials/imds.py

@@ -45,6 +45,10 @@ class ImdsCredential(AsyncContextManager, GetTokenMixin):
     def __init__(self, **kwargs: Any) -> None:
         super().__init__()
 
+        # If set to True/False, _enable_imds_probe forces whether or not the credential
+        # probes for the IMDS endpoint before attempting to get a token. If None (the default),
+        # the credential probes only if it's part of a ChainedTokenCredential chain.
+        self._enable_imds_probe = kwargs.pop("_enable_imds_probe", None)
         kwargs["retry_policy_class"] = AsyncImdsRetryPolicy
         self._client = AsyncManagedIdentityClient(_get_request, **dict(PIPELINE_SETTINGS, **kwargs))
         if EnvironmentVariables.AZURE_POD_IDENTITY_AUTHORITY_HOST in os.environ:
@@ -65,9 +69,9 @@ class ImdsCredential(AsyncContextManager, GetTokenMixin):
 
     async def _request_token(self, *scopes: str, **kwargs: Any) -> AccessTokenInfo:
 
-        if within_credential_chain.get() and not self._endpoint_available:
-            # If within a chain (e.g. DefaultAzureCredential), we do a quick check to see if the IMDS endpoint
-            # is available to avoid hanging for a long time if the endpoint isn't available.
+        do_probe = self._enable_imds_probe if self._enable_imds_probe is not None else within_credential_chain.get()
+        if do_probe and not self._endpoint_available:
+            # Probe to see if the IMDS endpoint is available to avoid hanging for a long time if it's not.
             try:
                 await self._client.request_token(*scopes, connection_timeout=1, retry_total=0)
                 self._endpoint_available = True

py2docfx/venv/venv1/Lib/site-packages/azure/identity/aio/_credentials/managed_identity.py

@@ -49,6 +49,7 @@ class ManagedIdentityCredential(AsyncContextManager):
         user_identity_info = validate_identity_config(client_id, identity_config)
         self._credential: Optional[AsyncSupportsTokenInfo] = None
         exclude_workload_identity = kwargs.pop("_exclude_workload_identity_credential", False)
+        self._enable_imds_probe = kwargs.pop("_enable_imds_probe", None)
         managed_identity_type = None
         if os.environ.get(EnvironmentVariables.IDENTITY_ENDPOINT):
             if os.environ.get(EnvironmentVariables.IDENTITY_HEADER):
@@ -108,7 +109,12 @@ class ManagedIdentityCredential(AsyncContextManager):
             managed_identity_type = "IMDS"
             from .imds import ImdsCredential
 
-            self._credential = ImdsCredential(client_id=client_id, identity_config=identity_config, **kwargs)
+            self._credential = ImdsCredential(
+                client_id=client_id,
+                identity_config=identity_config,
+                _enable_imds_probe=self._enable_imds_probe,
+                **kwargs,
+            )
 
         if managed_identity_type:
             log_msg = f"{self.__class__.__name__} will use {managed_identity_type}"