@ewdurbin @benjaminp

@ned-deily salt automatically pulls deps from the requirements.txt file in this repo:

https://github.com/python/psf-salt/blob/master/salt/docs/init.sls#L38-L46

So I believe we should just need to add blurb here: https://github.com/python/docsbuild-scripts/blob/master/requirements.txt

I'll double check the PATH exposed to cron jobs...

Yep, assuming /srv/docsbuild/scripts/requirements.txt gets updated from there. Thanks!

So blurb is installed but I missed a step: the docsbuild script venv is running Python 2.7.

As nothing is blocking us for using Python 3 (not knowing it was 2.7, I always used a Python 3 venv locally and it works perfectly) we should first upgrade this venv to Python 3, then modify docsbuild script to pass this venv' python to Makefile so blurb will be available from within it.

See: python/psf-salt#109

Thanks to @ewdurbin we now have a Python 3 venv available https://github.com/python/psf-salt/pull/110/files with the requirements I updated in #15.

But the docs server provides Python 3.4 and blurb has been written in 3.6, may support 3.5 but is not compatible with 3.4:

  File "blurb/blurb.py", line 1049
    subprocess.run(["git", "add", *git_add_files], stdout=subprocess.PIPE, stderr=subprocess.PIPE).check_returncode()
                                         ^
SyntaxError: can use starred expression only as assignment target

I have not tested it extensively there may be other incompatibilities.

I no longer see blurb missing errors in logs.