Warning: This document is for the development version of Dramatiq.

Source code for dramatiq.errors

# This file is a part of Dramatiq.
#
# Copyright (C) 2017,2018 CLEARTYPE SRL <bogdan@cleartype.io>
#
# Dramatiq is free software; you can redistribute it and/or modify it
# under the terms of the GNU Lesser General Public License as published by
# the Free Software Foundation, either version 3 of the License, or (at
# your option) any later version.
#
# Dramatiq 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 Lesser General Public
# License for more details.
#
# You should have received a copy of the GNU Lesser General Public License
# along with this program.  If not, see <http://www.gnu.org/licenses/>.


[docs]class DramatiqError(Exception): # pragma: no cover """Base class for all dramatiq errors. """ def __init__(self, message): self.message = message def __str__(self): return str(self.message) or repr(self.message)
[docs]class BrokerError(DramatiqError): """Base class for broker-related errors. """
[docs]class ActorNotFound(BrokerError): """Raised when a message is sent to an actor that hasn't been declared. """
[docs]class QueueNotFound(BrokerError): """Raised when a message is sent to an queue that hasn't been declared. """
class QueueJoinTimeout(DramatiqError): """Raised by brokers that support joining on queues when the join operation times out. """
[docs]class ConnectionError(BrokerError): """Base class for broker connection-related errors. """
[docs]class ConnectionFailed(ConnectionError): """Raised when a broker connection could not be opened. """
[docs]class ConnectionClosed(ConnectionError): """Raised when a broker connection is suddenly closed. """
[docs]class RateLimitExceeded(DramatiqError): """Raised when a rate limit has been exceeded. """