docs(examples): add distinct argument example for intersect

Author: IndexSeek

ibis/expr/api.py

@@ -2079,11 +2079,15 @@ def intersect(table: ir.Table, *rest: ir.Table, distinct: bool = True) -> ir.Tab
     Table
         A new table containing the intersection of all input tables.
 
+    See Also
+    --------
+    [`Table.intersect`](./expression-tables.qmd#ibis.expr.types.relations.Table.intersect)
+
     Examples
     --------
     >>> import ibis
     >>> ibis.options.interactive = True
-    >>> t1 = ibis.memtable({"a": [1, 2]})
+    >>> t1 = ibis.memtable({"a": [1, 2, 2]})
     >>> t1
     ┏━━━━━━━┓
     ┃ a     ┃
@@ -2092,15 +2096,17 @@ def intersect(table: ir.Table, *rest: ir.Table, distinct: bool = True) -> ir.Tab
     ├───────┤
     │     1 │
     │     2 │
+    │     2 │
     └───────┘
-    >>> t2 = ibis.memtable({"a": [2, 3]})
+    >>> t2 = ibis.memtable({"a": [2, 2, 3]})
     >>> t2
     ┏━━━━━━━┓
     ┃ a     ┃
     ┡━━━━━━━┩
     │ int64 │
     ├───────┤
     │     2 │
+    │     2 │
     │     3 │
     └───────┘
     >>> ibis.intersect(t1, t2)
@@ -2111,7 +2117,15 @@ def intersect(table: ir.Table, *rest: ir.Table, distinct: bool = True) -> ir.Tab
     ├───────┤
     │     2 │
     └───────┘
-
+    >>> ibis.intersect(t1, t2, distinct=False)
+    ┏━━━━━━━┓
+    ┃ a     ┃
+    ┡━━━━━━━┩
+    │ int64 │
+    ├───────┤
+    │     2 │
+    │     2 │
+    └───────┘
     """
     return table.intersect(*rest, distinct=distinct) if rest else table
 

ibis/expr/types/relations.py

@@ -1718,7 +1718,7 @@ def intersect(self, table: Table, *rest: Table, distinct: bool = True) -> Table:
         --------
         >>> import ibis
         >>> ibis.options.interactive = True
-        >>> t1 = ibis.memtable({"a": [1, 2]})
+        >>> t1 = ibis.memtable({"a": [1, 2, 2]})
         >>> t1
         ┏━━━━━━━┓
         ┃ a     ┃
@@ -1727,15 +1727,17 @@ def intersect(self, table: Table, *rest: Table, distinct: bool = True) -> Table:
         ├───────┤
         │     1 │
         │     2 │
+        │     2 │
         └───────┘
-        >>> t2 = ibis.memtable({"a": [2, 3]})
+        >>> t2 = ibis.memtable({"a": [2, 2, 3]})
         >>> t2
         ┏━━━━━━━┓
         ┃ a     ┃
         ┡━━━━━━━┩
         │ int64 │
         ├───────┤
         │     2 │
+        │     2 │
         │     3 │
         └───────┘
         >>> t1.intersect(t2)
@@ -1746,6 +1748,15 @@ def intersect(self, table: Table, *rest: Table, distinct: bool = True) -> Table:
         ├───────┤
         │     2 │
         └───────┘
+        >>> t1.intersect(t2, distinct=False)
+        ┏━━━━━━━┓
+        ┃ a     ┃
+        ┡━━━━━━━┩
+        │ int64 │
+        ├───────┤
+        │     2 │
+        │     2 │
+        └───────┘
         """
         return self._assemble_set_op(ops.Intersection, table, *rest, distinct=distinct)