zuul-jobs/roles/ensure-sphinx/README.rst
Ian Wienand ab4042e60a ensure-sphinx: Use python3
All our platforms are Python 3 now, so we can simplify this.  We can
remove the virtualenv dependency as ensure-pip installs venv and sets
variables for us to use it when making a virtualenv.

Change-Id: I98c3da5b02a4ac7fb9d7bd8e00170762e77b9f40
2022-02-04 08:03:25 +11:00

42 lines
1.1 KiB
ReStructuredText

Ensure sphinx is installed
Installs sphinx. Also installs any dependencies needed in the first of
doc/requirements.txt, releasenotes/requirements.txt and
test-requirements.txt to be found.
All pip installs are done with a provided constraints file, if given.
**Role Variables**
.. zuul:rolevar:: constraints_file
Optional path to a pip constraints file for installing python libraries.
.. zuul:rolevar:: doc_building_packages
:default: []
List of python packages to install for building docs. The default
package list is based on the python version in use.
.. zuul:rolevar:: doc_building_extra_packages
:default: []
List of python additional packages to install for building docs.
By default this list is empty.
.. zuul:rolevar:: sphinx_python
:default: python3
**Deprecated**
Version of python to use, only supports ``python3``.
.. zuul:rolevar:: zuul_work_virtualenv
:default: ~/.venv
Virtualenv location in which to install things.
.. zuul:rolevar:: zuul_work_dir
:default: {{ zuul.project.src_dir }}
Directory to operate in.