393 lines
8.6 KiB
Python
393 lines
8.6 KiB
Python
# Copyright (c) Twisted Matrix Laboratories.
|
|
# See LICENSE for details.
|
|
|
|
"""
|
|
Exceptions in L{twisted.mail}.
|
|
"""
|
|
|
|
from __future__ import absolute_import, division
|
|
|
|
from twisted.python.compat import _PY3, unicode
|
|
|
|
|
|
class IMAP4Exception(Exception):
|
|
pass
|
|
|
|
|
|
|
|
class IllegalClientResponse(IMAP4Exception):
|
|
pass
|
|
|
|
|
|
|
|
class IllegalOperation(IMAP4Exception):
|
|
pass
|
|
|
|
|
|
|
|
class IllegalMailboxEncoding(IMAP4Exception):
|
|
pass
|
|
|
|
|
|
|
|
class MailboxException(IMAP4Exception):
|
|
pass
|
|
|
|
|
|
|
|
class MailboxCollision(MailboxException):
|
|
def __str__(self):
|
|
return 'Mailbox named %s already exists' % self.args
|
|
|
|
|
|
|
|
class NoSuchMailbox(MailboxException):
|
|
def __str__(self):
|
|
return 'No mailbox named %s exists' % self.args
|
|
|
|
|
|
|
|
class ReadOnlyMailbox(MailboxException):
|
|
def __str__(self):
|
|
return 'Mailbox open in read-only state'
|
|
|
|
|
|
class UnhandledResponse(IMAP4Exception):
|
|
pass
|
|
|
|
|
|
|
|
class NegativeResponse(IMAP4Exception):
|
|
pass
|
|
|
|
|
|
|
|
class NoSupportedAuthentication(IMAP4Exception):
|
|
def __init__(self, serverSupports, clientSupports):
|
|
IMAP4Exception.__init__(
|
|
self, 'No supported authentication schemes available')
|
|
self.serverSupports = serverSupports
|
|
self.clientSupports = clientSupports
|
|
|
|
def __str__(self):
|
|
return (IMAP4Exception.__str__(self)
|
|
+ ': Server supports %r, client supports %r'
|
|
% (self.serverSupports, self.clientSupports))
|
|
|
|
|
|
|
|
class IllegalServerResponse(IMAP4Exception):
|
|
pass
|
|
|
|
|
|
|
|
class IllegalIdentifierError(IMAP4Exception):
|
|
pass
|
|
|
|
|
|
|
|
class IllegalQueryError(IMAP4Exception):
|
|
pass
|
|
|
|
|
|
|
|
class MismatchedNesting(IMAP4Exception):
|
|
pass
|
|
|
|
|
|
|
|
class MismatchedQuoting(IMAP4Exception):
|
|
pass
|
|
|
|
|
|
|
|
class SMTPError(Exception):
|
|
pass
|
|
|
|
|
|
|
|
class SMTPClientError(SMTPError):
|
|
"""
|
|
Base class for SMTP client errors.
|
|
"""
|
|
def __init__(self, code, resp, log=None, addresses=None, isFatal=False,
|
|
retry=False):
|
|
"""
|
|
@param code: The SMTP response code associated with this error.
|
|
|
|
@param resp: The string response associated with this error.
|
|
|
|
@param log: A string log of the exchange leading up to and including
|
|
the error.
|
|
@type log: L{bytes}
|
|
|
|
@param isFatal: A boolean indicating whether this connection can
|
|
proceed or not. If True, the connection will be dropped.
|
|
|
|
@param retry: A boolean indicating whether the delivery should be
|
|
retried. If True and the factory indicates further retries are
|
|
desirable, they will be attempted, otherwise the delivery will be
|
|
failed.
|
|
"""
|
|
self.code = code
|
|
self.resp = resp
|
|
self.log = log
|
|
self.addresses = addresses
|
|
self.isFatal = isFatal
|
|
self.retry = retry
|
|
|
|
|
|
def __str__(self):
|
|
if _PY3:
|
|
return self.__bytes__().decode("utf-8")
|
|
else:
|
|
return self.__bytes__()
|
|
|
|
|
|
def __bytes__(self):
|
|
if self.code > 0:
|
|
res = [u"{:03d} {}".format(self.code, self.resp)]
|
|
else:
|
|
res = [self.resp]
|
|
if self.log:
|
|
res.append(self.log)
|
|
res.append(b'')
|
|
for (i, r) in enumerate(res):
|
|
if isinstance(r, unicode):
|
|
res[i] = r.encode('utf-8')
|
|
return b'\n'.join(res)
|
|
|
|
|
|
|
|
class ESMTPClientError(SMTPClientError):
|
|
"""
|
|
Base class for ESMTP client errors.
|
|
"""
|
|
|
|
|
|
|
|
class EHLORequiredError(ESMTPClientError):
|
|
"""
|
|
The server does not support EHLO.
|
|
|
|
This is considered a non-fatal error (the connection will not be dropped).
|
|
"""
|
|
|
|
|
|
|
|
class AUTHRequiredError(ESMTPClientError):
|
|
"""
|
|
Authentication was required but the server does not support it.
|
|
|
|
This is considered a non-fatal error (the connection will not be dropped).
|
|
"""
|
|
|
|
|
|
|
|
class TLSRequiredError(ESMTPClientError):
|
|
"""
|
|
Transport security was required but the server does not support it.
|
|
|
|
This is considered a non-fatal error (the connection will not be dropped).
|
|
"""
|
|
|
|
|
|
|
|
class AUTHDeclinedError(ESMTPClientError):
|
|
"""
|
|
The server rejected our credentials.
|
|
|
|
Either the username, password, or challenge response
|
|
given to the server was rejected.
|
|
|
|
This is considered a non-fatal error (the connection will not be
|
|
dropped).
|
|
"""
|
|
|
|
|
|
|
|
class AuthenticationError(ESMTPClientError):
|
|
"""
|
|
An error occurred while authenticating.
|
|
|
|
Either the server rejected our request for authentication or the
|
|
challenge received was malformed.
|
|
|
|
This is considered a non-fatal error (the connection will not be
|
|
dropped).
|
|
"""
|
|
|
|
|
|
|
|
class SMTPTLSError(ESMTPClientError):
|
|
"""
|
|
An error occurred while negiotiating for transport security.
|
|
|
|
This is considered a non-fatal error (the connection will not be dropped).
|
|
"""
|
|
|
|
|
|
|
|
class SMTPConnectError(SMTPClientError):
|
|
"""
|
|
Failed to connect to the mail exchange host.
|
|
|
|
This is considered a fatal error. A retry will be made.
|
|
"""
|
|
def __init__(self, code, resp, log=None, addresses=None, isFatal=True,
|
|
retry=True):
|
|
SMTPClientError.__init__(self, code, resp, log, addresses, isFatal,
|
|
retry)
|
|
|
|
|
|
|
|
class SMTPTimeoutError(SMTPClientError):
|
|
"""
|
|
Failed to receive a response from the server in the expected time period.
|
|
|
|
This is considered a fatal error. A retry will be made.
|
|
"""
|
|
def __init__(self, code, resp, log=None, addresses=None, isFatal=True,
|
|
retry=True):
|
|
SMTPClientError.__init__(self, code, resp, log, addresses, isFatal,
|
|
retry)
|
|
|
|
|
|
|
|
class SMTPProtocolError(SMTPClientError):
|
|
"""
|
|
The server sent a mangled response.
|
|
|
|
This is considered a fatal error. A retry will not be made.
|
|
"""
|
|
def __init__(self, code, resp, log=None, addresses=None, isFatal=True,
|
|
retry=False):
|
|
SMTPClientError.__init__(self, code, resp, log, addresses, isFatal,
|
|
retry)
|
|
|
|
|
|
|
|
class SMTPDeliveryError(SMTPClientError):
|
|
"""
|
|
Indicates that a delivery attempt has had an error.
|
|
"""
|
|
|
|
|
|
|
|
class SMTPServerError(SMTPError):
|
|
def __init__(self, code, resp):
|
|
self.code = code
|
|
self.resp = resp
|
|
|
|
|
|
def __str__(self):
|
|
return "%.3d %s" % (self.code, self.resp)
|
|
|
|
|
|
|
|
class SMTPAddressError(SMTPServerError):
|
|
def __init__(self, addr, code, resp):
|
|
from twisted.mail.smtp import Address
|
|
|
|
SMTPServerError.__init__(self, code, resp)
|
|
self.addr = Address(addr)
|
|
|
|
|
|
def __str__(self):
|
|
return "%.3d <%s>... %s" % (self.code, self.addr, self.resp)
|
|
|
|
|
|
|
|
class SMTPBadRcpt(SMTPAddressError):
|
|
def __init__(self, addr, code=550,
|
|
resp='Cannot receive for specified address'):
|
|
SMTPAddressError.__init__(self, addr, code, resp)
|
|
|
|
|
|
|
|
class SMTPBadSender(SMTPAddressError):
|
|
def __init__(self, addr, code=550, resp='Sender not acceptable'):
|
|
SMTPAddressError.__init__(self, addr, code, resp)
|
|
|
|
|
|
|
|
class AddressError(SMTPError):
|
|
"""
|
|
Parse error in address
|
|
"""
|
|
|
|
|
|
class POP3Error(Exception):
|
|
"""
|
|
The base class for POP3 errors.
|
|
"""
|
|
pass
|
|
|
|
|
|
|
|
class _POP3MessageDeleted(Exception):
|
|
"""
|
|
An internal control-flow error which indicates that a deleted message was
|
|
requested.
|
|
"""
|
|
|
|
|
|
|
|
class POP3ClientError(Exception):
|
|
"""
|
|
The base class for all exceptions raised by POP3Client.
|
|
"""
|
|
|
|
|
|
|
|
class InsecureAuthenticationDisallowed(POP3ClientError):
|
|
"""
|
|
An error indicating secure authentication was required but no mechanism
|
|
could be found.
|
|
"""
|
|
|
|
|
|
|
|
class TLSError(POP3ClientError):
|
|
"""
|
|
An error indicating secure authentication was required but either the
|
|
transport does not support TLS or no TLS context factory was supplied.
|
|
"""
|
|
|
|
|
|
|
|
class TLSNotSupportedError(POP3ClientError):
|
|
"""
|
|
An error indicating secure authentication was required but the server does
|
|
not support TLS.
|
|
"""
|
|
|
|
|
|
|
|
class ServerErrorResponse(POP3ClientError):
|
|
"""
|
|
An error indicating that the server returned an error response to a
|
|
request.
|
|
|
|
@ivar consumer: See L{__init__}
|
|
"""
|
|
def __init__(self, reason, consumer=None):
|
|
"""
|
|
@type reason: L{bytes}
|
|
@param reason: The server response minus the status indicator.
|
|
|
|
@type consumer: callable that takes L{object}
|
|
@param consumer: The function meant to handle the values for a
|
|
multi-line response.
|
|
"""
|
|
POP3ClientError.__init__(self, reason)
|
|
self.consumer = consumer
|
|
|
|
|
|
|
|
class LineTooLong(POP3ClientError):
|
|
"""
|
|
An error indicating that the server sent a line which exceeded the
|
|
maximum line length (L{LineOnlyReceiver.MAX_LENGTH}).
|
|
"""
|