Skip to main content

Integrates Webassets into Morepath.

Project description

Webassets | Morepath

This package is somewhat similar to more.static, which integrates bowerstatic into Morepath. It is currently not really used anywhere, so you should probably stick to more.static.

Now that you are sufficently discouraged from using more.webassets, these are the reasons it might be for you:

  • You don’t have to learn about javascript package managers (i.e. Bower).

  • You can have your assets compiled on the fly.

  • Your stylesheets are rendered at the top, your scripts at the bottom. No configuration necessary.

If you are alreay familiar with webassets: This package might not be as powerful as you’re used to. It currently has little flexibility. It’s also the first time the author uses webassets, so things might be off.

Usage

To get a basic application that serves webassets under /assets/*:

from morepath import reify
from more.webassets import WebassetsApp
from webassets import Bundle

class MyApp(WebassetsApp):

    @reify
    def webassets_bundles(self):
        return {
            'jquery': Bundle(
                'jquery.js',
                filters='jsmin',
                output='bundles/jquery.bundle.js'
            )
        }

@MyApp.path('')
class Root(object):
    pass

@MyApp.html(model=Root):
def index(self, request):
    request.include('jquery')

    return '<html><head></head><body>hello</body></html>'

This will result in the following html (formatted for readability):

<html>
    <head></head>
    <body>hello</body>
    <script type="text/javascript" src="./assets/bundles/jquery.bundle.js?1234"></script>
</html>

For it to work you need an ‘assets’ folder with a ‘jquery.js’ file in the same folder as your python file where ‘MyApp’ is defined.

Run the Tests

Install tox and run it:

pip install tox
tox

Limit the tests to a specific python version:

tox -e py27

Conventions

More Webassets follows PEP8 as close as possible. To test for it run:

tox -e pep8

More Webassets uses Semantic Versioning

Build Status

Build Status

Coverage

Project Coverage

Latests PyPI Release

Latest PyPI Release

License

more.webassets is released under the revised BSD license

Changelog

Unreleased

0.0.3 (2015-08-07)

  • Cache the resource urls for increased speed. Note that with this change a reload of the application is necessary to get the updated javascript files.

    If this is an issue for you, speak up and we might add a debug flag. [href]

0.0.2 (2015-05-18)

  • Adds more checks to ensure we never serve anything outside the assets directory. [href]

0.0.1 (2015-04-29)

  • Initial Release [href]

Project details


Download files

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

Source Distribution

more.webassets-0.0.3.tar.gz (8.6 kB view details)

Uploaded Source

File details

Details for the file more.webassets-0.0.3.tar.gz.

File metadata

File hashes

Hashes for more.webassets-0.0.3.tar.gz
Algorithm Hash digest
SHA256 33e0fab02a8f2b937360eea67a994c8daf5e7dc5bedd4cc192c3ef25fee8b9f6
MD5 d5a817f209af2df4fd2a04a5620c7c10
BLAKE2b-256 875b65f4aa273f78da78d7d0bcf434199caf8f0f264dae7c9f349efc11f1192b

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page