sphinx / numpydoc requires 0.37.0 of llvmlite but doc building requires 0.38.0

[sgbaird]

In #7354, I mentioned a workaround to Numba requires at least version 0.38.0 of llvmlite via:

conda install -c numba/label/ci_llvmlite_0.38 llvmlite

However, then doc builds don't work:

conda install sphinx numpydoc

The following packages will be SUPERSEDED by a higher-priority channel:

  llvmlite           numba/label/ci_llvmlite_0.38::llvmlit~ --> numba::llvmlite-0.37.0-py38_0

pip install sphinx_bootstrap_theme

Then under docs folder:

make html

Running Sphinx v4.1.2

Configuration error:
There is a programmable error in your configuration file:

Traceback (most recent call last):
  File "C:\Users\sterg\Documents\GitHub\sparks-baird\numba-fork\docs\source\conf.py", line 24, in <module>
    import numba
ModuleNotFoundError: No module named 'numba'

During handling of the above exception, another exception occurred:

Traceback (most recent call last):
  File "C:\Users\sterg\anaconda3\envs\numbaenv\lib\site-packages\sphinx\config.py", line 327, in eval_config_file
    exec(code, namespace)
  File "C:\Users\sterg\Documents\GitHub\sparks-baird\numba-fork\docs\source\conf.py", line 28, in <module>
    import numba
  File "C:\Users\sterg\Documents\GitHub\sparks-baird\numba-fork\numba\__init__.py", line 195, in <module>
    _ensure_llvm()
  File "C:\Users\sterg\Documents\GitHub\sparks-baird\numba-fork\numba\__init__.py", line 109, in _ensure_llvm
    raise ImportError(msg)
ImportError: Numba requires at least version 0.38.0 of llvmlite.
Installed version is 0.37.0.
Please update llvmlite.

[sgbaird]

Seemed a bit too simple, but when I ran the following again, it allowed the 0.38.0 version:

conda install -c numba/label/ci_llvmlite_0.38 llvmlite

However, running make html results in a different error:

Running Sphinx v4.1.2
Initializing ghfiles plugin
loading pickled environment... failed
failed: build environment version not current
WARNING: sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0

Theme error:
no theme named 'sphinx_rtd_theme' found (missing theme.conf?)

So then I install sphinx_rtd_theme via (Source):

pip install sphinx-rtd-theme

which includes the following output (not sure if this is relevant to another issue):

  Attempting uninstall: docutils
    Found existing installation: docutils 0.17.1
    Uninstalling docutils-0.17.1:
      Successfully uninstalled docutils-0.17.1

At this point, I run make html and it seems to work OK.

[gmarkall]

I suspect conda installed the lower version of llvmlite when you did conda install sphinx numpydoc because when that command was invoked, the numba/label/ci_llvmlite_0.38 channel wasn't also specified.

I don't think this is a Numba issue, but an aspect of conda's behavior and the specific sequence of commands used here. Is the documentation guidance specifying an incorrect set of steps?

[sgbaird]

@gmarkall, That's correct. The steps are listed under contributing: main-documentation. I'm running into the same issue again when trying to do other things with conda, such as conda install m2-base so I can use Linux commands in the Anaconda Windows shells, though interestingly enough conda install -c msys2 m2-base (source) doesn't seem to mess with llvm.

[github-actions]

This issue is marked as stale as it has had no activity in the past 30 days. Please close this issue if no further response or action is needed. Otherwise, please respond with any updates and confirm that this issue still needs to be addressed.

[esc]

@sgbaird I see that #7367 is still open and appears to have some remaining tasks to be completed.

[github-actions]

This issue is marked as stale as it has had no activity in the past 30 days. Please close this issue if no further response or action is needed. Otherwise, please respond with any updates and confirm that this issue still needs to be addressed.