Merge exp-elixir-branch to trunk. There is enough working to make me feel

confident the Elixir branch is ready to become mainline.  Also, fewer branches
makes for an easier migration to a dvcs.

Don't expect much of the old test suite to work, or even for much of the old
functionality to work.  The changes here are disruptive enough to break higher
level parts of Mailman.  But that's okay because I am slowly building up a new
and improved test suite, which will lead to a functional system again.

For now, only the doctests in Mailman/docs (and their related test harnesses)
will pass, but they all do pass.  Note that Mailman/docs serve as system
documentation first and unit tests second.  You should be able to read the
doctest files to understand the underlying data model.

Other changes included in this merge:

- Added the Mailman.ext extension package.
- zope.interfaces uses to describe major components
- SQLAlchemy/Elixir used as the database model
- Top level doinstall target renamed to justinstall
- 3rd-party packages are now installed in pythonlib/lib/python to be more
  compliant with distutils standards.  This allows us to use just --home
  instead of all the --install-* options.
- No longer need to include the email package or pysqlite, as Python 2.5 is
  required (and comes with both packages).
- munepy package is included, for Python enums
- IRosterSets are added as a way to manage a collection of IRosters.  Roster
  sets are named so that we can maintain the indirection between mailing lists
  and rosters, where the two are maintained in different storages.
- IMailingListRosters: remove_*_roster() -> delete_*_roster()
- Remove IMember interface.
- Utils.list_names() -> config.list_manager.names
- fqdn_listname() takes an optional hostname argument.
- Added a bunch of new exceptions used throughout the new interfaces.
- Make LockFile a context manager for use with the 'with' statement.

1 files changed, 82 insertions, 0 deletions

diff --git a/Mailman/interfaces/usermanager.py b/Mailman/interfaces/usermanager.py
new file mode 100644
index 000000000..302fe9b60
--- /dev/null
+++ b/Mailman/interfaces/usermanager.py
@@ -0,0 +1,82 @@
+# Copyright (C) 2007 by the Free Software Foundation, Inc.
+#
+# This program 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 2
+# of the License, or (at your option) any later version.
+#
+# This program 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 this program; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301,
+# USA.
+
+"""Interface describing a user manager service."""
+
+from zope.interface import Interface, Attribute
+
+
+
+class IUserManager(Interface):
+    """The interface of a global user manager service.
+
+    Different user managers have different concepts of what a user is, and the
+    users managed by different IUserManagers are completely independent.  This
+    is how you can separate the user contexts for different domains, on a
+    multiple domain system.
+
+    There is one special roster, the null roster ('') which contains all
+    IUsers in all IRosters.
+    """
+
+    def create_roster(name):
+        """Create and return the named IRoster.
+
+        Raises RosterExistsError if the named roster already exists.
+        """
+
+    def get_roster(name):
+        """Return the named IRoster.
+
+        Raises NoSuchRosterError if the named roster doesnot yet exist.
+        """
+
+    def delete_roster(name):
+        """Delete the named IRoster.
+
+        Raises NoSuchRosterError if the named roster doesnot yet exist.
+        """
+
+    rosters = Attribute(
+        """An iterator over all IRosters managed by this user manager.""")
+
+    def create_user():
+        """Create and return an IUser."""
+
+    def delete_user(user):
+        """Delete the given IUser."""
+
+    def get_user(address):
+        """Get the user that controls the given email address, or None.
+
+        'address' is a text email address.
+        """
+
+    users = Attribute(
+        """An iterator over all the IUsers managed by this user manager.""")
+
+    def create_rosterset():
+        """Create and return a new IRosterSet.
+
+        IRosterSets manage groups of IRosters.
+        """
+
+    def delete_rosterset(rosterset):
+        """Delete the given IRosterSet."""
+
+    def get_rosterset(serial):
+        """Return the IRosterSet that matches the serial number, or None."""