py2docfx 0.1.16rc2051518__py3-none-any.whl → 0.1.17__py3-none-any.whl

py2docfx/venv/basevenv/Lib/site-packages/wheel/vendored/packaging/utils.py

@@ -1,172 +0,0 @@
-# This file is dual licensed under the terms of the Apache License, Version
-# 2.0, and the BSD License. See the LICENSE file in the root of this repository
-# for complete details.
-
-import re
-from typing import FrozenSet, NewType, Tuple, Union, cast
-
-from .tags import Tag, parse_tag
-from .version import InvalidVersion, Version
-
-BuildTag = Union[Tuple[()], Tuple[int, str]]
-NormalizedName = NewType("NormalizedName", str)
-
-
-class InvalidName(ValueError):
-    """
-    An invalid distribution name; users should refer to the packaging user guide.
-    """
-
-
-class InvalidWheelFilename(ValueError):
-    """
-    An invalid wheel filename was found, users should refer to PEP 427.
-    """
-
-
-class InvalidSdistFilename(ValueError):
-    """
-    An invalid sdist filename was found, users should refer to the packaging user guide.
-    """
-
-
-# Core metadata spec for `Name`
-_validate_regex = re.compile(
-    r"^([A-Z0-9]|[A-Z0-9][A-Z0-9._-]*[A-Z0-9])$", re.IGNORECASE
-)
-_canonicalize_regex = re.compile(r"[-_.]+")
-_normalized_regex = re.compile(r"^([a-z0-9]|[a-z0-9]([a-z0-9-](?!--))*[a-z0-9])$")
-# PEP 427: The build number must start with a digit.
-_build_tag_regex = re.compile(r"(\d+)(.*)")
-
-
-def canonicalize_name(name: str, *, validate: bool = False) -> NormalizedName:
-    if validate and not _validate_regex.match(name):
-        raise InvalidName(f"name is invalid: {name!r}")
-    # This is taken from PEP 503.
-    value = _canonicalize_regex.sub("-", name).lower()
-    return cast(NormalizedName, value)
-
-
-def is_normalized_name(name: str) -> bool:
-    return _normalized_regex.match(name) is not None
-
-
-def canonicalize_version(
-    version: Union[Version, str], *, strip_trailing_zero: bool = True
-) -> str:
-    """
-    This is very similar to Version.__str__, but has one subtle difference
-    with the way it handles the release segment.
-    """
-    if isinstance(version, str):
-        try:
-            parsed = Version(version)
-        except InvalidVersion:
-            # Legacy versions cannot be normalized
-            return version
-    else:
-        parsed = version
-
-    parts = []
-
-    # Epoch
-    if parsed.epoch != 0:
-        parts.append(f"{parsed.epoch}!")
-
-    # Release segment
-    release_segment = ".".join(str(x) for x in parsed.release)
-    if strip_trailing_zero:
-        # NB: This strips trailing '.0's to normalize
-        release_segment = re.sub(r"(\.0)+$", "", release_segment)
-    parts.append(release_segment)
-
-    # Pre-release
-    if parsed.pre is not None:
-        parts.append("".join(str(x) for x in parsed.pre))
-
-    # Post-release
-    if parsed.post is not None:
-        parts.append(f".post{parsed.post}")
-
-    # Development release
-    if parsed.dev is not None:
-        parts.append(f".dev{parsed.dev}")
-
-    # Local version segment
-    if parsed.local is not None:
-        parts.append(f"+{parsed.local}")
-
-    return "".join(parts)
-
-
-def parse_wheel_filename(
-    filename: str,
-) -> Tuple[NormalizedName, Version, BuildTag, FrozenSet[Tag]]:
-    if not filename.endswith(".whl"):
-        raise InvalidWheelFilename(
-            f"Invalid wheel filename (extension must be '.whl'): {filename}"
-        )
-
-    filename = filename[:-4]
-    dashes = filename.count("-")
-    if dashes not in (4, 5):
-        raise InvalidWheelFilename(
-            f"Invalid wheel filename (wrong number of parts): {filename}"
-        )
-
-    parts = filename.split("-", dashes - 2)
-    name_part = parts[0]
-    # See PEP 427 for the rules on escaping the project name.
-    if "__" in name_part or re.match(r"^[\w\d._]*$", name_part, re.UNICODE) is None:
-        raise InvalidWheelFilename(f"Invalid project name: {filename}")
-    name = canonicalize_name(name_part)
-
-    try:
-        version = Version(parts[1])
-    except InvalidVersion as e:
-        raise InvalidWheelFilename(
-            f"Invalid wheel filename (invalid version): {filename}"
-        ) from e
-
-    if dashes == 5:
-        build_part = parts[2]
-        build_match = _build_tag_regex.match(build_part)
-        if build_match is None:
-            raise InvalidWheelFilename(
-                f"Invalid build number: {build_part} in '{filename}'"
-            )
-        build = cast(BuildTag, (int(build_match.group(1)), build_match.group(2)))
-    else:
-        build = ()
-    tags = parse_tag(parts[-1])
-    return (name, version, build, tags)
-
-
-def parse_sdist_filename(filename: str) -> Tuple[NormalizedName, Version]:
-    if filename.endswith(".tar.gz"):
-        file_stem = filename[: -len(".tar.gz")]
-    elif filename.endswith(".zip"):
-        file_stem = filename[: -len(".zip")]
-    else:
-        raise InvalidSdistFilename(
-            f"Invalid sdist filename (extension must be '.tar.gz' or '.zip'):"
-            f" {filename}"
-        )
-
-    # We are requiring a PEP 440 version, which cannot contain dashes,
-    # so we split on the last dash.
-    name_part, sep, version_part = file_stem.rpartition("-")
-    if not sep:
-        raise InvalidSdistFilename(f"Invalid sdist filename: {filename}")
-
-    name = canonicalize_name(name_part)
-
-    try:
-        version = Version(version_part)
-    except InvalidVersion as e:
-        raise InvalidSdistFilename(
-            f"Invalid sdist filename (invalid version): {filename}"
-        ) from e
-
-    return (name, version)

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

@@ -1,119 +0,0 @@
-# ------------------------------------
-# Copyright (c) Microsoft Corporation.
-# Licensed under the MIT License.
-# ------------------------------------
-import logging
-import os
-from typing import Any, Optional, cast
-
-from azure.core.credentials import AccessToken, AccessTokenInfo, TokenRequestOptions, SupportsTokenInfo, TokenCredential
-from .chained import ChainedTokenCredential
-from .environment import EnvironmentCredential
-from .managed_identity import ManagedIdentityCredential
-from .._constants import EnvironmentVariables
-from .._internal import get_default_authority, normalize_authority
-
-_LOGGER = logging.getLogger(__name__)
-
-
-class AzureApplicationCredential(ChainedTokenCredential):
-    """A credential for Microsoft Entra applications.
-
-    This credential is designed for applications deployed to Azure (:class:`~azure.identity.DefaultAzureCredential` is
-    better suited to local development). It authenticates service principals and managed identities.
-
-    For service principal authentication, set these environment variables to identify a principal:
-
-        - **AZURE_TENANT_ID**: ID of the service principal's tenant. Also called its "directory" ID.
-        - **AZURE_CLIENT_ID**: the service principal's client ID
-
-    And one of these to authenticate that principal:
-
-        - **AZURE_CLIENT_SECRET**: one of the service principal's client secrets
-
-        **or**
-
-        - **AZURE_CLIENT_CERTIFICATE_PATH**: path to a PEM-encoded certificate file including the private key. The
-          certificate must not be password-protected.
-
-    See `Azure CLI documentation <https://learn.microsoft.com/cli/azure/create-an-azure-service-principal-azure-cli>`_
-    for more information about creating and managing service principals.
-
-    When this environment configuration is incomplete, the credential will attempt to authenticate a managed identity.
-    See `Microsoft Entra ID documentation
-    <https://learn.microsoft.com/entra/identity/managed-identities-azure-resources/overview>`__ for an overview
-    of managed identities.
-
-    :keyword str authority: Authority of a Microsoft Entra endpoint, for example "login.microsoftonline.com",
-        the authority for Azure Public Cloud, which is the default when no value is given for this keyword argument or
-        environment variable AZURE_AUTHORITY_HOST. :class:`~azure.identity.AzureAuthorityHosts` defines authorities for
-        other clouds. Authority configuration applies only to service principal authentication.
-    :keyword str managed_identity_client_id: The client ID of a user-assigned managed identity. Defaults to the value
-        of the environment variable AZURE_CLIENT_ID, if any. If not specified, a system-assigned identity will be used.
-    """
-
-    def __init__(self, **kwargs: Any) -> None:
-        authority = kwargs.pop("authority", None)
-        authority = normalize_authority(authority) if authority else get_default_authority()
-        managed_identity_client_id = kwargs.pop(
-            "managed_identity_client_id", os.environ.get(EnvironmentVariables.AZURE_CLIENT_ID)
-        )
-        super(AzureApplicationCredential, self).__init__(
-            EnvironmentCredential(authority=authority, **kwargs),
-            ManagedIdentityCredential(client_id=managed_identity_client_id, **kwargs),
-        )
-
-    def get_token(
-        self, *scopes: str, claims: Optional[str] = None, tenant_id: Optional[str] = None, **kwargs: Any
-    ) -> AccessToken:
-        """Request an access token for `scopes`.
-
-        This method is called automatically by Azure SDK clients.
-
-        :param str scopes: desired scopes for the access token. This method requires at least one scope.
-            For more information about scopes, see
-            https://learn.microsoft.com/entra/identity-platform/scopes-oidc.
-        :keyword str claims: additional claims required in the token, such as those returned in a resource provider's
-            claims challenge following an authorization failure.
-        :keyword str tenant_id: optional tenant to include in the token request.
-
-        :return: An access token with the desired scopes.
-        :rtype: ~azure.core.credentials.AccessToken
-        :raises ~azure.core.exceptions.ClientAuthenticationError: authentication failed. The exception has a
-            `message` attribute listing each authentication attempt and its error message.
-        """
-        if self._successful_credential:
-            token = cast(TokenCredential, self._successful_credential).get_token(
-                *scopes, claims=claims, tenant_id=tenant_id, **kwargs
-            )
-            _LOGGER.info(
-                "%s acquired a token from %s", self.__class__.__name__, self._successful_credential.__class__.__name__
-            )
-            return token
-
-        return super(AzureApplicationCredential, self).get_token(*scopes, claims=claims, tenant_id=tenant_id, **kwargs)
-
-    def get_token_info(self, *scopes: str, options: Optional[TokenRequestOptions] = None) -> AccessTokenInfo:
-        """Request an access token for `scopes`.
-
-        This is an alternative to `get_token` to enable certain scenarios that require additional properties
-        on the token. This method is called automatically by Azure SDK clients.
-
-        :param str scopes: desired scopes for the access token. This method requires at least one scope.
-            For more information about scopes, see https://learn.microsoft.com/entra/identity-platform/scopes-oidc.
-        :keyword options: A dictionary of options for the token request. Unknown options will be ignored. Optional.
-        :paramtype options: ~azure.core.credentials.TokenRequestOptions
-
-        :rtype: ~azure.core.credentials.AccessTokenInfo
-        :return: An AccessTokenInfo instance containing information about the token.
-        :raises ~azure.core.exceptions.ClientAuthenticationError: authentication failed. The exception has a
-            `message` attribute listing each authentication attempt and its error message.
-        """
-        if self._successful_credential:
-            token_info = cast(SupportsTokenInfo, self._successful_credential).get_token_info(*scopes, options=options)
-            _LOGGER.info(
-                "%s acquired a token from %s", self.__class__.__name__, self._successful_credential.__class__.__name__
-            )
-            return token_info
-
-        return cast(SupportsTokenInfo, super()).get_token_info(*scopes, options=options)

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

@@ -1,121 +0,0 @@
-# ------------------------------------
-# Copyright (c) Microsoft Corporation.
-# Licensed under the MIT License.
-# ------------------------------------
-import logging
-import os
-from typing import Optional, Any, cast
-
-from azure.core.credentials import AccessToken, AccessTokenInfo, TokenRequestOptions
-from azure.core.credentials_async import AsyncSupportsTokenInfo, AsyncTokenCredential
-from .chained import ChainedTokenCredential
-from .environment import EnvironmentCredential
-from .managed_identity import ManagedIdentityCredential
-from ..._constants import EnvironmentVariables
-from ..._internal import get_default_authority, normalize_authority
-
-_LOGGER = logging.getLogger(__name__)
-
-
-class AzureApplicationCredential(ChainedTokenCredential):
-    """A credential for Microsoft Entra applications.
-
-    This credential is designed for applications deployed to Azure (:class:`~azure.identity.aio.DefaultAzureCredential`
-    is better suited to local development). It authenticates service principals and managed identities.
-
-    For service principal authentication, set these environment variables to identify a principal:
-
-        - **AZURE_TENANT_ID**: ID of the service principal's tenant. Also called its "directory" ID.
-        - **AZURE_CLIENT_ID**: the service principal's client ID
-
-    And one of these to authenticate that principal:
-
-        - **AZURE_CLIENT_SECRET**: one of the service principal's client secrets
-
-        **or**
-
-        - **AZURE_CLIENT_CERTIFICATE_PATH**: path to a PEM-encoded certificate file including the private key. The
-          certificate must not be password-protected.
-
-    See `Azure CLI documentation <https://learn.microsoft.com/cli/azure/create-an-azure-service-principal-azure-cli>`_
-    for more information about creating and managing service principals.
-
-    When this environment configuration is incomplete, the credential will attempt to authenticate a managed identity.
-    See `Microsoft Entra ID documentation
-    <https://learn.microsoft.com/entra/identity/managed-identities-azure-resources/overview>`__ for an overview
-    of managed identities.
-
-    :keyword str authority: Authority of a Microsoft Entra endpoint, for example "login.microsoftonline.com",
-        the authority for Azure Public Cloud, which is the default when no value is given for this keyword argument or
-        environment variable AZURE_AUTHORITY_HOST. :class:`~azure.identity.AzureAuthorityHosts` defines authorities for
-        other clouds. Authority configuration applies only to service principal authentication.
-    :keyword str managed_identity_client_id: The client ID of a user-assigned managed identity. Defaults to the value
-        of the environment variable AZURE_CLIENT_ID, if any. If not specified, a system-assigned identity will be used.
-    """
-
-    def __init__(
-        self, *, authority: Optional[str] = None, managed_identity_client_id: Optional[str] = None, **kwargs: Any
-    ) -> None:
-        authority = normalize_authority(authority) if authority else get_default_authority()
-        managed_identity_client_id = managed_identity_client_id or os.environ.get(EnvironmentVariables.AZURE_CLIENT_ID)
-        super().__init__(
-            EnvironmentCredential(authority=authority, **kwargs),
-            ManagedIdentityCredential(client_id=managed_identity_client_id, **kwargs),
-        )
-
-    async def get_token(
-        self, *scopes: str, claims: Optional[str] = None, tenant_id: Optional[str] = None, **kwargs: Any
-    ) -> AccessToken:
-        """Asynchronously request an access token for `scopes`.
-
-        This method is called automatically by Azure SDK clients.
-
-        :param str scopes: desired scopes for the access token. This method requires at least one scope.
-            For more information about scopes, see
-            https://learn.microsoft.com/entra/identity-platform/scopes-oidc.
-        :keyword str claims: additional claims required in the token, such as those returned in a resource provider's
-            claims challenge following an authorization failure.
-        :keyword str tenant_id: optional tenant to include in the token request.
-
-        :return: An access token with the desired scopes.
-        :rtype: ~azure.core.credentials.AccessToken
-        :raises ~azure.core.exceptions.ClientAuthenticationError: authentication failed. The exception has a
-            `message` attribute listing each authentication attempt and its error message.
-        """
-        if self._successful_credential:
-            token = await cast(AsyncTokenCredential, self._successful_credential).get_token(
-                *scopes, claims=claims, tenant_id=tenant_id, **kwargs
-            )
-            _LOGGER.info(
-                "%s acquired a token from %s", self.__class__.__name__, self._successful_credential.__class__.__name__
-            )
-            return token
-
-        return await super().get_token(*scopes, claims=claims, tenant_id=tenant_id, **kwargs)
-
-    async def get_token_info(self, *scopes: str, options: Optional[TokenRequestOptions] = None) -> AccessTokenInfo:
-        """Request an access token for `scopes`.
-
-        This is an alternative to `get_token` to enable certain scenarios that require additional properties
-        on the token. This method is called automatically by Azure SDK clients.
-
-        :param str scopes: desired scopes for the access token. This method requires at least one scope.
-            For more information about scopes, see https://learn.microsoft.com/entra/identity-platform/scopes-oidc.
-        :keyword options: A dictionary of options for the token request. Unknown options will be ignored. Optional.
-        :paramtype options: ~azure.core.credentials.TokenRequestOptions
-
-        :rtype: ~azure.core.credentials.AccessTokenInfo
-        :return: An AccessTokenInfo instance containing information about the token.
-        :raises ~azure.core.exceptions.ClientAuthenticationError: authentication failed. The exception has a
-            `message` attribute listing each authentication attempt and its error message.
-        """
-        if self._successful_credential:
-            token_info = await cast(AsyncSupportsTokenInfo, self._successful_credential).get_token_info(
-                *scopes, options=options
-            )
-            _LOGGER.info(
-                "%s acquired a token from %s", self.__class__.__name__, self._successful_credential.__class__.__name__
-            )
-            return token_info
-
-        return await cast(AsyncSupportsTokenInfo, super()).get_token_info(*scopes, options=options)