docs(rows): add examples showing the rows returned by basic factories

diff --git a/docs/api/rows.rst b/docs/api/rows.rst
index 15dfd3cadcea60845a1aea0c846c5fd3cfd27e67..0c9d1fb37faa1242b570722bd5265c4f840659b1 100644 (file)
--- a/docs/api/rows.rst
+++ b/docs/api/rows.rst
@@ -12,11 +12,38 @@ the basic tuples.
 Check out :ref:`row-factory-create` for information about how to use these objects.
 
 .. autofunction:: tuple_row
+
+    Example::
+
+        >>> cur = conn.cursor(row_factory=tuple_row)
+        >>> cur.execute("SELECT 10 AS foo, 'hello' AS bar").fetchone()
+        (10, 'hello')
+
 .. autofunction:: dict_row
+
+    Example::
+
+        >>> cur = conn.cursor(row_factory=dict_row)
+        >>> cur.execute("SELECT 10 AS foo, 'hello' AS bar").fetchone()
+        {'foo': 10, 'bar': 'hello'}
+
 .. autofunction:: namedtuple_row
+
+    Example::
+
+        >>> cur = conn.cursor(row_factory=namedtuple_row)
+        >>> cur.execute("SELECT 10 AS foo, 'hello' AS bar").fetchone()
+        Row(foo=10, bar='hello')
+
 .. autofunction:: scalar_row
 
-        .. versionadded:: 3.2
+    Example::
+
+        >>> cur = conn.cursor(row_factory=scalar_row)
+        >>> cur.execute("SELECT 10 AS foo, 'hello' AS bar").fetchone()
+        10
+
+    .. versionadded:: 3.2
 
 .. autofunction:: class_row