chore!: replace direct download of nyc_taxi with hvsampledata

datashader/__init__.py

@@ -18,12 +18,36 @@
     from . import datatypes  # noqa (API import)
 
 # make pyct's example/data commands available if possible
-from functools import partial
+from functools import partial, wraps
+
+
+def _warn_pyct_deprecated(stacklevel=2):
+    import warnings
+
+    warnings.warn(
+        "The 'fetch_data()', 'copy_examples()', and 'examples()' functions are "
+        "deprecated since version 0.19 and will be removed in version 0.20. "
+        "For downloading sample datasets, use 'hvsampledata' instead. "
+        "For example: `hvsampledata.nyc_taxi_remote('pandas')`.",
+        category=FutureWarning,
+        stacklevel=stacklevel,
+    )
+
+
+def _deprecated_pyct_wrapper(func):
+    """Wrapper to add deprecation warning to pyct functions."""
+    @wraps(func)  # noqa: F821
+    def wrapper(*args, **kwargs):
+        _warn_pyct_deprecated(stacklevel=3)
+        return func(*args, **kwargs)
+    return wrapper
+
+
 try:
     from pyct.cmd import copy_examples as _copy, fetch_data as _fetch, examples as _examples
-    copy_examples = partial(_copy,'datashader')
-    fetch_data = partial(_fetch,'datashader')
-    examples = partial(_examples,'datashader')
+    copy_examples = _deprecated_pyct_wrapper(partial(_copy, 'datashader'))
+    fetch_data = _deprecated_pyct_wrapper(partial(_fetch, 'datashader'))
+    examples = _deprecated_pyct_wrapper(partial(_examples, 'datashader'))
 except ImportError:
     def _missing_cmd(*args,**kw):
         return("install pyct to enable this command (e.g. `conda install pyct or "
@@ -32,4 +56,4 @@ def _missing_cmd(*args,**kw):
     def err():
         raise ValueError(_missing_cmd())
     fetch_data = copy_examples = examples = err
-del partial, _examples, _copy, _fetch
+del partial, wraps, _examples, _copy, _fetch

datashader/__main__.py

@@ -1,6 +1,10 @@
+
+
 def main(args=None):
     try:
         import pyct.cmd
+        from . import _warn_pyct_deprecated
+        _warn_pyct_deprecated(stacklevel=3)
     except ImportError:
         import sys
         from . import _missing_cmd

examples/getting_started/1_Introduction.ipynb

@@ -24,9 +24,10 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "import datashader as ds, pandas as pd, colorcet as cc\n",
+    "import datashader as ds, colorcet as cc\n",
+    "import hvsampledata as hvs\n",
     "\n",
-    "df = pd.read_csv('../data/nyc_taxi.csv', usecols=['dropoff_x', 'dropoff_y'])\n",
+    "df = hvs.nyc_taxi_remote(\"pandas\", engine_kwargs={\"columns\": ['dropoff_x', 'dropoff_y']})\n",
     "df.head()"
    ]
   },
@@ -35,9 +36,8 @@
    "metadata": {},
    "source": [
     ":::{note}\n",
-    "The file `nyc_taxi.csv` used above is located at\n",
-    "[nyc_taxi.csv](https://github.com/holoviz/datashader/blob/main/examples/data/.data_stubs/nyc_taxi.csv) in the Datashader repository. When running this example, make sure the file is available locally and update the path accordingly.\n",
-    ":::\n"
+    "The first time this cell is run, it will download the NYC taxi dataset (about 260MB).\n",
+    ":::"
    ]
   },
   {

pixi.toml

@@ -80,6 +80,7 @@ scikit-image = "*"
 shapely = ">=2.0.0"
 spatialpandas = "*"
 streamz = "*"
+hvsampledata = ">=0.1.5a3"
 
 # =============================================
 # =================== TESTS ===================

scripts/download_data.py

@@ -1,9 +1,10 @@
 from contextlib import suppress
-
-import pyct.cmd
 from packaging.version import Version
 
-pyct.cmd.fetch_data(name="data", path="examples", datasets="datasets.yml")
+with suppress(ImportError):
+    import pyct.cmd
+
+    pyct.cmd.fetch_data(name="data", path="examples", datasets="datasets.yml")
 
 
 with suppress(ImportError):
@@ -21,4 +22,10 @@
 
     gds.get_path("geoda.natregimes")
     gds.get_path("nybb")
-    gds.get_path('geoda health')
+    gds.get_path("geoda health")
+
+
+with suppress(ImportError):
+    import hvsampledata as hvs
+
+    path = hvs.download("nyc_taxi_remote")