corner 2.2.3rc1__tar.gz → 2.3.0__tar.gz

{corner-2.2.3rc1 → corner-2.3.0}/.github/workflows/tests.yml

@@ -15,60 +15,56 @@ jobs:
       fail-fast: false
       matrix:
         os: ["ubuntu-latest"]
-        python-version: ["3.10", "3.11", "3.12"]
-        nox-session: ["tests"]
-        include:
-          - os: ubuntu-latest
-            python-version: "3.10"
-            nox-session: "lint"
+        python-version: ["3.12", "3.14"]
 
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v7
         with:
           submodules: true
           fetch-depth: 0
-      - name: Configure Python
-        uses: actions/setup-python@v5
+      - name: Install uv
+        uses: astral-sh/setup-uv@d31148d669074a8d0a63714ba94f3201e7020bc3 # v8.3.0
         with:
           python-version: ${{ matrix.python-version }}
+          enable-cache: true
+      - name: Run tests
+        run: uv run pytest -v tests
+      - name: Upload generated images on failure
+        uses: actions/upload-artifact@v7
+        if: ${{ failure() }}
+        with:
+          name: images-${{ matrix.os }}-${{ matrix.python-version }}
+          path: ./result_images
+
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v7
+      - name: Install uv
+        uses: astral-sh/setup-uv@d31148d669074a8d0a63714ba94f3201e7020bc3 # v8.3.0
       - name: Cache pre-commit environments
-        if: ${{ matrix.nox-session == 'lint' }}
-        uses: actions/cache@v4
+        uses: actions/cache@v6
         with:
           path: ~/.cache/pre-commit
           key: ${{ runner.os }}-pre-commit-${{ hashFiles('.pre-commit-config.yaml') }}
           restore-keys: |
             ${{ runner.os }}-pre-commit-
-      - name: Install nox
-        run: |
-          python -m pip install -U pip
-          python -m pip install -U nox
-      - name: Run tests
-        run: python -m nox --non-interactive -s ${{ matrix.nox-session }}
-      - name: Upload generated images on failure
-        uses: actions/upload-artifact@v4
-        if: ${{ failure() && matrix.nox-session == 'tests' }}
-        with:
-          name: images-${{ matrix.os }}-${{ matrix.python-version }}
-          path: ./result_images
+      - name: Run pre-commit
+        run: uvx pre-commit run --all-files
 
   build:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v7
         with:
           fetch-depth: 0
-      - uses: actions/setup-python@v5
-        name: Install Python
-        with:
-          python-version: "3.10"
+      - name: Install uv
+        uses: astral-sh/setup-uv@d31148d669074a8d0a63714ba94f3201e7020bc3 # v8.3.0
       - name: Build sdist and wheel
-        run: |
-          python -m pip install -U pip
-          python -m pip install -U build
-          python -m build .
-      - uses: actions/upload-artifact@v4
+        run: uv build
+      - uses: actions/upload-artifact@v7
         with:
           path: dist/*
 
@@ -76,13 +72,14 @@ jobs:
     needs: [tests, build]
     runs-on: ubuntu-latest
     if: startsWith(github.ref, 'refs/tags/')
+    environment:
+      name: pypi
+      url: https://pypi.org/p/corner
+    permissions:
+      id-token: write
     steps:
-      - uses: actions/download-artifact@v4
+      - uses: actions/download-artifact@v8
         with:
           name: artifact
           path: dist
-
-      - uses: pypa/gh-action-pypi-publish@v1.11.0
-        with:
-          user: __token__
-          password: ${{ secrets.pypi_password }}
+      - uses: pypa/gh-action-pypi-publish@v1.14.0

{corner-2.2.3rc1 → corner-2.3.0}/.gitignore

@@ -6,7 +6,8 @@ _skbuild
 *.so
 .mypy_cache
 .tox
-.nox
+.venv
+uv.lock
 .coverage
 .coverage*
 dist

{corner-2.2.3rc1 → corner-2.3.0}/.pre-commit-config.yaml

@@ -7,7 +7,7 @@ repos:
         language: fail
         files: "\\.rej$"
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v5.0.0
+    rev: v6.0.0
     hooks:
       - id: trailing-whitespace
       - id: end-of-file-fixer
@@ -15,15 +15,15 @@ repos:
         exclude: ".copier-answers.yml"
       - id: check-yaml
   - repo: https://github.com/PyCQA/isort
-    rev: "5.13.2"
+    rev: "9.0.0a3"
     hooks:
       - id: isort
         additional_dependencies: [toml]
-  - repo: https://github.com/psf/black
-    rev: "24.10.0"
+  - repo: https://github.com/psf/black-pre-commit-mirror
+    rev: "26.5.1"
     hooks:
       - id: black-jupyter
   - repo: https://github.com/kynan/nbstripout
-    rev: "0.8.1"
+    rev: "0.9.1"
     hooks:
       - id: nbstripout

{corner-2.2.3rc1 → corner-2.3.0}/CONTRIBUTING.md

@@ -38,8 +38,13 @@ TODO
 ## How to test the project
 
 ```bash
-python -m pip install nox
-python -m nox
+uv run pytest -v tests
+```
+
+You can also run the linters with:
+
+```bash
+uvx pre-commit run --all-files
 ```
 
 ## How to submit changes

{corner-2.2.3rc1 → corner-2.3.0}/PKG-INFO

@@ -1,12 +1,13 @@
-Metadata-Version: 2.3
+Metadata-Version: 2.4
 Name: corner
-Version: 2.2.3rc1
+Version: 2.3.0
 Summary: Make some beautiful corner plots
 Project-URL: Homepage, https://corner.readthedocs.io
 Project-URL: Source, https://github.com/dfm/corner.py
 Project-URL: Bug Tracker, https://github.com/dfm/corner.py/issues
 Author-email: Dan Foreman-Mackey <foreman.mackey@gmail.com>
 License: BSD 2-Clause License
+License-File: LICENSE
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: License :: OSI Approved :: BSD License
 Classifier: Operating System :: OS Independent
@@ -14,8 +15,10 @@ Classifier: Programming Language :: Python :: 3
 Requires-Python: >=3.9
 Requires-Dist: matplotlib>=2.1
 Provides-Extra: arviz
+Requires-Dist: arviz-base; extra == 'arviz'
 Requires-Dist: arviz>=0.9; extra == 'arviz'
 Provides-Extra: docs
+Requires-Dist: arviz-base; extra == 'docs'
 Requires-Dist: arviz>=0.9; extra == 'docs'
 Requires-Dist: ipython; extra == 'docs'
 Requires-Dist: myst-nb; extra == 'docs'
@@ -23,6 +26,7 @@ Requires-Dist: pandoc; extra == 'docs'
 Requires-Dist: sphinx-book-theme; extra == 'docs'
 Requires-Dist: sphinx>=1.7.5; extra == 'docs'
 Provides-Extra: test
+Requires-Dist: arviz-base; extra == 'test'
 Requires-Dist: arviz>=0.9; extra == 'test'
 Requires-Dist: pytest; extra == 'test'
 Requires-Dist: scipy; extra == 'test'

{corner-2.2.3rc1 → corner-2.3.0}/docs/install.rst

@@ -50,9 +50,7 @@ source directory, run:
 
 .. code-block:: bash
 
-    python -m pip install nox
-    python -m nox -s tests-PYTHON_VERSION
+    uv run pytest -v tests
 
-Where ``PYTHON_VERSION`` is the version of Python you're using (e.g.
-``3.10``) This might take a few minutes but you shouldn't get any errors
-if all went as planned.
+This might take a few minutes but you shouldn't get any errors if all went as
+planned.

{corner-2.2.3rc1 → corner-2.3.0}/docs/pages/arviz.ipynb

@@ -26,10 +26,18 @@
     "np.random.seed(11234)\n",
     "\n",
     "x = np.random.randn(2, 2000)\n",
-    "data = az.from_dict(\n",
-    "    posterior={\"x\": x, \"y\": np.random.randn(2, 2000, 2)},\n",
-    "    sample_stats={\"diverging\": x < -1.2},\n",
-    ")\n",
+    "try:\n",
+    "    data = az.from_dict(\n",
+    "        posterior={\"x\": x, \"y\": np.random.randn(2, 2000, 2)},\n",
+    "        sample_stats={\"diverging\": x < -1.2},\n",
+    "    )\n",
+    "except TypeError:\n",
+    "    data = az.from_dict(\n",
+    "        {\n",
+    "            \"posterior\": {\"x\": x, \"y\": np.random.randn(2, 2000, 2)},\n",
+    "            \"sample_stats\": {\"diverging\": x < -1.2},\n",
+    "        },\n",
+    "    )\n",
     "\n",
     "figure = corner.corner(data, divergences=True)"
    ]

corner-2.3.0/docs/pages/sigmas.ipynb

@@ -0,0 +1,124 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# A note about sigmas\n",
+    "\n",
+    "We are regularly asked about the default \"sigma\" confidence levels in the 2D histograms. The default confidence levels are `(0.118, 0.393, 0.675, 0.864)` corresponding to the `(0.5, 1, 1.5, 2)`-sigma confidence regions for a **2D** Gaussian distribution. These differ from the corresponding `(0.382, 0.683, 0.866, 0.955)` confidence intervals you would expect for a **1D** Guassian distribution. On this page, we will give a brief explanation about Gaussian distributions, confidence levels, and how the default `corner` confidence levels work.\n",
+    "\n",
+    "In one dimension, a Gaussian probability density is given by\n",
+    "\n",
+    "    pdf(r) = exp(-(r/s)^2/2) / sqrt(2*pi*s^2)\n",
+    "\n",
+    "If we integrate this distribution from `r = (-1*s, -2*s, -3*s)` to `(+1*s, +2*s, +3*s)` then we see that these ranges respectively include `(68.3%, 95.4%, 99.7%)` of the probability. Because scientists often report 1D confidence intervals and many distributions are approximately normal, it has become conventional to call reported confidence intervals  \"`n-σ` confidence intervals\" if the confidence level matches the probability contained in a 1D Gaussian distribution between `r=+/-n*s`. However, the relationship between, e.g., the 68.3% confidence level and `1-σ` doesn't make sense for non-Guassian distributions because those distributions may not be parametrized by a `σ` parameter at all. As we will see below, this relationship changes even for a 2D Gaussian density.\n",
+    "\n",
+    "In two dimensions, a Gaussian probability density is given by:\n",
+    "\n",
+    "    pdf(r) = exp(-(r/s)^2/2) / (2*pi*s^2)\n",
+    "\n",
+    "If we integrate (marginalize) over the polar angle and integrate the probability within a radius `r` from the center of the distribution we compute\n",
+    "\n",
+    "    cdf(r) = Integral(r' * exp(-(r'/s)^2/2) / s^2, {r', 0, r})\n",
+    "           = 1 - exp(-(r/s)^2/2)\n",
+    "\n",
+    "From this calculation we see that for `r = (0.5*s, 1*s, 1.5*s, 2*s)` the included probability is `(11.8%, 39.3%, 67.5%, 86.4%)` matching the `corner.py` default confidence levels for the 2D histograms.\n",
+    "\n",
+    "The advantage of using the 2D Gaussian sigma confidence levels for the  2D histograms is that, for data that are approximately multivariate normally distributed and uncorrelated, the edges of the n-sigma confidence regions shown in the 2D histogram will line up with the n-sigma confidence intervals shown in the 1D histogram at the top of the figure column. See below."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {
+    "tags": []
+   },
+   "outputs": [],
+   "source": [
+    "import corner\n",
+    "import numpy as np\n",
+    "\n",
+    "one_sigma_1d = 0.683\n",
+    "q_lower = 1 / 2 - one_sigma_1d / 2\n",
+    "q_upper = 1 / 2 + one_sigma_1d / 2\n",
+    "\n",
+    "one_sigma_2d = 0.393\n",
+    "\n",
+    "# Generate some fake data from a Gaussian\n",
+    "np.random.seed(42)\n",
+    "x = np.random.randn(50000, 2)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "First, plot this using the 2D Gaussian 1-sigma confidence level  (39.3%) for the 2D histogram with the 1D Gaussian 1-sigma confidence interval for the 1D histogram:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {
+    "jupyter": {
+     "outputs_hidden": false
+    }
+   },
+   "outputs": [],
+   "source": [
+    "fig = corner.corner(x, quantiles=(q_lower, q_upper), levels=(one_sigma_2d,))\n",
+    "_ = fig.suptitle(\"default 'one-sigma' level\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Now, plot this using 1D Gaussian 1-sigma confidence level (68.3%) for the 2D histogram again with the 1D Gaussian 1-sigma confidence interval for the 1D histogram:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {
+    "jupyter": {
+     "outputs_hidden": false
+    }
+   },
+   "outputs": [],
+   "source": [
+    "fig = corner.corner(x, quantiles=(q_lower, q_upper), levels=(one_sigma_1d,))\n",
+    "_ = fig.suptitle(\"alternative 'one-sigma' level\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "We see that the edges of the 2D confidence region no longer line up with the edges of the 1D confidence region. However, this visualization has the advantage that the same percentage of data is contained within the confidence regions in each plot, a condition which is not satisfied when using the default 2D Gaussian sigma levels."
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3 (ipykernel)",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.12.6"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 4
+}

{corner-2.2.3rc1 → corner-2.3.0}/pyproject.toml

@@ -20,9 +20,13 @@ dependencies = ["matplotlib>=2.1"]
 "Bug Tracker" = "https://github.com/dfm/corner.py/issues"
 
 [project.optional-dependencies]
-test = ["pytest", "arviz>=0.9", "scipy"]
-arviz = ["arviz>=0.9"]
-docs = ["arviz>=0.9", "sphinx>=1.7.5", "pandoc", "myst-nb", "sphinx-book-theme", "ipython"]
+test = ["pytest", "arviz>=0.9", "arviz-base", "scipy"]
+arviz = ["arviz>=0.9", "arviz-base"]
+docs = ["arviz>=0.9", "arviz-base", "sphinx>=1.7.5", "pandoc", "myst-nb", "sphinx-book-theme", "ipython"]
+
+# Installed by default with `uv run`/`uv sync`, so `uv run pytest` just works.
+[dependency-groups]
+dev = ["pytest", "arviz>=0.9", "arviz-base", "scipy"]
 
 [build-system]
 requires = ["hatchling", "hatch-vcs"]

{corner-2.2.3rc1 → corner-2.3.0}/readthedocs.yaml

@@ -4,9 +4,9 @@ submodules:
   include: all
 
 build:
-  os: ubuntu-20.04
+  os: ubuntu-22.04
   tools:
-    python: "3.10"
+    python: "3.12"
 
 python:
   install:

corner-2.3.0/src/corner/__init__.py

@@ -0,0 +1,22 @@
+# -*- coding: utf-8 -*-
+
+__all__ = [
+    "corner",
+    "hist2d",
+    "quantile",
+    "overplot_lines",
+    "overplot_points",
+    "axis_from_param_indices",
+    "param_indices_from_axis",
+]
+
+from corner.core import (
+    axis_from_param_indices,
+    hist2d,
+    overplot_lines,
+    overplot_points,
+    param_indices_from_axis,
+    quantile,
+)
+from corner.corner import corner
+from corner.version import version as __version__

{corner-2.2.3rc1 → corner-2.3.0}/src/corner/arviz_corner.py

@@ -3,14 +3,48 @@
 __all__ = ["arviz_corner"]
 
 import logging
+import re
 from collections.abc import Mapping
 
 import numpy as np
-from arviz.data import convert_to_dataset
-from arviz.utils import _var_names, get_coords
+
+try:
+    from arviz.preview import convert_to_dataset
+except ImportError:
+    from arviz import convert_to_dataset
 
 # Support multiple versions of arviz
 try:
+    # arviz < 1.0
+    from arviz.utils import _var_names, get_coords
+except ImportError:
+    # arviz >= 1.0: these functions were removed
+
+    def _var_names(var_names, dataset, filter_vars=None):
+        if var_names is None:
+            return None
+        if filter_vars == "like":
+            return [
+                v
+                for v in dataset.data_vars
+                if any(vn in v for vn in var_names)
+            ]
+        elif filter_vars == "regex":
+            return [
+                v
+                for v in dataset.data_vars
+                if any(re.search(vn, v) for vn in var_names)
+            ]
+        return list(var_names)
+
+    def get_coords(dataset, coords):
+        if not coords:
+            return dataset
+        return dataset.sel(coords)
+
+
+try:
+    # Very old arviz
     from arviz.plots.plot_utils import (
         make_label,
         xarray_to_ndarray,
@@ -24,8 +58,14 @@ try:
         ]
 
 except ImportError:
-    from arviz.labels import BaseLabeller
-    from arviz.sel_utils import xarray_to_ndarray, xarray_var_iter
+    try:
+        # Medium arviz (< 1.0)
+        from arviz.labels import BaseLabeller
+        from arviz.sel_utils import xarray_to_ndarray, xarray_var_iter
+    except ImportError:
+        # arviz >= 1.0
+        from arviz import xarray_to_ndarray, xarray_var_iter
+        from arviz_base.labels import BaseLabeller
 
     def _get_labels(plotters, labeller=None):
         if labeller is None:

{corner-2.2.3rc1 → corner-2.3.0}/src/corner/core.py

@@ -112,6 +112,14 @@ def corner_impl(
     plotdim = factor * K + factor * (K - 1.0) * whspace
     dim = lbdim + plotdim + trdim
 
+    # Make title_fmt into a list if necessary, otherwise check length
+    if isinstance(title_fmt, str):
+        title_fmt = [title_fmt] * K
+    elif title_fmt is not None:
+        assert (
+            len(title_fmt) == K
+        ), "'title_fmt' should contain as many elements as data dimensions"
+
     # Make axes_scale into a list if necessary, otherwise check length
     if isinstance(axes_scale, str):
         axes_scale = [axes_scale] * K
@@ -263,7 +271,7 @@ def corner_impl(
                 q_m, q_p = q_mid - q_lo, q_hi - q_mid
 
                 # Format the quantile display.
-                fmt = "{{0:{0}}}".format(title_fmt).format
+                fmt = "{{0:{0}}}".format(title_fmt[i]).format
                 title = r"${{{0}}}_{{-{1}}}^{{+{2}}}$"
                 title = title.format(fmt(q_mid), fmt(q_m), fmt(q_p))
 
@@ -562,9 +570,10 @@ def hist2d(
         If true, suppress warnings for small datasets.
 
     levels : array_like
-        The contour levels to draw.
-        If None, (0.5, 1, 1.5, 2)-sigma equivalent contours are drawn,
-        i.e., containing 11.8%, 39.3%, 67.5% and 86.4% of the samples.
+        Confidence levels to use to draw contours.
+        If None, confidence levels (0.118, 0.393, 0.675, and 0.864) will be drawn.
+        For a 2D Gaussian distribution, these correspond to contours separated from the
+        center of the distribution by (0.5, 1, 1.5, 2)-sigma.
         See https://corner.readthedocs.io/en/latest/pages/sigmas/
 
     ax : matplotlib.Axes
@@ -891,6 +900,84 @@ def overplot_points(fig, xs, reverse=False, **kwargs):
                 axes[k2, k1].plot(xs[k1], xs[k2], **kwargs)
 
 
+def axis_from_param_indices(fig, ix, iy, return_axis=True):
+    """
+    Get axis corresponding to indices ``ix``, ``iy`` of the input data.  This can be used, e.g., for
+    manually adding additional data or labels to a specific axis.  This is the inverse of
+    `param_indices_from_axis`.
+
+    Parameters
+    ----------
+    fig : Figure
+        The figure generated by a call to :func:`corner.corner`.
+
+    ix, iy : int
+        Indices of the parameter list corresponding to the plotted ``x`` and ``y`` axes.  Only cases
+        where ``ix <= iy`` have plotted axes, and ``ix == iy`` corresponds to the histogram axis for
+        parameter index ``ix``.  The function doesn't raise an error when ``ix > iy`` corresponding to one
+        of the hidden axes, though it does raise an error if either ``ix`` or ``iy`` is too large for the
+        dimensions of the plotted ``fig``.
+
+    return_axis : bool
+        Return either the axis itself or its integer index
+
+    Returns
+    -------
+    ax : axis
+        Entry in the ``fig.axes`` list.
+    """
+    ndim = int(np.sqrt(len(fig.axes)))
+    if ix > ndim - 1:
+        msg = f"ix={ix} too large for ndim={ndim}"
+        raise ValueError(msg)
+    elif iy > ndim - 1:
+        msg = f"ix={ix} too large for ndim={ndim}"
+        raise ValueError(msg)
+
+    for i in range(ndim**2):
+        ix_i = range(ndim)[(i % ndim)]
+        iy_i = range(ndim)[(i // ndim) - ndim]
+
+        if (ix == ix_i) & (iy == iy_i):
+            break
+
+    if return_axis:
+        return fig.axes[i]
+    else:
+        return i
+
+
+def param_indices_from_axis(fig, i):
+    """
+    Get indices ``ix``, ``iy`` of the input data associated with one of the plotted axes.  This is the
+    inverse of `axis_from_param_indices`.
+
+    Parameters
+    ----------
+    fig : Figure
+        The figure generated by a call to :func:`corner.corner`.
+
+    i : int
+        Index of an entry in the ``fig.axes`` list
+
+    Returns
+    -------
+    ix, iy : int
+        Indices of the figure axes list corresponding to the plotted ``x`` and ``y`` of the specified axis
+        index
+    """
+    if i > len(fig.axes):
+        msg = f"{i} must be < len(fig.axes) = {len(fig.axes)}"
+        raise ValueError(msg)
+
+    ndim = int(np.sqrt(len(fig.axes)))
+
+    ix = range(ndim)[(i % ndim)]
+    iy = range(ndim)[(i // ndim) - ndim]
+
+    return ix, iy
+
+
 def _parse_input(xs):
     xs = np.atleast_1d(xs)
     if len(xs.shape) == 1:

{corner-2.2.3rc1 → corner-2.3.0}/src/corner/corner.py

@@ -63,7 +63,7 @@ def corner(
     Parameters
     ----------
     data : obj
-        Any object that can be converted to an ``arviz.InferenceData`` object.
+        Any object that can be converted to an ``arviz.InferenceData`` or ``xarrayDataTree`` object.
         Refer to documentation of ``arviz.convert_to_dataset`` for details.
 
     bins : int or array_like[ndim,]
@@ -148,10 +148,10 @@ def corner(
         errors. If `None` (default), inherit the values from quantiles, unless
         quantiles is `None`, in which case it defaults to [0.16,0.5,0.84]
 
-    title_fmt : string
-        The format string for the quantiles given in titles. If you explicitly
-        set ``show_titles=True`` and ``title_fmt=None``, the labels will be
-        shown as the titles. (default: ``.2f``)
+    title_fmt : string or iterable (ndim,)
+        The format string for the quantiles given in titles for eachimension.
+        If you explicitly set ``show_titles=True`` and ``title_fmt=None``,
+        the labels will be shown as the titles. (default: ``.2f``)
 
     title_kwargs : dict
         Any extra keyword arguments to send to the `set_title` command.

corner-2.3.0/src/corner/version.py

@@ -0,0 +1,24 @@
+# file generated by vcs-versioning
+# don't change, don't track in version control
+from __future__ import annotations
+
+__all__ = [
+    "__version__",
+    "__version_tuple__",
+    "version",
+    "version_tuple",
+    "__commit_id__",
+    "commit_id",
+]
+
+version: str
+__version__: str
+__version_tuple__: tuple[int | str, ...]
+version_tuple: tuple[int | str, ...]
+commit_id: str | None
+__commit_id__: str | None
+
+__version__ = version = '2.3.0'
+__version_tuple__ = version_tuple = (2, 3, 0)
+
+__commit_id__ = commit_id = None