Skip to main content

pybars3 (handlebars) templates rendering for aiohttp.

Project description

aio_pybars
========

Quick Start
------------------

0. Install::

pip install aio_pybars

OR via setup.py::

python setup.py install

1. Configure your app::

from aio_pybars import FSTemplateLoader
loop.run_until_complete(aio_pybars.setup(app,
templates_dir=config['TEMPLATES_DIR'],
Loader=FSTemplateLoader))

2. Use templates in the view::

async def index(request):
context = {"var": "value"}
return AIOBarsResponse(request, 'template_name', context)

It will render the `template_name.hbs` template with variables in the `context` to the aiohttp response.

Helpers and partials
------------------------------------

Partial is the nested template that should be included in the specific place.
If the following code occurs in the template::

{{> "sidebar"}}

pybars3 will search the _partial_ named `sidebar` in the dictionary. How to add your own partial see below.

Helper is the callable that can be called from the template. Syntactically it looks same as the variable, but can
get the arguments::

<link rel="shortcut icon" href="{{asset "favicon.ico"}}">

would call the `asset` callable with "favicon.ico" argument and put the results in the rendered template.

*To use your own partials and helpers* implement your subclass of templates loader::

class AppFSTemplateLoader(FSTemplateLoader):
def __init__(self, app, base_dir):
super().__init__(app, base_dir)

def get_partials(self):
"""
Load all files in the partials/ subdirectory of templates dir.
Method should return the dictionary {'partial_name': <compiled template>, ...}
"""
partials = super().get_partials()
base_partials = os.path.join(self.app.config['TEMPLATES_DIR'], 'partials')
for name in os.listdir(base_partials):
filename = os.path.splitext(name)[0]
template_source = open(os.path.join(base_partials, name), 'r', encoding='utf8').read()
template = self.compiler.compile(template_source)
partials[filename] = template
return partials

def get_helpers(self):
"""
Define your own set of helpers.
Method should return the dictionary {'helper_name': <callable>, ...}
"""
helpers = super().get_helpers()
helpers.update({"asset": _asset})
return helpers


def _asset(options, val, *args, **kwargs):
return "/static/{}".format(val)

and pass it as Loader argument to the setup::

loop.run_until_complete(aio_pybars.setup(app,
templates_dir=config['TEMPLATES_DIR'],
Loader=AppFSTemplateLoader))

Recursive rendering of templates
--------------------------

The aio_pybars enables templates to be recursive. If the first line of the template contains::

{{!< base_template}}

all the rendered template will be passed as variable `body` to the base template.

For example:

base.hbs::

<!DOCTYPE html>
<html>
<head>
<title>Template</title>
</head>
<body>
{{body}}
</body>

test.hbs::

{{!< base}}
Hello, {{name}}.

Then result of the `render(loader, 'test', {'name': 'Roma'})` will be::

<!DOCTYPE html>
<html>
<head>
<title>Template</title>
</head>
<body>
Hello, Roma
</body>

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

aio_pybars-0.1.0.tar.gz (3.6 kB view details)

Uploaded Source

File details

Details for the file aio_pybars-0.1.0.tar.gz.

File metadata

  • Download URL: aio_pybars-0.1.0.tar.gz
  • Upload date:
  • Size: 3.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for aio_pybars-0.1.0.tar.gz
Algorithm Hash digest
SHA256 e0850762a9f30e713ea79a5dc9c080d8a33bd1d14fe9ebf0dd869595c0e48c9b
MD5 0d38ac946c8d5011b3d93b4ddfe2da76
BLAKE2b-256 14efe62432c5b998b0151629b53a0b8e6f3f71220fb960d8826c1dedb09b4bb7

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