xarray-plotly 0.0.13__tar.gz → 0.0.16__tar.gz

{xarray_plotly-0.0.13 → xarray_plotly-0.0.16}/.github/dependabot.yml

@@ -4,6 +4,8 @@ updates:
     directory: "/"
     schedule:
       interval: "weekly"
+    commit-message:
+      prefix: "chore"
     groups:
       dev-dependencies:
         patterns:
@@ -23,3 +25,5 @@ updates:
     directory: "/"
     schedule:
       interval: "weekly"
+    commit-message:
+      prefix: "ci"

{xarray_plotly-0.0.13 → xarray_plotly-0.0.16}/.github/workflows/ci.yml

@@ -23,7 +23,7 @@ jobs:
         run: uv python install ${{ matrix.python-version }}
 
       - name: Install dependencies
-        run: uv sync --extra dev
+        run: uv sync --group dev
 
       - name: Lint
         run: uv run ruff check .
@@ -38,7 +38,7 @@ jobs:
         run: uv run pytest --cov=xarray_plotly --cov-report=xml
 
       - name: Upload coverage
-        uses: codecov/codecov-action@v5
+        uses: codecov/codecov-action@v6
         if: matrix.python-version == '3.12'
         with:
           token: ${{ secrets.CODECOV_TOKEN }}
@@ -53,7 +53,7 @@ jobs:
         uses: astral-sh/setup-uv@v7
 
       - name: Install dependencies
-        run: uv sync --extra docs
+        run: uv sync --group docs
 
       - name: Build docs
         run: uv run mkdocs build

xarray_plotly-0.0.16/.github/workflows/dependabot-auto-merge.yml

@@ -0,0 +1,39 @@
+name: Dependabot auto-merge
+
+on:
+  pull_request:
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  auto-merge:
+    name: Auto-merge patch
+    if: github.actor == 'dependabot[bot]'
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: dependabot/fetch-metadata@v3
+        id: metadata
+
+      - name: Generate app token
+        if: steps.metadata.outputs.update-type == 'version-update:semver-patch'
+        id: app-token
+        uses: actions/create-github-app-token@v3
+        with:
+          app-id: ${{ secrets.APP_ID }}
+          private-key: ${{ secrets.APP_PRIVATE_KEY }}
+
+      - name: Approve PR
+        if: steps.metadata.outputs.update-type == 'version-update:semver-patch'
+        run: gh pr review "$PR" --approve
+        env:
+          PR: ${{ github.event.pull_request.html_url }}
+          GH_TOKEN: ${{ steps.app-token.outputs.token }}
+
+      - name: Enable auto-merge
+        if: steps.metadata.outputs.update-type == 'version-update:semver-patch'
+        run: gh pr merge "$PR" --auto --squash
+        env:
+          PR: ${{ github.event.pull_request.html_url }}
+          GH_TOKEN: ${{ github.token }}

{xarray_plotly-0.0.13 → xarray_plotly-0.0.16}/.github/workflows/docs.yml

@@ -1,11 +1,13 @@
 name: Docs
 
 on:
+  push:
+    branches: [main]
   pull_request:
     branches: [main]
   workflow_dispatch:  # Manual trigger
   workflow_run:
-    workflows: ["Release"]
+    workflows: ["Publish"]
     types: [completed]
 
 permissions:
@@ -30,7 +32,7 @@ jobs:
         uses: astral-sh/setup-uv@v7
 
       - name: Install dependencies
-        run: uv sync --extra docs
+        run: uv sync --group docs
 
       - name: Build docs
         run: uv run mkdocs build

xarray_plotly-0.0.16/.github/workflows/latest-deps.yml

@@ -0,0 +1,35 @@
+name: Test Latest Dependencies
+
+on:
+  schedule:
+    # Every Monday at 07:00 UTC
+    - cron: "0 7 * * 1"
+  workflow_dispatch:
+
+jobs:
+  test-latest:
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Install with latest dependencies
+        run: uv sync --group dev --upgrade
+
+      - name: Test
+        run: uv run pytest --cov=xarray_plotly
+
+      - name: Print dependency versions
+        if: always()
+        run: uv pip list | grep -iE "xarray|plotly|pandas" || true

{xarray_plotly-0.0.13 → xarray_plotly-0.0.16}/.github/workflows/pr-title.yml

@@ -2,13 +2,15 @@ name: PR Title Check
 
 on:
   pull_request:
-    types: [opened, edited, synchronize, reopened]
+    types: [opened, edited, reopened]
+  push:
+    branches: ['release-please--**']
 
 jobs:
   validate:
     runs-on: ubuntu-latest
     steps:
-      - uses: amannn/action-semantic-pull-request@v5
+      - uses: amannn/action-semantic-pull-request@v6
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         with:
@@ -17,15 +19,12 @@ jobs:
           types: |
             feat
             fix
-            docs
-            style
-            refactor
-            perf
+            refac
             test
-            build
-            ci
+            docs
             chore
-            revert
+            ci
+            perf
           # Scope is optional
           requireScope: false
           # Subject (description) requirements

xarray_plotly-0.0.16/.github/workflows/publish.yaml

@@ -0,0 +1,66 @@
+name: Publish
+
+on:
+  push:
+    tags: ["v*"]
+
+concurrency:
+  group: publish-${{ github.ref_name }}
+  cancel-in-progress: false
+
+permissions:
+  contents: write
+  id-token: write
+  attestations: write
+
+jobs:
+  publish:
+    name: Build & publish to PyPI
+    runs-on: ubuntu-24.04
+    timeout-minutes: 10
+    environment:
+      name: pypi
+      url: https://pypi.org/project/xarray_plotly
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          ref: ${{ github.ref_name }}
+          fetch-depth: 0
+
+      - uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+
+      - name: Build
+        run: uv build
+
+      - uses: pypa/gh-action-pypi-publish@release/v1
+
+  github-release:
+    name: Create GitHub Release
+    needs: [publish]
+    if: github.event_name == 'push' && needs.publish.result == 'success'
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          ref: ${{ github.ref_name }}
+
+      - name: Create GitHub Release
+        run: |
+          if gh release view "$TAG" &>/dev/null; then
+            echo "Release $TAG already exists, skipping."
+            exit 0
+          fi
+          if [[ "$TAG" == *-* ]]; then
+            gh release create "$TAG" --generate-notes --prerelease
+          else
+            gh release create "$TAG" --generate-notes
+          fi
+        env:
+          GH_TOKEN: ${{ github.token }}
+          TAG: ${{ github.ref_name }}

xarray_plotly-0.0.16/.github/workflows/release.yaml

@@ -0,0 +1,27 @@
+name: Release
+
+on:
+  push:
+    branches: [main]
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  release-please:
+    name: Release Please
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/create-github-app-token@v3
+        id: app-token
+        with:
+          app-id: ${{ secrets.APP_ID }}
+          private-key: ${{ secrets.APP_PRIVATE_KEY }}
+
+      - uses: googleapis/release-please-action@v5
+        id: release
+        with:
+          token: ${{ steps.app-token.outputs.token }}
+          config-file: .release-please-config.json
+          manifest-file: .release-please-manifest.json

xarray_plotly-0.0.16/.readthedocs.yaml

@@ -0,0 +1,18 @@
+version: 2
+
+mkdocs:
+  configuration: mkdocs.yml
+
+build:
+  os: ubuntu-24.04
+  tools:
+    python: "3.13"
+  jobs:
+    pre_create_environment:
+      - asdf plugin add uv
+      - asdf install uv latest
+      - asdf global uv latest
+    create_environment:
+      - uv venv "${READTHEDOCS_VIRTUALENV_PATH}"
+    install:
+      - UV_PROJECT_ENVIRONMENT="${READTHEDOCS_VIRTUALENV_PATH}" uv sync --group docs

xarray_plotly-0.0.16/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.0.16"
+}

xarray_plotly-0.0.16/CHANGELOG.md

@@ -0,0 +1,30 @@
+# Changelog
+
+## [0.0.16](https://github.com/FBumann/xarray_plotly/compare/v0.0.15...v0.0.16) (2026-06-03)
+
+
+### Features
+
+* **imshow:** support facet_row for subplot rows (plotly>=6.7) ([#82](https://github.com/FBumann/xarray_plotly/issues/82)) ([55b503b](https://github.com/FBumann/xarray_plotly/commit/55b503b37d598c845631c7b35adcea3a8f1e3ed9))
+* **plotting:** add facet_titles kwarg to strip dim= prefix ([#77](https://github.com/FBumann/xarray_plotly/issues/77)) ([1433a95](https://github.com/FBumann/xarray_plotly/commit/1433a95c45cacb5f49c35e6f63794d668f6278ab))
+
+## [0.0.15](https://github.com/FBumann/xarray_plotly/compare/v0.0.14...v0.0.15) (2026-03-23)
+
+
+### Bug Fixes
+
+* legend, style persistence, and axis ranges in combined figures ([#53](https://github.com/FBumann/xarray_plotly/issues/53)) ([28fccc3](https://github.com/FBumann/xarray_plotly/commit/28fccc3d32da334625e626096bfcbf78e3c65de6))
+
+## [0.0.14](https://github.com/FBumann/xarray_plotly/compare/v0.0.13...v0.0.14) (2026-03-09)
+
+
+### Bug Fixes
+
+* continuous colorscale strings with discrete-only chart types ([#46](https://github.com/FBumann/xarray_plotly/issues/46)) ([cc865b5](https://github.com/FBumann/xarray_plotly/commit/cc865b5c1d2f7a2921b8e27c23546a883a974279))
+
+## [0.0.13](https://github.com/FBumann/xarray_plotly/compare/v0.0.12...v0.0.13) (2026-01-28)
+
+
+### Bug Fixes
+
+* secondary y axis match and visibility when faceted ([#32](https://github.com/FBumann/xarray_plotly/issues/32)) ([10da229](https://github.com/FBumann/xarray_plotly/commit/10da229282377a229054321e8ff98e3fd6825939))

{xarray_plotly-0.0.13 → xarray_plotly-0.0.16}/CONTRIBUTING.md

@@ -42,11 +42,8 @@ uv run ruff format .
 
 ## Releases
 
-Releases are automated via GitHub Actions. Version is determined from git tags via setuptools_scm.
+Releases are fully automated via [Release Please](https://github.com/googleapis/release-please).
 
-To create a release:
-
-1. Tag: `git tag v0.1.0`
-2. Push: `git push && git push --tags`
-
-The CI will automatically publish to PyPI and deploy updated docs.
+1. Merge PRs to `main` using [conventional commit](https://www.conventionalcommits.org/) prefixes (`feat:`, `fix:`, etc.)
+2. Release Please automatically creates/updates a release PR with changelog and version bump
+3. Merge the release PR to publish to PyPI and deploy updated docs

{xarray_plotly-0.0.13/xarray_plotly.egg-info → xarray_plotly-0.0.16}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: xarray_plotly
-Version: 0.0.13
+Version: 0.0.16
 Summary: Interactive Plotly Express plotting accessor for xarray
 Author: Felix
 License: MIT
@@ -24,20 +24,6 @@ License-File: LICENSE
 Requires-Dist: xarray>=2023.1.0
 Requires-Dist: plotly>=5.0.0
 Requires-Dist: pandas>=1.5.0
-Provides-Extra: dev
-Requires-Dist: pytest==9.0.2; extra == "dev"
-Requires-Dist: pytest-cov==7.0.0; extra == "dev"
-Requires-Dist: mypy==1.19.1; extra == "dev"
-Requires-Dist: ruff==0.14.14; extra == "dev"
-Requires-Dist: pre-commit==4.5.1; extra == "dev"
-Requires-Dist: nbstripout==0.9.0; extra == "dev"
-Provides-Extra: docs
-Requires-Dist: mkdocs==1.6.1; extra == "docs"
-Requires-Dist: mkdocs-material==9.7.1; extra == "docs"
-Requires-Dist: mkdocstrings[python]==1.0.1; extra == "docs"
-Requires-Dist: mkdocs-jupyter==0.25.1; extra == "docs"
-Requires-Dist: mkdocs-plotly-plugin==0.1.3; extra == "docs"
-Requires-Dist: jupyter==1.1.1; extra == "docs"
 Dynamic: license-file
 
 # xarray_plotly

{xarray_plotly-0.0.13 → xarray_plotly-0.0.16}/docs/examples/combining.ipynb

@@ -10,7 +10,8 @@
     "xarray-plotly provides helper functions to combine multiple figures:\n",
     "\n",
     "- **`overlay`**: Overlay traces on the same axes\n",
-    "- **`add_secondary_y`**: Plot with two independent y-axes"
+    "- **`add_secondary_y`**: Plot with two independent y-axes\n",
+    "- **`subplots`**: Arrange independent figures in a grid"
    ]
   },
   {
@@ -23,7 +24,7 @@
     "import plotly.express as px\n",
     "import xarray as xr\n",
     "\n",
-    "from xarray_plotly import add_secondary_y, config, overlay, xpx\n",
+    "from xarray_plotly import add_secondary_y, config, overlay, subplots, xpx\n",
     "\n",
     "config.notebook()"
    ]
@@ -440,6 +441,128 @@
    "cell_type": "markdown",
    "id": "27",
    "metadata": {},
+   "source": [
+    "## subplots\n",
+    "\n",
+    "Arrange independent figures side-by-side in a grid. Each figure gets its own\n",
+    "subplot cell with axes and title automatically derived from the source figure."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "28",
+   "metadata": {},
+   "source": [
+    "### Different Variables Side by Side"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "29",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# One figure per variable, arranged in a row\n",
+    "us_pop = population.sel(country=\"United States\")\n",
+    "us_gdp = gdp_per_capita.sel(country=\"United States\")\n",
+    "us_life = life_expectancy.sel(country=\"United States\")\n",
+    "\n",
+    "pop_fig = xpx(us_pop).bar(title=\"Population\")\n",
+    "gdp_fig = xpx(us_gdp).line(title=\"GDP per Capita\")\n",
+    "life_fig = xpx(us_life).line(title=\"Life Expectancy\")\n",
+    "\n",
+    "grid = subplots(pop_fig, gdp_fig, life_fig, cols=3)\n",
+    "grid.update_layout(title=\"United States Overview\", height=350, showlegend=False)\n",
+    "grid"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "30",
+   "metadata": {},
+   "source": [
+    "### 2x2 Grid\n",
+    "\n",
+    "Use `cols=2` and pass four figures for a 2x2 layout."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "31",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# One subplot per country\n",
+    "fig_us = xpx(population.sel(country=\"United States\")).bar(title=\"United States\")\n",
+    "fig_cn = xpx(population.sel(country=\"China\")).bar(title=\"China\")\n",
+    "fig_de = xpx(population.sel(country=\"Germany\")).bar(title=\"Germany\")\n",
+    "fig_br = xpx(population.sel(country=\"Brazil\")).bar(title=\"Brazil\")\n",
+    "\n",
+    "grid = subplots(fig_us, fig_cn, fig_de, fig_br, cols=2)\n",
+    "grid.update_layout(height=500, showlegend=False)\n",
+    "grid"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "32",
+   "metadata": {},
+   "source": [
+    "### Mixed Chart Types\n",
+    "\n",
+    "Each cell can use a different chart type. Subplot titles fall back to the\n",
+    "y-axis label when no explicit title is set."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "33",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# No explicit title — subplot titles come from the y-axis label (DataArray name)\n",
+    "pop_bar = xpx(us_pop).bar()\n",
+    "gdp_line = xpx(us_gdp).line()\n",
+    "life_scatter = xpx(us_life).scatter()\n",
+    "\n",
+    "grid = subplots(pop_bar, gdp_line, life_scatter, cols=3)\n",
+    "grid.update_layout(height=350, showlegend=False)\n",
+    "grid"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "34",
+   "metadata": {},
+   "source": [
+    "### With Facets\n",
+    "\n",
+    "Faceted figures can be composed — each figure's internal subplots are remapped into the grid cell."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "35",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Faceted bar on top, faceted line below\n",
+    "pop_faceted = xpx(population).bar(facet_col=\"country\")\n",
+    "gdp_faceted = xpx(gdp_per_capita).line(facet_col=\"country\")\n",
+    "\n",
+    "grid = subplots(pop_faceted, gdp_faceted, cols=1)\n",
+    "grid.update_layout(height=600, showlegend=False)\n",
+    "grid"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "36",
+   "metadata": {},
    "source": [
     "---\n",
     "\n",
@@ -450,7 +573,7 @@
   },
   {
    "cell_type": "markdown",
-   "id": "28",
+   "id": "37",
    "metadata": {},
    "source": [
     "### overlay: Mismatched Facet Structure\n",
@@ -461,7 +584,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "29",
+   "id": "38",
    "metadata": {},
    "outputs": [],
    "source": [
@@ -479,7 +602,7 @@
   },
   {
    "cell_type": "markdown",
-   "id": "30",
+   "id": "39",
    "metadata": {},
    "source": [
     "### overlay: Animated Overlay on Static Base\n",
@@ -490,7 +613,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "31",
+   "id": "40",
    "metadata": {},
    "outputs": [],
    "source": [
@@ -508,7 +631,7 @@
   },
   {
    "cell_type": "markdown",
-   "id": "32",
+   "id": "41",
    "metadata": {},
    "source": [
     "### overlay: Mismatched Animation Frames\n",
@@ -519,7 +642,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "33",
+   "id": "42",
    "metadata": {},
    "outputs": [],
    "source": [
@@ -535,7 +658,7 @@
   },
   {
    "cell_type": "markdown",
-   "id": "34",
+   "id": "43",
    "metadata": {},
    "source": [
     "### add_secondary_y: Mismatched Facet Structure\n",
@@ -546,7 +669,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "35",
+   "id": "44",
    "metadata": {},
    "outputs": [],
    "source": [
@@ -564,7 +687,7 @@
   },
   {
    "cell_type": "markdown",
-   "id": "36",
+   "id": "45",
    "metadata": {},
    "source": [
     "### add_secondary_y: Animated Secondary on Static Base\n",
@@ -575,7 +698,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "37",
+   "id": "46",
    "metadata": {},
    "outputs": [],
    "source": [
@@ -593,7 +716,7 @@
   },
   {
    "cell_type": "markdown",
-   "id": "38",
+   "id": "47",
    "metadata": {},
    "source": [
     "### add_secondary_y: Mismatched Animation Frames"
@@ -602,7 +725,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "39",
+   "id": "48",
    "metadata": {},
    "outputs": [],
    "source": [
@@ -618,7 +741,7 @@
   },
   {
    "cell_type": "markdown",
-   "id": "40",
+   "id": "49",
    "metadata": {},
    "source": [
     "## Summary\n",
@@ -626,7 +749,8 @@
     "| Function | Facets | Animation | Static + Animated |\n",
     "|----------|--------|-----------|-------------------|\n",
     "| `overlay` | Yes (must match) | Yes (frames must match) | Static overlay on animated base OK |\n",
-    "| `add_secondary_y` | Yes (must match) | Yes (frames must match) | Static secondary on animated base OK |"
+    "| `add_secondary_y` | Yes (must match) | Yes (frames must match) | Static secondary on animated base OK |\n",
+    "| `subplots` | Yes (remapped into cells) | No | N/A |"
    ]
   }
  ],

{xarray_plotly-0.0.13 → xarray_plotly-0.0.16}/docs/examples/dimensions.ipynb

@@ -134,7 +134,7 @@
     "| line | x, color, line_dash, facet_col, facet_row, animation_frame |\n",
     "| scatter | x, color, symbol, facet_col, facet_row, animation_frame |\n",
     "| bar | x, color, facet_col, facet_row, animation_frame |\n",
-    "| imshow | x, y, facet_col, facet_row, animation_frame |"
+    "| imshow | y, x, facet_col, facet_row, animation_frame |"
    ]
   },
   {
@@ -186,6 +186,16 @@
     "xpx(data_3d).line(x=\"year\", facet_col=\"metric\", facet_row=\"country\")"
    ]
   },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Heatmap grids: imshow supports facet_col and facet_row (requires plotly>=6.7)\n",
+    "xpx(data_3d).imshow(facet_row=\"metric\")"
+   ]
+  },
   {
    "cell_type": "markdown",
    "metadata": {},