Build Salt's HTML Documentation
(session, compress, clean)
| 1713 | @nox.parametrize("clean", [False, True]) |
| 1714 | @nox.parametrize("compress", [False, True]) |
| 1715 | def docs_html(session, compress, clean): |
| 1716 | """ |
| 1717 | Build Salt's HTML Documentation |
| 1718 | """ |
| 1719 | if _upgrade_pip_setuptools_and_wheel(session): |
| 1720 | requirements_file = os.path.join( |
| 1721 | "requirements", "static", "ci", _get_pydir(session), "docs.lock" |
| 1722 | ) |
| 1723 | install_command = ["--progress-bar=off", "-r", requirements_file] |
| 1724 | session.install(*install_command, silent=PIP_INSTALL_SILENT) |
| 1725 | os.chdir("doc/") |
| 1726 | if clean: |
| 1727 | session.run("make", "clean", external=True) |
| 1728 | session.run("make", "html", "SPHINXOPTS=-W", external=True) |
| 1729 | if compress: |
| 1730 | session.run("tar", "-cJvf", "html-archive.tar.xz", "_build/html", external=True) |
| 1731 | os.chdir("..") |
| 1732 | |
| 1733 | |
| 1734 | @nox.session(name="docs-man", python="3") |
nothing calls this directly
no test coverage detected