sphinxext.bokeh_plot broken

ALL software version info (bokeh, python, notebook, OS, browser, any other relevant pacakges)

This was the result of conda create -n minimal python=3.5 sphinx bokeh today on OS X 10.11.6, replicated also on another mac running 10.11. Full result of conda list below in case it’s helpful. Note also that @handwerkerd verified also not working with latext Sphinx 1.5.3.

alabaster                 0.7.10                   py35_0  
babel                     2.3.4                    py35_0  
bokeh                     0.12.4                   py35_0  
docutils                  0.13.1                   py35_0  
imagesize                 0.7.1                    py35_0  
jinja2                    2.9.5                    py35_0  
markupsafe                0.23                     py35_2  
mkl                       2017.0.1                      0  
numpy                     1.12.0                   py35_0  
openssl                   1.0.2k                        0  
pip                       9.0.1                    py35_1  
pygments                  2.2.0                    py35_0  
python                    3.5.3                         0  
python-dateutil           2.6.0                    py35_0  
pytz                      2016.10                  py35_0  
pyyaml                    3.12                     py35_0  
readline                  6.2                           2  
requests                  2.13.0                   py35_0  
setuptools                27.2.0                   py35_0  
six                       1.10.0                   py35_0  
snowballstemmer           1.2.1                    py35_0  
sphinx                    1.5.1                    py35_0  
sqlite                    3.13.0                        0  
tk                        8.5.18                        0  
tornado                   4.4.2                    py35_0  
wheel                     0.29.0                   py35_0  
xz                        5.2.2                         1  
yaml                      0.1.6                         0  
zlib                      1.2.8                         3  

Description of expected behavior and the observed behavior

Clone and build this with make html. We should get a simple sphinx doc with a simple bokeh plot. As I note in the index.rst, I grabbed the bokeh plot code directly from the docs in bokeh/sphinxext/bokeh_plot.py.

Complete, minimal, self-contained example code that reproduces the issue

https://github.com/davclark/simple-bokeh-sphinx/tree/broken

Stack traceback and/or browser JavaScript console output

Trimmed error to console:

reading sources... [ 50%] conf                                                                        
Exception occurred:
  File "/Users/clarkda/miniconda3/envs/minimal/lib/python3.5/site-packages/bokeh/sphinxext/bokeh_plot.py", line 125, in _process_script
    js, script = autoload_static(d.roots[0], resources, script_path)
IndexError: list index out of range
The full traceback has been saved in /var/folders/longhashystring.log, if you want to report the issue to the developers.

I’ll put /var/folders/longhashystring.log in a subsequent note.

Screenshots or screencasts of the bug in action

Not relevant.

[bryevdv]

@davclark @cdeil @handwerkerd just a heads up that a PR #8665 to be merged for 1.1 makes the plot scripts always unconditionally be placed adjacent to the document they are for, and always loads them using relative URLs. The hacky options in #6223 are now no longer necessary, and will no longer have any effect (tho supplying them will not cause an error, until 2.0) I think this is a positive change that will allow bokeh-plot to always work without needing complicated extra configuration, and I don’t believe it will adversely affect any current usage (by the few folks that use bokeh-plot) but please reach out if any issues arise after 1.1. is released.

[bryevdv]

That said, focusing on your solution to this bug, I’m a sphinx amateur, but the conf.py file is necessary for sphinx and probably should never be parsed by Bokeh.

I certainly agree with this, and it was certainly not my intent to execute conf.py. In fact, the reason why conf.py is not considered when the Bokeh docs are run, is because it is explicitly excluded in our conf.py:

# List of patterns, relative to source directory, that match files and
# directories to ignore when looking for source files.
#
# NOTE: in these docs all .py script are assumed to be bokeh plot scripts
exclude_patterns = ['conf.py']

I do think the directive needs to be made more configurable and robust to support better general use, but if you add this to your conf.py that should get around the immediate problem.