Resourcesモジュールは,BokehJSコードとCSS資源のBokeh文書における位置付け,ロード,埋め込み方式を容易に構成するためのResourcesクラスを提供する.
また,検索に用いる Subresource Integrity ここではBokeh JavaScriptファイルのハッシュを提供する.
いくつかの予め構成されたリソースオブジェクトは、属性として使用することができる。
CDN
CDNからダウンサイジングされたBoehJSをロードする
INLINE
ライブラリ静的ディレクトリから簡素化されたBokehJSを提供
CSSResources
CSSResourcesクラスパッケージは,BokehクライアントCSSに関する情報をロードまたは埋め込む.
mode (str) -- Bokeh CSSが出力にどのように含まれるか利用可能なモードに関する説明は、以下を参照されたい
version (str, optional) -- Bokeh CSSはどのバージョンをロードしていますか '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 デフォルトサーバに基づいて構成された絶対URLが生成されます。 root_url 空文字列であってもよく、この場合、相対URL、例えば“static/js/boke.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
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)
js_raw
内部に入れなければならないどんな原始的なJSも必要です <script> ラベル
<script>
js_files
ロードが必要なJSファイルのURL <script> ラベル
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
特定のバージョン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 -- 紛失、冗長、または一致しない文書が存在する場合