falkolab.cacheburster

Manipulations with browser resource URL to forcing a browser to update its cache

These details have not been verified by PyPI

Project description

This package provides new flexible zcml directive to inserts a computed by content version info (hash, crc32 or versionfile) into the resource’s URL, so the URL changes whenever the contents change, thereby forcing a browser to update its cache.

Cache Burster for Zope 3/BlueBream

This package contains the IVersionedResourceLayer layer. This layer supports a correct set of component registration and can be used for inheritation in custom skins.

Testing

For testing the Cache Burster we use the testing skin defined in the tests package which uses the IVersionedResourceLayer layer as the only base layer. This means, that our testing skin provides only the views defined in the minimal package and it’s testing views defined in tests.

>>> from zope.testbrowser.testing import Browser
>>> browser = Browser()
>>> browser.addHeader('Authorization', 'Basic mgr:mgrpw')

We have page template file that looks as:

>>> print getTemplateContent('page.pt')
<html><head>
<script type="text/javascript" src="script.js"
tal:attributes="src context/++resource++script.js"></script>
<BLANKLINE>
<script type="text/javascript" src="one-module.css"
tal:attributes="src context/++resource++one-module.css"></script>
</head>
<body></body>
</html>

We have page.html view which is registred in the ftesting.zcml file with our skin for testing purposes:

>>> browser.open('http://localhost/page.html')
>>> browser.url
'http://localhost/page.html'

Rendered view:

>>> print browser.contents
<html><head>
<script type="text/javascript"
        src="http://localhost/@@/script.js"></script>
<BLANKLINE>
<script type="text/javascript"
        src="http://localhost/@@/one-module.css"></script>
</head>
<body></body>
</html>

Nothing has changed, all right.

Cache Burster rule

Now we register Cache Burster rule:

>>> from zope.configuration import xmlconfig
>>> import falkolab.cacheburster
>>> context = xmlconfig.file('meta.zcml', falkolab.cacheburster)
>>> def zcml(s, context):
...     return xmlconfig.string(s, context)

>>> context = zcml(r"""
...    <configure
...        xmlns="http://namespaces.zope.org/browser"
...        >
...
...      <cacheburster
...          from="(script).js"
...          to="\1.{version}.js"
...          fileset="tests/testfiles/*.js"
...          />
...
...    </configure>
... """, context)

OK. Render page again:

>>> browser.open('http://localhost/page.html')
>>> print browser.contents
<html><head>
<script type="text/javascript"
        src="http://localhost/@@/script.8dc15d98.js"></script>
<BLANKLINE>
<script type="text/javascript"
        src="http://localhost/@@/one-module.css"></script>
</head>
<body></body>
</html>

The cacheburster directive from and to fields use python re syntax. That looks similarly re.sub(from, to, resourcename) We can specify from=”(.*).js”. It means that the rule was accepted by all resources that end with .js.

Test that resource URL is accessible:

>>> browser.open('http://localhost/@@/script.8dc15d98.js')
>>> print browser.contents
alert('script.js');

Add next rule:

>>> context = zcml(r"""
...    <configure
...        xmlns="http://namespaces.zope.org/browser"
...        >
...
...      <cacheburster
...          from="(.*)-module.css"
...          to="\1-module.css?{version}"
...          manager="md5"
...          />
...
...    </configure>
... """, context)

Render page again:

>>> browser.open('http://localhost/page.html')
>>> print browser.contents
<html><head>
<script type="text/javascript"
        src="http://localhost/@@/script.8dc15d98.js"></script>
<BLANKLINE>
<script type="text/javascript"
        src="http://localhost/@@/one-module.css?c25661cc824732136e9ec697d97afaed"></script>
</head>
<body></body>
</html>

Test that resource URL is accessible:

>>> browser.open('http://localhost/@@/one-module.css?579d7fcdc5acc3fe9f063020b2f573cf')
>>> print browser.contents
body {background:#ffffff;}

No-file resource

>>> import zope.browserresource
>>> context = xmlconfig.file('meta.zcml', zope.browserresource, context)
>>> context = zcml(r"""
...    <configure
...        xmlns="http://namespaces.zope.org/browser"
...        >
...    <resource
...       name="nofile"
...       factory="falkolab.cacheburster.testing.NoFileResourceFactory"
...       layer="falkolab.cacheburster.interfaces.IVersionedResourceLayer"
...       />
...
...      <cacheburster
...          from="nofile"
...          to="{version}.nofile"
...          />
...
...    </configure>
... """, context)

>>> browser.open('http://localhost/page2.html')
>>> print browser.contents
<html><head>
<script type="text/javascript"
        src="http://localhost/@@/fdd9b757.nofile"></script>
</head>
<body></body>
</html>

Test that resource URL is accessible:

>>> browser.open('http://localhost/@@/fdd9b757.nofile')
>>> print browser.contents
no file resource body

Resource Directory

>>> context = zcml(r"""
...    <configure
...        xmlns="http://namespaces.zope.org/browser"
...        >
...    <resourceDirectory
...       name="resources"
...       directory="tests/testfiles"
...       layer="falkolab.cacheburster.interfaces.IVersionedResourceLayer"
...       />
...    </configure>
... """, context)

Now we test resource url within ResourceDirectory:

>>> resourceDir = zope.component.getAdapter(request, name='resources')
>>> resourceDir['script.js']()
'http://127.0.0.1/@@/resources/script.js'

>>> resourceDir['one-module.css']()
'http://127.0.0.1/@@/resources/one-module.css?c25661cc824732136e9ec697d97afaed'

We can see rules matching difference between (script).js and (.*)-module.css. Test that resource URL is accessible:

>>> browser.open('http://localhost/@@/resources/one-module.css?c25661cc824732136e9ec697d97afaed')
>>> print browser.contents
body {background:#ffffff;}

File Version Manager

Create and register file manager as versionfile:

>>> import os, tempfile
>>> temp_dir = tempfile.mkdtemp()

>>> pathToVersionFile = os.path.join(temp_dir, 'version.txt')
>>> open(pathToVersionFile, 'w').write("1")

>>> from zope.browserresource.interfaces import IResource
>>> manager = falkolab.cacheburster.version.FileVersionManager(pathToVersionFile)

>>> zope.component.provideAdapter(manager,
...     (zope.browserresource.interfaces.IResource,
...     falkolab.cacheburster.interfaces.IVersionedResourceLayer),
... falkolab.cacheburster.interfaces.IVersionManager, name='versionfile')

Add rule:

>>> context = zcml(r"""
...    <configure
...        xmlns="http://namespaces.zope.org/browser"
...        >
...
...      <cacheburster
...          from="(.*).pack"
...          to="\1.{version}"
...          fileset="tests/testfiles/*.pack"
...          manager="versionfile"
...          />
...
...    </configure>
... """, context)

Look at the page:

>>> print getTemplateContent('page3.pt')
<html><head>
<script type="text/javascript" src="any_script.pack"
tal:attributes="src context/++resource++any_script.pack"></script>
</head>
<body></body>
</html>

Render page:

>>> browser.open('http://localhost/page3.html')
>>> print browser.contents
<html><head>
<script type="text/javascript"
        src="http://localhost/@@/any_script.1"></script>
</head>
<body></body>
</html>

Cleanup

>>> import shutil
>>> shutil.rmtree(temp_dir)

CHANGES

0.1.5 (2010-12-17)

Added path normalization so that A//B, A/B/, A/./B and A/foo/../B all become A/B.

0.1.4 (2010-12-07)

Fix direct call Resources from ResourceDirectory

0.1.3 (2010-11-23)

ResourceDirectory support

0.1.2 (2010-11-21)

Changes to MANIFEST.in

0.1.1 (2010-11-19)

Package broken. Changes to add README.txt

0.1.0 (2010-11-16)

Initial release.

Project details

These details have not been verified by PyPI

Release history Release notifications | RSS feed

This version

0.1.5

Dec 17, 2010

0.1.4

Dec 7, 2010

0.1.3

Nov 23, 2010

0.1.2

Nov 21, 2010

0.1.1

Nov 19, 2010

0.1.0

Nov 18, 2010

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

falkolab.cacheburster-0.1.5-py2.6.egg (36.0 kB view details)

Uploaded Dec 17, 2010 Egg

File details

Details for the file falkolab.cacheburster-0.1.5-py2.6.egg.

File metadata

Download URL: falkolab.cacheburster-0.1.5-py2.6.egg
Upload date: Dec 17, 2010
Size: 36.0 kB
Tags: Egg
Uploaded using Trusted Publishing? No

File hashes

Hashes for falkolab.cacheburster-0.1.5-py2.6.egg
Algorithm	Hash digest
SHA256	`6b2a9dba6948386c536b582c05051ecce96c9a82f72a6415087df287868d30b3`
MD5	`78f449e31296d3a6587477a66a624e57`
BLAKE2b-256	`034c9b192a65058fd1b8ae17133da07ce5a93c898521e6dbada73aad2f3596f7`

See more details on using hashes here.

falkolab.cacheburster 0.1.5

Navigation

Verified details

Maintainers

Unverified details

Meta

Classifiers

Project description

Cache Burster for Zope 3/BlueBream

Testing

Cache Burster rule

No-file resource

Resource Directory

File Version Manager

Cleanup

CHANGES

0.1.4 (2010-12-07)

0.1.3 (2010-11-23)

0.1.2 (2010-11-21)

0.1.1 (2010-11-19)

0.1.0 (2010-11-16)

Project details

Verified details

Maintainers

Unverified details

Meta

Classifiers

Release history Release notifications | RSS feed

Download files

Source Distributions

Built Distribution

File details

File metadata

File hashes