Skip to main content
Help us improve Python packaging – donate today!

An extension to allow Django to use Handlebars templates through the pybars port of Handlebars.js

Project Description

djangobars

An extension to allow Django to use Handlebars templates through the pybars port of Handlebars.js

Because don’t we all want to use the same templates on the client that we do on the server?

https://travis-ci.org/mjumbewu/djangobars.png?branch=master:target:https://travis-ci.org/mjumbewu/djangobars

NOTE: This project is very early-stage. Try it out, leave feedback and wishes in the issues. And pull-requests welcome!

Installation

  1. pip install djangobars

  2. Add 'djangobars' to your installed applications.

  3. Add a HANDLEBARS_LOADERS value to your settings module. You will probably want:

    HANDLEBARS_LOADERS = (
        'djangobars.template.loaders.filesystem.Loader',
        'djangobars.template.loaders.app_directories.Loader',
    )
    
  4. (optional) Add a HANDLEBARS_DIRS and/or HANDLEBARS_APP_DIRNAMES value to your setting module. By default, djangobars will search in your TEMPLATE_DIRS folder, but you can use the HANDLEBARS_DIRS value to override this behavior. For example, if you want to use both Django templates and Handlebars templates, you may want to keep the two in separate directories.

Usage

Use pretty much just as you would Django’s own built-in templates. Instead of:

from django.shortcuts import render

def my_view(request):
    # View code here...
    return render(request, 'myapp/index.html', {"foo": "bar"},
        content_type="application/xhtml+xml")

do this:

from djangobars.shortcuts import render

def my_view(request):
    # View code here...
    return render(request, 'myapp/handlebar_index.html', {"foo": "bar"},
        content_type="application/xhtml+xml")

And instead of:

from django.views.generic import TemplateView

class MyView (TemplateView):
    template_name = 'myapp/index.html'

do this:

from django.views.generic import TemplateView
from djangobars.response import HandlebarsResponse

class MyView (TemplateView):
    template_name = 'myapp/handlebar_index.html'
    response_class = HandlebarsResponse

Template Tags

You can also include Handlebars templates with a Django template tag:

{% load djangobars %}

{% include_handlebars "handlebars_template_name.html" %}

The current template context will be carried over into the Handlebars template.

0.1.2

  • Depend on specific forks of pymeta and pybars

0.1.1

  • First Release

Release history Release notifications

History Node

0.2.1

History Node

0.2.0

History Node

0.1.5

History Node

0.1.4

History Node

0.1.3

This version
History Node

0.1.2

History Node

0.1.1

History Node

0.1.0

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
djangobars-0.1.2.tar.gz (6.4 kB) Copy SHA256 hash SHA256 Source None Jan 30, 2014

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