blob: f4c185cd2579d2571cd7d658fdd51c52d8f32411 (
plain)
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
|
# 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/>.
"""Interfaces for list styles."""
from __future__ import absolute_import, unicode_literals
__metaclass__ = type
__all__ = [
'DuplicateStyleError',
'IStyle',
'IStyleManager',
]
from zope.interface import Interface, Attribute
from mailman.interfaces.errors import MailmanError
class DuplicateStyleError(MailmanError):
"""A style with the same name is already registered."""
class IStyle(Interface):
"""Application of a style to an existing mailing list."""
name = Attribute(
"""The name of this style. Must be unique.""")
def apply(mailing_list):
"""Apply the style to the mailing list.
:type mailing_list: `IMailingList`.
:param mailing_list: the mailing list to apply the style to.
"""
class IStyleManager(Interface):
"""A manager of styles."""
def get(name):
"""Return the named style or None.
:type name: string
:param name: A style name.
:return: the named `IStyle` or None if the style doesn't exist.
"""
styles = Attribute(
'An iterator over all the styles known by this manager.')
def populate():
"""Populate the styles from the configuration files.
This clears the current set of styles and resets them from those
defined in the configuration files.
"""
def register(style):
"""Register a style with this manager.
:param style: an IStyle.
:raises DuplicateStyleError: if a style with the same name was already
registered.
"""
def unregister(style):
"""Unregister the style.
:param style: an IStyle.
:raises KeyError: If the style's name is not currently registered.
"""
|
