#7: Added docstrings for structures/incomming.py.

src/edeposit/amqp/rest/structures/incomming.py

@@ -3,19 +3,30 @@
 #
 # Interpreter version: python 2.7
 #
+"""
+Structures which may be used to store data in the REST subsystem.
+"""
 # Imports =====================================================================
 from collections import namedtuple
 
 
-# Variables ===================================================================
 # Functions & classes =========================================================
 class SaveLogin(namedtuple("SaveLogin", ["username", "password_hash"])):
     """
+    Store new login to the user database.
+
+    Attributes:
+        username (str): Name of the user.
+        password_hash (str): Bcrypt password hash.
     """
 
 
 class RemoveLogin(namedtuple("RemoveLogin", ["username"])):
     """
+    Remove user from the database.
+
+    Attributes:
+        username (str): Name of the user.
     """
 
 
@@ -25,11 +36,22 @@ class StatusUpdate(namedtuple("StatusUpdate", ["rest_id",
                                                "pub_url",
                                                "book_name"])):
     """
+    Save new status for the ebook.
+
+    Attributes:
+        rest_id (str): String identifying the user's request.
+        timestamp (float): Timestamp output from ``time.time()``
+        message (str): Content of the message.
+        pub_url (str): URL of the book in edeposit.
+        book_name (str): Name of the book. If not set (=None), it is used from
+            user's metadata.
     """
 
 
 class CacheTick(namedtuple("CacheTick", [])):
     """
     Tick for the cached uploader, telling it that it is OK to upload one more
     request, if present.
+
+    This structure may also emit the :class:`.AfterDBCleanupRequest`.
     """