skip to navigation
skip to content

Not Logged In

django-pragmatic 0.9.7

Pragmatic tools and utilities for Django projects

Latest Version: 1.0.0

Pragmatic tools and utilities for Django projects

Tested on Django 1.5.

Requirements

  • Django

Some utilities require additional libraries as:

  • django_filters
  • fpdf
  • Pillow
  • pyBarcode

Installation

  1. Install python library using pip: pip install django-pragmatic
  2. Add pragmatic to INSTALLED_APPS in your Django settings file

Usage

Templates

pragmatic/helpers/breadcrumbs.html
Template helper for django-breadcrumbs app
pragmatic/helpers/confirm_delete.html
Form for delete confirmation
pragmatic/helpers/messages.html
Template helper for django messages framework
pragmatic/helpers/pagination.html
Template helper for paginating objects in ListViews
pragmatic/helpers/pagination-listview.html
Template helper for paginating objects in ListViews

Template tags

{% load pragmatic_tags %}

def klass(obj)
Returns string of instance class name.
def bootstrap3_field(field)
Adds 'form-control' class to field widget classes.
def filtered_objects_counts(filtered, all)
Returns translatable percentage description of value filtered/all in this format: '<strong>%d (%.2f%%)</strong> filtered, from a total of %d' % (filtered, percent, all)'
def qrcode(value, alt=None)
Outputs generated QR code using Google charts API from a given string and adds alternative description to it.
def barcode(code, args=None):
Outputs generated barcode using pyBarcode library from a given string.
def paginator(context, objects, page_ident='page', anchor=None, adjacent=2)
Pagination template tag.
def divide(value, arg)
Divides the value by argument.
def multiply(value, arg)
Multiplies the value by argument.
def add(value, arg)
Adds the arg to the value.
def subtract(value, arg)
Subtracts the arg to the value.
def capture(parser, token)
Capture contents of block into context.

Context processors

def date_formats(request)
Returns a lazy 'date formats' context variables DATE_FORMAT_JS, DATE_FORMAT_TAG, DATE_FORMAT_FULLMONTH_TAG, from settings file.
def installed_apps(request)
Returns a lazy 'INSTALLED_APPS' context variable.

Decorators

def permissions_required(app_label, login_url=None, raise_exception=False)
Decorator for views that checks whether a user has at least one app permission enabled, redirecting to the log-in page if necessary. If the raise_exception parameter is given the PermissionDenied exception is raised and app label of missing permission is stored in user instance.
def permission_required(perm, login_url=None, raise_exception=False)
Decorator for views that checks whether a user has a particular permission enabled, redirecting to the log-in page if necessary. If the raise_exception parameter is given the PermissionDenied exception is raised and missing permission is stored in user instance.
def receiver_subclasses(signal, sender, dispatch_uid_prefix, **kwargs)
A decorator for connecting receivers and all receiver's subclasses to signals.

Fields

class RangeField(forms.Field)
Form field which expects input to be a number or number range (2 numbers divided with '-').
class MultiSelectField(models.Field)
Model field which stores multiple choices as a comma-separated list of values, using the normal CHOICES attribute.
class MultiSelectFormField(forms.MultipleChoiceField)
Form field for model field above (MultiSelectField).
class TruncatedModelChoiceField(forms.ModelChoiceField)
ModelChoiceField is a form field which truncates overflowed characters from instance label and adds '...' instead of them.

Filters

class TruncatedModelChoiceFilter(forms.ModelChoiceField)
Filter field for TruncatedModelChoiceField.
class OneFieldRangeFilter(django_filters.Filter)
Filter field for RangeField.

Helpers

def base64_to_file(content, filepath):
Stores base64 encoded content to file.
def round_to_n_decimal_places(value, n)
Returns number rounded to n decimal places.
def generate_hash(length=5)
Returns random generated string
def get_subclasses(classes, level=0)
Return the list of all subclasses given class (or list of classes) has.
def barcode(code, args=None)
Returns barcode as string encoded in base64 format.

Mixins

class ReadOnlyFormMixin(forms.BaseForm)
Adds 'readonly and 'disabled' attributes to fields specified in read_only form attribute.
class DeleteObjectMixin(object)
Mixin for object delete confirmation. Implement get_parent() method or get_success_url() and get_back_url() methods instead.
class PickadateFormMixin(object)
Mixin which fixes pickadate.js inputs and adds data-value attribute to them if you use your own date formats.
class FPDFMixin(object)
Mixin helper for generating PDF outputs in Django using fpdf library.

Signals

def receiver_subclasses

Thirdparty

class BarcodeImageWriter(ImageWriter)
Fixed version of barcode.writer.ImageWriter.
class GroupedCheckboxSelectMultiple(CheckboxSelectMultiple)
Advanced form field widget for grouping multiple choices into custom groups. Use it with static/js/grouped-checkboxes.js
 
File Type Py Version Uploaded on Size
django-pragmatic-0.9.7.tar.gz (md5) Source 2014-01-27 15KB
  • Downloads (All Versions):
  • 29 downloads in the last day
  • 387 downloads in the last week
  • 1761 downloads in the last month