Skip to main content

Pyramid view layers

Project description

player

https://secure.travis-ci.org/fafhrd91/player.png

player allows to address templates with two parameters, category and name. Also it is possible to use set of directories for each layer, in that case player searches templates in each directory. It allows to override templates without changing code. For example form library can define layer field:

>> ls ./fields/
.. bool.pt
.. file.pt
...
.. textarea.pt

In your application you can override any of this template by defining new layer for field category:

>> ls ./myproject/fields/
.. bool.pt

Usually top level directory is a category and file in directory is template. For example ‘form:view.lt’:

`form` - layer category
`view` - template name
`.lt`  - custom pyramid renderer factory

Layer can to be defined with add_layer config directive:

>> config = Configurator()
.. config.include('player')
..
.. config.add_layer('form', path='./path_to_form_dirctory/form/')

form directory can contain any template:

>> ./form/
..   view.pt
..   actions.jinja2

It is possible to use any of this templates as pyramid renderer path:

>> config.add_view(
..     name='view.html',
..     renderer='form:view.lt')

or :

>> config.add_view(
..     name='actions.html',
..     renderer='form:actions.lt')

It is possible to run python code before rendering template. There are add_tmpl_filter directive and player.tmpl_filter decorator:

>> def form_actions(context, request):
..     return {'url': ...}

>> config.add_tmpl_filter('form:actions', form_action, name='custom')

or:

>> import player

>> @player.tmpl_filter('form:actions', name='custom')
.. def form_actions(context, request):
..     return {'url': ...}

form_actions function gets call just before rendering template. Layer has to be defined with add_layer directve before registering template filter function.

Customization

Any number of layer categories can be registered and any number of layers can be registered in each category. It doesnt require to override all templates from category. For example it is possible to override just view.pt template:

>> config.add_layer('form', 'custom', path='path_to_form_directory_2/form')

and content of this new directory:

>> ./another_path/form/
..   view.jinja2

Now view view.html uses view.jinja2 template. But actions.html stil uses original template.

Another example, if you want customize bool field from ptah.form package all you need is to create some folder, add it as ‘fields’ layer, and put bool.pt template to this folder, something like that:

>> config.add_layer('fields', 'custom', 'mypackage:fields')

and

>> .mypackage/fields/
..    bool.pt

Request method

player also provides request method render_tmpl. It acccepts path:

..  ${structure: request.render_tmpl('form:actions')

.lt extension is optional in this case.

player

License

player is offered under the BSD license.

CHANGES

0.5 (11-30-2012)

  • Use jinja2 for templates
  • Added layout_data request property
  • Allow to pass several messages to error message

0.4 (11-12-2012)

  • Added player.layout renderer
  • Added -c argument to player console script, it allows to customize templates
  • set_layout_data accepts keyword arguments
  • Removed player.wrap_layout()
  • Removed python2.6 support

0.3 (11-07-2012)

  • Added set_layout_data request method, allow to set global layout options
  • Added status messages
  • Added formatters

0.2 (11-01-2012)

  • Added layout subsystem

0.1 (10-30-2012)

  • Initial release

Project details


Release history Release notifications

History Node

0.6.1

History Node

0.6

This version
History Node

0.5

History Node

0.4

History Node

0.3

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
player-0.5.tar.gz (17.9 kB) Copy SHA256 hash SHA256 Source None Nov 30, 2012

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page