Skip to main content

Class based template tags for Django

Project description

Please refer to the documentation in the docs/ directory for help. For a HTML rendered version of it please see here.

https://travis-ci.org/ojii/django-classy-tags.svg?branch=master

About this project

The goal of this project 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.

Features

  • Class based template tags.

  • Template tag argument parser.

  • Declarative way to define arguments.

  • Supports (theoretically infinite) parse-until blocks.

  • Extensible!

For the impatient

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

from classytags.core import Options
from classytags.helpers import AsTag
from classytags.arguments import Argument
from django import template

register = template.Library()

class Hello(AsTag):
    options = Options(
        Argument('name', required=False, default='world'),
        'as',
        Argument('varname', required=False, resolve=False)
    )

    def get_value(self, context, name):
        return 'hello %s' % name

register.tag(Hello)

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.

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

django-classy-tags-0.7.0.tar.gz (18.7 kB view details)

Uploaded Source

Built Distribution

django_classy_tags-0.7.0-py2.py3-none-any.whl (23.3 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file django-classy-tags-0.7.0.tar.gz.

File metadata

File hashes

Hashes for django-classy-tags-0.7.0.tar.gz
Algorithm Hash digest
SHA256 e55b09d8cea6995a768e5f05031fac5b1bd26cc52f232dc1c8a6be1b0a6653ba
MD5 7337dac1db4f72e2a0cd1d3bc3e35379
BLAKE2b-256 8c093c04c32676dcb00dd2937f0ec70b563991508ba79d1cdcf4a1bab298f52b

See more details on using hashes here.

Provenance

File details

Details for the file django_classy_tags-0.7.0-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for django_classy_tags-0.7.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 d8ea7d1414b0734c549e6b52f088014f5980ca7f5ecf87c3997d1372d6f9c198
MD5 d23ca56f93a59673a512cbff2a9f30b9
BLAKE2b-256 f12f86b126d2546f6aab35f409a34fbba051a33b245daba00bed121982990ebf

See more details on using hashes here.

Provenance

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