bokeh.resources

Resourcesモジュールは,BokehJSコードとCSS資源のBokeh文書における位置付け,ロード,埋め込み方式を容易に構成するためのResourcesクラスを提供する.

また,検索に用いる Subresource Integrity ここではBokeh JavaScriptファイルのハッシュを提供する.

いくつかの予め構成されたリソースオブジェクトは、属性として使用することができる。

CDN

CDNからダウンサイジングされたBoehJSをロードする

INLINE

ライブラリ静的ディレクトリから簡素化されたBokehJSを提供

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) -- Bokeh CSSが出力にどのように含まれるか利用可能なモードに関する説明は、以下を参照されたい

  • version (str, optional) -- Bokeh CSSはどのバージョンをロードしていますか '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 デフォルトサーバに基づいて構成された絶対URLが生成されます。 root_url 空文字列であってもよく、この場合、相対URL、例えば“static/js/boke.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)[ソース]

Resourcesクラスは,Bokeh JavascriptやCSSのロードや埋め込みに関する情報を実装している.

パラメータ
  • 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 完全なバージョンのすべてのJavaScriptファイルのハッシュを取得するためにCDNに配布されます。この関数は、バージョン文字列をJavaSciptファイル名がそのハッシュに対応するサブ辞書にマッピングする辞書を返す。

戻り値

ディクト!

例を引く

返された辞書は、バージョン文字列を各バージョンのサブ辞書にマッピングします:

{
    '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 完全なバージョンのすべてのJavaScriptファイルのハッシュを取得するためにCDNに配布されます。単一バージョンのBokehに対して,この関数はJavaScriptファイル名をそのハッシュにマッピングした辞書を返す.

パラメータ

version (str) -- SRIハッシュのBokehバージョンを返す.ハッシュは、“dev”バージョンまたは候補バージョンのために提供されるのではなく、“1.4.0”のような完全なバージョンのためにのみ提供される。

戻り値

ディクト!

例外

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 -- 紛失、冗長、または一致しない文書が存在する場合