Update the IUser interface and tests, specifically as it relates to

preferences.  IAddresses, IUsers, and IMembers all get preferences by default,
althoughthe attributes of these preferences are None by default.

IMailingLists don't get preferences by default though; because these live in
the user database, we can't cross-polinate them in the mailing lists.  We'll
figure something out later for these.

IUser.register(): Add this method which registers and links an address to the
user.

Allow EnumType database columns to accept and return Nones.  This is useful
for when the columns are not defined NOT NULL.

Update doctests.

Removed teh hide_address preference.  I can't think of a reason not to want to
hide addresses for everyone.

1 files changed, 12 insertions, 7 deletions

diff --git a/Mailman/interfaces/user.py b/Mailman/interfaces/user.py
index 9e89c2416..f7647597d 100644
--- a/Mailman/interfaces/user.py
+++ b/Mailman/interfaces/user.py
@@ -30,19 +30,21 @@ class IUser(Interface):
     password = Attribute(
         """This user's password information.""")
 
-    preferences = Attribute(
-        """The default preferences for this user.""")
-
     addresses = Attribute(
         """An iterator over all the IAddresses controlled by this user.""")
 
-    def register(address):
+    def register(address, real_name=None):
         """Register the given email address and link it to this user.
 
         In this case, 'address' is a text email address, not an IAddress
-        object.  Raises AddressAlreadyLinkedError if this IAddress is already
-        linked to another user.  If the corresponding IAddress already exists
-        but is not linked, then it is simply linked to the user.
+        object.  If real_name is not given, the empty string is used.
+
+        Raises AddressAlreadyLinkedError if this IAddress is already linked to
+        another user.  If the corresponding IAddress already exists but is not
+        linked, then it is simply linked to the user, in which case
+        real_name is ignored.
+
+        Return the new IAddress object.
         """
 
     def link(address):
@@ -66,3 +68,6 @@ class IUser(Interface):
         'address' is a text email address.  This method returns true if the
         user controls the given email address, otherwise false.
         """
+
+    preferences = Attribute(
+        """This user's preferences.""")