Source code for repobee_plug.exceptions

"""Exceptions for repobee_plug.

.. module:: exception
    :synopsis: Exceptions for repobee_plug.
"""


[docs]class PlugError(Exception): """Base class for all repobee_plug exceptions.""" def __init__(self, *args, **kwargs): """Instantiate a PlugError. Args: args: List of positionals. These are passed directly to :py:class:`Exception`. Typically, you should only pass an error message here. kwargs: Keyword arguments to indicate what went wrong. For example, if the argument ``a`` caused the error, then you should pass ``a=a`` as a kwarg so it can be introspected at a later time. """ super().__init__(*args) self._kwargs = kwargs @property def kwargs(self): return dict(self._kwargs) def __str__(self): formatted_args = super().__str__() formatted_kwargs = ( "" if not self._kwargs else ". Passed arguments: " + ", ".join( "{}={}".format(key, value) for key, value in self._kwargs.items() ) ) return "{}{}".format(formatted_args, formatted_kwargs)
[docs]class HookNameError(PlugError): """Raise when a public method in a class that inherits from :py:class:`~repobee_plug.Plugin` does not have a hook name. """
[docs]class APIImplementationError(PlugError): """Raise when an API is defined incorrectly."""
[docs]class PlatformError(PlugError): """An exception raised when the API responds with an error code.""" def __init__(self, msg="", status=None): super().__init__(msg) self.status = status
[docs]class NotFoundError(PlatformError): """An exception raised when a platform API fails to find a resource."""
[docs]class ServiceNotFoundError(PlatformError): """Raise if the base url can't be located."""
[docs]class BadCredentials(PlatformError): """Raise when credentials are rejected."""
[docs]class UnexpectedException(PlatformError): """An exception raised when an API request raises an unexpected exception. """
[docs]class InvalidURL(PlatformError): """Error to raise if a URL is provided to the platform API, but it is not a valid URL for the platform. """
[docs]class FileError(PlugError): """Raise if something goes wrong with reading from or writing to a file."""