zuul-jobs/roles/ensure-twine/README.rst
Andreas Jaeger e6396cca48 Document twine_executable
Change Ia06218a830b5d44f04e0f10e0444be2cf9ad682e missed to document
the variable, add it.

Change-Id: Ibbe4c40f8a4ea26a16e0a25a788636621e062902
2020-06-01 13:11:52 +02:00

24 lines
733 B
ReStructuredText

Ensure twine is installed.
**Role Variables**
.. zuul:rolevar:: twine_python
:default: python
The python interpreter to use to install twine if it is not already
installed. Set it to "python3" to use python 3, for example.
**Output Variables**
.. zuul:rolevar:: twine_excutable
:default: twine
After running this role, ``twine_executable`` will be set as the path
to a valid ``twine``.
At role runtime, look for an existing ``twine`` at this specific
path. Note the default (``twine``) effectively means to find tox in
the current ``$PATH``. For example, if your base image
pre-installs twine in an out-of-path environment, set this so the
role does not attempt to install the user version.