| 1 |
# Minimal makefile for Sphinx documentation |
| 2 |
# |
| 3 |
|
| 4 |
# You can set these variables from the command line, and also |
| 5 |
# from the environment for the first two. |
| 6 |
SPHINXOPTS ?= |
| 7 |
SPHINXBUILD ?= sphinx-build |
| 8 |
SOURCEDIR = . |
| 9 |
BUILDDIR = _build |
| 10 |
|
| 11 |
# Put it first so that "make" without argument is like "make help". |
| 12 |
help: |
| 13 |
@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) |
| 14 |
|
| 15 |
.PHONY: help Makefile |
| 16 |
|
| 17 |
|
| 18 |
# Generate pytest JSON + HTML report (repo root) |
| 19 |
test-report: |
| 20 |
cd .. && python -m pytest --json-report --json-report-file=report.json |
| 21 |
|
| 22 |
# Build docs after generating test report |
| 23 |
html-with-tests: test-report |
| 24 |
@$(SPHINXBUILD) -M html "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) |
| 25 |
|
| 26 |
|
| 27 |
# Catch-all target: route all unknown targets to Sphinx using the new |
| 28 |
# "make mode" option. $(O) is meant as a shortcut for $(SPHINXOPTS). |
| 29 |
%: Makefile |
| 30 |
@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) |
| 31 |
|
| 32 |
|
| 33 |
|
| 34 |
|
| 35 |
|