django-pragmatic

Pragmatic tools and utilities for Django projects.

Requirements

• Python 3.8+
• Django 3.2+
• django-filter
• python-pragmatic

Optional dependencies are required only for the modules that use them (see Installation).

Installation

pip install django-pragmatic

Add pragmatic to INSTALLED_APPS:

INSTALLED_APPS = [
    ...
    'pragmatic',
]

Run migrations (needed only if you use deleted-object tracking):

python manage.py migrate pragmatic

What's included

Quick examples

Maintenance mode:

# settings.py
MAINTENANCE_MODE = True
MAINTENANCE_MODE_BYPASS_USERS = [1]  # superuser can still log in

Send an email from a template:

from pragmatic.managers import EmailManager

EmailManager.send_mail(
    to=user,
    template_prefix='emails/welcome',
    subject='Welcome!',
    data={'activation_link': url},
    request=request,
)

List view with display modes and sorting:

from pragmatic.mixins import DisplayListViewMixin, SortingListViewMixin

class ArticleListView(SortingListViewMixin, DisplayListViewMixin, ListView):
    model = Article
    displays = ['list', 'table']
    paginate_by_display = {'list': [10, 25], 'table': 100}
    sorting_options = {'-created': 'Newest', 'title': 'Title A–Z'}

Template filter values display:

{% load pragmatic_tags %}
{% filter_values filter %}
{% num_applied_filters filter request.GET as n %}
{{ n }} active filter{{ n|pluralize }}

Background task decorator:

# settings.py
PRAGMATIC_TASK_DECORATOR = 'django_rq.job'  # or 'celery.shared_task'

from pragmatic.utils import get_task_decorator

task = get_task_decorator(queue='default')

@task
def process_export(export_id):
    ...

Documentation

Full documentation is at django-pragmatic.readthedocs.io.

License

BSD License — see LICENSE for details.