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
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
|
# Copyright (C) 2007-2014 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 representing domains."""
from __future__ import absolute_import, print_function, unicode_literals
__metaclass__ = type
__all__ = [
'BadDomainSpecificationError',
'DomainCreatedEvent',
'DomainCreatingEvent',
'DomainDeletedEvent',
'DomainDeletingEvent',
'IDomain',
'IDomainManager',
]
from mailman.core.errors import MailmanError
from zope.interface import Interface, Attribute
class BadDomainSpecificationError(MailmanError):
"""The specification of a virtual domain is invalid or duplicated."""
def __init__(self, domain):
super(BadDomainSpecificationError, self).__init__(domain)
self.domain = domain
class DomainCreatingEvent:
"""A domain is about to be created."""
def __init__(self, mail_host):
self.mail_host = mail_host
class DomainCreatedEvent:
"""A domain was created."""
def __init__(self, domain):
self.domain = domain
class DomainDeletingEvent:
"""A domain is about to be deleted."""
def __init__(self, domain):
self.domain = domain
class DomainDeletedEvent:
"""A domain was deleted."""
def __init__(self, mail_host):
self.mail_host = mail_host
class IDomain(Interface):
"""Interface representing domains."""
mail_host = Attribute('The host name for email for this domain.')
url_host = Attribute(
'The host name for the web interface for this domain.')
base_url = Attribute("""\
The base url for the Mailman server at this domain, which includes the
scheme and host name.""")
scheme = Attribute(
"""The protocol scheme used to contact this list's server.""")
description = Attribute(
'The human readable description of the domain name.')
contact_address = Attribute("""\
The contact address for the human at this domain.
E.g. postmaster@example.com""")
mailing_lists = Attribute(
"""All mailing lists for this domain.
The mailing lists are returned in order sorted by list-id.
""")
def confirm_url(token=''):
"""The url used for various forms of confirmation.
:param token: The confirmation token to use in the url.
:type token: string
:return: The confirmation url.
:rtype: string
"""
class IDomainManager(Interface):
"""The manager of domains."""
def add(mail_host, description=None, base_url=None, contact_address=None):
"""Add a new domain.
:param mail_host: The email host name for the domain.
:type mail_host: string
:param description: The description of the domain.
:type description: string
:param base_url: The base url, including the scheme for the web
interface of the domain. If not given, it defaults to
http://`mail_host`/
:type base_url: string
:param contact_address: The email contact address for the human
managing the domain. If not given, defaults to
postmaster@`mail_host`
:type contact_address: string
:return: The new domain object
:rtype: `IDomain`
:raises `BadDomainSpecificationError`: when the `mail_host` is
already registered.
"""
def remove(mail_host):
"""Remove the domain.
:param mail_host: The email host name of the domain to remove.
:type mail_host: string
:raises KeyError: if the named domain does not exist.
"""
def __getitem__(mail_host):
"""Return the named domain.
:param mail_host: The email host name of the domain to remove.
:type mail_host: string
:return: The domain object.
:rtype: `IDomain`
:raises KeyError: if the named domain does not exist.
"""
def get(mail_host, default=None):
"""Return the named domain.
:param mail_host: The email host name of the domain to remove.
:type mail_host: string
:param default: What to return if the named domain does not exist.
:type default: object
:return: The domain object or None if the named domain does not exist.
:rtype: `IDomain`
"""
def __iter__():
"""An iterator over all the domains.
Domains are returned sorted by `mail_host`.
:return: iterator over `IDomain`.
"""
def __contains__(mail_host):
"""Is this a known domain?
:param mail_host: An email host name.
:type mail_host: string
:return: True if this domain is known.
:rtype: bool
"""
|
