Tests: update test suite and fix some tests (#242)

* Update Git ignore

* Tests: update test suite and fix some tests

I expect some versions to fail due to #240. If that's the case, we can merge #241
here and move forward with it.

.circleci/config.yml

@@ -8,7 +8,7 @@ commands:
         type: string
       sphinx-version:
         type: string
-        default: "5,6,7,latest"
+        default: "5,6,7,8,latest,dev"
     steps:
       - checkout
       # NOTE: use Tox 3.x until I understand the syntax for generative environments:
@@ -23,12 +23,14 @@ jobs:
     steps:
       - run-tox:
           version: py38
+          sphinx-version: "5,6"
   py39:
     docker:
       - image: 'cimg/python:3.9'
     steps:
       - run-tox:
           version: py39
+          sphinx-version: "5,6,7"
   py310:
     docker:
       - image: 'cimg/python:3.10'

.gitignore

@@ -108,4 +108,7 @@ package-lock.json
 node_modules
 
 # vscode
-.vscode/
+.vscode/
+
+# PyPI build
+_build/

tests/examples/404rst/conf.py

@@ -1,5 +1,6 @@
 # conf.py to run tests
 
+project = 'Python'
 master_doc = 'index'
 extensions = [
     'notfound.extension',

tests/examples/default/conf.py

@@ -1,5 +1,6 @@
 # conf.py to run tests
 
+project = 'Python'
 master_doc = 'index'
 extensions = [
     'notfound.extension',

tests/test_urls.py

@@ -64,14 +64,19 @@ def test_default_settings(app, status, warning):
     else:
         cssclass = ""
 
+    if sphinx.version_info < (7, 3):
+        alt = "Logo"
+    else:
+        alt = "Logo of Python"
+
     chunks = [
         '<h1>Page not found</h1>',
         "Unfortunately we couldn't find the content you were looking for.",
         '<title>Page not found &#8212; Python  documentation</title>',
 
         # favicon and logo
         f'<link rel="{cssclass}icon" href="/en/latest/_static/favicon.png"/>',
-        '<img class="logo" src="/en/latest/_static/logo.svg" alt="Logo"/>',
+        f'<img class="logo" src="/en/latest/_static/logo.svg" alt="{alt}"/>',
 
         # sidebar URLs
         '<h1 class="logo"><a href="/en/latest/index.html">Python</a></h1>',
@@ -139,6 +144,11 @@ def test_urls_prefix_setting(app, status, warning):
     else:
         cssclass = ""
 
+    if sphinx.version_info < (7, 3):
+        alt = "Logo"
+    else:
+        alt = "Logo of Python"
+
     chunks = [
         # sidebar URLs
         '<h1 class="logo"><a href="/language/version/index.html">Python</a></h1>',
@@ -147,7 +157,7 @@ def test_urls_prefix_setting(app, status, warning):
 
         # favicon and logo
         f'<link rel="{cssclass}icon" href="/language/version/_static/favicon.png"/>',
-        '<img class="logo" src="/language/version/_static/logo.svg" alt="Logo"/>',
+        f'<img class="logo" src="/language/version/_static/logo.svg" alt="{alt}"/>',
 
         # resources
         _get_css_html_link_tag(app, 'language', 'version', 'alabaster.css'),
@@ -177,6 +187,12 @@ def test_urls_prefix_setting_none(app, status, warning):
     else:
         cssclass = ""
 
+    if sphinx.version_info < (7, 3):
+        alt = "Logo"
+    else:
+        alt = "Logo of Python"
+
+
     chunks = [
         # sidebar URLs
         '<h1 class="logo"><a href="/index.html">Python</a></h1>',
@@ -185,7 +201,7 @@ def test_urls_prefix_setting_none(app, status, warning):
 
         # favicon and logo
         f'<link rel="{cssclass}icon" href="/_static/favicon.png"/>',
-        '<img class="logo" src="/_static/logo.svg" alt="Logo"/>',
+        f'<img class="logo" src="/_static/logo.svg" alt="{alt}"/>',
 
         # resources
         _get_css_html_link_tag(app, '', '', 'alabaster.css'),

tox.ini

@@ -4,7 +4,9 @@ isolated_build = True
 
 envlist =
   docs
-  py{38,39,310,311,312}-sphinx{5,6,7,latest}
+  py{38}-sphinx{5,6}
+  py{39}-sphinx{5,6,7}
+  py{310,311,312}-sphinx{5,6,7,8,latest,dev}
 
 [testenv]
 deps =
@@ -15,7 +17,9 @@ deps =
   sphinx5: sphinx<6.0
   sphinx6: sphinx<7.0
   sphinx7: sphinx<8.0
+  sphinx8: sphinx<9.0
   sphinxlatest: sphinx
+  sphinxdev: https://github.com/sphinx-doc/sphinx/archive/refs/heads/master.zip
 commands = pytest {posargs}
 
 [testenv:docs]