Skip to main content

pyramid_webassets

Project description

Configuration
====================
You are required to set base_dir and base_url, the rest are optional,
but we currently support:

* base_dir: The directory to output and search for assets
* base_url: The url static assets will be located
* debug: If webassets should be in debug mode (i.e no compression)
* updater: Different update configurations (i.e always, timestamp)
* cache: If we should use webassets cache
* jst_compiler: A custom jst compiler, by defalut it uses underscore

``` python
webassets.base_dir=%(here)s/app/static
webassets.base_url=/static
webassets.debug=True
webassets.updater=timestamp
webassets.cache=False
webassets.jst_compiler=Handlebars.compile
```

Then you can just use config.add_webasset to add bundles to your environment

``` python
jst = Bundle('templates/*.html',
filters='jst',
output='js/jst.js', debug=False)

config.add_webasset('jst', jst)
```

Mako
====================
You can use the global webassets tag:
``` python
% for url in webassets(request, 'css/bootstrap.css', 'css/bootstrap-responsive.css', output='css/generated.css', filters='cssmin'):
<link href="${url}" rel="stylesheet">
% endfor
```

or you can grab the environment from the request.

From The Request
====================
If you are not using Jinja2, you can still access the environment from the request.

```python
jst_urls = request.webassets_env['jst'].urls()
```


Jinja2
====================
If you are using Jinja2, you can just do the following configuration (this assumes use of pyramid_jinja2):

``` python
config.add_jinja2_extension('webassets.ext.jinja2.AssetsExtension')
assets_env = config.get_webassets_env()
jinja2_env.assets_environment = assets_env
```

Extras
====================
There are a few utility methods you can use:

get_webassets_env_from_settings(settings, prefix='static_assets'): Pass it a dictionary of your settings and an
optional keyword argument of the prefix in your configuration and it will return you a webassets environment.

get_webassets_env(request or config): This will pull the environment out of the registry, you can use either
a configurator object or a request.

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

pyramid_webassets-0.7.1.tar.gz (5.7 kB view details)

Uploaded Source

File details

Details for the file pyramid_webassets-0.7.1.tar.gz.

File metadata

File hashes

Hashes for pyramid_webassets-0.7.1.tar.gz
Algorithm Hash digest
SHA256 a5922dc5cc3f238b9531d598224c9c4d056fe2e5f6dcf1fcbb09a5ef28de4e27
MD5 eaa5c10563625d40719f94f5c33343ab
BLAKE2b-256 e00489a68b4c1b1bea02279f0d713316910360c9acbde6345c65fd08ea33974c

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