Update documentation and small Pixi improvements

.github/workflows/build.yaml

@@ -44,6 +44,7 @@ jobs:
         with:
           environments: "build"
           download-data: false
+          install: false
       - name: conda build
         run: pixi run -e build build-conda
       - uses: actions/upload-artifact@v4
@@ -91,6 +92,7 @@ jobs:
         with:
           environments: "build"
           download-data: false
+          install: false
       - name: Build package
         run: pixi run -e build build-pip
       - uses: actions/upload-artifact@v4
@@ -114,8 +116,12 @@ jobs:
           path: dist/
       - name: Install package
         run: python -m pip install dist/*.whl
-      - name: Test package
+      - name: Import package
         run: python -c "import $PACKAGE; print($PACKAGE.__version__)"
+      - name: Install test dependencies
+        run: python -m pip install "$(ls dist/*whl)[tests]"
+      - name: Test package
+        run: python -m pytest --pyargs $PACKAGE --color=yes
 
   pip_publish:
     name: Publish PyPI

.github/workflows/docs.yaml

@@ -20,28 +20,27 @@ on:
   schedule:
     - cron: "0 14 * * SUN"
 
+defaults:
+  run:
+    shell: bash -el {0}
+
 jobs:
   pixi_lock:
     name: Pixi lock
     runs-on: ubuntu-latest
     steps:
       - uses: holoviz-dev/holoviz_tasks/pixi_lock@pixi
 
-  build_docs:
-    name: Documentation
+  docs_build:
+    name: Build Documentation
     needs: [pixi_lock]
-    runs-on: "ubuntu-latest"
-    timeout-minutes: 120
-    defaults:
-      run:
-        shell: bash -el {0}
+    runs-on: "macos-latest"
+    timeout-minutes: 180
+    outputs:
+      tag: ${{ steps.vars.outputs.tag }}
     env:
-      DESC: "Documentation build"
       MPLBACKEND: "Agg"
       GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-      AWS_ACCESS_KEY_ID: ${{ secrets.AWS_ACCESS_KEY_ID }}
-      AWS_SECRET_ACCESS_KEY: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
-      AWS_DEFAULT_REGION: ${{ secrets.AWS_DEFAULT_REGION }}
       MOZ_HEADLESS: 1
       PANEL_EMBED: "true"
       PANEL_EMBED_JSON: "true"
@@ -51,22 +50,44 @@ jobs:
       - uses: holoviz-dev/holoviz_tasks/pixi_install@pixi
         with:
           environments: docs
+      - name: Build documentation
+        run: pixi run -e docs docs-build
+      - uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: docs
+          if-no-files-found: error
+          path: builtdocs
       - name: Set output
         id: vars
         run: echo "tag=${GITHUB_REF#refs/*/}" >> $GITHUB_OUTPUT
-      - name: Build documentation
-        run: pixi run -e docs docs-build
+
+  docs_publish:
+    name: Publish Documentation
+    runs-on: "ubuntu-latest"
+    needs: [docs_build]
+    env:
+      GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      AWS_ACCESS_KEY_ID: ${{ secrets.AWS_ACCESS_KEY_ID }}
+      AWS_SECRET_ACCESS_KEY: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
+      AWS_DEFAULT_REGION: ${{ secrets.AWS_DEFAULT_REGION }}
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: docs
+          path: builtdocs/
+      - name: Set output
+        id: vars
+        run: echo "tag=${{ needs.docs_build.outputs.tag }}" >> $GITHUB_OUTPUT
       - name: upload dev
         if: |
           (github.event_name == 'workflow_dispatch' && github.event.inputs.target == 'dev') ||
           (github.event_name == 'push' && (contains(steps.vars.outputs.tag, 'a') || contains(steps.vars.outputs.tag, 'b') || contains(steps.vars.outputs.tag, 'rc')))
         run: |
-          pipx install awscli
           aws s3 sync --quiet ./builtdocs s3://dev.holoviews.org/
       - name: upload main
         if: |
           (github.event_name == 'workflow_dispatch' && github.event.inputs.target == 'main') ||
           (github.event_name == 'push' && !(contains(steps.vars.outputs.tag, 'a') || contains(steps.vars.outputs.tag, 'b') || contains(steps.vars.outputs.tag, 'rc')))
         run: |
-          pipx install awscli
           aws s3 sync --quiet ./builtdocs s3://holoviews.org/

.github/workflows/test.yaml

@@ -37,6 +37,7 @@ env:
   PYTHONIOENCODING: "utf-8"
   GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
   DASK_DATAFRAME__QUERY_PLANNING: false
+  COV: "--cov=./holoviews --cov-report=xml"
 
 jobs:
   pre_commit:
@@ -83,16 +84,16 @@ jobs:
         if: env.MATRIX_OPTION == 'default'
         run: |
           MATRIX=$(jq -nsc '{
-              "os": ["ubuntu-latest", "macos-14", "windows-latest"],
+              "os": ["ubuntu-latest", "macos-latest", "windows-latest"],
               "environment": ["test-39", "test-312"]
           }')
           echo "MATRIX=$MATRIX" >> $GITHUB_ENV
       - name: Set test matrix with 'full' option
         if: env.MATRIX_OPTION == 'full'
         run: |
           MATRIX=$(jq -nsc '{
-              "os": ["ubuntu-latest", "macos-14", "windows-latest"],
-              "environment": ["test-39", "test-310", "test311", "test312"]
+              "os": ["ubuntu-latest", "macos-latest", "windows-latest"],
+              "environment": ["test-39", "test-310", "test-311", "test-312"]
           }')
           echo "MATRIX=$MATRIX" >> $GITHUB_ENV
       - name: Set test matrix with 'downstream' option
@@ -132,7 +133,7 @@ jobs:
       - name: Test Unit
         if: needs.setup.outputs.code_change == 'true'
         run: |
-          pixi run -e ${{ matrix.environment }} test-unit --cov=./holoviews --cov-report=xml
+          pixi run -e ${{ matrix.environment }} test-unit $COV
       - name: Test Examples
         if: needs.setup.outputs.code_change == 'true'
         run: |
@@ -162,7 +163,17 @@ jobs:
       - name: Test UI
         if: needs.setup.outputs.code_change == 'true'
         run: |
-          pixi run -e ${{ matrix.environment }} test-ui --cov=./holoviews --cov-report=xml
+          # Create a .uicoveragerc file to set the concurrency library to greenlet
+          # https://github.com/microsoft/playwright-python/issues/313
+          echo "[run]\nconcurrency = greenlet" > .uicoveragerc
+          FAIL="--screenshot only-on-failure --full-page-screenshot --output ui_screenshots --tracing retain-on-failure"
+          pixi run -e ${{ matrix.environment }} test-ui $COV --cov-config=.uicoveragerc $FAIL
+      - uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: ui_screenshots_${{ runner.os }}
+          path: ./ui_screenshots
+          if-no-files-found: ignore
       - uses: codecov/codecov-action@v4
         if: needs.setup.outputs.code_change == 'true'
         with:

README.md

@@ -56,46 +56,25 @@ Check out the [HoloViews web site](http://holoviews.org) for extensive examples
 
 # Installation
 
-HoloViews works with
-[Python](https://github.com/holoviz/holoviews/actions/workflows/test.yaml)
-on Linux, Windows, or Mac, and works seamlessly with
-[Jupyter Notebook and JupyterLab](https://jupyter.org).
+HoloViews works with [Python](https://github.com/holoviz/holoviews/actions/workflows/test.yaml)
+on Linux, Windows, or Mac, and works seamlessly with [Jupyter Notebook and JupyterLab](https://jupyter.org).
 
-The recommended way to install HoloViews is using the
-[conda](https://docs.conda.io/projects/conda/en/latest/index.html) command provided by
-[Anaconda](https://docs.anaconda.com/free/anaconda/install/) or
-[Miniconda](https://docs.conda.io/en/latest/miniconda.html):
+You can install HoloViews either with `conda` or `pip`, for more information see the [install guide](https://holoviews.org/install.html).
 
     conda install holoviews
 
-This command will install the typical packages most useful with
-HoloViews, though HoloViews itself depends only on
-[Numpy](https://numpy.org) [Pandas](https://pandas.pydata.org) and [Param](https://param.holoviz.org).
-Additional installation and configuration options are described in the
-[user guide](https://holoviews.org/user_guide/Installing_and_Configuring.html).
+    pip install holoviews
 
-You can also clone holoviews directly from GitHub and install it with:
+# Developer Guide
 
-    git clone git://github.com/holoviz/holoviews.git
-    cd holoviews
-    pip install -e .
+If you want to help develop HoloViews, you can checkout the [developer guide](http://dev.holoviews.org/developer_guide/index.html),
+this guide will help you get set-up. Making it easy to contribute.
 
-## Usage
+# Communication
 
-Once you've installed HoloViews, you can get a copy of all the examples shown on this website:
-
-    holoviews --install-examples
-    cd holoviews-examples
-
-Now you can launch Jupyter Notebook or JupyterLab to explore them:
-
-    jupyter notebook
-
-    jupyter lab
+If you find any bugs or have any feature suggestions please file a GitHub
+[issue](https://github.com/holoviz/holoviews/issues).
 
-For more details on setup and configuration see [our website](https://holoviews.org/user_guide/Installing_and_Configuring.html).
+If you have any usage questions, please ask them on [HoloViz Discourse](https://discourse.holoviz.org/),
 
-For general discussion, we have a [discord channel](https://discord.gg/AXRHnJU6sP).
-If you find any bugs or have any feature suggestions please file a GitHub
-[issue](https://github.com/holoviz/holoviews/issues)
-or submit a [pull request](https://help.github.com/articles/about-pull-requests).
+For general discussion, we have a [Discord channel](https://discord.gg/AXRHnJU6sP).

doc/index.md

@@ -0,0 +1,122 @@
+<h1><img src="_static/logo_horizontal.png" style="width: 30%;"></h1>
+
+**Stop plotting your data - annotate your data and let it visualize
+itself.**
+
+<div style="display: flex">
+  <div style="width: 95%">
+
+HoloViews is an
+[open-source](https://github.com/holoviz/holoviews/blob/main/LICENSE.txt)
+Python library designed to make data analysis and visualization seamless
+and simple. With HoloViews, you can usually express what you want to do
+in very few lines of code, letting you focus on what you are trying to
+explore and convey, not on the process of plotting.
+
+For examples, check out the thumbnails below and the other items in the
+[Gallery](gallery/index) of demos and apps and the [Reference Gallery](reference/index)
+that shows every HoloViews component. Be sure to
+look at the code, not just the pictures, to appreciate how easy it is to
+create such plots yourself!
+
+The [Getting-Started](getting_started/index) guide explains the basic concepts
+and how to start using HoloViews, and is the recommended way to
+understand how everything works.
+
+The [User Guide](user_guide/index) goes more deeply into key concepts from
+HoloViews, when you are ready for further study.
+
+The [API](reference_manual) is the definitive guide to each HoloViews
+object, but the same information is available more conveniently via the
+`hv.help()` command and tab completion in the Jupyter notebook.
+
+If you have any [issues](https://github.com/holoviz/holoviews/issues) or
+wish to [contribute code](https://help.github.com/articles/about-pull-requests), you can
+visit our [GitHub site](https://github.com/holoviz/holoviews), file a
+topic on the [HoloViz Discourse](https://discourse.holoviz.org/), or ask a quick question
+on [Holoviz Discord](https://discord.gg/AXRHnJU6sP).
+
+</div>
+
+</div>
+<hr width='100%'></hr>
+
+<div>
+<div >
+  <a href="https://holoviews.org/gallery/demos/bokeh/iris_splom_example.html">
+    <img src="https://holoviews.org/_images/iris_splom_example.png" width='24%'>    </img> </a>
+  <a href="https://holoviews.org/getting_started/Gridded_Datasets.html">
+    <img src="https://assets.holoviews.org/collage/cells.png" width='27%'> </img>  </a>
+  <a href="https://holoviews.org/gallery/demos/bokeh/scatter_economic.html">
+    <img src="https://holoviews.org/_images/scatter_economic.png" width='47%'> </img>    </a>
+</div>
+
+<div >
+  <a href="https://holoviews.org/gallery/demos/bokeh/square_limit.html">
+    <img src="https://holoviews.org/_images/square_limit.png" width='24%'> </a>
+  <a href="https://holoviews.org/gallery/demos/bokeh/bars_economic.html">
+    <img src="https://holoviews.org/_images/bars_economic.png" width='24%'> </a>
+  <a href="https://holoviews.org/gallery/demos/bokeh/texas_choropleth_example.html">
+    <img src="https://holoviews.org/_images/texas_choropleth_example.png"    width='24%'> </a>
+  <a href="https://holoviews.org/gallery/demos/bokeh/verhulst_mandelbrot.html">
+    <img src="https://holoviews.org/_images/verhulst_mandelbrot.png" width='24%'>    </a>
+</div>
+<div >
+    <a href="https://holoviews.org/gallery/demos/bokeh/dropdown_economic.html">
+      <img src="https://assets.holoviews.org/collage/dropdown.gif" width='33%'> </a>
+    <a href="https://holoviews.org/gallery/demos/bokeh/dragon_curve.html">
+      <img src="https://assets.holoviews.org/collage/dragon_fractal.gif" width='30%'> </a>
+    <a href="https://holoviews.org/gallery/apps/bokeh/nytaxi_hover.html">
+      <img src="https://assets.holoviews.org/collage/ny_datashader.gif" width='33%'> </a>
+</div>
+</div>
+
+# Installation
+
+[![CondaPkg](https://img.shields.io/conda/v/anaconda/holoviews.svg?label=conda%7Cdefaults&style=flat&colorB=4488ff)](https://anaconda.org/pyviz/holoviews)
+[![PyPI](https://img.shields.io/pypi/v/holoviews.svg)](https://pypi.python.org/pypi/holoviews)
+[![License](https://img.shields.io/pypi/l/holoviews.svg)](https://github.com/holoviz/holoviews/blob/main/LICENSE.txt)
+[![Coverage](https://codecov.io/gh/holoviz/holoviews/branch/main/graph/badge.svg)](https://codecov.io/gh/holoviz/holoviews)
+
+HoloViews works with Python 3 on Linux, Windows, or Mac, and works
+seamlessly with [Jupyter Notebook and JupyterLab](https://jupyter.org).
+
+You can install HoloViews either with `conda` or `pip`, for more information see the [install guide](install).
+
+    conda install holoviews
+
+    pip install holoviews
+
+# Usage
+
+Once you've installed HoloViews, you can get a copy of all the examples
+shown on this website:
+
+    holoviews --install-examples
+    cd holoviews-examples
+
+Now you can launch Jupyter Notebook or JupyterLab to explore them:
+
+    jupyter notebook
+
+    jupyter lab
+
+After you have successfully installed and configured HoloViews, please
+see [Getting Started](getting_started/index).
+
+```{toctree}
+:titlesonly:
+:hidden:
+:maxdepth: 2
+
+Home
+Getting Started <getting_started/index>
+User Guide <user_guide/index>
+Gallery <gallery/index>
+Reference Gallery <reference/index>
+Developer Guide <developer_guide/index>
+Releases <releases>
+API <reference_manual/index>
+FAQ Roadmap <roadmap>
+About <about>
+```