(機械翻訳) pyramid.static

class static_view(root_dir, cache_max_age=3600, package_name=None, use_subpath=False, index='index.html')

このクラスのインスタンスは：app： Pyramid：term：` view callable`のように動作する呼び出し可能オブジェクトです。このビューは、コンストラクタに提供する `` root_dir``に基づいてディスク上のディレクトリから静的ファイルを提供します。

ディレクトリには、サブディレクトリが含まれている可能性があります（再帰的に）。静的ビュー実装は、パスを応答に解決するためにURLのコンポーネントに基づいて必要に応じてこれらのディレクトリに降下します。

絶対ファイルシステムパスまたは相対ファイルシステムパス、あるいは：class：constructorへの `` root_dir``引数として静的ファイルを含むディレクトリを表す：term： `asset specification`を渡すことができます。

`` root_dir``パスが相対パスで、 `` package_name``引数が `` None``の場合、 `` root_dir``は静的ファイルを呼び出すPythonファイル``が存在します。 `` package_name``引数が指定され、 `` root_dir``が提供されている場合、 `` root_dir``は `` package_name``で指定されたPython：term： `package`に相対的に考慮されます。 Pythonパッケージへの点線のパス）。

`` cache_max_age``はビューによって返される `` Expires``と `` Max-Age``レスポンスヘッダに影響を与えます（デフォルトは3600秒か1時間です）。

`` use_subpath``は、実際に静的ファイルを提供する基盤となるWSGIアプリケーションを呼び出すときに、 `` `` `` 要求パス ``が `` PATH_INFO``として使われるかどうかに影響します。 `` True``の場合、静的アプリケーションは `` request.subpath``を `` PATH_INFO``入力とみなします。 `` False``の場合、静的アプリケーションはrequest.environ [ PATH_INFO``]を `` PATH_INFO``入力と見なします。デフォルトでは、これは `` False``です。

注釈

`` root_dir``がa：term： package`に相対的であるか、または：term： asset specification`：app： Pyramid：class：` pyramid.config.Configurator`メソッドを使用して、名前が付けられた `` root_dir``パッケージ相対ディレクトリ内のアセットをオーバーライドします。ただし、 `` root_dir``が絶対的なものであれば、設定はそこに含まれるアセットを上書きすることができません。

class ManifestCacheBuster(manifest_spec, reload=False)

：class： `〜pyramid.interfaces.ICacheBuster`の実装で、指定されたマニフェストファイルを使用してアセットパスをパスのキャッシュで破棄されたバージョンにマッピングします。

`` manifest_spec``はパッケージ相対ファイルを指し示す絶対パスかa：term： `asset specification 'です。

マニフェストファイルは、次の単純なJSON形式に準拠する必要があります。

{
    "css/main.css": "css/main-678b7c80.css",
    "images/background.png": "images/background-a8169106.png",
}

デフォルトでは、キーは、：meth： `〜pyramid.request.Request.static_url`への呼び出しで使用されるソースアセットパスであるJSON連載辞書です。例えば：

>>> request.static_url('myapp:static/css/main.css')
"http://www.example.com/static/css/main-678b7c80.css"

ファイル形式と場所は、meth： `.parse_manifest`のサブクラス化とオーバーライドによって変更できます。

マニフェストにパスが見つからない場合は、パスは変更されません。

`` reload``が `` True``の場合、マニフェストファイルは変更時に再ロードされます。本稼働環境でこれを有効のままにすることはお勧めしません。

マニフェストファイルがディスク上に見つからない場合、 `` reload``が `` False``でない限り、空のマッピングとして扱われます。

バージョン 1.6 で追加.

static exists(path)

パスが存在するかどうかをテストします。壊れたシンボリックリンクに対してFalseを返します。

static getmtime(filename)

os.stat（）によって報告されたファイルの最終更新時刻を返します。

manifest

現在のマニフェスト辞書。

parse_manifest(content)

`` manifest_path``から読み込んだ `` content``を辞書マッピングに解析します。

サブクラスは、このメソッドをオーバーライドして、 `` json.loads``以外の形式を使用して任意のタイプのファイル形式をロードし、適合する辞書を返すことができます。

class QueryStringCacheBuster(param='x')

：class： `〜pyramid.interfaces.ICacheBuster`の実装で、アセットURLのクエリ文字列にキャッシュ破棄用のトークンを追加します。

オプションの `` param``引数は、クエリ文字列に追加されるパラメータの名前を決定し、デフォルトは `` x'``です。

このクラスを使用するには、サブクラス化し、 `` request、pathspec、kw``を受け取り、トークンを返す `` tokenize``メソッドを提供します。

バージョン 1.6 で追加.

class QueryStringConstantCacheBuster(token, param='x')

：class： `〜pyramid.interfaces.ICacheBuster`の実装で、アセットURLのクエリ文字列にキャッシュ破棄のための任意のトークンを追加します。

`` token``パラメータは、キャッシュ破棄に使用するトークン文字列であり、すべての要求で同じになります。

オプションの `` param``引数は、クエリ文字列に追加されるパラメータの名前を決定し、デフォルトは `` x'``です。

バージョン 1.6 で追加.