Prepare 0.23 release (#2499)

* update warning, version and changelog

* cmdstanpy 2.0 support only in arviz-base

* update 404 page

* remove deprecated GHA

* double check public namespaces

* pylint

Author: OriolAbril

.azure-pipelines/azure-pipelines-external.yml

@@ -18,7 +18,7 @@ jobs:
 
       Python_311_Special_versions:
         python.version: "3.11"
-        cmdstanpy.version: "github"
+        cmdstanpy.version: "latest"
         emcee.version: 2
         name: "External special"
 

.github/workflows/rtd_link_description.yaml

@@ -1,19 +1,13 @@
 # Change Log
 
-## v0.x.x Unreleased
-
-### New features
+## v0.23.0 (2025 Des 9)
 
 ### Maintenance and fixes
 - Fix numpyro jax incompatibility. ([2465](https://github.com/arviz-devs/arviz/pull/2465))
 - Avoid closing unloaded files in `from_netcdf()` ([2463](https://github.com/arviz-devs/arviz/issues/2463))
 - Fix sign error in lp parsed in from_numpyro ([2468](https://github.com/arviz-devs/arviz/issues/2468))
 - Fix attrs persistance in idata-datatree conversions ([2476](https://github.com/arviz-devs/arviz/issues/2476))
 
-### Deprecation
-
-### Documentation
-
 ## v0.22.0 (2025 Jul 9)
 
 ### New features

CHANGELOG.md

@@ -1,12 +1,10 @@
 # pylint: disable=wildcard-import,invalid-name,wrong-import-position
 """ArviZ is a library for exploratory analysis of Bayesian models."""
-__version__ = "0.23.0.dev0"
+__version__ = "0.23.0"
 
 import logging
 import os
-import warnings
-import datetime
-from pathlib import Path
+import re
 
 from matplotlib.colors import LinearSegmentedColormap
 from matplotlib.pyplot import style
@@ -15,6 +13,17 @@
 
 
 def _warn_once_per_day():
+    from .preview import info
+
+    # skip warning if all 3 arviz subpackages are already installed
+    pat = re.compile(r"arviz_(base|stats|plots) available")
+    if len(pat.findall(info)) == 3:
+        return
+
+    import datetime
+    from warnings import warn
+    from pathlib import Path
+
     warning_dir = Path.home() / "arviz_data"
     warning_dir.mkdir(exist_ok=True)
 
@@ -27,7 +36,7 @@ def _warn_once_per_day():
         last_date = None
 
     if last_date != today:
-        warnings.warn(
+        warn(
             "\nArviZ is undergoing a major refactor to improve flexibility and extensibility "
             "while maintaining a user-friendly interface."
             "\nSome upcoming changes may be backward incompatible."
@@ -364,4 +373,4 @@ def _mpl_cm(name, colorlist):
 
 
 # clean namespace
-del os, logging, LinearSegmentedColormap, Logger, mpl
+del os, re, logging, version, LinearSegmentedColormap, Logger, mpl

arviz/__init__.py

@@ -8,41 +8,51 @@
 
 try:
     from arviz_base import *
+    import arviz_base as base
 
-    status = "arviz_base available, exposing its functions as part of arviz.preview"
-    _log.info(status)
+    _status = "arviz_base available, exposing its functions as part of arviz.preview"
+    _log.info(_status)
 except ModuleNotFoundError:
-    status = "arviz_base not installed"
-    _log.info(status)
+    _status = "arviz_base not installed"
+    _log.info(_status)
 except ImportError:
-    status = "Unable to import arviz_base"
-    _log.info(status, exc_info=True)
+    _status = "Unable to import arviz_base"
+    _log.info(_status, exc_info=True)
 
-info += status + "\n"
+info += _status + "\n"
 
 try:
     from arviz_stats import *
 
-    status = "arviz_stats available, exposing its functions as part of arviz.preview"
-    _log.info(status)
+    # the base computational module fron arviz_stats will override the alias to arviz-base
+    # arviz.stats.base will still be available
+    import arviz_base as base
+    import arviz_stats as stats
+
+    _status = "arviz_stats available, exposing its functions as part of arviz.preview"
+    _log.info(_status)
 except ModuleNotFoundError:
-    status = "arviz_stats not installed"
-    _log.info(status)
+    _status = "arviz_stats not installed"
+    _log.info(_status)
 except ImportError:
-    status = "Unable to import arviz_stats"
-    _log.info(status, exc_info=True)
-info += status + "\n"
+    _status = "Unable to import arviz_stats"
+    _log.info(_status, exc_info=True)
+info += _status + "\n"
 
 try:
     from arviz_plots import *
+    import arviz_plots as plots
 
-    status = "arviz_plots available, exposing its functions as part of arviz.preview"
-    _log.info(status)
+    _status = "arviz_plots available, exposing its functions as part of arviz.preview"
+    _log.info(_status)
 except ModuleNotFoundError:
-    status = "arviz_plots not installed"
-    _log.info(status)
+    _status = "arviz_plots not installed"
+    _log.info(_status)
 except ImportError:
-    status = "Unable to import arviz_plots"
-    _log.info(status, exc_info=True)
+    _status = "Unable to import arviz_plots"
+    _log.info(_status, exc_info=True)
+
+info += _status + "\n"
 
-info += status + "\n"
+# clean namespace
+del logging, _status, _log

arviz/preview.py

@@ -0,0 +1,19 @@
+---
+html_theme.sidebar_secondary.remove:
+orphan:
+---
+
+:::{title}
+Page not found
+:::
+
+:::{card} 404 - Page not found
+:img-top: _static/404.png
+
+Sorry, it looks like your sampler ventured to an undefined region of the documentation space.
+
+The page you are looking for could not be found.
+
+The navbar can help you find the page you are looking for.
+Otherwise you can go back to the [documentation homepage](https://python.arviz.org).
+:::

doc/_templates/404.html

@@ -161,7 +161,7 @@
 # This patterns also effect to html_static_path and html_extra_path
 exclude_patterns = ["_build", "build", "Thumbs.db", ".DS_Store", "notebooks/.ipynb_checkpoints"]
 # configure notfound extension to not add any prefix to the urls
-notfound_urls_prefix = "/en/latest/"
+notfound_urls_prefix = "/en/stable/"
 
 # The name of the Pygments (syntax highlighting) style to use.
 pygments_style = "sphinx"
@@ -220,7 +220,7 @@
     "doc_path": "doc/source/",
     "default_mode": "light",
 }
-html_sidebars: Dict[str, Any] = {"index": []}
+html_sidebars: Dict[str, Any] = {"index": [], "404": [], "community": []}
 
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,
@@ -229,11 +229,6 @@
 html_static_path = ["_static"]
 html_css_files = ["custom.css"]
 
-# use additional pages to add a 404 page
-html_additional_pages = {
-    "404": "404.html",
-}
-
 # -- Options for HTMLHelp output ------------------------------------------
 
 # Output file base name for HTML help builder.

doc/source/404.md

@@ -28,6 +28,11 @@
     "and exposes all their elements through the `arviz.preview` namespace. In the future, with the ArviZ 1.0 release, the `arviz` namespace will look\n",
     "like `arviz.preview` looks like today.\n",
     "\n",
+    ":::{info}\n",
+    "Starting with version 0.23.0, ArviZ will emit a warning once a day at import time informing about the upcoming major version.\n",
+    "You can install arviz-base, arviz-stats and arviz-plots to silence this warning completely.\n",
+    ":::\n",
+    "\n",
     "We encourage you to try it out and get a head start on the migration!"
    ]
   },
@@ -15046,7 +15051,7 @@
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "arviz",
+   "display_name": "Python 3 (ipykernel)",
    "language": "python",
    "name": "python3"
   },
@@ -15060,7 +15065,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.13.5"
+   "version": "3.12.12"
   }
  },
  "nbformat": 4,