Release v26.3.0 (#5424)

Author: BradyPlanden

.github/release_workflow.md

@@ -7,7 +7,7 @@ GitHub, PyPI, and conda-forge by the maintainers.
 
 1. Create and checkout a new release branch (e.g., `release/vYY.MM.0`) from the `main` branch. The year and month are taken from the date of the release. The final number represents the bug fix version, which is zero for a new major release.
 
-2. Run `scripts/update_version.py` to update `CITATION.cff` and `CHANGELOG.md`, then create a PR from `release/vYY.MM.0` to `main`.
+2. Run `python scripts/update_version.py YY.MM.0` to update `CITATION.cff` and `CHANGELOG.md`, then create a PR from `release/vYY.MM.0` to `main`.
 
 3. Ensure CI passes on the PR, then merge it.
 
@@ -28,7 +28,7 @@ If a new bugfix release is required after the release of `vYY.MM.{x-1}`:
    git cherry-pick -x <commit-sha-from-main>
    ```
 
-4. Run `scripts/update_version.py` to update `CITATION.cff` and `CHANGELOG.md`, then commit the changes.
+4. Run `python scripts/update_version.py YY.MM.x` to update `CITATION.cff` and `CHANGELOG.md`, then commit the changes.
 
 5. Create a new GitHub release with the tag `vYY.MM.x` from the `release/vYY.MM.x` branch (not `main`) and a description copied from `CHANGELOG.md`. This ensures the release contains only the bugfixes, not all changes on `main`. This will automatically trigger `publish_pypi.yml` and create a _release_ on PyPI.
 

CHANGELOG.md

@@ -2,6 +2,14 @@
 
 ## Features
 
+## Bug fixes
+
+## Breaking changes
+
+# [v26.3.0](https://github.com/pybamm-team/PyBaMM/tree/v26.3.0) - 2026-03-23
+
+## Features
+
 - Improved the performance of processed variables by replacing `casadi.vertcat` input stacking with numpy vectors. ([#5413](https://github.com/pybamm-team/PyBaMM/pull/5413))
 - Preserve custom variables and events in built-in model to_config ([#5411](https://github.com/pybamm-team/PyBaMM/pull/5411))
 - Allow out of bounds initial state of charge to enable initialising a simulation at a voltage outside the voltage limits. ([#5386](https://github.com/pybamm-team/PyBaMM/pull/5386))

CITATION.cff

@@ -24,6 +24,6 @@ keywords:
   - "expression tree"
   - "python"
   - "symbolic differentiation"
-version: "25.12.2"
+version: "26.3.0"
 repository-code: "https://github.com/pybamm-team/PyBaMM"
 title: "Python Battery Mathematical Modelling (PyBaMM)"

docs/conf.py

@@ -94,6 +94,7 @@
     "https://books.google.co.uk/books",
     "https://docs.scipy.org/doc/scipy",  # SciPy docs timeout intermittently
     "https://chemrxiv.org",  # ChemRxiv blocks automated link checking
+    "https://pubs.acs.org",  # ACS blocks automated link checking
 ]
 
 

scripts/update_version.py

@@ -2,16 +2,15 @@
 Automatically update version numbers in various files for releases
 """
 
+import argparse
 import os
 import re
 from datetime import date
 
-from pybamm._version import __version__ as release_version
-
 import pybamm
 
 
-def update_version():
+def update_version(release_version):
     """
     Updates version numbers and release information across project files
     """
@@ -39,4 +38,12 @@ def update_version():
 
 
 if __name__ == "__main__":
-    update_version()
+    parser = argparse.ArgumentParser(
+        description="Update version numbers for a PyBaMM release"
+    )
+    parser.add_argument(
+        "version",
+        help="Release version, e.g. 26.3 or 26.3.1",
+    )
+    args = parser.parse_args()
+    update_version(args.version)