Add driver autogenerated docs

Start to add/build a developer oriented doc that
can be further refined to explain to developers how
to use the different tooz drivers (and what the varying
drivers capabilities are).

Change-Id: I49f6bf5b397d6bc5426c074f6196c764c8938d23

doc/source/conf.py

@@ -31,6 +31,8 @@ extensions = [
     'sphinx.ext.graphviz',
     'sphinx.ext.extlinks',
     'oslosphinx',
+    'sphinx.ext.inheritance_diagram',
+    'sphinx.ext.viewcode',
 ]
 
 # Add any paths that contain templates here, relative to this directory.

doc/source/developers.rst

@@ -0,0 +1,54 @@
+==========
+Developers
+==========
+
+Interfaces
+----------
+
+.. autoclass:: tooz.coordination.CoordinationDriver
+   :members:
+
+IPC
+~~~
+
+.. autoclass:: tooz.drivers.ipc.IPCDriver
+   :members:
+
+Memcached
+~~~~~~~~~
+
+.. autoclass:: tooz.drivers.memcached.MemcachedDriver
+   :members:
+
+Mysql
+~~~~~
+
+.. autoclass:: tooz.drivers.mysql.MySQLDriver
+   :members:
+
+PostgreSQL
+~~~~~~~~~~
+
+.. autoclass:: tooz.drivers.pgsql.PostgresDriver
+   :members:
+
+Redis
+~~~~~
+
+.. autoclass:: tooz.drivers.redis.RedisDriver
+   :members:
+
+Zake
+~~~~
+
+.. autoclass:: tooz.drivers.zake.ZakeDriver
+   :members:
+
+Zookeeper
+~~~~~~~~~
+
+.. autoclass:: tooz.drivers.zookeeper.BaseZooKeeperDriver
+   :members:
+
+.. autoclass:: tooz.drivers.zookeeper.KazooDriver
+   :members:

doc/source/index.rst

@@ -13,6 +13,7 @@ Contents:
    install
    drivers
    tutorial/index
+   developers
 
 Indices and tables
 ==================

tooz/drivers/ipc.py

@@ -120,6 +120,7 @@ class IPCLock(locking.Lock):
 
 
 class IPCDriver(coordination.CoordinationDriver):
+    """A IPC based driver."""
 
     def __init__(self, member_id, parsed_url, options):
         """Initialize the IPC driver."""

tooz/drivers/memcached.py

@@ -79,6 +79,7 @@ class MemcachedLock(locking.Lock):
 
 
 class MemcachedDriver(coordination.CoordinationDriver):
+    """A memcached based driver."""
 
     _GROUP_PREFIX = b'_TOOZ_GROUP_'
     _GROUP_LEADER_PREFIX = b'_TOOZ_GROUP_LEADER_'

tooz/drivers/mysql.py

@@ -67,6 +67,7 @@ class MySQLLock(locking.Lock):
 
 
 class MySQLDriver(coordination.CoordinationDriver):
+    """A mysql based driver."""
 
     def __init__(self, member_id, parsed_url, options):
         """Initialize the MySQL driver."""

tooz/drivers/pgsql.py

@@ -127,6 +127,7 @@ class PostgresLock(locking.Lock):
 
 
 class PostgresDriver(coordination.CoordinationDriver):
+    """A PostgreSQL based driver."""
 
     def __init__(self, member_id, parsed_url, options):
         """Initialize the PostgreSQL driver."""