Merge remote-tracking branch 'upstream/main' into more-dedup-1

Author: dangotbanned

.github/workflows/mkdocs.yml

@@ -26,9 +26,7 @@ jobs:
           path: .cache
           restore-keys: |
             mkdocs-material-
-      - 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,dask,duckdb]
-
-      - run: mkdocs gh-deploy --force
+      - name: Install dependencies
+        run: pip install -e .[docs,dask,duckdb]
+      - name: Deploy docs
+        run: mkdocs gh-deploy --force

CONTRIBUTING.md

@@ -111,15 +111,6 @@ If you want to run PySpark-related tests, you'll need to have Java installed. Re
    If you also want to test other libraries like Dask , PySpark, and Modin, you can install them too with
    `uv pip install -e ".[dev, core, docs, dask, pyspark, modin]"`.
 
-3. Install a fork of griffe:
-
-   ```terminal
-   uv pip install git+https://github.com/MarcoGorelli/griffe.git@no-overloads
-   ```
-
-   This is hopefully temporary until [mkdocstrings#716](https://github.com/mkdocstrings/mkdocstrings/issues/716)
-   is addressed.
-
 You should also install pre-commit:
 
 ```terminal

docs/installation.md

@@ -30,7 +30,7 @@ To verify the installation, start the Python REPL and execute:
 ```python
 >>> import narwhals
 >>> narwhals.__version__
-'1.27.1'
+'1.28.0'
 ```
 
 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.27.1"
+__version__ = "1.28.0"
 
 __all__ = [
     "Array",

pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "narwhals"
-version = "1.27.1"
+version = "1.28.0"
 dependencies = []
 requires-python = ">=3.8"
 authors = [
@@ -76,6 +76,7 @@ docs = [
   "mkdocs-autorefs",
   "mkdocs-material",
   "mkdocstrings[python]",
+  "mkdocstrings-python>=1.16",
   "pandas",
   "polars>=1.0.0",
   "pyarrow",