Skip to main content

A context decorator for Django views

Project description

Continuous integration Coverage PyPI

django-context-decorator is a Python package for Django removing the need to call super().get_context_data(**kwargs) in nearly every Django view.

You can also read the blog post about this package.

Usage

from django_context_decorator import context
from django.utils.functional import cached_property
from django.views.generic import TemplateView

class MyView(TemplateView):
    template_name = 'path/to/template.html'

    @context
    def context_variable(self):
        return 'context value'

    @context
    @property
    def context_property(self):
        return 'context property'

    @context
    @cached_property
    def expensive_context_property(self):
        return 'expensive context property'

Now you’ll have access to {{ context_variable }}, {{ context_property }} and {{ expensive_context_property }} in your template.

Please note: While this package works with the @cached_property decorator, please make sure to add the @context decorator above the @cached_property decorator.

This is especially useful when you couple it with inheritance, because it allows you to re-use parent class variables without having to extract them from your context. So you could write a long-form like this:

from django.views.generic import TemplateView


class BaseMixin:

    def get_context_data(self, **kwargs):
        ctx = super().get_context_data(**kwargs)
        ctx['var_from_base_mixin'] = 'var_from_base_mixin'
        return ctx


class View1(BaseMixin, TemplateView):

    def get_context_data(self, **kwargs):
        ctx = super().get_context_data(**kwargs)
        ctx['var_from_view_1'] = 'value_from_view_1'
        return ctx


class View2(View1):

    def get_context_data(self, **kwargs):
        ctx = super().get_context_data(**kwargs)
        ctx['var_from_view_2'] = 'value_from_view_2'
        return ctx

instead like this:

from django.views.generic import TemplateView
from django_context_decorator import context


class BaseMixin:

    @context
    def var_from_base_mixin(self):
        return 'var_from_base_mixin'


class View1(BaseMixin, TemplateView):

    @context
    def var_from_view_1(self):
        return 'value_from_view_1'


class View2(View1):

    @context
    def var_from_view_2(self):
        return 'value_from_view_2'

Limitations

Due to the usage of __set_name__, this package is limited to Python 3.6+.

Development

All code resides in django_context_decorator.py. Tests are collected by pytest from all files starting with test_. To run tests, start a virtual environment, install the dependencies, and run pytest:

pip install django pytest pytest-cov
pytest --cov-report term --cov=django_context_decorator

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-context-decorator, version 1.6.0
Filename, size File type Python version Upload date Hashes
Filename, size django_context_decorator-1.6.0-py3-none-any.whl (3.3 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size django_context_decorator-1.6.0.tar.gz (3.3 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