1# Copyright (C) 2001-2006 Python Software Foundation
2# Author: Barry Warsaw
3# Contact: email-sig@python.org
4
5"""email package exception classes."""
6
7
8class MessageError(Exception):
9    """Base class for errors in the email package."""
10
11
12class MessageParseError(MessageError):
13    """Base class for message parsing errors."""
14
15
16class HeaderParseError(MessageParseError):
17    """Error while parsing headers."""
18
19
20class BoundaryError(MessageParseError):
21    """Couldn't find terminating boundary."""
22
23
24class MultipartConversionError(MessageError, TypeError):
25    """Conversion to a multipart is prohibited."""
26
27
28class CharsetError(MessageError):
29    """An illegal charset was given."""
30
31
32# These are parsing defects which the parser was able to work around.
33class MessageDefect(ValueError):
34    """Base class for a message defect."""
35
36    def __init__(self, line=None):
37        if line is not None:
38            super().__init__(line)
39        self.line = line
40
41class NoBoundaryInMultipartDefect(MessageDefect):
42    """A message claimed to be a multipart but had no boundary parameter."""
43
44class StartBoundaryNotFoundDefect(MessageDefect):
45    """The claimed start boundary was never found."""
46
47class CloseBoundaryNotFoundDefect(MessageDefect):
48    """A start boundary was found, but not the corresponding close boundary."""
49
50class FirstHeaderLineIsContinuationDefect(MessageDefect):
51    """A message had a continuation line as its first header line."""
52
53class MisplacedEnvelopeHeaderDefect(MessageDefect):
54    """A 'Unix-from' header was found in the middle of a header block."""
55
56class MissingHeaderBodySeparatorDefect(MessageDefect):
57    """Found line with no leading whitespace and no colon before blank line."""
58# XXX: backward compatibility, just in case (it was never emitted).
59MalformedHeaderDefect = MissingHeaderBodySeparatorDefect
60
61class MultipartInvariantViolationDefect(MessageDefect):
62    """A message claimed to be a multipart but no subparts were found."""
63
64class InvalidMultipartContentTransferEncodingDefect(MessageDefect):
65    """An invalid content transfer encoding was set on the multipart itself."""
66
67class UndecodableBytesDefect(MessageDefect):
68    """Header contained bytes that could not be decoded"""
69
70class InvalidBase64PaddingDefect(MessageDefect):
71    """base64 encoded sequence had an incorrect length"""
72
73class InvalidBase64CharactersDefect(MessageDefect):
74    """base64 encoded sequence had characters not in base64 alphabet"""
75
76class InvalidBase64LengthDefect(MessageDefect):
77    """base64 encoded sequence had invalid length (1 mod 4)"""
78
79# These errors are specific to header parsing.
80
81class HeaderDefect(MessageDefect):
82    """Base class for a header defect."""
83
84    def __init__(self, *args, **kw):
85        super().__init__(*args, **kw)
86
87class InvalidHeaderDefect(HeaderDefect):
88    """Header is not valid, message gives details."""
89
90class HeaderMissingRequiredValue(HeaderDefect):
91    """A header that must have a value had none"""
92
93class NonPrintableDefect(HeaderDefect):
94    """ASCII characters outside the ascii-printable range found"""
95
96    def __init__(self, non_printables):
97        super().__init__(non_printables)
98        self.non_printables = non_printables
99
100    def __str__(self):
101        return ("the following ASCII non-printables found in header: "
102            "{}".format(self.non_printables))
103
104class ObsoleteHeaderDefect(HeaderDefect):
105    """Header uses syntax declared obsolete by RFC 5322"""
106
107class NonASCIILocalPartDefect(HeaderDefect):
108    """local_part contains non-ASCII characters"""
109    # This defect only occurs during unicode parsing, not when
110    # parsing messages decoded from binary.
111
112class InvalidDateDefect(HeaderDefect):
113    """Header has unparsable or invalid date"""
114