django-classy-tags 0.4

Class based template tags for Django
django-classy-tags's goal is to create a new way of writing Django template tags which is fully compatible with the current Django templating infrastructure. This new way should be easy, clean and require as little boilerplate code as possible while still staying as powerful as possible.

For the impatient

This is how a tag looks like using django-classy-tags:

from classytags.core import Tag, Options
from classytags.arguments import Argument
from django import template

register = template.Library()

class Hello(Tag):
 options = Options(
 Argument('name', required=False, default='world'),
 Argument('varname', required=False, no_resolve=True)

 def render_tag(self, context, name, varname):
 output = 'hello %s' % name
 if varname:
 context[varname] = output
 return ''
 return output


That's your standard hello world example. Which can be used like this:

 * {% hello %}: Outputs hello world
 * {% hello "classytags" %}: Outputs hello classytags
 * {% hello as myvar %}: Outputs nothing but stores hello world into the template variable myvar.
 * {% hello "my friend" as othervar %}: Outputs nothing but stores hello my friend into the template variable othervar.

Main features:

  • Class based template tags.
  • Template tag argument parser.
  • Declarative way to define arguments.
  • Supports (theoretically infinite) parse-until blocks.
  • Extensible!

last updated on:
August 13th, 2011, 6:28 GMT
license type:
BSD License 
developed by:
Jonas Obrist
ROOT \ Internet \ Django Plugins
Download Button

In a hurry? Add it to your Download Basket!

user rating



Rate it!

Add your review!