python-gitlab/gitlab/exceptions.py at main · python-gitlab/python-gitlab

430 lines (271 loc) · 8.19 KB
from __future__ import annotations
import functools
from typing import Any, Callable, cast, TYPE_CHECKING, TypeVar
class GitlabError(Exception):
    def __init__(
        self,
        error_message: str | bytes = "",
        response_code: int | None = None,
        response_body: bytes | None = None,
    ) -> None:
        Exception.__init__(self, error_message)
        # Http status code
        self.response_code = response_code
        # Full http response
        self.response_body = response_body
        # Parsed error message from gitlab
        try:
            # if we receive str/bytes we try to convert to unicode/str to have
            # consistent message types (see #616)
            if TYPE_CHECKING:
                assert isinstance(error_message, bytes)
            self.error_message = error_message.decode()
        except Exception:
            if TYPE_CHECKING:
                assert isinstance(error_message, str)
            self.error_message = error_message
    def __str__(self) -> str:
        if self.response_code is not None:
            return f"{self.response_code}: {self.error_message}"
        return f"{self.error_message}"
class GitlabAuthenticationError(GitlabError):
class RedirectError(GitlabError):
class GitlabParsingError(GitlabError):
class GitlabCiLintError(GitlabError):
class GitlabConnectionError(GitlabError):
class GitlabOperationError(GitlabError):
class GitlabHttpError(GitlabError):
class GitlabListError(GitlabOperationError):
class GitlabGetError(GitlabOperationError):
class GitlabHeadError(GitlabOperationError):
class GitlabCreateError(GitlabOperationError):
class GitlabUpdateError(GitlabOperationError):
class GitlabDeleteError(GitlabOperationError):
class GitlabSetError(GitlabOperationError):
class GitlabProtectError(GitlabOperationError):
class GitlabTransferProjectError(GitlabOperationError):
class GitlabGroupTransferError(GitlabOperationError):
class GitlabProjectDeployKeyError(GitlabOperationError):
class GitlabPromoteError(GitlabOperationError):
class GitlabCancelError(GitlabOperationError):
class GitlabPipelineCancelError(GitlabCancelError):
class GitlabRetryError(GitlabOperationError):
class GitlabBuildCancelError(GitlabCancelError):
class GitlabBuildRetryError(GitlabRetryError):
class GitlabBuildPlayError(GitlabRetryError):
class GitlabBuildEraseError(GitlabRetryError):
class GitlabJobCancelError(GitlabCancelError):
class GitlabJobRetryError(GitlabRetryError):
class GitlabJobPlayError(GitlabRetryError):
class GitlabJobEraseError(GitlabRetryError):
class GitlabPipelinePlayError(GitlabRetryError):
class GitlabPipelineRetryError(GitlabRetryError):
class GitlabBlockError(GitlabOperationError):
class GitlabUnblockError(GitlabOperationError):
class GitlabDeactivateError(GitlabOperationError):
class GitlabActivateError(GitlabOperationError):
class GitlabBanError(GitlabOperationError):
class GitlabUnbanError(GitlabOperationError):
class GitlabSubscribeError(GitlabOperationError):
class GitlabUnsubscribeError(GitlabOperationError):
class GitlabMRForbiddenError(GitlabOperationError):
class GitlabMRApprovalError(GitlabOperationError):
class GitlabMRRebaseError(GitlabOperationError):
class GitlabMRResetApprovalError(GitlabOperationError):
class GitlabMRClosedError(GitlabOperationError):
class GitlabMROnBuildSuccessError(GitlabOperationError):
class GitlabTodoError(GitlabOperationError):
class GitlabTopicMergeError(GitlabOperationError):
class GitlabTimeTrackingError(GitlabOperationError):
class GitlabUploadError(GitlabOperationError):
class GitlabAttachFileError(GitlabOperationError):
class GitlabImportError(GitlabOperationError):
class GitlabInvitationError(GitlabOperationError):
class GitlabCherryPickError(GitlabOperationError):
class GitlabHousekeepingError(GitlabOperationError):
class GitlabOwnershipError(GitlabOperationError):
class GitlabSearchError(GitlabOperationError):
class GitlabStopError(GitlabOperationError):
class GitlabMarkdownError(GitlabOperationError):
class GitlabVerifyError(GitlabOperationError):
class GitlabRenderError(GitlabOperationError):
class GitlabRepairError(GitlabOperationError):
class GitlabRestoreError(GitlabOperationError):
class GitlabRevertError(GitlabOperationError):
class GitlabRotateError(GitlabOperationError):
class GitlabLicenseError(GitlabOperationError):
class GitlabFollowError(GitlabOperationError):
class GitlabUnfollowError(GitlabOperationError):
class GitlabUserApproveError(GitlabOperationError):
class GitlabUserRejectError(GitlabOperationError):
class GitlabDeploymentApprovalError(GitlabOperationError):
class GitlabHookTestError(GitlabOperationError):
# For an explanation of how these type-hints work see:
# https://mypy.readthedocs.io/en/stable/generics.html#declaring-decorators
# The goal here is that functions which get decorated will retain their types.
__F = TypeVar("__F", bound=Callable[..., Any])
def on_http_error(error: type[Exception]) -> Callable[[__F], __F]:
    """Manage GitlabHttpError exceptions.
    This decorator function can be used to catch GitlabHttpError exceptions
    raise specialized exceptions instead.
        The exception type to raise -- must inherit from GitlabError
    def wrap(f: __F) -> __F:
        @functools.wraps(f)
        def wrapped_f(*args: Any, **kwargs: Any) -> Any:
            try:
                return f(*args, **kwargs)
            except GitlabHttpError as e:
                raise error(e.error_message, e.response_code, e.response_body) from e
        return cast(__F, wrapped_f)
    return wrap
# Export manually to keep mypy happy
__all__ = [
    "GitlabActivateError",
    "GitlabAttachFileError",
    "GitlabAuthenticationError",
    "GitlabBanError",
    "GitlabBlockError",
    "GitlabBuildCancelError",
    "GitlabBuildEraseError",
    "GitlabBuildPlayError",
    "GitlabBuildRetryError",
    "GitlabCancelError",
    "GitlabCherryPickError",
    "GitlabCiLintError",
    "GitlabConnectionError",
    "GitlabCreateError",
    "GitlabDeactivateError",
    "GitlabDeleteError",
    "GitlabDeploymentApprovalError",
    "GitlabError",
    "GitlabFollowError",
    "GitlabGetError",
    "GitlabGroupTransferError",
    "GitlabHeadError",
    "GitlabHookTestError",
    "GitlabHousekeepingError",
    "GitlabHttpError",
    "GitlabImportError",
    "GitlabInvitationError",
    "GitlabJobCancelError",
    "GitlabJobEraseError",
    "GitlabJobPlayError",
    "GitlabJobRetryError",
    "GitlabLicenseError",
    "GitlabListError",
    "GitlabMRApprovalError",
    "GitlabMRClosedError",
    "GitlabMRForbiddenError",
    "GitlabMROnBuildSuccessError",
    "GitlabMRRebaseError",
    "GitlabMRResetApprovalError",
    "GitlabMarkdownError",
    "GitlabOperationError",
    "GitlabOwnershipError",
    "GitlabParsingError",
    "GitlabPipelineCancelError",
    "GitlabPipelinePlayError",
    "GitlabPipelineRetryError",
    "GitlabProjectDeployKeyError",
    "GitlabPromoteError",
    "GitlabProtectError",
    "GitlabRenderError",
    "GitlabRepairError",
    "GitlabRestoreError",
    "GitlabRetryError",
    "GitlabRevertError",
    "GitlabRotateError",
    "GitlabSearchError",
    "GitlabSetError",
    "GitlabStopError",
    "GitlabSubscribeError",
    "GitlabTimeTrackingError",
    "GitlabTodoError",
    "GitlabTopicMergeError",
    "GitlabTransferProjectError",
    "GitlabUnbanError",
    "GitlabUnblockError",
    "GitlabUnfollowError",
    "GitlabUnsubscribeError",
    "GitlabUpdateError",
    "GitlabUploadError",
    "GitlabUserApproveError",
    "GitlabUserRejectError",
    "GitlabVerifyError",
    "RedirectError",
Navigation Menu

Uh oh!

Uh oh!

FilesExpand file tree

exceptions.py

Latest commit

History

exceptions.py

File metadata and controls
