Merge remote-tracking branch 'origin/main' into python-3.13

Author: adamtheturtle

.github/workflows/publish-site.yml

@@ -0,0 +1,27 @@
+---
+name: Deploy documentation
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  pages:
+    runs-on: ubuntu-latest
+    environment:
+      name: ${{ github.ref_name == 'main' && 'github-pages' || 'development' }}
+      url: ${{ steps.deployment.outputs.page_url }}
+    permissions:
+      pages: write
+      id-token: write
+    steps:
+      - id: deployment
+        uses: sphinx-notes/pages@v3
+        with:
+          documentation_path: docs/source
+          pyproject_extras: dev
+          python_version: '3.13'
+          sphinx_build_options: -W
+          publish: ${{ github.ref_name == 'main' }}

README.rst

@@ -1,4 +1,4 @@
-|Build Status| |codecov| |PyPI| |Documentation Status|
+|Build Status| |codecov| |PyPI|
 
 VWS Auth Tools
 ==============
@@ -63,15 +63,12 @@ Usage
 Full Documentation
 ------------------
 
-See the `full documentation <https://vws-auth-tools.readthedocs.io/en/latest>`__.
+See the `full documentation <https://vws-python.github.io/vws-auth-tools/>`__.
 
 .. |Build Status| image:: https://github.com/VWS-Python/vws-auth-tools/actions/workflows/ci.yml/badge.svg?branch=main
    :target: https://github.com/VWS-Python/vws-auth-tools/actions
 .. |codecov| image:: https://codecov.io/gh/VWS-Python/vws-auth-tools/branch/main/graph/badge.svg
    :target: https://codecov.io/gh/VWS-Python/vws-auth-tools
-.. |Documentation Status| image:: https://readthedocs.org/projects/vws-auth-tools/badge/?version=latest
-   :target: https://vws-auth-tools.readthedocs.io/en/latest/?badge=latest
-   :alt: Documentation Status
 .. |PyPI| image:: https://badge.fury.io/py/VWS-Auth-Tools.svg
    :target: https://badge.fury.io/py/VWS-Auth-Tools
 .. |minimum-python-version| replace:: 3.13

docs/source/conf.py

@@ -4,11 +4,19 @@
 """
 
 import importlib.metadata
+from pathlib import Path
 
 from packaging.specifiers import SpecifierSet
+from sphinx_pyproject import SphinxConfig
 
-project = "VWS-Auth-Tools"
-author = "Adam Dangoor"
+_pyproject_file = Path(__file__).parent.parent.parent / "pyproject.toml"
+_pyproject_config = SphinxConfig(
+    pyproject_file=_pyproject_file,
+    config_overrides={"version": None},
+)
+
+project = _pyproject_config.name
+author = _pyproject_config.author
 
 extensions = [
     "sphinx_copybutton",

pyproject.toml

@@ -64,6 +64,7 @@ optional-dependencies.dev = [
     "sphinx==8.2.0",
     "sphinx-copybutton==0.5.2",
     "sphinx-lint==1.0.0",
+    "sphinx-pyproject==0.3.0",
     "sphinx-substitution-extensions==2025.2.19",
     "sphinxcontrib-spelling==8.0.1",
     "sybil==9.1.0",
@@ -271,7 +272,6 @@ ignore = [
     "*.enc",
     ".markdownlint.json",
     ".pre-commit-config.yaml",
-    "readthedocs.yaml",
     "CHANGELOG.rst",
     "CODE_OF_CONDUCT.rst",
     "CONTRIBUTING.rst",