From 2189275e785deaf6e97f1e6df376a041616223da Mon Sep 17 00:00:00 2001 From: Nilanjan Chatterjee Date: Sun, 11 Oct 2026 02:28:30 -0500 Subject: [PATCH] docs: list cytoolz as an optional dependency distributed imports toolz through tlz, which uses cytoolz when present, and the conda recipe already pins cytoolz >=0.11.2. Nothing in the install docs told pip users about it. Add an "Optional dependencies" section to install.rst with the same minimum version as the recipe. Closes #1495 Co-Authored-By: Claude Opus 5.5 --- docs/source/install.rst | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/docs/source/install.rst b/docs/source/install.rst index 0a2be6c118..886c325d9c 100644 --- a/docs/source/install.rst +++ b/docs/source/install.rst @@ -31,6 +31,21 @@ To install distributed from source, clone the repository from `github python -m pip install . +Optional dependencies +--------------------- + +Dask.distributed runs without these packages but uses them when they are +installed: + +- `cytoolz `_ ``>=0.11.2``: a Cython + implementation of ``toolz``. Dask.distributed imports ``toolz`` functions + through ``tlz``, which picks ``cytoolz`` when it is installed and falls + back to ``toolz`` otherwise. + +Install it with ``conda install cytoolz -c conda-forge`` or +``python -m pip install cytoolz``. + + Notes -----