python-tuf/tuf/api/exceptions.py
Martin Vrachev 15ee1d8457 Make LengthOrHashMismatchError a RepositoryError
LengthOrHashMismatchError is a thrown when there are problems with
metadata verification or problems from the repository side when looking
it from the user's perspective.

Signed-off-by: Martin Vrachev <mvrachev@vmware.com>
2022-01-19 16:52:19 +02:00

61 lines
1.6 KiB
Python

# Copyright New York University and the TUF contributors
# SPDX-License-Identifier: MIT OR Apache-2.0
"""
Define TUF exceptions used inside the new modern implementation.
The names chosen for TUF Exception classes should end in 'Error' except where
there is a good reason not to, and provide that reason in those cases.
"""
#### Repository errors ####
class RepositoryError(Exception):
"""An error with a repository's state, such as a missing file."""
class UnsignedMetadataError(RepositoryError):
"""An error about metadata object with insufficient threshold of
signatures."""
class BadVersionNumberError(RepositoryError):
"""An error for metadata that contains an invalid version number."""
class ExpiredMetadataError(RepositoryError):
"""Indicate that a TUF Metadata file has expired."""
class LengthOrHashMismatchError(RepositoryError):
"""An error while checking the length and hash values of an object."""
#### Download Errors ####
class DownloadError(Exception):
"""An error occurred while attempting to download a file."""
class DownloadLengthMismatchError(DownloadError):
"""Indicate that a mismatch of lengths was seen while downloading a file."""
class SlowRetrievalError(DownloadError):
"""Indicate that downloading a file took an unreasonably long time."""
class FetcherHTTPError(DownloadError):
"""
Returned by FetcherInterface implementations for HTTP errors.
Args:
message: The HTTP error messsage
status_code: The HTTP status code
"""
def __init__(self, message: str, status_code: int):
super().__init__(message)
self.status_code = status_code