Repository files navigation

Simple ETag and Last-Modified mixins for class based views.

Django Conditional Views builds off of the built indjango conditional view processing machineryto provide simple mixins for class based views that implement support for the ETag and Last-Modifiedconditional request headers.

Inherit one of these mixins to make your TemplateView's, DetailView's, or ListView's:

1. Calculate and append ETag and/or Last-Modified headers to the response and;
2. Respond with a304 Not Modified or a412 Precondition Failed to requests that provide conditional response headers such as If-Modified-Since

Helpful Defaults

• ETags are automatically generated from the response.content.
• ETag generation can be customized both before and after the response is rendered.
• The Last Modified header is automatically set from the last modified timestamp of the template.
• In the case of the DetailView and ListView mixins, the Last Modified header may also beconfigured to get the last modification timestamp from a field on the model, in which casethe lastest of that or the template's last modified timestamp will be used.

First install django-conditional-views

$ pip install django-conditional-views

Then inherit from one of the following mixins in your views:

• ConditionalGetMixin - Inherits from View
• ConditionalGetTemplateViewMixin - Inherits from TemplateView
• ConditionalGetListViewMixin - Inherits from ListView
• ConditionalGetDetailViewMixin - Inherits from DetailView

See theUsage andAPI sections of thedocumentation for more details.

Contributions are welcome.

To work on the Pendulum codebase, you'll want to clone the project locallyand install the required dependencies viapoetry.

$ git clone git@github.com:cordery/django-conditional-views.git$ poetry develop

django-conditional-views uses pytest. To run tests:

$ pytest