change way to describe fields of CapBaseObject, and lot of documentation

weboob/tools/capabilities/bank/transactions.py

@@ -30,6 +30,9 @@ __all__ = ['FrenchTransaction']
 
 
 class FrenchTransaction(Transaction):
+    """
+    Transaction with some helpers for french bank websites.
+    """
     PATTERNS = []
 
     def clean_amount(self, text):
@@ -61,7 +64,7 @@ class FrenchTransaction(Transaction):
 
         When calling this method, you should have defined patterns (in the
         PATTERN class attribute) with a list containing tuples of regexp
-        and the associated type, for example:
+        and the associated type, for example::
 
             PATTERNS = [(re.compile('^VIR(EMENT)? (?P<text>.*)'), FrenchTransaction.TYPE_TRANSFER),
                         (re.compile('^PRLV (?P<text>.*)'),        FrenchTransaction.TYPE_ORDER),
@@ -70,8 +73,9 @@ class FrenchTransaction(Transaction):
                        ]
 
         In regexps, you can define this patterns:
-            - text: part of label to store in simplified label
-            - yy, mm, dd, HH, MM: date and time parts
+
+            * text: part of label to store in simplified label
+            * yy, mm, dd, HH, MM: date and time parts
         """
         if not isinstance(date, (datetime.date, datetime.datetime)):
             if date.isdigit() and len(date) == 8:

weboob/tools/capabilities/messages/GenericBackend.py

@@ -27,7 +27,9 @@ from weboob.tools.newsfeed import Newsfeed
 
 
 class GenericNewspaperBackend(BaseBackend, ICapMessages):
-    "GenericNewspaperBackend class"
+    """
+    GenericNewspaperBackend class
+    """
     MAINTAINER = 'Julien Hebert'
     EMAIL = 'juke@free.fr'
     VERSION = '0.c'

weboob/tools/capabilities/thumbnail.py

@@ -17,13 +17,23 @@
 # You should have received a copy of the GNU Affero General Public License
 # along with weboob. If not, see <http://www.gnu.org/licenses/>.
 
-from weboob.capabilities.base import CapBaseObject, NotLoaded
+from weboob.capabilities.base import CapBaseObject, NotLoaded, StringField, BytesField
+
+
+__all__ = ['Thumbnail']
+
 
 class Thumbnail(CapBaseObject):
+    """
+    Thumbnail of an image.
+    """
+
+    url =   StringField('URL to photo thumbnail')
+    data =  BytesField('Data')
+
     def __init__(self, url):
         CapBaseObject.__init__(self, url)
-        self.add_field('url', basestring, url.replace(' ', '%20'))
-        self.add_field('data', str)
+        self.url = url.replace(' ', '%20')
 
     def __str__(self):
         return self.url