readthedocs builds are failing, july 23 2022 version

[ctb]

https://readthedocs.org/projects/sourmash/builds/17495788/ - succeeded, "Completed July 20, 2022. 9:14 p.m."

https://readthedocs.org/projects/sourmash/builds/17510182/ - failed, "Completed July 22, 2022. 11:06 a.m".

Nothing significant changed in sourmash during that time (just #2131, a docs-only change) so to me it looks like it's a readthedocs problem.

[ctb]

ahh. looks like sphinx-rtd-theme is conflicting with docutils requirement,

ERROR: pip's dependency resolver does not currently take into account all the packages that are installed.

This behaviour is the source of the following dependency conflicts.
sphinx-rtd-theme 1.0.0 requires docutils<0.18, but you have docutils 0.18.1 which is incompatible.

Successfully installed asttokens-2.0.5 attrs-21.4.0 backcall-0.2.0 beautifulsoup4-4.11.1 bitstring-3.1.9 bleach-5.0.1 bz2file-0.98 cachetools-5.2.0 cycler-0.11.0 decorator-5.1.1 defusedxml-0.7.1 deprecation-2.1.0 docutils-0.18.1 entrypoints-0.4 executing-0.8.3 fastjsonschema-2.16.1 fonttools-4.34.4 importlib-metadata-4.12.0 importlib-resources-5.8.0 ipython-8.4.0 jedi-0.18.1 jsonschema-4.7.2 jupyter-client-7.3.4 jupyter-core-4.11.1 jupyterlab-pygments-0.2.2 kiwisolver-1.4.4 markdown-it-py-2.1.0 matplotlib-3.5.2 matplotlib-inline-0.1.3 mdit-py-plugins-0.3.0 mdurl-0.1.1 mistune-0.8.4 myst-parser-0.18.0 nbclient-0.6.6 nbconvert-6.5.0 nbformat-5.4.0 nbsphinx-0.8.9 nest-asyncio-1.5.5 numpy-1.23.1 pandocfilters-1.5.0 parso-0.8.3 pexpect-4.8.0 pickleshare-0.7.5 pockets-0.9.1 prompt-toolkit-3.0.30 ptyprocess-0.7.0 pure-eval-0.2.2 pyrsistent-0.18.1 python-dateutil-2.8.2 pyyaml-6.0 pyzmq-23.2.0 scipy-1.8.1 screed-1.0.5 soupsieve-2.3.2.post1 sourmash-4.4.3.dev1+gd8aa9f8c.d20220720 sphinxcontrib-napoleon-0.7 stack-data-0.3.0 tinycss2-1.1.1 tornado-6.2 traitlets-5.3.0 typing-extensions-4.3.0 wcwidth-0.2.5 webencodings-0.5.1 zipp-3.8.1

and also it's failing to build, https://pypi.org/project/sphinx-rtd-theme/.

[ctb]

I can replicate the problem on farm, a Linux box. Still not sure what is causing the problem tho.

This is the command:

python -m pip install --upgrade --upgrade-strategy eager --no-cache-dir .[doc] 

and it errors out with

      ModuleNotFoundError: No module named 'sourmash'

I wonder if this is a pip version thing where pip's behavior changed?

[ctb]

ok, I had not realized that we were already using .readthedocs.yml for readthedocs config 😆

(per configuration files)

[ctb]

it's honestly starting to look like a pip version problem - 22.2 was released at exactly the time the errors started.

from https://pypi.org/project/pip/#history -

[ctb]

this issue might be related - pypa/pip#11294

going to try:

• downgrading pip to < 22.2
• building docs with python 3.10
• export SETUPTOOLS_USE_DISTUTILS=stdlib