build(release): Bump version 0.0.1a2 → 0.0.1a3

tony · tony · commit 9d438ce278ea · 2026-04-06T09:23:18.000-05:00
why: Advance all workspace packages to the next alpha release.
what:
- Update version in all 8 pyproject.toml files
- Update __version__ / setup() version strings in all __init__.py files
- Update inter-package pinned dependency versions in gp-sphinx
- Update workspace root dependency pin
- Update uv.lock
- Update test assertions and docs/scripts referencing the version
diff --git a/docs/project/releasing.md b/docs/project/releasing.md
@@ -27,11 +27,11 @@ building, and publishing. There is no setup.py or requirements files.
 5. Commit and tag with the repo-wide release format:
 
    ```console
-   $ git commit -m 'build(release): Tag v0.0.1a2'
+   $ git commit -m 'build(release): Tag v0.0.1a3'
    ```
 
    ```console
-   $ git tag v0.0.1a2
+   $ git tag v0.0.1a3
    ```
 
 6. Push:
diff --git a/packages/gp-sphinx/pyproject.toml b/packages/gp-sphinx/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "gp-sphinx"
-version = "0.0.1a2"
+version = "0.0.1a3"
 description = "Shared Sphinx documentation platform for git-pull projects"
 requires-python = ">=3.10,<4.0"
 authors = [
@@ -26,8 +26,8 @@ readme = "README.md"
 keywords = ["sphinx", "documentation", "configuration"]
 dependencies = [
   "sphinx<9",
-  "sphinx-gptheme==0.0.1a2",
-  "sphinx-fonts==0.0.1a2",
+  "sphinx-gptheme==0.0.1a3",
+  "sphinx-fonts==0.0.1a3",
   "myst-parser",
   "docutils",
   "sphinx-autodoc-typehints",
@@ -42,7 +42,7 @@ dependencies = [
 
 [project.optional-dependencies]
 argparse = [
-  "sphinx-argparse-neo==0.0.1a2",
+  "sphinx-argparse-neo==0.0.1a3",
 ]
 
 [project.urls]
diff --git a/packages/gp-sphinx/src/gp_sphinx/__init__.py b/packages/gp-sphinx/src/gp_sphinx/__init__.py
@@ -7,7 +7,7 @@
 __title__ = "gp-sphinx"
 __package_name__ = "gp_sphinx"
 __description__ = "Shared Sphinx documentation platform for git-pull projects"
-__version__ = "0.0.1a2"
+__version__ = "0.0.1a3"
 __author__ = "Tony Narlock"
 __github__ = "https://github.com/git-pull/gp-sphinx"
 __docs__ = "https://gp-sphinx.git-pull.com"
diff --git a/packages/sphinx-argparse-neo/pyproject.toml b/packages/sphinx-argparse-neo/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "sphinx-argparse-neo"
-version = "0.0.1a2"
+version = "0.0.1a3"
 description = "Modern Sphinx extension for documenting argparse-based CLI tools"
 requires-python = ">=3.10,<4.0"
 authors = [
diff --git a/packages/sphinx-argparse-neo/src/sphinx_argparse_neo/__init__.py b/packages/sphinx-argparse-neo/src/sphinx_argparse_neo/__init__.py
@@ -43,7 +43,7 @@
 if t.TYPE_CHECKING:
     from sphinx.application import Sphinx
 
-__version__ = "0.0.1a2"
+__version__ = "0.0.1a3"
 
 
 class SetupDict(t.TypedDict):
diff --git a/packages/sphinx-autodoc-docutils/pyproject.toml b/packages/sphinx-autodoc-docutils/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "sphinx-autodoc-docutils"
-version = "0.0.1a2"
+version = "0.0.1a3"
 description = "Sphinx extension for documenting docutils directives and roles as first-class reference entries"
 requires-python = ">=3.10,<4.0"
 authors = [
diff --git a/packages/sphinx-autodoc-docutils/src/sphinx_autodoc_docutils/__init__.py b/packages/sphinx-autodoc-docutils/src/sphinx_autodoc_docutils/__init__.py
@@ -46,7 +46,7 @@ def setup(app: Sphinx) -> ExtensionMetadata:
     app.add_directive("autorole-index", AutoRoleIndex)
 
     return {
-        "version": "0.0.1a2",
+        "version": "0.0.1a3",
         "parallel_read_safe": True,
         "parallel_write_safe": True,
     }
diff --git a/packages/sphinx-autodoc-pytest-fixtures/pyproject.toml b/packages/sphinx-autodoc-pytest-fixtures/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "sphinx-autodoc-pytest-fixtures"
-version = "0.0.1a2"
+version = "0.0.1a3"
 description = "Sphinx extension for documenting pytest fixtures as first-class objects"
 requires-python = ">=3.10,<4.0"
 authors = [
diff --git a/packages/sphinx-autodoc-sphinx/pyproject.toml b/packages/sphinx-autodoc-sphinx/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "sphinx-autodoc-sphinx"
-version = "0.0.1a2"
+version = "0.0.1a3"
 description = "Sphinx extension for documenting extension config values as first-class conf.py reference entries"
 requires-python = ">=3.10,<4.0"
 authors = [
diff --git a/packages/sphinx-autodoc-sphinx/src/sphinx_autodoc_sphinx/__init__.py b/packages/sphinx-autodoc-sphinx/src/sphinx_autodoc_sphinx/__init__.py
@@ -41,7 +41,7 @@ def setup(app: Sphinx) -> ExtensionMetadata:
     app.add_directive("autoconfigvalue-index", AutoconfigvalueIndexDirective)
     app.add_directive("autosphinxconfig-index", AutosphinxconfigIndexDirective)
     return {
-        "version": "0.0.1a2",
+        "version": "0.0.1a3",
         "parallel_read_safe": True,
         "parallel_write_safe": True,
     }
diff --git a/packages/sphinx-fonts/pyproject.toml b/packages/sphinx-fonts/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "sphinx-fonts"
-version = "0.0.1a2"
+version = "0.0.1a3"
 description = "Sphinx extension for self-hosted fonts via Fontsource CDN"
 requires-python = ">=3.10,<4.0"
 authors = [
diff --git a/packages/sphinx-fonts/src/sphinx_fonts/__init__.py b/packages/sphinx-fonts/src/sphinx_fonts/__init__.py
@@ -25,7 +25,7 @@
 
 logger = logging.getLogger(__name__)
 logger.addHandler(logging.NullHandler())
-__version__ = "0.0.1a2"
+__version__ = "0.0.1a3"
 
 CDN_TEMPLATE = (
     "https://cdn.jsdelivr.net/npm/{package}@{version}"
diff --git a/packages/sphinx-gptheme/pyproject.toml b/packages/sphinx-gptheme/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "sphinx-gptheme"
-version = "0.0.1a2"
+version = "0.0.1a3"
 description = "Furo child theme for git-pull project documentation"
 requires-python = ">=3.10,<4.0"
 authors = [
diff --git a/packages/sphinx-gptheme/src/sphinx_gptheme/__init__.py b/packages/sphinx-gptheme/src/sphinx_gptheme/__init__.py
@@ -23,7 +23,7 @@
 if t.TYPE_CHECKING:
     from sphinx.application import Sphinx
 
-__version__ = "0.0.1a2"
+__version__ = "0.0.1a3"
 
 
 def get_theme_path() -> pathlib.Path:
diff --git a/pyproject.toml b/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "gp-sphinx-workspace"
-version = "0.0.1a2"
+version = "0.0.1a3"
 description = "Workspace root for gp-sphinx packages"
 requires-python = ">=3.10,<4.0"
 authors = [
@@ -9,7 +9,7 @@ authors = [
 license = { text = "MIT" }
 readme = "README.md"
 dependencies = [
-  "gp-sphinx==0.0.1a2",
+  "gp-sphinx==0.0.1a3",
 ]
 
 [tool.uv.workspace]
diff --git a/scripts/ci/package_tools.py b/scripts/ci/package_tools.py
@@ -402,7 +402,7 @@ def smoke_gp_sphinx(dist_dir: pathlib.Path, version: str) -> None:
 
                 conf = merge_sphinx_config(
                     project="demo",
-                    version="0.0.1a2",
+                    version="0.0.1a3",
                     copyright="2026",
                 )
                 globals().update(conf)
diff --git a/tests/test_package_tools.py b/tests/test_package_tools.py
@@ -13,7 +13,7 @@
 
 def test_workspace_version_is_lockstep() -> None:
     """All workspace packages share the same version."""
-    assert package_tools.workspace_version() == "0.0.1a2"
+    assert package_tools.workspace_version() == "0.0.1a3"
 
 
 def test_check_versions_passes_for_repo() -> None:
@@ -23,10 +23,10 @@ def test_check_versions_passes_for_repo() -> None:
 
 def test_release_metadata_accepts_repo_tag() -> None:
     """Repo-wide release tags resolve to the shared version."""
-    assert package_tools.release_metadata("v0.0.1a2") == {"version": "0.0.1a2"}
+    assert package_tools.release_metadata("v0.0.1a3") == {"version": "0.0.1a3"}
 
 
 def test_release_metadata_rejects_package_tag() -> None:
     """Package-scoped tags are no longer valid release inputs."""
     with pytest.raises(SystemExit, match="invalid release tag format"):
-        package_tools.release_metadata("gp-sphinx@v0.0.1a2")
+        package_tools.release_metadata("gp-sphinx@v0.0.1a3")
diff --git a/uv.lock b/uv.lock

Original file line number	Diff line number	Diff line change
`@@ -46,7 +46,7 @@ def setup(app: Sphinx) -> ExtensionMetadata:`
`46`	`46`	`app.add_directive("autorole-index", AutoRoleIndex)`
`47`	`47`
`48`	`48`	`return {`
`49`		`- "version": "0.0.1a2",`
	`49`	`+ "version": "0.0.1a3",`
`50`	`50`	`"parallel_read_safe": True,`
`51`	`51`	`"parallel_write_safe": True,`
`52`	`52`	`}`
Original file line number	Diff line number	Diff line change
`@@ -41,7 +41,7 @@ def setup(app: Sphinx) -> ExtensionMetadata:`
`41`	`41`	`app.add_directive("autoconfigvalue-index", AutoconfigvalueIndexDirective)`
`42`	`42`	`app.add_directive("autosphinxconfig-index", AutosphinxconfigIndexDirective)`
`43`	`43`	`return {`
`44`		`- "version": "0.0.1a2",`
	`44`	`+ "version": "0.0.1a3",`
`45`	`45`	`"parallel_read_safe": True,`
`46`	`46`	`"parallel_write_safe": True,`
`47`	`47`	`}`