Run make html as test

Refs #213

Author: sverhoeven

tests/test_project.py

@@ -15,11 +15,15 @@ def test_project_folder(cookies):
     assert project.project.isdir()
 
 
-def run(args: Sequence[str], dirpath: os.PathLike) -> subprocess.CompletedProcess:
+def run(args: Sequence[str], dirpath: os.PathLike, env_bin=None) -> subprocess.CompletedProcess:
+    env = os.environ.copy()
+    if env_bin:
+        env['PATH'] = os.getcwd() + env_bin + ':' + os.environ.get('PATH')
     return subprocess.run(args=args,
                           stdout=subprocess.PIPE,
                           stderr=subprocess.PIPE,
                           cwd=dirpath,
+                          env=env,
                           encoding="utf-8")
 
 
@@ -29,16 +33,16 @@ def baked_with_development_dependencies(cookies):
     env_output = run(['python3', '-m', 'venv', 'env'], result.project)
     assert env_output.returncode == 0
     env_bin = 'env/Scripts/' if platform.startswith("win") else 'env/bin/'
-    latest_pip_output = run([f'{env_bin}pip3', 'install', '--upgrade', 'pip', 'setuptools'], result.project)
+    latest_pip_output = run(['pip3', 'install', '--upgrade', 'pip', 'setuptools'], result.project, env_bin)
     assert latest_pip_output.returncode == 0
-    pip_output = run([f'{env_bin}pip3', 'install', '--editable', '.[dev]'], result.project)
+    pip_output = run(['pip3', 'install', '--editable', '.[dev]'], result.project, env_bin)
     assert pip_output.returncode == 0
     return result.project, env_bin
 
 
 def test_pytest(baked_with_development_dependencies):
     project_dir, env_bin = baked_with_development_dependencies
-    pytest_output = run([f'{env_bin}pytest'], project_dir)
+    pytest_output = run(['pytest'], project_dir, env_bin)
     assert pytest_output.returncode == 0
     assert '== 3 passed in' in pytest_output.stdout
     assert (project_dir / 'coverage.xml').exists()
@@ -55,7 +59,16 @@ def test_subpackage(baked_with_development_dependencies):
     subsubpackage.mkdir()
     (subsubpackage / '__init__.py').write_text('FOO = "bar"', encoding="utf-8")
 
-    build_output = run([f'{env_bin}python3', 'setup.py', 'build'], project_dir)
+    build_output = run([f'python3', 'setup.py', 'build'], project_dir, env_bin)
     assert build_output.returncode == 0
     assert (project_dir / 'build' / 'lib' / 'my_python_package' / 'mysub' / '__init__.py').exists()
     assert (project_dir / 'build' / 'lib' / 'my_python_package' / 'mysub' / 'mysub2' / '__init__.py').exists()
+
+
+def test_generate_api_docs(baked_with_development_dependencies):
+    project_dir, env_bin = baked_with_development_dependencies
+
+    docs_dir = project_dir / 'docs'
+    build_output = run([f'make', 'html'], docs_dir, env_bin)
+    assert build_output.returncode == 0
+    assert (docs_dir / '_build' / 'html' / 'index.html').exists()