quite a refactor

.github/workflows/mkdocs.yml

@@ -20,7 +20,6 @@ jobs:
           python-version: 3.x
       - run: echo "cache_id=$(date --utc '+%V')" >> $GITHUB_ENV
 
-
       - uses: actions/cache@v4
         with:
           key: mkdocs-material-${{ env.cache_id }}
@@ -30,6 +29,6 @@ jobs:
       - name: griffe
         # hopefully temporary until https://github.com/mkdocstrings/mkdocstrings/issues/716
         run: pip install git+https://github.com/MarcoGorelli/griffe.git@no-overloads
-      - run: pip install -e .[docs]
+      - run: pip install -e .[docs,dask,duckdb]
 
       - run: mkdocs gh-deploy --force

.github/workflows/pytest.yml

@@ -95,4 +95,4 @@ jobs:
       - name: Run doctests
         # reprs differ between versions, so we only run doctests on the latest Python
         if: matrix.python-version == '3.13'
-        run: pytest narwhals --doctest-modules
+        run: pytest narwhals/*.py --doctest-modules

docs/api-reference/dataframe.md

@@ -44,6 +44,7 @@
         - to_native
         - to_numpy
         - to_pandas
+        - to_polars
         - unique
         - unpivot
         - with_columns

docs/api-reference/selectors.md

@@ -15,6 +15,7 @@ set operations are supported:
         - boolean
         - by_dtype
         - categorical
+        - matches
         - numeric
         - string
       show_root_heading: false

docs/api-reference/series.md

@@ -77,6 +77,7 @@
         - to_list
         - to_numpy
         - to_pandas
+        - to_polars
         - to_native
         - unique
         - value_counts

docs/backcompat.md

@@ -111,6 +111,16 @@ before making any change.
 
 ### After `stable.v1`
 
+The following are differences between the main Narwhals namespace and `narwhals.stable.v1`:
+
+- Since Narwhals 1.23:
+
+  - Passing an `ibis.Table` to `from_native` returns a `LazyFrame`. In
+    `narwhals.stable.v1`, it returns a `DataFrame` with `level='interchange'`.
+  - `eager_or_interchange_only` has been removed from `from_native` and `narwhalify`.
+  - Order-dependent expressions can no longer be used with `narwhals.LazyFrame`.
+  - The following expressions have been deprecated from the main namespace: `Expr.head`,
+    `Expr.tail`, `Expr.gather_every`, `Expr.sample`, `Expr.arg_true`, `Expr.sort`.
 
 - Since Narwhals 1.21, passing a `DuckDBPyRelation` to `from_native` returns a `LazyFrame`. In
   `narwhals.stable.v1`, it returns a `DataFrame` with `level='interchange'`.

docs/extending.md

@@ -107,22 +107,20 @@ the next section for what else you can do.
 We love open source, but we're not "open source absolutists". If you're unable to open
 source you library, then this is how you can make your library compatible with Narwhals.
 
-Make sure that, in addition to the public Narwhals API, you also define:
-
-  - `DataFrame.__narwhals_dataframe__`: return an object which implements public methods
-    from `Narwhals.DataFrame`
-  - `DataFrame.__narwhals_namespace__`: return an object which implements public top-level
-    functions from `narwhals` (e.g. `narwhals.col`, `narwhals.concat`, ...)
-  - `DataFrame.__native_namespace__`: return a native namespace object which must have a
-    `from_dict` method
-  - `LazyFrame.__narwhals_lazyframe__`: return an object which implements public methods
-    from `Narwhals.LazyFrame`
-  - `LazyFrame.__narwhals_namespace__`: return an object which implements public top-level
-    functions from `narwhals` (e.g. `narwhals.col`, `narwhals.concat`, ...)
-  - `LazyFrame.__native_namespace__`: return a native namespace object which must have a
-    `from_dict` method
-  - `Series.__narwhals_series__`: return an object which implements public methods
-    from `Narwhals.Series`
+Make sure that you also define:
+
+  - `DataFrame.__narwhals_dataframe__`: return an object which implements methods from the
+    `CompliantDataFrame` protocol in  `narwhals/typing.py`.
+  - `DataFrame.__narwhals_namespace__`: return an object which implements methods from the
+    `CompliantNamespace` protocol in `narwhals/typing.py`.
+  - `DataFrame.__native_namespace__`: return the object's native namespace.
+  - `LazyFrame.__narwhals_lazyframe__`: return an object which implements methods from the
+    `CompliantLazyFrame` protocol in  `narwhals/typing.py`.
+  - `LazyFrame.__narwhals_namespace__`: return an object which implements methods from the
+    `CompliantNamespace` protocol in `narwhals/typing.py`.
+  - `LazyFrame.__native_namespace__`: return the object's native namespace.
+  - `Series.__narwhals_series__`: return an object which implements methods from the
+    `CompliantSeries` protocol in `narwhals/typing.py`.
 
   If your library doesn't distinguish between lazy and eager, then it's OK for your dataframe
   object to implement both `__narwhals_dataframe__` and `__narwhals_lazyframe__`. In fact,

docs/installation.md

@@ -30,7 +30,7 @@ To verify the installation, start the Python REPL and execute:
 ```python
 >>> import narwhals
 >>> narwhals.__version__
-'1.21.1'
+'1.24.1'
 ```
 
 If you see the version number, then the installation was successful!

narwhals/__init__.py

@@ -79,7 +79,7 @@
 from narwhals.utils import maybe_reset_index
 from narwhals.utils import maybe_set_index
 
-__version__ = "1.21.1"
+__version__ = "1.24.1"
 
 __all__ = [
     "Array",