(機械翻訳) pyramid.paster
¶
-
bootstrap
(config_uri, request=None, options=None)[ソース]¶ `` config_uri``で指定されたPasteDeploy設定ファイルからWSGIアプリケーションをロードします。環境は、現在 ``要求 ''を提供しているかのように設定され、URLを生成しレンダラーを利用できるスクリプトを書くための自然環境が残っています。
この関数は、 `` app``、 `` root``、 `` closer``、 `` request``、および `` registry``キーで辞書を返します。 `` app``は( `` config_uri``に基づいて)ロードされたWSGIアプリケーションであり、 `` root``はPyramidアプリケーションのトラバーサルルートリソースであり、 `` close``は呼び出されるかもしれないパラメータのないコールバックですスクリプトが完了すると(スレッドローカルスタックがポップされます)。
注釈
app: `Pyramid`内のほとんどの操作は、WSGIリクエストのコンテキスト内で呼び出されることが予想されるため、アクティブなWSGIリクエスト中に通常は呼び出されないスクリプトやその他のコードを実行するときにアプリケーションをロードする際に重要です。
注釈
:app: Pyramid`アプリケーションを含む複雑な設定ファイルの場合、この関数はlast-loaded:app: Pyramid`アプリケーションのコンテキストで環境を設定します。下位レベルの関数:meth: pyramid.paster.get_app`と:meth: pyramid.scripting.prepare`を:attr: `pyramid.config.global_registries`とともに使用して、特定のアプリケーションを自分で読み込むことができます。
`` config_uri`` - 対話的なシェルに使うPasteDeploy設定ファイルを指定します。フォーマットは `` inifile#name``です。名前を省略すると、 `` main``が仮定されます。
`` request`` - 指定されたWSGIパラメータのセットにスクリプトをアンカーするために指定されます。たとえば、ほとんどの人は、ホスト、スキーム、およびポートを指定して、スクリプトがそれらのパラメータに関連してURLを生成するようにしたいとします。提供されていない場合は、デフォルトのパラメータを持つリクエストが生成されます。後でリクエストの `` environ``を変更して、特定のホスト/ポート/スキーム/ etcを設定することができます。
`` options`` {'http_port':8080}のような変数の代入としてget_appに渡され、次に設定ファイルで%(http_port)が使用されます。
この関数は、自動的に `` close``を呼び出すコンテキストマネージャとして使用できます:
with bootstrap('development.ini') as env: request = env['request'] # ...
この関数の使い方の詳細については、:ref: `writing_a_script`を参照してください。
バージョン 1.8 で変更: コンテクストマネージャーとして戻り値を使用する機能が追加されました。
-
get_app
(config_uri, name=None, options=None)[ソース]¶ `` config_uri``で指定されたPasteDeploy設定ファイルに `` name``という名前のWSGIアプリケーションを返します。
`` options``が渡された場合、 `` {'http_port':8080} ``のような変数の代入として使われる辞書でなければなりません。これは、例えば ``%(http_port)s``が設定ファイルで使われている場合に便利です。
`` name``がNoneの場合、 `` inifile#name``の形式を期待する `` config_uri``文字列の名前を解析しようとします。名前が見つからない場合、名前はデフォルトで"main "になります。
-
get_appsettings
(config_uri, name=None, options=None)[ソース]¶ `` config_uri``で表されるファイル内の `` app``セクションのキーと値のペアを表す辞書を返します。
`` options``が渡された場合、 `` {'http_port':8080} ``のような変数の代入として使われる辞書でなければなりません。これは、例えば ``%(http_port)s``が設定ファイルで使われている場合に便利です。
`` name``がNoneの場合、 `` inifile#name``の形式を期待する `` config_uri``文字列の名前を解析しようとします。名前が見つからない場合、名前はデフォルトで"main "になります。