Update for Sphinx v9 Compatibility (#25)

* update kwarg passing to generate_autosummary_content for sphinx v9+

* change checkout fetch-depth so setuptools_scm will ("should") work

* add test case on py 3.14

* add test case for sphinx<9

* set fetch-depth 0 for sphinx_limits tests (for setuptools_scm to work)

* update Automodsumm.get_items

Author: rocco8773

.github/workflows/documentation.yml

@@ -20,14 +20,14 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python: ['3.8', '3.10', '3.11', '3.12', '3.13']
+        python: ['3.8', '3.10', '3.11', '3.12', '3.13', '3.14']
         os: [ubuntu-latest]
 
     steps:
     - name: Checkout code
       uses: actions/checkout@v3
       with:
-        fetch-depth: 1
+        fetch-depth: 0
     - name: Set up Python
       uses: actions/setup-python@v5
       with:
@@ -63,11 +63,15 @@ jobs:
           os: ubuntu-latest
           sphinx: sphinx<8.2
 
+        - python: '3.13'
+          os: ubuntu-latest
+          sphinx: sphinx<9.0
+
     steps:
     - name: Checkout code
       uses: actions/checkout@v3
       with:
-        fetch-depth: 1
+        fetch-depth: 0
     - name: Set up Python
       uses: actions/setup-python@v5
       with:

plasmapy_sphinx/automodsumm/core.py

@@ -623,7 +623,11 @@ def option_processor(self):
         return processor
 
     def get_items(self, names):
-        self.bridge.genopt["imported-members"] = True
+        if Version(sphinx_version) < Version("9.0"):
+            self.bridge.genopt["imported-members"] = True
+        else:
+            # sphinx dropped the use of DocumenterBridge in v9.0
+            self.options["imported-members"] = True
         return Autosummary.get_items(self, names)
 
     @property

plasmapy_sphinx/automodsumm/generate.py

@@ -321,10 +321,13 @@ def generate_docs(
             }
             if Version(sphinx_version) < Version("8.2"):
                 _kwargs["app"] = app
-            else:
+            elif Version(sphinx_version) < Version("9.0"):
                 _kwargs["config"] = app.config
                 _kwargs["events"] = app.events
                 _kwargs["registry"] = app.registry
+            else:
+                _kwargs["config"] = app.config
+                _kwargs["events"] = app.events
 
             content = generate_autosummary_content(**_kwargs)