feat: update installation instructions to include optional PyArrow support

Author: kosiew

README.md

@@ -187,16 +187,23 @@ See [examples](examples/README.md) for more information.
 
 ## How to install
 
+DataFusion works with any library exposing the Arrow PyCapsule interface. If you
+need `pyarrow`, install the optional extra.
+
 ### uv
 
 ```bash
 uv add datafusion
+# or with PyArrow support
+uv add "datafusion[pyarrow]"
 ```
 
 ### Pip
 
 ```bash
 pip install datafusion
+# or with PyArrow support
+pip install "datafusion[pyarrow]"
 # or
 python -m pip install datafusion
 ```

docs/mdbook/src/installation.md

@@ -18,6 +18,13 @@
 
 DataFusion is easy to install, just like any other Python library.
 
+DataFusion works with any library exposing the Arrow PyCapsule interface. If
+you rely on `pyarrow`, install the optional extra:
+
+```bash
+uv pip install "datafusion[pyarrow]"
+```
+
 ## Using uv
 
 If you do not yet have a virtual environment, create one:
@@ -36,12 +43,16 @@ Or, to add to a project:
 
 ```bash
 uv add datafusion
+# or with PyArrow support
+uv add "datafusion[pyarrow]"
 ```
 
 ## Using pip
 
 ``` bash
 pip install datafusion
+# or with PyArrow support
+pip install "datafusion[pyarrow]"
 ```
 
 ## uv & JupyterLab setup

docs/source/user-guide/introduction.rst

@@ -26,11 +26,16 @@ DataFusion through various examples and highlight the most effective ways of usi
 Installation
 ------------
 
-DataFusion is a Python library and, as such, can be installed via pip from `PyPI <https://pypi.org/project/datafusion>`__.
+DataFusion is a Python library and, as such, can be installed via pip from
+`PyPI <https://pypi.org/project/datafusion>`__. DataFusion works with any
+library exposing the Arrow PyCapsule interface. If you need ``pyarrow``,
+install the optional extra.
 
 .. code-block:: shell
 
     pip install datafusion
+    # or with PyArrow support
+    pip install "datafusion[pyarrow]"
 
 You can verify the installation by running:
 

pyproject.toml

@@ -38,19 +38,22 @@ classifiers = [
     "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
-    "Programming Language :: Python :: 3.12",
+"Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
     "Programming Language :: Python",
     "Programming Language :: Rust",
 ]
-dependencies = ["pyarrow>=11.0.0", "typing-extensions;python_version<'3.13'"]
+dependencies = ["typing-extensions;python_version<'3.13'"]
 dynamic = ["version"]
 
 [project.urls]
 homepage = "https://datafusion.apache.org/python"
 documentation = "https://datafusion.apache.org/python"
 repository = "https://github.com/apache/datafusion-python"
 
+[project.optional-dependencies]
+pyarrow = ["pyarrow>=11.0.0"]
+
 [tool.isort]
 profile = "black"