Skip to main content

Hotwired/Turbo response helpers for Django

Project description

This package provides helpers for server-side rendering of Hotwired/Turbo streams and frames.

Disclaimer: the Hotwired/Turbo client libraries are, at time of writing, still in Beta. We expect there will be breaking changes until the first stable release. This package, and the Turbo client, should therefore be used with caution in a production environment. The version used in testing is @hotwired/turbo==7.0.0-beta.4.

Requirements

This library requires Python 3.7+ and Django 3.0+.

Installation

pip install django-turbo-response

To install from Git:

git clone https://github.com/hotwire-django/django-turbo-response

cd django-turbo-response

python setup.py install

Note: This library does not include any client libraries (Turbo or Stimulus). You may wish to add these yourself using your preferred Javascript build tool, or use a CDN. Please refer to the Hotwire documentation on installing these libraries.

Full documentation on ReadTheDocs:

https://django-turbo-response.readthedocs.io/en/latest/

License

This project is covered by the MIT license.

Changelog

[0.0.31] - 2021-2-2

Refactoring mixin classes

[0.0.30] - 2021-2-1

TurboStreamIterableResponse removed

TurboStreamFormMixin and turbo-stream form views added

[0.0.29] - 2021-1-27

TurboStreamIterableResponse deprecated

TurboStreamMiddleware removed

[0.0.28] - 2021-1-22

Support for Python 3.7

[0.0.27] - 2021-1-21

Bugfix for Turbo-Frame header in middleware

[0.0.26] - 2021-1-17

Added TurboMiddleware (replacing TurboStreamMiddleware).

Removed TemplateFormResponse.

[0.0.24] - 2021-1-17

Added render_form_response shortcut.

[0.0.23] - 2021-1-14

Added TurboStreamIterableResponse class.

[0.0.22] - 2021-1-14

Added TemplateFormResponse class which automatically sets correct status based on form error state.

[0.0.21] - 2021-1-13

Middleware now accepts content type *text/vnd.turbo-stream.html.

[0.0.20] - 2021-1-13

Deprecated mixin methods removed.

Update response content type from text/html; turbo-stream to text/vnd.turbo-stream.html:

https://github.com/hotwired/turbo/releases/tag/v7.0.0-beta.3

[0.0.19] - 2021-1-13

Changes to mixin APIs.

[0.0.18] - 2021-1-12

TurboStreamDeleteView automatically resolves target based on model name+PK.

[0.0.17] - 2021-1-7

Added HttpResponseSeeOther class and redirect_303 shortcut function.

[0.0.16] - 2021-1-7

Ensure all form mixins/views return a 303 on redirect as per Turbo docs.

[0.0.15] - 2021-1-7

Removed protocol classes and mypy pre-commit requirement

[0.0.14] - 2021-1-6

Dependency bugfix

[0.0.13] - 2021-1-6

Added type hinting, tidy up of mixin class inheritance.

[0.0.12] - 2021-1-5

Update form handling for changes in @hotwired/turbo 7.0.0-beta.2:

  • TurboStreamFormMixin class and supporting classes removed
  • TurboFormMixin class added that just returns a 422 response on invalid
  • TurboStreamFormView, TurboStreamCreateView and TurboStreamUpdateView classes removed
  • TurboFormView, TurboCreateView and TurboUpdateView classes added, using new TurboFormMixin

[0.0.10] - 2020-12-30

Remove str methods from TurboStream and TurboFrame classes

[0.0.9] - 2020-12-30

Add render() method to template proxies

[0.0.8] - 2020-12-30

Added

TurboStream and TurboFrame classes

Project details


Download files

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

Source Distribution

django-turbo-response-0.0.31.tar.gz (9.0 kB view hashes)

Uploaded Source

Built Distribution

django_turbo_response-0.0.31-py3-none-any.whl (12.6 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page