0.12.5 (Mar 2017) is an incremental update that adds a few important features and fixes several bugs. Some of the highlights include:
--hostparameter no longer necessary (
GMapPlotincluding a new
gmapfunction for creating Google Maps plots easily (
CustomJSTransformnow available for CDS columns (
componentsand in Jupyter notebooks (
Many other bugfixes and docs additions are also included. For full details see the
The ClientSession APIs defined in bokeh.client.session, such as push_session, don't currently support the new on_event interface for UI event callbacks in Bokeh Server application. You may track the issue on GitHub (
As the project approaches a 1.0 release, it is necessary to make some changes to bring interfaces and functionality up to a point that can be maintained long-term. We try to limit such changes as much as possible, and have a period of deprecation.
MPL COMPATIBILITY IS DEPRECATED
Bokeh's MPL compatibility was implemented using a third-party library that only exposes a small fraction of all Matplotlib functionality, and is now no longer being actively maintained. The Bokeh team unfortunately does not have the resources to continue supporting this functionality, which was never more than extremely limited in capability, and often produced substandard results. Accordingly, in order to support the long term health of the project, it has been decided to remove all MPL compatibility support on the occasion of a 1.0 release. Any code that currently uses
to_bokeh will continue to work with a deprecation warning until that time.
bokeh.embed.standalone_html_page_for_models method has been deprecated in place of
bokeh.embed.file_html. For details see
validate keyword argument to
bokeh.io.save has been deprecated. Future usage of
bokeh.io.save will always validate the document before outputting a file.
All previous deprecations up to
0.12.0 have be removed. Below is the complete list of removals.
Modules and functions and classes that have been removed:
|Functions Removed||Modules Removed||Classes Removed|
ColumnDataSource have been removed.
bokeh.io.output_server function has been also been removed. Additionally,
bokeh.io.push and other supporting functions or properties that are useless without
output_server have been removed. This includes any transitive imports of these functions from other modules.
Additionally, the property
bokeh.charts.builder.Builder.sort_legend was removed, as well as the following properties of
--host parameter is now unnecessary. For compatibility, supplying it will currently cause a warning to be displayed, but it will otherwise be ignored, and apps will run as normal. In a future release, supplying it will result in an error.
--host parameter for the Bokeh server was confusing and difficult to explain. As long as the Bokeh server relied on the HTTP "host" header to provide URLs to resources, the
--host parameter was a necessary precaution against certain kinds of HTTP spoofing attacks. However, the Bokeh server has been updated to no longer require the use of the "host" header (and this is maintained under test). Accordingly, there is no need to have any check on the value of the "host" header, and so
--host is no longer needed.
In order that
models.py only contain things that might be of usual interest to users, some changes and rearrangements were made.
abstract class decorator was moved from
has_props.py. The class decorator now also adds an admonition to the docstring of any class marked abstract that it is not useful to instantiate directly.
Viewable has been renamed to
document.py module has been split up, and parts that would not be of normal interest to most users have been moved to better locations.
These changes are not expected to impact user code in any way. For complete details see
Both of these removals together result in a ~10% reduction in the size of the minified BokehJS library.
When showing tooltips for lines, the new default is to label the nearest point, instead of the previous point, which used to be the default.
request previously attribute was added to session contexts as a way to expose HTTP query parameters. It was discovered that providing the entire request is not compatible with the usage of
--num-procs. A method was found to satisfy the original feature request for query arguments, together with
--num-procs (but only for query arguments). Accordingly the only attribute that can now be accessed on
Attempting to access any other attribute on
request will result in an error.
If user-specified or default destination cannot be written to, a temporary file is generated instead. This mostly affects using
output_file in an interactive session which formerly could result in a
PermissionError. For details see
bokeh.io.save method will now only accept a
LayoutDOM object and no longer a
Document object for its
obj argument. This aligns the
bokeh.io.save argument types with
Low-level examples, located under
examples/models, were split into
server examples and are available under
examples/models/server respectively (similarly to plotting examples).
Previously it was possible to enable WebGL with
?webgl=1 URL parameter. With addition of a separate
bokeh-gl bundle, this usage is no longer supportable. WebGL rendering is still configurable using the