From 20b6e2def3e02305955a3d8c37b950d6aabf430c Mon Sep 17 00:00:00 2001 From: James Bourbeau Date: Fri, 9 Feb 2024 10:58:16 -0600 Subject: [PATCH] Slight update to ``dask-expr`` warning (#10916) --- dask/dataframe/__init__.py | 23 +++++++++++++++-------- 1 file changed, 15 insertions(+), 8 deletions(-) diff --git a/dask/dataframe/__init__.py b/dask/dataframe/__init__.py index 4095dcf2b82..fca52eba909 100644 --- a/dask/dataframe/__init__.py +++ b/dask/dataframe/__init__.py @@ -161,19 +161,26 @@ def inner_func(*args, **kwargs): raise ImportError(msg) from e warnings.warn( """The current Dask DataFrame implementation is deprecated. -Dask will switch to a new implementation that contains a logical query planning -layer and many other improvements in a future version. The new user-facing API is -compatible with the existing API. +In a future release, Dask DataFrame will use new implementation that +contains several improvements including a logical query planning. +The user-facing DataFrame API will remain unchanged. -The new implementation is already available and you can opt-in with +The new implementation is already available and can be enabled by +installing the dask-expr library: -pip install dask-expr + $ pip install dask-expr -and through setting the configuration option +and turning the query planning option on: -dask.config.set({'dataframe.query-planning': True}) + >>> import dask + >>> dask.config.set({'dataframe.query-planning': True}) + >>> import dask.dataframe as dd -The API-Docs can be found at https://docs.dask.org/en/stable/dask-expr-api.html +API documentation for the new implementation is available at +https://docs.dask.org/en/stable/dask-expr-api.html + +Any feedback can be reported on the Dask issue tracker +https://github.com/dask/dask/issues """, DeprecationWarning, stacklevel=2,