Add mypy and test coverage reports for docs.

.github/workflows/release.yml

@@ -35,7 +35,7 @@ jobs:
       - name: Upload pages artifact
         uses: actions/upload-pages-artifact@v2
         with:
-          path: public
+          path: public/html
       - id: deployment
         name: Deploy to GitHub Pages
         uses: actions/deploy-pages@v2

.gitlab-ci.yml

@@ -59,7 +59,7 @@ package:
 pages:
   artifacts:
     paths:
-      - public
+      - public/html
   except:
     refs:
       - schedules

.gitlab-ci.yml.jinja

@@ -76,7 +76,7 @@ package:
 pages:
   artifacts:
     paths:
-      - public
+      - public/html
   except:
     refs:
       - schedules

.readthedocs.yaml

@@ -2,10 +2,8 @@ build:
   os: ubuntu-22.04
   tools:
     python: '3'
-python:
-  install:
-    - extra_requirements:
-        - docs
-      method: pip
-      path: .
+  commands:
+    - pip install --upgrade pip
+    - make dev-docs
+    - make docs
 version: 2

Makefile

@@ -3,6 +3,7 @@
 # Construct pipenv run command with or without site-packages flag when not in CI environment and pipenv command exists.
 SITE_PACKAGES_FLAG = $(shell [ "${SS_SITE_PACKAGES}" = "true" ] && echo --site-packages)
 PIPRUN := $(shell [ "${CI}" != "true" ] && command -v pipenv > /dev/null 2>&1 && echo pipenv ${SITE_PACKAGES_FLAG} run)
+PUBLIC_DIR := $(or $(READTHEDOCS_OUTPUT),public)
 
 # Remove common intermediate files.
 clean:
@@ -15,7 +16,7 @@ clean:
 		Pipfile* \
 		coverage.xml \
 		dist \
-		public
+		$(PUBLIC_DIR)
 	find . -name '*.egg-info' -print0 | xargs -0 rm -rf
 	find . -name '*.pyc' -print0 | xargs -0 rm -f
 	find . -name '*.swp' -print0 | xargs -0 rm -f
@@ -72,7 +73,9 @@ upload:
 	${PIPRUN} python -m twine upload dist/*
 
 docs:
-	${PIPRUN} python -m sphinx.cmd.build docs public
+	${PIPRUN} python -m sphinx.cmd.build docs ${PUBLIC_DIR}/html
+	${PIPRUN} python -m mypy tests src --html-report ${PUBLIC_DIR}/html/reports/mypy
+	${PIPRUN} python -m pytest --cov-report html:${PUBLIC_DIR}/html/reports/coverage .
 
 docs-autobuild:
-	${PIPRUN} python -m sphinx_autobuild docs public --watch src
+	${PIPRUN} python -m sphinx_autobuild docs ${PUBLIC_DIR}/html --watch src

Makefile.jinja

@@ -3,6 +3,7 @@
 # Construct pipenv run command with or without site-packages flag when not in CI environment and pipenv command exists.
 SITE_PACKAGES_FLAG = $(shell [ "${SS_SITE_PACKAGES}" = "true" ] && echo --site-packages)
 PIPRUN := $(shell [ "${CI}" != "true" ] && command -v pipenv > /dev/null 2>&1 && echo pipenv ${SITE_PACKAGES_FLAG} run)
+PUBLIC_DIR := $(or $(READTHEDOCS_OUTPUT),public)
 
 # Remove common intermediate files.
 clean:
@@ -17,7 +18,7 @@ clean:
 		Pipfile* \
 		coverage.xml \
 		dist \
-		public
+		$(PUBLIC_DIR)
 	find . -name '*.egg-info' -print0 | xargs -0 rm -rf
 	find . -name '*.pyc' -print0 | xargs -0 rm -f
 	find . -name '*.swp' -print0 | xargs -0 rm -f
@@ -74,7 +75,9 @@ upload:
 	${PIPRUN} python -m twine upload dist/*
 
 docs:
-	${PIPRUN} python -m sphinx.cmd.build docs public
+	${PIPRUN} python -m sphinx.cmd.build docs ${PUBLIC_DIR}/html
+	${PIPRUN} python -m mypy tests src --html-report ${PUBLIC_DIR}/html/reports/mypy
+	${PIPRUN} python -m pytest --cov-report html:${PUBLIC_DIR}/html/reports/coverage .
 
 docs-autobuild:
-	${PIPRUN} python -m sphinx_autobuild docs public --watch src
+	${PIPRUN} python -m sphinx_autobuild docs ${PUBLIC_DIR}/html --watch src

copier.yaml

@@ -6,7 +6,6 @@ _exclude:
   - __pycache__
   - copier.yaml
   - copier.yml
-  - docs/modules/serious_scaffold.settings.rst
   - includes
   - src/serious_scaffold
   - ~*

docs/cli/index.rst

@@ -1,5 +1,5 @@
-Command Line Interface
-======================
+CLI Reference
+=============
 
 .. click:: serious_scaffold.cli:typer_click_object
   :prog: serious-scaffold-cli

docs/cli/index.rst.jinja

@@ -1,5 +1,5 @@
-Command Line Interface
-======================
+CLI Reference
+=============
 
 .. click:: {{ module_name }}.cli:typer_click_object
   :prog: {{ package_name }}-cli

docs/index.rst

@@ -6,6 +6,7 @@ Welcome to Serious Scaffold Python's documentation!
 
    cli/index
    api/index
+   reports/index
 
 Indices and tables
 ==================

docs/index.rst.jinja

@@ -6,6 +6,7 @@ Welcome to {{ project_name }}'s documentation!
 
    cli/index
    api/index
+   reports/index
 
 Indices and tables
 ==================

docs/reports/coverage/index.rst

@@ -0,0 +1,4 @@
+Coverage Reports
+================
+
+This is a placeholder for coverage reports which supposed to be overridden.

docs/reports/index.rst

@@ -0,0 +1,8 @@
+Code Quality Reports
+====================
+
+.. toctree::
+   :maxdepth: 2
+
+   mypy/index
+   coverage/index

docs/reports/mypy/index.rst

@@ -0,0 +1,4 @@
+MyPy Reports
+============
+
+This is a placeholder for mypy reports which supposed to be overridden.

requirements/docs.txt

@@ -1,6 +1,9 @@
 # Requirements for docs.
 autodoc-pydantic
 furo
+mypy[reports]
+pytest
+pytest-cov
 Sphinx
 sphinx-autobuild
 sphinx-click

src/serious_scaffold/cli.py

@@ -23,7 +23,3 @@ def main() -> None:
 # NOTE(huxuan): click object is used for document generation.
 # Reference: https://github.com/tiangolo/typer/issues/200#issuecomment-796485787
 typer_click_object = typer.main.get_command(app)
-
-
-if __name__ == "__main__":
-    app()  # pragma: no cover

src/{{ module_name }}/cli.py.jinja

@@ -23,7 +23,3 @@ def main() -> None:
 # NOTE(huxuan): click object is used for document generation.
 # Reference: https://github.com/tiangolo/typer/issues/200#issuecomment-796485787
 typer_click_object = typer.main.get_command(app)
-
-
-if __name__ == "__main__":
-    app()  # pragma: no cover