fix: show the next version on the docs changelog

Author: onerandomusername

docs/conf.py

@@ -21,6 +21,7 @@
 import sys
 from typing import Any, Dict, Optional
 
+import versioningit
 from sphinx.application import Sphinx
 
 # If extensions (or modules to document with autodoc) are in another directory,
@@ -110,6 +111,11 @@
 # The short X.Y version.
 version = ".".join(release.split(".")[:2])
 
+next_version = versioningit.get_next_version(os.path.abspath(".."))
+
+rst_prolog += f"""
+.. |next_version| replace:: {next_version}
+"""
 
 _IS_READTHEDOCS = bool(os.getenv("READTHEDOCS"))
 

docs/whats_new.rst

@@ -13,7 +13,7 @@ Changelog
 This page keeps a detailed human friendly rendering of what's new and changed
 in specific versions. Please see :ref:`version_guarantees` for more information.
 
-.. towncrier-draft-entries:: |release| [UNRELEASED]
+.. towncrier-draft-entries:: |next_version| [UNRELEASED]
 
 .. towncrier release notes start
 

pyproject.toml

@@ -63,6 +63,7 @@ docs = [
     "towncrier==23.6.0",
     "sphinx-notfound-page==0.8.3",
     "sphinxext-opengraph==0.9.1",
+    "versioningit>=3.3.0",
 ]
 
 [dependency-groups]