resources模块提供了resources类,可以方便地配置BokehJS代码和CSS资源在Bokeh文档中的定位、加载和嵌入方式。
另外,用于检索 Subresource Integrity 这里提供了Bokeh JavaScript文件的哈希值。
一些预先配置的资源对象可用作属性。
CDN
从CDN加载小型BokehJS
INLINE
从库静态目录提供小型bokehj
CSSResources
CSSResources类封装与加载或嵌入Bokeh客户端CSS有关的信息。
mode (str) -- 关于如何在BOH中包含CSS输出的说明,请参见下面的说明
version (str, optional) -- 什么样的boh版本才有效 'cdn' 模式
'cdn'
root_dir (str, optional) -- 用于加载BokehJS资源的根目录仅对 'relative' 和 'relative-dev' 模式
'relative'
'relative-dev'
minified (bool, optional) -- 是否应该缩小CSS(默认值:True)
root_url (str, optional) -- 从中加载资源的Bokeh服务器的URL和端口仅对 'server' 和 'server-dev' 模式
'server'
'server-dev'
以下 mode 值可用于配置资源对象:
'inline' 配置为以内联方式提供整个BokehJS代码和CSS
'inline'
'cdn' configure to load Bokeh CSS from https://cdn.bokeh.org
https://cdn.bokeh.org
'server' 配置为从Bokeh服务器加载
'server-dev' 等同于 server 但支持非缩小的CSS
server
'relative' 配置为相对于给定目录加载
'relative-dev' 等同于 relative 但支持非缩小的CSS
relative
'absolute' 配置为从已安装的Bokeh库静态目录加载
'absolute'
'absolute-dev' 等同于 absolute 但支持非缩小的CSS
'absolute-dev'
absolute
配置后,资源对象将公开以下公共属性:
css_raw
任何需要放在里面的原始CSS <style> 标签
<style>
css_files
需要加载的任何CSS文件的url <link> 标签
<link>
messages
有关此配置的任何信息性消息
在嵌入Bokeh图时,这些属性通常用作模板参数。
JSResources
Resources类封装与加载或嵌入Bokeh Javascript相关的信息。
mode (str) -- Bokeh JS应该如何包含在输出中有关可用模式的说明,请参见下文
version (str, optional) -- 要加载的Bokeh JS的哪个版本只对 'cdn' 模式
root_dir (str, optional) -- 用于加载Bokeh JS资产的根目录仅对 'relative' 和 'relative-dev' 模式
minified (bool, optional) -- 是否应该缩小JavaScript(默认值:True)
root_url (str, optional) -- 从中加载资源的Bokeh服务器的URL和端口(默认值:None) None ,将生成基于默认服务器配置的绝对URL。 root_url 也可以是空字符串,在这种情况下是相对URL,例如“static/js”/bokeh.min.js公司,将生成。仅适用于 'server' 和 'server-dev' 模式
None
root_url
'inline' 配置为内联提供整个Bokeh JS和CSS
'cdn' configure to load Bokeh JS and CSS from https://cdn.bokeh.org
'server-dev' 等同于 server 但支持非小型资产
'relative-dev' 等同于 relative 但支持非小型资产
'absolute-dev' 等同于 absolute 但支持非小型资产
Resources
并封装与加载CSS或keh类相关的信息。
mode (str) -- 输出中应该如何包含Bokeh JS和CSS请参见下面关于可用模式的描述
version (str, optional) -- 什么版本的Bokeh JS和CSS只在 'cdn' 模式
root_dir (str, optional) -- 用于加载Bokeh JS和CSS资产的根目录仅对 'relative' 和 'relative-dev' 模式
minified (bool, optional) -- 是否应该缩小JavaScript和CSS(默认值:True)
js_raw
任何需要放在里面的原始JS <script> 标签
<script>
js_files
需要加载的任何JS文件的URL <script> 标签
get_all_sri_hashes
报告所有版本的BokehJS的SRI脚本哈希值。
Bokeh提供 Subresource Integrity 发布到CDN以获得完整版本的所有JavaScript文件的哈希。此函数返回一个字典,该字典将版本字符串映射到子字典,子字典将javascip文件名映射到它们的哈希值。
双关语
示例
返回的dict将把版本字符串映射到每个版本的子词典:
{ '1.4.0': { 'bokeh-1.4.0.js': 'vn/jmieHiN+ST+GOXzRU9AFfxsBp8gaJ/wvrzTQGpIKMsdIcyn6U1TYtvzjYztkN', 'bokeh-1.4.0.min.js': 'mdMpUZqu5U0cV1pLU9Ap/3jthtPth7yWSJTu1ayRgk95qqjLewIkjntQDQDQA5cZ', ... } '1.3.4': { ... } ... }
get_sri_hashes_for_version
报告特定版本的BokehJS的SRI脚本哈希值。
Bokeh提供 Subresource Integrity 发布到CDN以获得完整版本的所有JavaScript文件的哈希。对于Bokeh的单个版本,此函数返回一个字典,该字典将JavaScript文件名映射到它们的哈希值。
version (str) -- 返回SRI hashes的Bokeh版本。散列只提供给完整版本,例如“1.4.0”,而不是“dev”版本或候选版本。
KeyError -- 如果指定的版本不存在
返回的单个版本的dict将把该版本的文件名映射到它们的SRI哈希:
{ 'bokeh-1.4.0.js': 'vn/jmieHiN+ST+GOXzRU9AFfxsBp8gaJ/wvrzTQGpIKMsdIcyn6U1TYtvzjYztkN', 'bokeh-1.4.0.min.js': 'mdMpUZqu5U0cV1pLU9Ap/3jthtPth7yWSJTu1ayRgk95qqjLewIkjntQDQDQA5cZ', 'bokeh-api-1.4.0.js': 'Y3kNQHt7YjwAfKNIzkiQukIOeEGKzUU3mbSrraUl1KVfrlwQ3ZAMI1Xrw5o3Yg5V', 'bokeh-api-1.4.0.min.js': '4oAJrx+zOFjxu9XLFp84gefY8oIEr75nyVh2/SLnyzzg9wR+mXXEi+xyy/HzfBLM', 'bokeh-tables-1.4.0.js': 'I2iTMWMyfU/rzKXWJ2RHNGYfsXnyKQ3YjqQV2RvoJUJCyaGBrp0rZcWiTAwTc9t6', 'bokeh-tables-1.4.0.min.js': 'pj14Cq5ZSxsyqBh+pnL2wlBS3UX25Yz1gVxqWkFMCExcnkN3fl4mbOF8ZUKyh7yl', 'bokeh-widgets-1.4.0.js': 'scpWAebHEUz99AtveN4uJmVTHOKDmKWnzyYKdIhpXjrlvOwhIwEWUrvbIHqA0ke5', 'bokeh-widgets-1.4.0.min.js': 'xR3dSxvH5hoa9txuPVrD63jB1LpXhzFoo0ho62qWRSYZVdyZHGOchrJX57RwZz8l' }
verify_sri_hashes
在完整的发布包中验证SRI哈希值。
此函数用于比较完整版本包中BokehJS文件的SRI哈希值与SRI清单文件中的值。如果所有哈希匹配,则返回None,否则将引发异常。
注解
此函数只能在完全版本(例如“1.2.3”)包上调用。
没有
ValueError -- 如果在完整的发布包之外调用
RuntimeError -- 如果有丢失、多余或不匹配的文件