bokeh icon indicating copy to clipboard operation
bokeh copied to clipboard

Be more careful with mutated sample data in docs examples

Open bryevdv opened this issue 4 years ago • 0 comments

Currently, the :bokeh-plot: sphinx directive runs all examples in a given docs build run in a single process. If the examples modify mutable data sources from bokeh.sampledata this can cause subtle and order-dependent build failures. (ref: https://github.com/bokeh/bokeh/pull/11599) There are a couple of possible ways to mitigate this:

  • always return a copy from bokeh.sampledata e.g. perhaps with a module-getattr
  • run docs example code in separate subprocesses

Or possibly both.

bryevdv avatar Sep 13 '21 22:09 bryevdv