Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

pyramid tween for fanstatic

Project Description

pyramid_fanstatic

This package provide a Pyramid tween for fanstatic and a pyramid scaffold.

Scaffold

Just run:

$ pcreate -s starter -s pyramid_fanstatic myproject

Or:

$ pcreate -s pyramid_fanstatic myexistingproject

if you want to add pyramid_fanstatic to an existing project.

Then read README_FANSTATIC.txt

Fanstatic library definition is added to resources.py. Resources are located in the resources/ directory.

Tween usage

You can use all fanstatic options in your .ini. You just need to prefix options with fanstatic.:

[app:main]
...
fanstatic.publisher_signature = fanstatic

You should add at least those two options:

fanstatic.bottom = true
fanstatic.debug = true # in development.ini

Then include pyramid_fanstatic in your __init__.py:

config.include('pyramid_fanstatic')

Base URLs for resources

Static

By default, resource URLs from Fanstatic come served at in the script root and Fanstatic provides its base_url option to set a URL prefix for all resource URLs. You can utilise this option statically using the following:

[app:main]
...
fanstatic.base_url = https://example.com/myapp

Take note that the URL should not have a trailing slash - Fanstatic has resources URLs that feature a / prefix already.

Dynamic

The above process works, but your application may need to serve from multiple URLs, multiple paths, and so forth. pyramid_fanstatic has a special option to allow the base_url prefix to be configured on a per-request basis. Your application URI is generated using wsgiref.util.application_uri and is based upon the request environment (according to PEP 333).

This option is fanstatic.use_application_uri and is specific to pyramid_fanstatic and is not passed to Fanstatic. Specify this option as follows:

[app:main]
...
fanstatic.use_application_uri = true

Any static base_url that is set will take precedence over this option.

Changelog

0.6 (unreleased)

  • Nothing changed yet.

0.5 (2013-11-08)

  • Support fanstatic > 1.0 with backward compat

0.4 (2012-09-21)

  • Add new option fanstatic.use_application_uri to have Fanstatic base URLs generated using the current request. A base_url that is set will override this option. [davidjb]
  • Document details about Fanstatic base URLs and the fanstatic.base_url option. [davidjb]

0.3 (2011-12-27)

  • Improve the Pyramid scaffold that’s available with pcreate. [gawel]

0.2 (2011-12-26)

  • Forward requests to Pyramid handler if a resource can’t be found. [gawel]
  • Documentation and coverage improvements [gawel]

0.1 (2011-12-26)

  • Initial release. [gawel]
Release History

Release History

This version
History Node

0.5

History Node

0.4

History Node

0.3

History Node

0.2

History Node

0.1

Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
pyramid_fanstatic-0.5.zip (13.2 kB) Copy SHA256 Checksum SHA256 Source Nov 8, 2013

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting