Documentation update; small pep8 changes to client.py

Author: lavagetto

README.rst

@@ -78,6 +78,15 @@ Atomic Compare and Swap
     client.write('/nodes/n2', 2, prevIndex = 30) # will set /nodes/n2 's value to 2 only if the key was last modified at index 30
     client.test_and_set('/nodes/n2', 2, 4) #equivalent to client.write('/nodes/n2', 2, prevValue = 4)
 
+You can also atomically update a result:
+
+.. code:: python
+
+    result = client.read('/foo')
+    print(result.value) # bar
+    result.value += u'bar'
+    updated = client.update(result) # if any other client wrote '/foo' in the meantime this will fail
+    print(updated.value) # barbar
 
 Watch a key
 ~~~~~~~~~~~

docs-source/index.rst

@@ -62,6 +62,18 @@ Set a key
     client.write('/nodes/queue', 'test', append=True) #will write i.e. /nodes/queue/11
     client.write('/nodes/queue', 'test2', append=True) #will write i.e. /nodes/queue/12
 
+You can also atomically update a result:
+
+.. code:: python
+
+    result = client.read('/foo')
+    print(result.value) # bar
+    result.value += u'bar'
+    updated = client.update(result) # if any other client wrote '/foo' in the meantime this will fail
+    print(updated.value) # barbar
+
+
+
 Get a key
 .........
 

src/etcd/client.py

@@ -348,13 +348,16 @@ def delete(self, key, recursive=None, dir=None, **kwdargs):
 
             key (str):  Key.
 
-            recursive (bool): if we want to recursively delete a directory, set it to true
+            recursive (bool): if we want to recursively delete a directory, set
+                              it to true
 
             dir (bool): if we want to delete a directory, set it to true
 
-            prevValue (str): compare key to this value, and swap only if corresponding (optional).
+            prevValue (str): compare key to this value, and swap only if
+                             corresponding (optional).
 
-            prevIndex (int): modify key only if actual modifiedIndex matches the provided one (optional).
+            prevIndex (int): modify key only if actual modifiedIndex matches the
+                             provided one (optional).
 
         Returns:
             client.EtcdResult
@@ -527,7 +530,7 @@ def _next_server(self):
         except IndexError:
             raise etcd.EtcdException('No more machines in the cluster')
 
-    def api_execute(self, path, method,  params=None, timeout=None):
+    def api_execute(self, path, method, params=None, timeout=None):
         """ Executes the query. """
 
         some_request_failed = False