📝 Document .in_() method (#619)

* Document IN()

* Update "includes" and "tip" formatting in `where.md`

* Fix code block formatting in `where.md`

* Fix link in `where.md`

* Rename code example, add `_py310` version

---------

Co-authored-by: Motov Yurii <109919500+YuriiMotov@users.noreply.github.com>
Co-authored-by: Yurii Motov <yurii.motov.monte@gmail.com>
This commit is contained in:
Pau Ramon Revilla
2026-03-04 13:13:04 +01:00
committed by GitHub
parent 4f5700339f
commit 421072293a
4 changed files with 168 additions and 1 deletions

View File

@@ -562,7 +562,7 @@ We could imagine that **Spider-Boy** is even **younger**. But because we don't k
### Less Than or Equal
Finally, we can use `<=` to get the rows where a column is **less than or equal** to a value:
We can also use `<=` to get the rows where a column is **less than or equal** to a value:
{* ./docs_src/tutorial/where/tutorial006_py310.py ln[42:47] hl[44] *}
@@ -579,6 +579,22 @@ We get `Black Lion` here too because although the age is not *strictly* less tha
///
### In
Finally, we can use `in_` to get the rows where a column is a member of a collection of values:
{* ./docs_src/tutorial/where/tutorial006b_py310.py ln[42:47] hl[44] *}
In this case, we match `Deadpond` since it's part of the collections of names.
We don't have any hero called `Ratman`, so it does not match any hero.
/// tip
You need to wrap your attribute with `col()` to use `in_`.
You can read more about it in the [Type annotations and errors](#type-annotations-and-errors){.internal-link target=_blank} section.
///
### Benefits of Expressions
Here's a good moment to see that being able to use these pure Python expressions instead of keyword arguments can help a lot. ✨