diff --git a/.pip-tools.toml b/.pip-tools.toml new file mode 100644 index 000000000000..c1f6c7ad65a1 --- /dev/null +++ b/.pip-tools.toml @@ -0,0 +1,5 @@ +[tool.pip-tools] +resolver = "backtracking" +allow-unsafe = true +strip-extras = true +quiet = true diff --git a/docs/docsite/requirements.in b/docs/docsite/requirements.in new file mode 100644 index 000000000000..580df8eb6013 --- /dev/null +++ b/docs/docsite/requirements.in @@ -0,0 +1,7 @@ +# This requirements file is used for AWX latest doc builds. + +sphinx # Tooling to build HTML from RST source. +sphinx-ansible-theme # Ansible community theme for Sphinx doc builds. +docutils # Tooling for RST processing and the swagger extension. +Jinja2 # Requires investiation. Possibly inherited from previous repo with a custom theme. +PyYaml # Requires investigation. Possibly used as tooling for swagger API reference content. diff --git a/docs/docsite/requirements.txt b/docs/docsite/requirements.txt index fd4bc52d97a0..46bad56c7d28 100644 --- a/docs/docsite/requirements.txt +++ b/docs/docsite/requirements.txt @@ -1,5 +1,74 @@ +# +# This file is autogenerated by pip-compile with Python 3.11 +# by the following command: +# +# pip-compile --allow-unsafe --output-file=docs/docsite/requirements.txt --strip-extras docs/docsite/requirements.in +# +alabaster==0.7.13 + # via sphinx +ansible-pygments==0.1.1 + # via sphinx-ansible-theme +babel==2.12.1 + # via sphinx +certifi==2023.7.22 + # via requests +charset-normalizer==3.2.0 + # via requests +docutils==0.16 + # via + # -r docs/docsite/requirements.in + # sphinx + # sphinx-rtd-theme +idna==3.4 + # via requests +imagesize==1.4.1 + # via sphinx +jinja2==3.0.3 + # via + # -r docs/docsite/requirements.in + # sphinx +markupsafe==2.1.3 + # via jinja2 +packaging==23.1 + # via sphinx +pygments==2.16.1 + # via + # ansible-pygments + # sphinx +pyyaml==6.0.1 + # via -r docs/docsite/requirements.in +requests==2.31.0 + # via sphinx +snowballstemmer==2.2.0 + # via sphinx sphinx==5.1.1 + # via + # -r docs/docsite/requirements.in + # sphinx-ansible-theme + # sphinx-rtd-theme + # sphinxcontrib-applehelp + # sphinxcontrib-devhelp + # sphinxcontrib-htmlhelp + # sphinxcontrib-jquery + # sphinxcontrib-qthelp + # sphinxcontrib-serializinghtml sphinx-ansible-theme==0.9.1 -docutils==0.16 -Jinja2<3.1 -PyYaml + # via -r docs/docsite/requirements.in +sphinx-rtd-theme==1.3.0 + # via sphinx-ansible-theme +sphinxcontrib-applehelp==1.0.7 + # via sphinx +sphinxcontrib-devhelp==1.0.5 + # via sphinx +sphinxcontrib-htmlhelp==2.0.4 + # via sphinx +sphinxcontrib-jquery==4.1 + # via sphinx-rtd-theme +sphinxcontrib-jsmath==1.0.1 + # via sphinx +sphinxcontrib-qthelp==1.0.6 + # via sphinx +sphinxcontrib-serializinghtml==1.1.9 + # via sphinx +urllib3==2.0.4 + # via requests diff --git a/tox.ini b/tox.ini index 45f6d0140c82..726381832654 100644 --- a/tox.ini +++ b/tox.ini @@ -19,8 +19,20 @@ commands = select = F401,F402,F821,F823,F841,F811,E265,E266,F541,W605,E722,F822,F523,W291,F405 exclude = awx/ui/node_modules,awx/ui/node_modules,env,awx_collection_build +[testenv:pip-compile-docs] +description = Compile docs build lockfiles +deps = + # pip-tools config file support was introduced in v7 + pip-tools >= 7 +commands = + {envpython} -m piptools compile \ + --output-file=docs/docsite/requirements.txt \ + docs/docsite/requirements.in + [testenv:docs] description = Build documentation -deps = -r{toxinidir}/docs/docsite/requirements.txt +deps = + -r{toxinidir}/docs/docsite/requirements.in + -c{toxinidir}/docs/docsite/requirements.txt commands = sphinx-build -T -E -W -n --keep-going {tty:--color} -j auto -c docs/docsite -d docs/docsite/build/doctrees -b html docs/docsite/rst docs/docsite/build/html