docs(name): improve docstring of Value.name API

ibis-project · Dec 17, 2023 · dd66af2 · dd66af2
1 parent 5b0f987
commit dd66af2
Showing 1 changed file with 19 additions and 4 deletions.
diff --git a/ibis/expr/types/generic.py b/ibis/expr/types/generic.py
@@ -42,11 +42,26 @@ def name(self, name):
         Examples
         --------
         >>> import ibis
-        >>> t = ibis.table(dict(a="int64"), name="t")
+        >>> ibis.options.interactive = True
+        >>> t = ibis.memtable({"a": [1, 2]}, name="t")
+        >>> t.a
+        ┏━━━━━━━┓
+        ┃ a     ┃
+        ┡━━━━━━━┩
+        │ int64 │
+        ├───────┤
+        │     1 │
+        │     2 │
+        └───────┘
         >>> t.a.name("b")
-        r0 := UnboundTable: t
-          a int64
-        b: r0.a
+        ┏━━━━━━━┓
+        ┃ b     ┃
+        ┡━━━━━━━┩
+        │ int64 │
+        ├───────┤
+        │     1 │
+        │     2 │
+        └───────┘
         """
         # TODO(kszucs): shouldn't do simplification here, but rather later
         # when simplifying the whole operation tree