.travis.yml

@@ -19,9 +19,9 @@ matrix:
                   python: "3.9"
                 - os: "windows"
                   language: shell
-      python: "3.9"
+                  python: "3.8"
-      env: "PATH=/c/python39:/c/python39/Scripts:$PATH"
+                  env: "PATH=/c/python38:/c/python38/Scripts:$PATH"
                   before_install:
-              - choco install python --version=3.9.6
+                          - choco install python --version=3.8.6
-              - cp /c/python39/python.exe /c/python39/python3.exe
+                          - cp /c/python38/python.exe /c/python38/python3.exe
-      script: tox -e py39
+                  script: tox -e py38

hscommon/sphinxgen.py

@@ -7,8 +7,10 @@
 import os.path as op
 import re
 
+from distutils.version import LooseVersion
+from pkg_resources import load_entry_point, get_distribution
+
 from .build import read_changelog_file, filereplace
-from sphinx.cmd.build import build_main as sphinx_build
 
 CHANGELOG_FORMAT = """
 {version} ({date})
@@ -71,6 +73,9 @@ def gen(
     if op.exists(confpath):
         conf_out = op.join(basepath, "conf.py")
         filereplace(confpath, conf_out, **confrepl)
+    if LooseVersion(get_distribution("sphinx").version) >= LooseVersion("1.7.0"):
+        from sphinx.cmd.build import build_main as sphinx_build
+
         # Call the sphinx_build function, which is the same as doing sphinx-build from cli
         try:
             sphinx_build([basepath, destpath])
@@ -78,3 +83,16 @@ def gen(
             print(
                 "Sphinx called sys.exit(), but we're cancelling it because we don't actually want to exit"
             )
+    else:
+        # We used to call sphinx-build with print_and_do(), but the problem was that the virtualenv
+        # of the calling python wasn't correctly considered and caused problems with documentation
+        # relying on autodoc (which tries to import the module to auto-document, but fail because of
+        # missing dependencies which are in the virtualenv). Here, we do exactly what is done when
+        # calling the command from bash.
+        cmd = load_entry_point("Sphinx", "console_scripts", "sphinx-build")
+        try:
+            cmd(["sphinx-build", basepath, destpath])
+        except SystemExit:
+            print(
+                "Sphinx called sys.exit(), but we're cancelling it because we don't actually want to exit"
+            )

requirements-extra.txt

@@ -1,5 +1,5 @@
-pytest>=6,<7
+pytest>=5,<6
 flake8
 tox-travis
 black
-pyinstaller>=4.5,<5.0; sys_platform != 'linux'
+pyinstaller>=4.0,<5.0; sys_platform != 'linux'

requirements.txt

@@ -1,7 +1,7 @@
 Send2Trash>=1.3.0
-sphinx>=3.0.0
+sphinx>=1.2.2
-polib>=1.1.0
+polib>=1.0.4
 hsaudiotag3k>=1.1.3*
 distro>=1.5.0
-PyQt5 >=5.14.1,<6.0; sys_platform != 'linux'
+PyQt5 >=5.4,<6.0; sys_platform != 'linux'
-pywin32>=228; sys_platform == 'win32'
+pywin32>=200; sys_platform == 'win32'