Lots of work to update the model for users, passwords, membership, testing,

and the REST API.   A highlight of the merged changes:

* The REST API now has a /users top-level URL under which user information can
  be accessed, and new users can be created.
* IUsers now have a unique `user_id` which is evident in the REST API.  Under
  testing, these uids are predictable, but otherwise, they're entirely random
  but guaranteed to be unique.
* IUsers now have a `created_on` attribute.  Like `user_id` these are
  predictable under testing, but otherwise reflect the actual date.
* User passwords are now 'encrypted' (hashed) as defined by the config file.
  - new mailman.cfg variables password_scheme and password_length
* IMember gets a `user` attribute which is a convenience for getting the IUser
  associated with the member.
* mmsitepass is gone:
  - creator_pw_file
  - site_pw_file
* Improved test initialization and its hook into zc.buildout.

1 files changed, 3 insertions, 1 deletions

diff --git a/src/mailman/tests/test_documentation.py b/src/mailman/tests/test_documentation.py
index 23cc189d0..2a72a367f 100644
--- a/src/mailman/tests/test_documentation.py
+++ b/src/mailman/tests/test_documentation.py
@@ -126,7 +126,7 @@ def dump_list(list_of_things, key=str):
 
 
 def call_http(url, data=None, method=None, username=None, password=None):
-    """'Call' a URL with a given HTTP method and return the resulting object.
+    """'Call a URL with a given HTTP method and return the resulting object.
 
     The object will have been JSON decoded.
 
@@ -142,6 +142,8 @@ def call_http(url, data=None, method=None, username=None, password=None):
     :param password: The HTTP Basic Auth password.  None means use the value
         from the configuration.
     :type username: str
+    :return: The decoded JSON data structure.
+    :raises HTTPError: when a non-2xx return code is received.
     """
     headers = {}
     if data is not None: