Source code for duplicity.errors

# -*- Mode:Python; indent-tabs-mode:nil; tab-width:4; encoding:utf-8 -*-
#
# Copyright 2002 Ben Escoto <ben@emerose.org>
# Copyright 2007 Kenneth Loafman <kenneth@loafman.com>
#
# This file is part of duplicity.
#
# Duplicity is free software; you can redistribute it and/or modify it
# under the terms of the GNU General Public License as published by the
# Free Software Foundation; either version 2 of the License, or (at your
# option) any later version.
#
# Duplicity is distributed in the hope that it will be useful, but
# WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
# General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with duplicity; if not, write to the Free Software Foundation,
# Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

u"""
Error/exception classes that do not fit naturally anywhere else.
"""

from duplicity import log


[docs]class DuplicityError(Exception): pass
[docs]class UserError(DuplicityError): u""" Subclasses use this in their inheritance hierarchy to signal that the error is a user generated one, and that it is therefore typically unsuitable to display a full stack trace. """ pass
[docs]class NotSupported(DuplicityError): u""" Exception raised when an action cannot be completed because some particular feature is not supported by the environment. """ pass
[docs]class ConflictingScheme(DuplicityError): u""" Raised to indicate an attempt was made to register a backend for a scheme for which there is already a backend registered. """ pass
[docs]class InvalidBackendURL(UserError): u""" Raised to indicate a URL was not a valid backend URL. """ pass
[docs]class UnsupportedBackendScheme(InvalidBackendURL, UserError): u""" Raised to indicate that a backend URL was parsed successfully as a URL, but was not supported. """
[docs] def __init__(self, url): InvalidBackendURL.__init__(self, (u"scheme not supported in url: %s" % (url,))) self.url = url
[docs]class BackendException(DuplicityError): u""" Raised to indicate a backend specific problem. """
[docs] def __init__(self, msg, code=log.ErrorCode.backend_error): super(BackendException, self).__init__(msg) self.code = code
[docs]class FatalBackendException(BackendException): u""" Raised to indicate a backend failed fatally. """ pass
[docs]class TemporaryLoadException(BackendException): u""" Raised to indicate a temporary issue on the backend. Duplicity should back off for a bit and try again. """ pass
[docs]class BadVolumeException(DuplicityError): pass