leave a warning about future instantiation

dask · Jul 19, 2024 · a5f8430 · a5f8430
1 parent f211ada
commit a5f8430
Showing 1 changed file with 5 additions and 0 deletions.
diff --git a/distributed/client.py b/distributed/client.py
@@ -253,6 +253,11 @@ class Future(WrappedKey):
     manages future objects in the local Python process to determine what
     happens in the larger cluster.
 
+    .. note::
+
+        Users should not instantiate futures manually. This can lead to state
+        corruption and deadlocking clusters.
+
     Parameters
     ----------
     key: str, or tuple