bokeh.settings

環境変数を用いてグローバル構成オプションを制御します。Bokehの他の部分は、参照可能なグローバル設定オブジェクトです。

定義的設定

上で設定にアクセスすることができます bokeh.settings.settings インスタンスは，アクセプタ方法によって.例：

settings.minified()

Bokehは、以下の定義の設定を提供します。

allowed_ws_origin

Type

明細書. [ひも.]

環境変数

BOKEH_ALLOW_WS_ORIGIN

Default

[]

デバイスのデフォルト値

(未設定)

Bokehサーバアプリケーションによって許可されているWebSocketソースのコンマ分割リスト。

auth_module

Type

ひも.

環境変数

BOKEH_AUTH_MODULE

Default

なし

デバイスのデフォルト値

(未設定)

Bokehサーバのためのユーザ認証機能を実現するPythonモジュールのパス。

警告

このモジュールの内容を実行します！

browser

Type

ひも.

環境変数

BOKEH_BROWSER

Default

なし

デバイスのデフォルト値

“なし”

Bokehは、文書を表示するためのデフォルトブラウザです。

有効値は、python標準ライブラリが理解できる任意のブラウザ名です。 webbrowser モジュールです。

version

Type

ひも.

環境変数

BOKEH_CDN_VERSION

Default

なし

デバイスのデフォルト値

(未設定)

CDN資源はどのバージョンのBokehJSを使用するか.

ご参照ください Resources 完全な詳細については、クラス参照を参照されたい。

docs_cdn

Type

ひも.

環境変数

BOKEH_DOCS_CDN

Default

なし

デバイスのデフォルト値

(未設定)

文書を構築する際にはCDN資源のBokehJSバージョンをロードする必要がある.

ローカルに構築されたBokehJSを用いて文書を構築·表示するには、ご利用ください local それがそうです。例：

BOKEH_DOCS_CDN=local make clean serve

ローカルに構築されたBokehJSを使用して文書の最新コピーを構築し、新しいブラウザオプションカードを開いて表示します。

そうでなければ、この値はCDNのバージョンとして解釈されるであろう。例：

BOKEH_DOCS_CDN=1.4.0rc1 make clean

BokehJSバージョンを使用したドキュメントを構築します 1.4.0rc1 シーディーエヌからです。

docs_version

Type

ひも.

環境変数

BOKEH_DOCS_VERSION

Default

なし

デバイスのデフォルト値

(未設定)

文書を構築する際に規定されるBokehバージョン.

新しい修復または再展開ドキュメントの既存バージョンを変更するためには、この設定が必要です。

ignore_filename

Type

ブール.

環境変数

BOKEH_IGNORE_FILENAME

Default

エラー

デバイスのデフォルト値

(未設定)

Bokehコンテンツを保存する際に現在のスクリプトファイル名を無視するかどうか.

log_level

Type

ひも.

環境変数

BOKEH_LOG_LEVEL

Default

‘情報’

デバイスのデフォルト値

“デバッグ”

JavaScript BokehJSコードのログレベルを設定します。

有効値は、重症度が増加する順に、

  • trace

  • debug

  • info

  • warn

  • error

  • fatal

minified

Type

ブール.

環境変数

BOKEH_MINIFIED

Default

本当です。

デバイスのデフォルト値

エラー

Bokehは縮小されたBoehJSリソースを使用すべきかどうか.

legacy

Type

ブール.

環境変数

BOKEH_LEGACY

Default

エラー

デバイスのデフォルト値

エラー

Bokehは、古いバージョン(IEとPantomjs互換性)BokehJSリソースを使用すべきかどうか。

nodejs_path

Type

ひも.

環境変数

BOKEH_NODEJS_PATH

Default

なし

デバイスのデフォルト値

(未設定)

ノードはファイルのパスを実行可能である.

NodeJSは，PNGとSVG導出およびカスタム拡張のコンパイルに必要なオプション依存項である.Bokehは、インストールされたノード実行可能ファイルの自動位置決めを試みます。この環境変数を用いてBokehが見つけた位置を上書きするか，非標準位置を指す.

validate_doc

Type

ブール.

環境変数

BOKEH_VALIDATE_DOC

Default

本当です。

デバイスのデフォルト値

(未設定)

Bokehが文書に対して検証検査を実行すべきかどうか.

この値をFalseに設定するとやや性能が向上する可能性がある.

pretty

Type

ひも.

環境変数

BOKEH_PRETTY

Default

エラー

デバイスのデフォルト値

本当です。

JSON文字列をきれいに印刷すべきかどうか。

py_log_level

Type

ログレベル

環境変数

BOKEH_PY_LOG_LEVEL

Default

“なし”

デバイスのデフォルト値

“デバッグ”

Python Bokehコードのログレベルです。

有効値は、重症度が増加する順に、

  • trace

  • debug

  • info

  • warn

  • error

  • fatal

  • none

resources

Type

ひも.

環境変数

BOKEH_RESOURCES

Default

“cdn”

デバイスのデフォルト値

‘Absolute-dev’

どのようなBokehJSリソースを構成するか、例えば inline あるいは…。 cdn

ご参照ください Resources 完全な詳細については、クラス参照を参照されたい。

rootdir

Type

ひも.

環境変数

BOKEH_ROOTDIR

Default

なし

デバイスのデフォルト値

(未設定)

一緒に使うルートカタログ relative 資源

ご参照ください Resources 完全な詳細については、クラス参照を参照されたい。

secret_key

Type

ひも.

環境変数

BOKEH_SECRET_KEY

Default

なし

デバイスのデフォルト値

(未設定)

Bokehは独自の暗号化ランダム長暗号を導入している.

sign_sessions

Type

ひも.

環境変数

BOKEH_SIGN_SESSIONS

Default

エラー

デバイスのデフォルト値

(未設定)

Boehサーバは鍵署名のセッションのみを許可すべきであるかどうか.

Trueなら BOKEH_SECRET_KEY また設定しなければなりません。

simple_ids

Type

ブール.

環境変数

BOKEH_SIMPLE_IDS

Default

本当です。

デバイスのデフォルト値

(未設定)

BokehはモデルIDとして簡単な整数を使用すべきかどうか(1000から)である.

Falseであれば，Bokehはオブジェクト識別子としてUUIDを用いる.たとえば，複数のプロセスが単一のBokeh文書に貢献している場合には，そうする必要がある可能性がある.

ssl_certfile

Type

ひも.

環境変数

BOKEH_SSL_CERTFILE

Default

なし

デバイスのデフォルト値

(未設定)

SSLで終了した証明書ファイルのパス.

ssl_keyfile

Type

ひも.

環境変数

BOKEH_SSL_KEYFILE

Default

なし

デバイスのデフォルト値

(未設定)

SSL終了のための秘密鍵ファイルのパス。

ssl_password

Type

ひも.

環境変数

BOKEH_SSL_PASSWORD

Default

なし

デバイスのデフォルト値

(未設定)

SSL鍵ファイルを復号するための暗号(必要に応じて)。

strict

Type

ブール.

環境変数

BOKEH_STRICT

Default

(未設定)

デバイスのデフォルト値

(未設定)

チェックが厳しいべきかどうか(すなわちエラーを引き起こす)かどうかを検証する.

xsrf_cookies

Type

ブール.

環境変数

BOKEH_XSRF_COOKIES

Default

エラー

デバイスのデフォルト値

(未設定)

TokehサーバでTornado XSRF Cookie保護を有効にするかどうか。これは，認証モジュールやカスタムハンドラも使用する場合にのみ適用される.見

Https：//www.tornadoweb.org/en/Stability/Guide/security.html#サイト間の偽造保護要求

竜巻でのXSRF保護に関するより多くの情報。この設定がアクティブ状態にある場合には，すべてのPUT，POST，DELETEハンドラを適切に検出する必要がある.

優先順位.

設定値は常に以下の所定の順序で探索される。

即時提供値

以下に設定に渡す値を示す.

settings.minified(minified_val)

もし minified_val NONEでなければそのまま返す.そうでなければ，渡されていなければ，値を下に探索し続ける探索順序を設定する.これは，デフォルトの場合に無となるオプション関数パラメータを渡すために非常に有用である.パラメータを関数に渡すと，それが優先される.

以前ユーザが設定した値

この値がコードに明示的に設定されている場合：

settings.minified = False

この値は他のソースよりも優先される.アプリケーションは、この機能を使用して、環境変数よりも優先するように、コマンドライン上で提供される値を設定することができる。

ユーザが指定した構成オーバーレイファイル

明示的にロードされたYAMLプロファイルの値：

settings.load_config("/path/to/bokeh.yaml)

どのような値でも bokeh.yaml 次のソースより優先する.アプリケーションは、このようなファイルをロードするためのコマンドラインパラメータを提供することができる。例： bokeh serve --use-config myconf.yaml

環境変数

関連する環境変数で見つかった値：

BOKEH_MINIFIED=no bokeh serve app.py
ローカルユーザプロファイル

Bokehは、現在のユーザのホームディレクトリでYAMLプロファイルを検索します。 ${{HOME}}/.bokeh/bokeh.yaml それがそうです。

グローバル·システム構成(実施されていない)

将来のサポート計画は、グローバル·システム構成からBokeh設定をロードします。

ローカルデフォルト設定

以下は、アクセス設定時に定義されるデフォルト値です。

settings.resources(default="server")

ローカルデフォルト値の優先度は、グローバルデフォルト値以外のすべての設定機構よりも低い。

グローバルデフォルト値

これらは設定宣言によって定義されるデフォルト値である.それらの優先度は他のどんな設定機構よりも低い。

これらのすべての位置を探索した後に何の値も得られなければ，RuntimeErrorが開始される.

API

いくつかの方法があります settings 目標：

class Settings[ソース]
bokehjsdir()[ソース]

BokehJS源木の位置。

css_files()[ソース]

BokehJSディレクトリのCSSファイル。

js_files()[ソース]

BokehJSディレクトリ中のJSファイル。

load_config(location)[ソース]

ユーザが指定したオーバーレイ構成ファイルをロードします。

このファイルはYAML形式であり、含まれているものとする key: value せりふ。

secret_key_bytes() → Optional[bytes][ソース]

SECRET_KEYを返し，バイトに変換してキャッシュする.