django-unpoly

What it does

unpoly is a reusable app for Django implementing a Django-flavored Unpoly v2 Server Protocol.

It provides:

1. A middleware which adds is_unpoly unpoly_target, and unpoly_validate methods to the request object.

2. A view mixin classes support both Django Generic Views and Vanilla Views.

3. A Form mixin class for Crispy Forms.

Installation

pip install unpoly_django

Configuration

You need to add unpoly.middleware.UnpolyMiddleware to your MIDDLEWARE.

To install all the middleware, you want something like:

MIDDLEWARE = (
    # ...
    'unpoly.middleware.UnpolyMiddleware',
    # ...
)

Settings

If using the View mixins following constants to settings.py:

MAIN_UP_TARGET = '#your_main_up_target'
MAIN_UP_FAIL_TARGET = '#your_main_upfail_target'

DEFAULT_UP_ERROR_TEMPLATE = 'your-unpoly-error-template.html'

# Default Templates for various Unpoly layers.
# Override on individual View attributes.
UNPOLY_MODAL_TEMPLATE = 'your-unpoly-modal-template.html'
UNPOLY_DRAWER_TEMPLATE = 'your-unpoly-drawer-template.html'
UNPOLY_POPUP_TEMPLATE = 'your-unpoly-popup-template.html'
UNPOLY_COVER_TEMPLATE = 'your-unpoly-cover-template.html'

# Routing URL kwarg set when an optimized response is to be sent
OPTIMIZED_SUCCESS_RESPONSE = 'optimized_success_response'

DEFAULT_ERROR_VIEW = 'appname:error_view_name'

CSRF Token

Ensure that the csrf_token meta tag is included in the head section of your templates

<meta name="csrf-token" content="{{ csrf_token }}" />

View Mixins

View mixin classes add hooks and properties for sending optimized server responses to the frontend.

Add view mixin classes to Django's Generic views, or Vanilla Views:

from django.views.generic import FormView, TemplateView
from unpoly.views import UnpolyViewMixin, UnpolyFormViewMixin, UnpolyCrispyFormViewMixin


class YourTemplateView(UnpolyViewMixin, TemplateView):
    pass

class YourFormView(UnpolyViewMixin, FormView):
    pass

class YourCrispyFormView(UnpolyCrispyFormViewMixin, FormView):
    pass

Crispy Form Mixin

The Crispy Form mixin can be used when form mixins are used, which enables passing up-target, up-layer, up-fail-layer and up-fail-target params from views to forms:

from django.forms import ModelForm
from unpoly.forms import UnpolyCrispyFormMixin

class UnpolyCrispyForm(UnpolyCrispyFormMixin, ModelForm):
    pass

Running the tests

If you have a cloned copy, run::

python3 runtests.py

Contributing

Contributions welcome! The project lives in the Github repo at thinkwelltwd/unpoly_django repository.

Bug reports and feature requests can be filed on the repository's issue tracker.

License

Released under the MIT License. There's should be a LICENSE file in the root of the repository.

The MIT License (MIT) Copyright (c) 2021, Dave Burkholder

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Change history for unpoly_django

0.1.0 ^^^^^^

• Initial release.