boto3-errors 0.1.0__py3-none-any.whl

boto3_errors/__init__.py

@@ -0,0 +1,6 @@
+"""Typed, statically-importable exception classes for every AWS service."""
+
+from boto3_errors._base import Boto3Error
+from boto3_errors._patch import patch_client
+
+__all__ = ["Boto3Error", "patch_client"]

boto3_errors/_base.py

@@ -0,0 +1,40 @@
+from __future__ import annotations
+
+from typing import Any
+
+from botocore.exceptions import ClientError
+
+
+class Boto3Error(ClientError):
+    """Base class for all typed boto3 exceptions.
+
+    Inherits from ClientError so existing ``except ClientError`` handlers
+    still catch these exceptions.
+    """
+
+    _SERVICE: str = ""
+    _ERROR_CODE: str = ""
+
+    # Widen from botocore-stubs' TypedDict so that generated properties
+    # can ``self.response.get("SomeField")`` without returning ``object``.
+    response: dict[str, Any]  # type: ignore[assignment]
+
+    @property
+    def message(self) -> str:
+        """Human-readable error message from the ``Error.Message`` field."""
+        return self.response.get("Error", {}).get("Message", "")  # type: ignore[no-any-return]
+
+    @property
+    def error_code(self) -> str:
+        """AWS error code from the ``Error.Code`` field."""
+        return self.response.get("Error", {}).get("Code", "")  # type: ignore[no-any-return]
+
+    @property
+    def http_status_code(self) -> int:
+        """HTTP status code from ``ResponseMetadata``."""
+        return self.response.get("ResponseMetadata", {}).get("HTTPStatusCode", 0)  # type: ignore[no-any-return]
+
+    @property
+    def request_id(self) -> str:
+        """AWS request ID from ``ResponseMetadata``."""
+        return self.response.get("ResponseMetadata", {}).get("RequestId", "")  # type: ignore[no-any-return]

boto3_errors/_patch.py

@@ -0,0 +1,54 @@
+import functools
+import importlib
+from typing import Any
+
+from botocore.client import BaseClient
+from botocore.exceptions import ClientError
+
+
+def patch_client(client: BaseClient) -> None:
+    """Wrap *client*'s ``_make_api_call``.
+
+    Re-raises ``ClientError`` as a typed :class:`~boto3_errors._base.Boto3Error`
+    subclass when a matching exception class exists.
+
+    Safe to call more than once on the same client (subsequent calls are
+    no-ops).
+    """
+    if getattr(client, "_boto3_errors_patched", False):
+        return
+
+    service: str = client._service_model.service_name  # type: ignore[attr-defined]
+    module_name = _service_to_module(service)
+
+    try:
+        mod = importlib.import_module(f"boto3_errors.{module_name}")
+    except ModuleNotFoundError:
+        # No generated module for this service — nothing to patch.
+        return
+
+    exceptions: dict[str, type] = getattr(mod, "EXCEPTIONS", {})
+    original = client._make_api_call  # type: ignore[attr-defined]
+
+    @functools.wraps(original)
+    def _patched_make_api_call(
+        operation_name: str, api_params: dict[str, Any]
+    ) -> dict[str, Any]:
+        try:
+            return original(operation_name, api_params)  # type: ignore[no-any-return]
+        except ClientError as e:
+            code = e.response.get("Error", {}).get("Code", "")
+            exc_cls = exceptions.get(code)
+            if exc_cls is not None:
+                raise exc_cls(e.response, e.operation_name) from e
+            raise
+
+    client._make_api_call = _patched_make_api_call  # type: ignore[attr-defined]
+    client._boto3_errors_patched = True  # type: ignore[attr-defined]
+
+
+def _service_to_module(service: str) -> str:
+    name = service.replace("-", "_")
+    if name == "lambda":
+        name = "lambda_"
+    return name

boto3_errors/accessanalyzer.py

@@ -0,0 +1,118 @@
+# Auto-generated. Do not edit manually.
+from __future__ import annotations
+
+from typing import Any
+
+from boto3_errors._base import Boto3Error
+
+
+class AccessAnalyzerError(Boto3Error):
+    _SERVICE = "accessanalyzer"
+
+
+class AccessDeniedException(AccessAnalyzerError):
+    """You do not have sufficient access to perform this action."""
+    _ERROR_CODE = "AccessDeniedException"
+
+
+class ConflictException(AccessAnalyzerError):
+    """A conflict exception error."""
+    _ERROR_CODE = "ConflictException"
+
+    @property
+    def resource_id(self) -> str | None:
+        """The ID of the resource."""
+        return self.response.get("resourceId")
+
+    @property
+    def resource_type(self) -> str | None:
+        """The resource type."""
+        return self.response.get("resourceType")
+
+
+class InternalServerException(AccessAnalyzerError):
+    """Internal server error."""
+    _ERROR_CODE = "InternalServerException"
+
+    @property
+    def retry_after_seconds(self) -> int | None:
+        """The seconds to wait to retry."""
+        return self.response.get("retryAfterSeconds")
+
+
+class InvalidParameterException(AccessAnalyzerError):
+    """The specified parameter is invalid."""
+    _ERROR_CODE = "InvalidParameterException"
+
+
+class ResourceNotFoundException(AccessAnalyzerError):
+    """The specified resource could not be found."""
+    _ERROR_CODE = "ResourceNotFoundException"
+
+    @property
+    def resource_id(self) -> str | None:
+        """The ID of the resource."""
+        return self.response.get("resourceId")
+
+    @property
+    def resource_type(self) -> str | None:
+        """The type of the resource."""
+        return self.response.get("resourceType")
+
+
+class ServiceQuotaExceededException(AccessAnalyzerError):
+    """Service quote met error."""
+    _ERROR_CODE = "ServiceQuotaExceededException"
+
+    @property
+    def resource_id(self) -> str | None:
+        """The resource ID."""
+        return self.response.get("resourceId")
+
+    @property
+    def resource_type(self) -> str | None:
+        """The resource type."""
+        return self.response.get("resourceType")
+
+
+class ThrottlingException(AccessAnalyzerError):
+    """Throttling limit exceeded error."""
+    _ERROR_CODE = "ThrottlingException"
+
+    @property
+    def retry_after_seconds(self) -> int | None:
+        """The seconds to wait to retry."""
+        return self.response.get("retryAfterSeconds")
+
+
+class UnprocessableEntityException(AccessAnalyzerError):
+    """The specified entity could not be processed."""
+    _ERROR_CODE = "UnprocessableEntityException"
+
+
+class ValidationException(AccessAnalyzerError):
+    """Validation exception error."""
+    _ERROR_CODE = "ValidationException"
+
+    @property
+    def reason(self) -> str | None:
+        """The reason for the exception."""
+        return self.response.get("reason")
+
+    @property
+    def field_list(self) -> list[Any] | None:
+        """A list of fields that didn't validate."""
+        return self.response.get("fieldList")
+
+
+EXCEPTIONS: dict[str, type[AccessAnalyzerError]] = {
+    "AccessDeniedException": AccessDeniedException,
+    "ConflictException": ConflictException,
+    "InternalServerException": InternalServerException,
+    "InvalidParameterException": InvalidParameterException,
+    "ResourceNotFoundException": ResourceNotFoundException,
+    "ServiceQuotaExceededException": ServiceQuotaExceededException,
+    "ThrottlingException": ThrottlingException,
+    "UnprocessableEntityException": UnprocessableEntityException,
+    "ValidationException": ValidationException,
+}

boto3_errors/account.py

@@ -0,0 +1,113 @@
+# Auto-generated. Do not edit manually.
+from __future__ import annotations
+
+from typing import Any
+
+from boto3_errors._base import Boto3Error
+
+
+class AccountError(Boto3Error):
+    _SERVICE = "account"
+
+
+class AccessDeniedException(AccountError):
+    """The operation failed because the calling identity doesn't have the minimum required
+    permissions.
+    """
+
+    _ERROR_CODE = "AccessDeniedException"
+
+    @property
+    def error_type(self) -> str | None:
+        """The value populated to the `x-amzn-ErrorType` response header by API Gateway."""
+        return self.response.get("errorType")
+
+
+class ConflictException(AccountError):
+    """The request could not be processed because of a conflict in the current status of
+    the resource. For example, this happens if you try to enable a Region that is
+    currently being disabled (in a status of DISABLING) or if you try to change an
+    account’s root user email to an email address which is already in use.
+    """
+
+    _ERROR_CODE = "ConflictException"
+
+    @property
+    def error_type(self) -> str | None:
+        """The value populated to the `x-amzn-ErrorType` response header by API Gateway."""
+        return self.response.get("errorType")
+
+
+class InternalServerException(AccountError):
+    """The operation failed because of an error internal to Amazon Web Services. Try your
+    operation again later.
+    """
+
+    _ERROR_CODE = "InternalServerException"
+
+    @property
+    def error_type(self) -> str | None:
+        """The value populated to the `x-amzn-ErrorType` response header by API Gateway."""
+        return self.response.get("errorType")
+
+
+class ResourceNotFoundException(AccountError):
+    """The operation failed because it specified a resource that can't be found."""
+    _ERROR_CODE = "ResourceNotFoundException"
+
+    @property
+    def error_type(self) -> str | None:
+        """The value populated to the `x-amzn-ErrorType` response header by API Gateway."""
+        return self.response.get("errorType")
+
+
+class ResourceUnavailableException(AccountError):
+    """The operation failed because it specified a resource that is not currently
+    available.
+    """
+
+    _ERROR_CODE = "ResourceUnavailableException"
+
+    @property
+    def error_type(self) -> str | None:
+        """The value populated to the `x-amzn-ErrorType` response header by API Gateway."""
+        return self.response.get("errorType")
+
+
+class TooManyRequestsException(AccountError):
+    """The operation failed because it was called too frequently and exceeded a throttle
+    limit.
+    """
+
+    _ERROR_CODE = "TooManyRequestsException"
+
+    @property
+    def error_type(self) -> str | None:
+        """The value populated to the `x-amzn-ErrorType` response header by API Gateway."""
+        return self.response.get("errorType")
+
+
+class ValidationException(AccountError):
+    """The operation failed because one of the input parameters was invalid."""
+    _ERROR_CODE = "ValidationException"
+
+    @property
+    def field_list(self) -> list[Any] | None:
+        """The field where the invalid entry was detected."""
+        return self.response.get("fieldList")
+
+    @property
+    def reason(self) -> str | None:
+        """The reason that validation failed."""
+        return self.response.get("reason")
+
+
+EXCEPTIONS: dict[str, type[AccountError]] = {
+    "AccessDeniedException": AccessDeniedException,
+    "ConflictException": ConflictException,
+    "InternalServerException": InternalServerException,
+    "ResourceNotFoundException": ResourceNotFoundException,
+    "ResourceUnavailableException": ResourceUnavailableException,
+    "TooManyRequestsException": TooManyRequestsException,
+    "ValidationException": ValidationException,
+}

boto3_errors/acm.py

@@ -0,0 +1,125 @@
+# Auto-generated. Do not edit manually.
+from __future__ import annotations
+
+from typing import Any
+
+from boto3_errors._base import Boto3Error
+
+
+class ACMError(Boto3Error):
+    _SERVICE = "acm"
+
+
+class AccessDeniedException(ACMError):
+    """You do not have access required to perform this action."""
+    _ERROR_CODE = "AccessDeniedException"
+
+
+class ConflictException(ACMError):
+    """You are trying to update a resource or configuration that is already being created
+    or updated. Wait for the previous operation to finish and try again.
+    """
+
+    _ERROR_CODE = "ConflictException"
+
+
+class InvalidArgsException(ACMError):
+    """One or more of request parameters specified is not valid."""
+    _ERROR_CODE = "InvalidArgsException"
+
+
+class InvalidArnException(ACMError):
+    """The requested Amazon Resource Name (ARN) does not refer to an existing resource."""
+    _ERROR_CODE = "InvalidArnException"
+
+
+class InvalidDomainValidationOptionsException(ACMError):
+    """One or more values in the DomainValidationOption structure is incorrect."""
+    _ERROR_CODE = "InvalidDomainValidationOptionsException"
+
+
+class InvalidParameterException(ACMError):
+    """An input parameter was invalid."""
+    _ERROR_CODE = "InvalidParameterException"
+
+
+class InvalidStateException(ACMError):
+    """Processing has reached an invalid state."""
+    _ERROR_CODE = "InvalidStateException"
+
+
+class InvalidTagException(ACMError):
+    """One or both of the values that make up the key-value pair is not valid. For example,
+    you cannot specify a tag value that begins with `aws:`.
+    """
+
+    _ERROR_CODE = "InvalidTagException"
+
+
+class LimitExceededException(ACMError):
+    """An ACM quota has been exceeded."""
+    _ERROR_CODE = "LimitExceededException"
+
+
+class RequestInProgressException(ACMError):
+    """The certificate request is in process and the certificate in your account has not
+    yet been issued.
+    """
+
+    _ERROR_CODE = "RequestInProgressException"
+
+
+class ResourceInUseException(ACMError):
+    """The certificate is in use by another Amazon Web Services service in the caller's
+    account. Remove the association and try again.
+    """
+
+    _ERROR_CODE = "ResourceInUseException"
+
+
+class ResourceNotFoundException(ACMError):
+    """The specified certificate cannot be found in the caller's account or the caller's
+    account cannot be found.
+    """
+
+    _ERROR_CODE = "ResourceNotFoundException"
+
+
+class TagPolicyException(ACMError):
+    """A specified tag did not comply with an existing tag policy and was rejected."""
+    _ERROR_CODE = "TagPolicyException"
+
+
+class ThrottlingException(ACMError):
+    """The request was denied because it exceeded a quota."""
+    _ERROR_CODE = "ThrottlingException"
+
+
+class TooManyTagsException(ACMError):
+    """The request contains too many tags. Try the request again with fewer tags."""
+    _ERROR_CODE = "TooManyTagsException"
+
+
+class ValidationException(ACMError):
+    """The supplied input failed to satisfy constraints of an Amazon Web Services service."""
+    _ERROR_CODE = "ValidationException"
+
+
+EXCEPTIONS: dict[str, type[ACMError]] = {
+    "AccessDeniedException": AccessDeniedException,
+    "ConflictException": ConflictException,
+    "InvalidArgsException": InvalidArgsException,
+    "InvalidArnException": InvalidArnException,
+    "InvalidDomainValidationOptionsException": InvalidDomainValidationOptionsException,
+    "InvalidParameterException": InvalidParameterException,
+    "InvalidStateException": InvalidStateException,
+    "InvalidTagException": InvalidTagException,
+    "LimitExceededException": LimitExceededException,
+    "RequestInProgressException": RequestInProgressException,
+    "ResourceInUseException": ResourceInUseException,
+    "ResourceNotFoundException": ResourceNotFoundException,
+    "TagPolicyException": TagPolicyException,
+    "ThrottlingException": ThrottlingException,
+    "TooManyTagsException": TooManyTagsException,
+    "ValidationException": ValidationException,
+}

boto3_errors/acm_pca.py

@@ -0,0 +1,153 @@
+# Auto-generated. Do not edit manually.
+from __future__ import annotations
+
+from typing import Any
+
+from boto3_errors._base import Boto3Error
+
+
+class ACMPCAError(Boto3Error):
+    _SERVICE = "acm-pca"
+
+
+class CertificateMismatchException(ACMPCAError):
+    """The certificate authority certificate you are importing does not comply with
+    conditions specified in the certificate that signed it.
+    """
+
+    _ERROR_CODE = "CertificateMismatchException"
+
+
+class ConcurrentModificationException(ACMPCAError):
+    """A previous update to your private CA is still ongoing."""
+    _ERROR_CODE = "ConcurrentModificationException"
+
+
+class InvalidArgsException(ACMPCAError):
+    """One or more of the specified arguments was not valid."""
+    _ERROR_CODE = "InvalidArgsException"
+
+
+class InvalidArnException(ACMPCAError):
+    """The requested Amazon Resource Name (ARN) does not refer to an existing resource."""
+    _ERROR_CODE = "InvalidArnException"
+
+
+class InvalidNextTokenException(ACMPCAError):
+    """The token specified in the `NextToken` argument is not valid. Use the token returned
+    from your previous call to ListCertificateAuthorities.
+    """
+
+    _ERROR_CODE = "InvalidNextTokenException"
+
+
+class InvalidPolicyException(ACMPCAError):
+    """The resource policy is invalid or is missing a required statement. For general
+    information about IAM policy and statement structure, see Overview of JSON Policies.
+    """
+
+    _ERROR_CODE = "InvalidPolicyException"
+
+
+class InvalidRequestException(ACMPCAError):
+    """The request action cannot be performed or is prohibited."""
+    _ERROR_CODE = "InvalidRequestException"
+
+
+class InvalidStateException(ACMPCAError):
+    """The state of the private CA does not allow this action to occur."""
+    _ERROR_CODE = "InvalidStateException"
+
+
+class InvalidTagException(ACMPCAError):
+    """The tag associated with the CA is not valid. The invalid argument is contained in
+    the message field.
+    """
+
+    _ERROR_CODE = "InvalidTagException"
+
+
+class LimitExceededException(ACMPCAError):
+    """An Amazon Web Services Private CA quota has been exceeded. See the exception message
+    returned to determine the quota that was exceeded.
+    """
+
+    _ERROR_CODE = "LimitExceededException"
+
+
+class LockoutPreventedException(ACMPCAError):
+    """The current action was prevented because it would lock the caller out from
+    performing subsequent actions. Verify that the specified parameters would not result
+    in the caller being denied access to the resource.
+    """
+
+    _ERROR_CODE = "LockoutPreventedException"
+
+
+class MalformedCSRException(ACMPCAError):
+    """The certificate signing request is invalid."""
+    _ERROR_CODE = "MalformedCSRException"
+
+
+class MalformedCertificateException(ACMPCAError):
+    """One or more fields in the certificate are invalid."""
+    _ERROR_CODE = "MalformedCertificateException"
+
+
+class PermissionAlreadyExistsException(ACMPCAError):
+    """The designated permission has already been given to the user."""
+    _ERROR_CODE = "PermissionAlreadyExistsException"
+
+
+class RequestAlreadyProcessedException(ACMPCAError):
+    """Your request has already been completed."""
+    _ERROR_CODE = "RequestAlreadyProcessedException"
+
+
+class RequestFailedException(ACMPCAError):
+    """The request has failed for an unspecified reason."""
+    _ERROR_CODE = "RequestFailedException"
+
+
+class RequestInProgressException(ACMPCAError):
+    """Your request is already in progress."""
+    _ERROR_CODE = "RequestInProgressException"
+
+
+class ResourceNotFoundException(ACMPCAError):
+    """A resource such as a private CA, S3 bucket, certificate, audit report, or policy
+    cannot be found.
+    """
+
+    _ERROR_CODE = "ResourceNotFoundException"
+
+
+class TooManyTagsException(ACMPCAError):
+    """You can associate up to 50 tags with a private CA. Exception information is
+    contained in the exception message field.
+    """
+
+    _ERROR_CODE = "TooManyTagsException"
+
+
+EXCEPTIONS: dict[str, type[ACMPCAError]] = {
+    "CertificateMismatchException": CertificateMismatchException,
+    "ConcurrentModificationException": ConcurrentModificationException,
+    "InvalidArgsException": InvalidArgsException,
+    "InvalidArnException": InvalidArnException,
+    "InvalidNextTokenException": InvalidNextTokenException,
+    "InvalidPolicyException": InvalidPolicyException,
+    "InvalidRequestException": InvalidRequestException,
+    "InvalidStateException": InvalidStateException,
+    "InvalidTagException": InvalidTagException,
+    "LimitExceededException": LimitExceededException,
+    "LockoutPreventedException": LockoutPreventedException,
+    "MalformedCSRException": MalformedCSRException,
+    "MalformedCertificateException": MalformedCertificateException,
+    "PermissionAlreadyExistsException": PermissionAlreadyExistsException,
+    "RequestAlreadyProcessedException": RequestAlreadyProcessedException,
+    "RequestFailedException": RequestFailedException,
+    "RequestInProgressException": RequestInProgressException,
+    "ResourceNotFoundException": ResourceNotFoundException,
+    "TooManyTagsException": TooManyTagsException,
+}