0.12.5 (March 2017)¶
0.12.5 is an incremental update that adds a few important
features and fixes several bugs. Some of the highlights include:
- New general capability for Python/JS events (#3210, #3748, #5278)
- Bokeh apps easily viewable inline in Jupyter Notebooks (#3461)
--hostparameter no longer necessary (#5692)
- Interactive legends can now control glyph visibility (#2274, #3715)
- Many fixes and improvements to
GMapPlotincluding a new
gmapfunction for creating Google Maps plots easily (#2822, #2940, #3737, #4835, #5592, #5826, #5845)
CustomJSTransformnow available for CDS columns (#5015)
- Sophisticated “pivot” example app contributed (#5894)
- Themes now work with
componentsand in Jupyter notebooks (#4722, #4952, )
Many other bugfixes and docs additions are also included. For full details see the CHANGELOG.
NOTE: the 0.12.x series is the last planned release series before a version 1.0 release. The focus of the 1.0 release will be implementing build automation to enforce API stability, and a very small number of high value features. For more information see the project roadmap.
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 (#6092).
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 COMPATIBLITY 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
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 pull request 5978.
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.
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
removed, as well as the following properties of
Host Parameter Obsoleted¶
--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.
Document and Model Refactoring¶
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
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 pull request 5786.
JQuery and underscore.js removed from BokehJS¶
Both of these removals together result in a ~10% reduction in the size of the minified BokehJS library.
Default tooltip position for lines changed to nearest point¶
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.
HTTP Request information for apps limited to query arguments¶
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
--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
Default save file¶
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
For details see pull request 5942.
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
Reorganization of bokeh’s examples¶
Low-level examples, located under
examples/models, were split into
server examples and are available under
examples/models/server respectively (similarly to plotting examples).
Enabling WebGL via URL parameters disallowed¶
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