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?
NOTE: This project is very early-stage. Try it out, leave feedback and wishes in the issues. And pull-requests welcome!
Installation
Install pybars, pymeta, and djangobars:
pip install git+git://github.com/mjumbewu/pymeta.git@master#egg=pymeta pip install git+git://github.com/mjumbewu/pybars.git@master#egg=pybars pip install djangobars
NOTE that ``djangobars`` depends on particular versions of ``pymeta`` and ``pybars``. If you add ``djangobars`` to a requirements file, be sure to add these versions of ``pymeta`` and ``pybars`` first.
Add 'djangobars' to your installed applications.
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', )
(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
0.1.4
Fix a bug in the app directories template loader where the path names were calling decode in Python 2 and 3.
0.1.3
Change the installation details
Pip 1.5 makes it difficult to specify installation sources outside of the PyPI. Also, this is better motivation to get these packages officially on PyPI.
0.1.2
Depend on specific forks of pymeta and pybars
0.1.1
First Release
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.