bokeh.resources

resources模块提供了resources类,可以方便地配置BokehJS代码和CSS资源在Bokeh文档中的定位、加载和嵌入方式。

另外,用于检索 Subresource Integrity 这里提供了Bokeh JavaScript文件的哈希值。

一些预先配置的资源对象可用作属性。

CDN

从CDN加载小型BokehJS

INLINE

从库静态目录提供小型bokehj

class CSSResources(mode=None, version=None, root_dir=None, minified=None, legacy=None, log_level=None, root_url=None, path_versioner=None, components=None, base_dir=None)[源代码]

CSSResources类封装与加载或嵌入Bokeh客户端CSS有关的信息。

参数
  • mode (str) -- 关于如何在BOH中包含CSS输出的说明,请参见下面的说明

  • version (str, optional) -- 什么样的boh版本才有效 'cdn' 模式

  • root_dir (str, optional) -- 用于加载BokehJS资源的根目录仅对 'relative''relative-dev' 模式

  • minified (bool, optional) -- 是否应该缩小CSS(默认值:True)

  • root_url (str, optional) -- 从中加载资源的Bokeh服务器的URL和端口仅对 'server''server-dev' 模式

以下 mode 值可用于配置资源对象:

  • 'inline' 配置为以内联方式提供整个BokehJS代码和CSS

  • 'cdn' configure to load Bokeh CSS from https://cdn.bokeh.org

  • 'server' 配置为从Bokeh服务器加载

  • 'server-dev' 等同于 server 但支持非缩小的CSS

  • 'relative' 配置为相对于给定目录加载

  • 'relative-dev' 等同于 relative 但支持非缩小的CSS

  • 'absolute' 配置为从已安装的Bokeh库静态目录加载

  • 'absolute-dev' 等同于 absolute 但支持非缩小的CSS

配置后,资源对象将公开以下公共属性:

css_raw

任何需要放在里面的原始CSS <style> 标签

css_files

需要加载的任何CSS文件的url <link> 标签

messages

有关此配置的任何信息性消息

在嵌入Bokeh图时,这些属性通常用作模板参数。

class JSResources(mode=None, version=None, root_dir=None, minified=None, legacy=None, log_level=None, root_url=None, path_versioner=None, components=None, base_dir=None)[源代码]

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' 模式

以下 mode 值可用于配置资源对象:

  • 'inline' 配置为内联提供整个Bokeh JS和CSS

  • 'cdn' configure to load Bokeh JS and CSS from https://cdn.bokeh.org

  • 'server' 配置为从Bokeh服务器加载

  • 'server-dev' 等同于 server 但支持非小型资产

  • 'relative' 配置为相对于给定目录加载

  • 'relative-dev' 等同于 relative 但支持非小型资产

  • 'absolute' 配置为从已安装的Bokeh库静态目录加载

  • 'absolute-dev' 等同于 absolute 但支持非小型资产

配置后,资源对象将公开以下公共属性:

css_raw

任何需要放在里面的原始CSS <style> 标签

css_files

需要加载的任何CSS文件的url <link> 标签

messages

有关此配置的任何信息性消息

在嵌入Bokeh图时,这些属性通常用作模板参数。

class Resources(mode=None, version=None, root_dir=None, minified=None, legacy=None, log_level=None, root_url=None, path_versioner=None, components=None, base_dir=None)[源代码]

并封装与加载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)

  • root_url (str, optional) -- 从中加载资源的Bokeh服务器的URL和端口仅对 'server''server-dev' 模式

以下 mode 值可用于配置资源对象:

  • 'inline' 配置为内联提供整个Bokeh JS和CSS

  • 'cdn' configure to load Bokeh JS and CSS from https://cdn.bokeh.org

  • 'server' 配置为从Bokeh服务器加载

  • 'server-dev' 等同于 server 但支持非小型资产

  • 'relative' 配置为相对于给定目录加载

  • 'relative-dev' 等同于 relative 但支持非小型资产

  • 'absolute' 配置为从已安装的Bokeh库静态目录加载

  • 'absolute-dev' 等同于 absolute 但支持非小型资产

配置后,资源对象将公开以下公共属性:

js_raw

任何需要放在里面的原始JS <script> 标签

css_raw

任何需要放在里面的原始CSS <style> 标签

js_files

需要加载的任何JS文件的URL <script> 标签

css_files

需要加载的任何CSS文件的url <link> 标签

messages

有关此配置的任何信息性消息

在嵌入Bokeh图时,这些属性通常用作模板参数。

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(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 -- 如果有丢失、多余或不匹配的文件