Merge pull request #414 from European-XFEL/missingDaskDeps

Author: tmichela

.github/workflows/tests.yml

@@ -30,7 +30,7 @@ jobs:
     - name: Install dependencies
       run: |
         python3 -m pip install --upgrade pip
-        python3 -m pip install .[bridge,test] --constraint .github/dependabot/constraints.txt
+        python3 -m pip install .[test] --constraint .github/dependabot/constraints.txt
 
     - name: Test with pytest
       run: |

docs/index.rst

@@ -12,10 +12,19 @@ EXtra-data is available on our Anaconda installation on the Maxwell cluster::
     module load exfel exfel_anaconda3
 
 You can also install it `from PyPI <https://pypi.org/project/EXtra-data/>`__
-to use in other environments with Python 3.6 or later::
+to use in other environments with Python 3.7 or later::
 
     pip install extra_data
 
+This will install the `extra_data` package and the most commonly useful dependencies.
+Some large dependencies or dependencies only required for specific functionalities are
+not installed by default. You can use pip to install everything required for extra or
+all uses of `extra_data` (e.g. Dask Array, :ref:`cmd-serve-files`). This installs both
+`extra_data` and dependencies that are necessary::
+
+    pip install "extra_data[bridge]"    # install dependencies for karabo-bridge-like data streaming
+    pip install "extra_data[complete]"  # install dependencies for all features
+
 If you get a permissions error, add the ``--user`` flag to that command.
 
 Quickstart

setup.py

@@ -51,36 +51,38 @@ def find_version(*parts):
       },
       install_requires=[
           'h5py>=2.10',
+          'matplotlib',
           'numpy',
           'packaging',
           'pandas',
           'xarray',
-          'matplotlib'
       ],
       extras_require={
           'bridge': [
               'karabo-bridge >=0.6',
               'psutil',
           ],
+          'complete': [
+              'dask[array]',
+              'extra_data[bridge]',
+              'pyyaml',
+              'tomli; python_version < "3.11"',
+          ],
           'docs': [
-              'sphinx',
-              'nbsphinx',
+              'extra_data[bridge]',  # For autodoc of ZMQStreamer
               'ipython',  # For nbsphinx syntax highlighting
+              'nbsphinx',
+              'sphinx',
               'sphinxcontrib_github_alt',
-              'karabo-bridge',  # For autodoc of ZMQStreamer
-              'psutil',
           ],
           'test': [
               'cloudpickle',
               'coverage',
-              'dask[array]',
+              'extra_data[complete]',
               'nbval',
               'pytest',
               'pytest-cov',
               'testpath',
-              'psutil',
-              'pyyaml',
-              'tomli; python_version < "3.11"'
           ]
       },
       python_requires='>=3.6',