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
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
|
# Copyright (C) 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/>.
"""Module stuff."""
from __future__ import absolute_import, unicode_literals
__metaclass__ = type
__all__ = [
'DomainCollection',
]
from operator import attrgetter
from zope.component import getUtility
from zope.interface import implements
from zope.publisher.interfaces import NotFound
from mailman.app.membership import add_member, delete_member
from mailman.core.constants import system_preferences
from mailman.interfaces.address import InvalidEmailAddressError
from mailman.interfaces.domain import IDomainCollection, IDomainManager
from mailman.interfaces.listmanager import IListManager, NoSuchListError
from mailman.interfaces.member import DeliveryMode, NotAMemberError
from mailman.interfaces.membership import ISubscriptionService
from mailman.interfaces.rest import IResolvePathNames
class DomainCollection:
"""Sets of known domains."""
implements(IDomainCollection, IResolvePathNames)
__name__ = 'domains'
def get_domains(self):
"""See `IDomainCollection`."""
# lazr.restful requires the return value to be a concrete list.
return sorted(getUtility(IDomainManager), key=attrgetter('email_host'))
def get(self, name):
"""See `IResolvePathNames`."""
domain = getUtility(IDomainManager).get(name)
if domain is None:
raise NotFound(self, name)
return domain
def new(self, email_host, description=None, base_url=None,
contact_address=None):
"""See `IDomainCollection`."""
value = getUtility(IDomainManager).add(
email_host, description, base_url, contact_address)
return value
class SubscriptionService:
"""Subscription services for the REST API."""
implements(ISubscriptionService, IResolvePathNames)
__name__ = 'members'
def get_members(self):
"""See `ISubscriptionService`."""
# lazr.restful requires the return value to be a concrete list.
members = []
address_of_member = attrgetter('address.address')
list_manager = getUtility(IListManager)
for fqdn_listname in sorted(list_manager.names):
mailing_list = list_manager.get(fqdn_listname)
members.extend(
sorted((member for member in mailing_list.owners.members),
key=address_of_member))
members.extend(
sorted((member for member in mailing_list.moderators.members),
key=address_of_member))
members.extend(
sorted((member for member in mailing_list.members.members),
key=address_of_member))
return members
def join(self, fqdn_listname, address,
real_name= None, delivery_mode=None):
"""See `ISubscriptionService`."""
mlist = getUtility(IListManager).get(fqdn_listname)
if mlist is None:
raise NoSuchListError(fqdn_listname)
# Convert from string to enum. Allow ValueError exceptions to be
# returned by the API. XXX 2009-12-30 Does lazr.restful intelligently
# handle ValueError?
mode = (DeliveryMode.regular
if delivery_mode is None
else DeliveryMode(delivery_mode))
if real_name is None:
real_name, at, domain = address.partition('@')
if len(at) == 0:
# It can't possibly be a valid email address.
raise InvalidEmailAddressError(address)
# Because we want to keep the REST API simple, there is no password or
# language given to us. We'll use the system's default language for
# the user's default language. We'll set the password to None. XXX
# Is that a good idea? Maybe we should set it to something else,
# except that once we encode the password (as we must do to avoid
# cleartext passwords in the database) we'll never be able to retrieve
# it.
#
# Note that none of these are used unless the address is completely
# new to us.
return add_member(mlist, address, real_name, None, mode,
system_preferences.preferred_language)
def leave(self, fqdn_listname, address):
"""See `ISubscriptionService`."""
mlist = getUtility(IListManager).get(fqdn_listname)
if mlist is None:
raise NoSuchListError(fqdn_listname)
# XXX for now, no notification or user acknowledgement.
delete_member(mlist, address, False, False)
return ''
|
