Bokeh 1.0.0 里程碑回顾从发布说明到当前仓库源码的九大特性实证【免费下载链接】bokehInteractive Data Visualization in the browser, from Python项目地址: https://gitcode.com/GitHub_Trending/bo/bokehBokeh 1.0.0 于 2018 年 10 月发布是该项目从 0.x 系列走向稳定主版本的关键里程碑。本文以官方发布说明 1.0.0.rst 为骨架逐条解读其中列出的九项核心亮点并结合当前仓库中的源码实现glyph、工具栏、数据源、导出管线等验证这些特性至今的存在形态与参数细节帮助读者把一份发布说明变成一份可查证、可实操的特性清单。版本定位为什么说 1.0.0 是major milestone发布说明原文对 1.0.0 的定性只有一句话Bokeh Version1.0.0(October 2018) is a major milestone of the Bokeh project.随后列出了九项 highlights。在 Bokeh 的版本体系中1.0.0 意味着项目第一次承诺公共 API 的稳定性基线——此前 0.x 版本迭代中 API 可以更激进地变动而 1.0 之后的破坏性变更需要有明确的弃用周期。这一点对使用 Bokeh 构建生产级数据看板的用户很关键发布说明中每一项新特性Scatterglyph、CustomAction工具、AjaxDataSource适配回调等都从此成为可长期依赖的稳定接口。需要注意的适用前提当前仓库是一个持续演进的 Bokeh 主干版本由 git 标签动态生成见 pyproject.toml 中dynamic [version]与[tool.setuptools-git-versioning]配置运行时由 src/bokeh/init.py 中__version__ importlib_metadata.version(bokeh)读取。因此下文所有源码证据反映的是1.0.0 引入的特性在当前代码库中的存活状态而非 1.0.0 发布当日的代码。图形能力MultiPolygons 支持带孔多边形发布说明第一项Support for MultiPolygons with holes对应上游 issue 2321。这是 Bokeh 对齐 GeoJSON 多边形语义的图形能力一个 MultiPolygon 可以包含多个 Polygon每个 Polygon 由一个外环加若干内环孔洞组成。当前仓库中该 glyph 位于 src/bokeh/models/glyphs.pyMultiPolygons类继承Glyph、LineGlyph、FillGlyph、HatchGlyph说明它同时支持描边、填充和纹理hatch视觉属性三类 propsxs/ys以嵌套列表形式给坐标文档字符串明确写道 Each MultiPolygon is comprised ofnPolygons. Each Polygon is made of one exterior ring optionally followed byminterior rings (holes)——即列表的列表的列表的列表四层嵌套结构line_props、fill_props、hatch_props分别包含线型、填充、纹理相关的视觉参数。另外源码文档还记录了一个交互细节During box selection only multi-polygons entirely contained in the selection box will be included框选时只有完全包含在选区内的多边形才被选中这对做地理数据交互选中的开发者是可验证的行为事实。配套示例可直接查看 examples/basic/areas/multipolygon_with_holes.py 和 examples/basic/areas/multipolygon_with_separate_parts.py。图形能力Scatter glyph 支持参数化标记类型发布说明中的Scatter glyph for parameterizable marker typeissue 5884解决了此前画不同形状标记要选不同 glyph 类的问题。当前实现见 src/bokeh/models/glyphs.pyScatter继承自Markermarker属性为MarkerSpec默认circle可选的内置标记覆盖MarkerType枚举的全部取值asterisk、circle、circle_cross、circle_dot、circle_x、circle_y、cross、dash、diamond、diamond_cross、diamond_dot、dot、hex、hex_dot、inverted_triangle、plus、square、square_cross、square_dot、square_pin、square_x、star、star_dot、triangle、triangle_dot、triangle_pin、x、y使用方式有两种要么对全部点指定同一种标记markersquare要么把数据列名赋给marker如markermarkers由数据源中每一行的字符串决定该行画什么形状1.0.0 时代还不存在的扩展defs属性Dict(Regex(^.*$), Instance(CustomJS))允许用prefix.markername语法定义完全自定义的标记渲染回调。两个文档中明确记录的边界条件值得注意用Scatter画circle时size只能是屏幕像素单位若需要数据坐标下的半径应改用Circleglyph另外多标记类型在 WebGL 后端下的绘制顺序可能不同这是官方声明的性能取舍。参考示例examples/basic/scatters/markertypes.py 与 API 参考模型 examples/reference/models/Scatter.py。交互能力CustomAction 自定义工具栏按钮发布说明的CustomAction for user-defined Toolbar buttonsissue 8099让用户能在工具栏放置任意图标并绑定自定义 JS 回调。当前实现位于 src/bokeh/models/tools.py类文档给出了最小用法tool CustomAction(iconicon.png, callbackCustomJS(codealert(foo))) plot.add_tools(tool)从源码结构看CustomAction(ActionTool)的关键属性有三个属性类型作用callbackNullable(Instance(Callback))点击图标时执行的回调通常CustomJS可返回布尔值表示工具状态active_callbackNullable(Either(Instance(Callback), Auto))建立工具状态的回调必须返回布尔值填auto则每次点击切换状态初始状态由active决定源码标注该属性为实验性experimentalactive/disabledBool工具当前是否处于激活态 / 是否禁止交互完整的可运行示例见 examples/advanced/extensions/tool.py。交互能力工具栏 autohide 属性Toolbar autohide property to hide toolbars when not in useissue 8284对应Toolbar模型上的autohide布尔属性。当前定义在 src/bokeh/models/tools.pyautohide Bool(defaultFalse, help Whether the toolbar will be hidden by default. Default: False. If True, hides toolbar when cursor is not in canvas. )即默认关闭设为True后工具栏仅在鼠标悬停画布区域时显示。在布局层面ToolbarOptions也把autohide列为可配置项之一src/bokeh/layouts.pytype ToolbarOptions Literal[logo, autohide, active_drag, active_inspect, active_scroll, active_tap, active_multi]且在合并多个工具栏时会做唯一性断言src/bokeh/layouts.pyassert_unique(autohides, autohide)。相关示例examples/interaction/tools/toolbar_autohide.py 和 examples/plotting/toolbar_autohide.py。数据能力AjaxDataSource 的响应适配回调发布说明提到Callback to allow AjaxDataSource to adapt JSON responsesissue 8321。AjaxDataSource位于 src/bokeh/models/sources.py文档明确了它的标准数据契约REST API 的响应应当匹配ColumnDataSource.data的形态即列名到值数组的 JSON 字典{ x : [1, 2, 3, ...], y : [9, 3, 2, ...] }当你的 REST 接口返回别的格式时1.0.0 引入的适配回调父类WebDataSource上的adapter属性见 src/bokeh/models/sources.py接受一个CustomJS实例把任意 REST 响应转换成 Bokeh 需要的{column: [values]}结构——这正是让AjaxDataSource适配 JSON 响应这一亮点的落地方式。类文档同时强调若配合FactorRange使用即使列为空也必须显式设置data初始值。完整示例examples/basic/data/ajax_source.py。输出能力Plain JSON 导出/嵌入函数Plain JSON export/embed functionsissue 5231让把文档序列化为纯 JSON变成独立于 HTML 的一等公民 API为下游工具如静态站点、自定义 loader提供了不依赖完整页面的数据通道。当前仓库中这条链路体现在 src/bokeh/io/ 模块saving.py、doc.py、state.py等文件构成保存/文档序列化的实现协议层则由 src/bokeh/protocol/ 负责 JSON 编解码bokeh json命令入口src/bokeh/command/即基于这套设施。输出能力复用 web 驱动加速 PNG/SVG 导出Reuse webdrivers for faster PNG/SVG export by defaultissue 8329是纯性能优化之前每次export_png/export_svg都冷启动一个无头浏览器1.0.0 起默认复用已启动的驱动实例。当前仓库中该优化仍然成立证据在 src/bokeh/io/webdriver.py模块维护了一个webdriver_control单例池_screenshot_to_png之类的内部函数默认走webdriver_control.get(...)拿复用的驱动只有调用方显式传入driver参数时才使用外部实例如 src/bokeh/io/webdriver.py 的web_driver driver if driver is not None else webdriver_control.get()驱动类型由type DriverKind Literal[firefox, chromium]限定。导出入口见 src/bokeh/io/export.py用户示例见 examples/output/export/export_to_png.py 和 examples/output/export/export_to_svg.py。工程能力测试体系与导入速度发布说明的后两项属于项目工程基础Improved testing capabilitiesissues 2596/8078/8139/8146/8217/8225这一轮测试基建的很多成果至今仍是仓库的测试主骨架。Python 侧tests/ 下按unit、integration、cross、codebase分层组织另有 tests/conftest.py 提供共享夹具JS 侧bokehjs/test/ 下有自研的framework/、integration/、unit/目录与 1300 余张视觉回归基线bokehjs/test/baselines/linux/配合 bokehjs/test/devtools/ 中的 Chromium DevTools 协议工具链做浏览器内截图比对。Faster import timesissue 8309bokeh包的导入路径当时做了重构。可以推断这项优化在当前仓库中延续为对导入图的持续约束——例如 tests/unit/ 与代码库测试 tests/codebase/ 对模块依赖方向有检查防止重新引入重量级循环导入。发布说明中的全部条目对照表为便于检索核对发布说明 docs/bokeh/source/docs/releases/1.0.0.rst 列出的九项 highlights 与本文各节及当前仓库证据的对应关系如下发布说明条目上游 issue当前仓库证据MultiPolygons 带孔支持2321src/bokeh/models/glyphs.py、examples/basic/areas/multipolygon_with_holes.pyDataTable 修复与改进6 个 issue6454/7116/7417/8021/8040/8050/8201examples/interaction/widgets/data_table.py 等示例持续覆盖该组件CustomAction 自定义工具栏按钮8099src/bokeh/models/tools.pyPlain JSON 导出/嵌入函数5231src/bokeh/io/、src/bokeh/protocol/Toolbar autohide8284src/bokeh/models/tools.pyAjaxDataSource 响应适配回调8321src/bokeh/models/sources.pyScatter 参数化标记 glyph5884src/bokeh/models/glyphs.py复用 webdrivers 加速导出8329src/bokeh/io/webdriver.py测试能力与导入速度改进2596/8078/8139/8146/8217/8225、8309tests/、bokehjs/test/、src/bokeh/init.py结语1.0.0 的发布说明虽然篇幅不长但它划定了 Bokeh 稳定 API 的起点图形层拿到了MultiPolygons带孔语义与Scatter参数化标记交互层拿到了CustomAction与autohide数据层拿到了可适配任意 REST 响应的AjaxDataSource输出层拿到了纯 JSON 通道与更快的无头导出。上述每一项都可以在当前仓库中找到对应源码与示例这也解释了为什么里程碑版本对评估一个数据可视化库的长期可用性具有重要参考价值。【免费下载链接】bokehInteractive Data Visualization in the browser, from Python项目地址: https://gitcode.com/GitHub_Trending/bo/bokeh创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
