Skip to main content

A collection of utilities to help in Django Projects

Project description

A collection of utilities to help in Django Projects



pip install django-tiamat

Add to your Python path or install and add 'tiamat' to your INSTALLED_APPS setting.


This is intended for general use in any project to save time writing helpers that are common to most projects.

View Decorators

as_json will return a JSON response:

from tiamat.decorators import as_json

def some_view(request):
    #do something
    return {'key': 'value'}

as_jsonp will return a JSONP response:

from tiamat.decorators import as_jsonp

def some_view(request):
    #do something
    return {'key': 'value'}


returns `myFunctionCall({"foo": "1"})`

Model Mixins

SlugMixin will add a slug field (named slug) to your model that will be automatically generated from a field called ‘name’ on saving. If you wish to override the default field to generate the slug from set make_slug_from on the model. See the source for more details.

Generic Manager

A simple way to add a manager that overrides the queryset returned.

So this:

class SomeManager(models.Manager):
    def get_query_set(self):
        return super(SomeManager, self).get_query_set().filter(this=that)

class SomeModel(models.Model):
    # define the model
    objects = models.Manager()
    custom_objects = SomeManager()

Becomes this:

from tiamat.models import GenericManager

class SomeModel(models.Model):
    # define the model
    objects = models.Manager()
    custom_objects = GenericManager(this=that)

Pagination Helper

A simple way to handle pagination of your querysets:

from tiamat.paginate import page_objects

page = page_objects(Something.objects.all(), 25, 2)

Where 25 is objects per page and 2 is the current page number

ID Encoder

This is a good when you are using IDs in your urls. An example would be a link generated to confirm an email address, or a link generated to reset a user’s password.

Make sure you set the setting URL_ENCODER_KEY to something different than your SECRET_KEY then you can:

from tiamat.urlencoder import encoder



send_async_email provides an easy helper to send email using a template:

from tiamat.mail import send_async_email

    {'name': 'Steve'},
    [ for user in User.objects.all()]

Template Tags

As an alternative to using form.as_p() or form.as_table() and dealing with that you can define a generic template for forms by overriding the template tiamat/_form.html and using it like so:

{% load tiamat_tags %}
{% render_form form %}


See the source code for more.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for django-tiamat, version 0.9.8
Filename, size File type Python version Upload date Hashes
Filename, size django-tiamat-0.9.8.tar.gz (8.2 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page