Open Stack

On Wed, 2022-02-02 at 22:09 +0000, Jeremy Stanley wrote:
> On 2022-02-02 20:49:05 +0000 (+0000), Stone, Ronald wrote:
> > The StarlingX docs team is implementing the default
> > sphinxcontrib.spelling spelling extension for use from tox via a
> > virtualenv set up for this purpose. We do not want
> > sphinxcontrib.spelling loaded into other tox jobs that won't use
> > it. This means that it cannot be loaded from the standard conf.py.
> > Instead I am bypassing conf.py and setting parameters from the
> > sphinx-build command in the appropriate tox job:
> [...]
> 
> Have you considered creating a separate doc/source/conf-spelling.py
> and passing that via sphinx-build's -c option instead?

Also remember that the 'conf.py' is a Python file so you can encode logic in it.
tox injects environment variables when running [1]. It would be easy to check
for the presence of e.g. 'TOX_ENV_NAME' and add the extension as necessary.

Stephen

[1] https://tox.wiki/en/latest/config.html#injected-environment-variables