Add API for the update_seq option on view results (fixes #228)

dorins · dorins · commit 150246452a92 · 2014-07-06T13:52:58.000+02:00
diff --git a/couchdb/client.py b/couchdb/client.py
@@ -1150,7 +1150,7 @@ class ViewResults(object):
     def __init__(self, view, options):
         self.view = view
         self.options = options
-        self._rows = self._total_rows = self._offset = None
+        self._rows = self._total_rows = self._offset = self._update_seq = None
 
     def __repr__(self):
         return '<%s %r %r>' % (type(self).__name__, self.view, self.options)
@@ -1179,6 +1179,7 @@ def _fetch(self):
         self._rows = [wrapper(row) for row in data['rows']]
         self._total_rows = data.get('total_rows')
         self._offset = data.get('offset', 0)
+        self._update_seq = data.get('update_seq')
 
     @property
     def rows(self):
@@ -1214,6 +1215,20 @@ def offset(self):
             self._fetch()
         return self._offset
 
+    @property
+    def update_seq(self):
+        """The database update sequence that the view reflects.
+
+        The update sequence is included in the view result only when it is
+        explicitly requested using the `update_seq=true` query option.
+        Otherwise, the value is None.
+
+        :rtype: `int` or `NoneType` depending on the query options
+        """
+        if self._rows is None:
+            self._fetch()
+        return self._update_seq
+
 
 class Row(dict):
     """Representation of a row as returned by database views."""
