diff options
| author | Michael Merickel <michael@merickel.org> | 2015-03-05 10:09:53 -0600 |
|---|---|---|
| committer | Michael Merickel <michael@merickel.org> | 2015-03-05 10:09:53 -0600 |
| commit | 6279cc428b2464066f67e4795045680bb3d59973 (patch) | |
| tree | 5f8e22498468f316d88b326baa751abf0acb1d9d /docs/narr/assets.rst | |
| parent | 06bb4a4db67321e7629f4f2438516ba358f226e9 (diff) | |
| parent | af810c54fa9829096085f0ca601030c4fb74b5c7 (diff) | |
| download | pyramid-6279cc428b2464066f67e4795045680bb3d59973.tar.gz pyramid-6279cc428b2464066f67e4795045680bb3d59973.tar.bz2 pyramid-6279cc428b2464066f67e4795045680bb3d59973.zip | |
Merge branch 'master' into fix.shared-view-renderer
Diffstat (limited to 'docs/narr/assets.rst')
| -rw-r--r-- | docs/narr/assets.rst | 15 |
1 files changed, 8 insertions, 7 deletions
diff --git a/docs/narr/assets.rst b/docs/narr/assets.rst index fc908c2b4..d6bc8cbb8 100644 --- a/docs/narr/assets.rst +++ b/docs/narr/assets.rst @@ -446,19 +446,20 @@ In order to implement your own cache buster, you can write your own class from scratch which implements the :class:`~pyramid.interfaces.ICacheBuster` interface. Alternatively you may choose to subclass one of the existing implementations. One of the most likely scenarios is you'd want to change the -way the asset token is generated. To do this just subclass an existing -implementation and replace the :meth:`~pyramid.interfaces.ICacheBuster.token` -method. Here is an example which just uses Git to get the hash of the -currently checked out code: +way the asset token is generated. To do this just subclass either +:class:`~pyramid.static.PathSegmentCacheBuster` or +:class:`~pyramid.static.QueryStringCacheBuster` and define a +``tokenize(pathspec)`` method. Here is an example which just uses Git to get +the hash of the currently checked out code: .. code-block:: python :linenos: import os import subprocess - from pyramid.static import PathSegmentMd5CacheBuster + from pyramid.static import PathSegmentCacheBuster - class GitCacheBuster(PathSegmentMd5CacheBuster): + class GitCacheBuster(PathSegmentCacheBuster): """ Assuming your code is installed as a Git checkout, as opposed to as an egg from an egg repository like PYPI, you can use this cachebuster to @@ -470,7 +471,7 @@ currently checked out code: ['git', 'rev-parse', 'HEAD'], cwd=here).strip() - def token(self, pathspec): + def tokenize(self, pathspec): return self.sha1 Choosing a Cache Buster |
