1 files changed, 77 insertions, 0 deletions

diff --git a/src/mailman/interfaces/preferences.py b/src/mailman/interfaces/preferences.py
new file mode 100644
index 000000000..9aeed8496
--- /dev/null
+++ b/src/mailman/interfaces/preferences.py
@@ -0,0 +1,77 @@
+# 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 preferences."""
+
+from __future__ import absolute_import, unicode_literals
+
+__metaclass__ = type
+__all__ = [
+    'IPreferences',
+    ]
+
+
+from zope.interface import Interface, Attribute
+
+
+
+class IPreferences(Interface):
+    """Delivery related information."""
+
+    acknowledge_posts = Attribute(
+        """Send an acknowledgment for every posting?
+
+        This preference can be True, False, or None.  True means the user is
+        sent a receipt for each message they send to the mailing list.  False
+        means that no receipt is sent.  None means no preference is
+        specified.""")
+
+    preferred_language = Attribute(
+        """The preferred language for interacting with a mailing list.
+
+        This is either the language code for the preferred language, or None
+        meaning no preferred language is specified.""")
+
+    receive_list_copy = Attribute(
+        """Should an explicit recipient receive a list copy?
+
+        When a list member is explicitly named in a message's recipients
+        (e.g. the To or CC headers), and this preference is True, the
+        recipient will still receive a list copy of the message.  When False,
+        this list copy will be suppressed.  None means no preference is
+        specified.""")
+
+    receive_own_postings = Attribute(
+        """Should the poster get a list copy of their own messages?
+
+        When this preference is True, a list copy will be sent to the poster
+        of all messages.  When False, this list copy will be suppressed.  None
+        means no preference is specified.""")
+
+    delivery_mode = Attribute(
+        """The preferred delivery mode.
+
+        This is an enum constant of the type DeliveryMode.  It may also be
+        None which means that no preference is specified.""")
+
+    delivery_status = Attribute(
+        """The delivery status.
+
+        This is an enum constant of type DeliveryStatus.  It may also be None
+        which means that no preference is specified.
+
+        XXX I'm not sure this is the right place to put this.""")