1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
|
# Copyright (C) 2007-2009 by the Free Software Foundation, Inc.
#
# This file is part of GNU Mailman.
#
# GNU Mailman 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 3 of the License, or (at your option)
# any later version.
#
# GNU Mailman 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
# GNU Mailman. If not, see <http://www.gnu.org/licenses/>.
"""Interface for email address related information."""
from __future__ import absolute_import, unicode_literals
__metaclass__ = type
__all__ = [
'AddressAlreadyLinkedError',
'AddressError',
'AddressNotLinkedError',
'ExistingAddressError',
'IAddress',
]
from zope.interface import Interface, Attribute
from mailman.interfaces.errors import MailmanError
class AddressError(MailmanError):
"""A general address-related error occurred."""
class ExistingAddressError(AddressError):
"""The given email address already exists."""
class AddressAlreadyLinkedError(AddressError):
"""The address is already linked to a user."""
class AddressNotLinkedError(AddressError):
"""The address is not linked to the user."""
class IAddress(Interface):
"""Email address related information."""
address = Attribute(
"""Read-only text email address.""")
original_address = Attribute(
"""Read-only original case-preserved address.
For almost all intents and purposes, addresses in Mailman are case
insensitive, however because RFC 2821 allows for case sensitive local
parts, Mailman preserves the case of the original address when
emailing the user.
`original_address` will be the same as address if the original address
was all lower case. Otherwise `original_address` will be the case
preserved address; `address` will always be lower case.
""")
real_name = Attribute(
"""Optional real name associated with the email address.""")
registered_on = Attribute(
"""The date and time at which this email address was registered.
Registeration is really the date at which this address became known to
us. It may have been explicitly registered by a user, or it may have
been implicitly registered, e.g. by showing up in a non-member
posting.""")
verified_on = Attribute(
"""The date and time at which this email address was validated, or
None if the email address has not yet been validated. The specific
method of validation is not defined here.""")
def subscribe(mailing_list, role):
"""Subscribe the address to the given mailing list with the given role.
:param mailing_list: The IMailingList being subscribed to.
:param role: A MemberRole enum value.
:return: The IMember representing this subscription.
:raises AlreadySubscribedError: If the address is already subscribed
to the mailing list with the given role.
"""
preferences = Attribute(
"""This address's preferences.""")
|
