"""Exceptions used by the FlickrAPI module."""


class IllegalArgumentException(ValueError):
    """Raised when a method is passed an illegal argument.

    More specific details will be included in the exception message
    when thrown.
    """


class FlickrError(Exception):
    """Raised when a Flickr method fails.

    More specific details will be included in the exception message
    when thrown.
    """

    def __init__(self, message, code=None):
        Exception.__init__(self, message)

        if code is None:
            self.code = None
        else:
            self.code = int(code)


class CancelUpload(Exception):
    """Raise this exception in an upload/replace callback function to
    abort the upload.
    """


class LockingError(Exception):
    """Raised when TokenCache cannot acquire a lock within the timeout
    period, or when a lock release is attempted when the lock does not
    belong to this process.
    """


class CacheDatabaseError(FlickrError):
    """Raised when the OAuth token cache database is corrupted
    or otherwise unusable.
    """