Metadata-Version: 2.0
Name: django-decorator-plus
Version: 0.0.1a2
Summary: Extra decorators for your Django project.
Home-page: https://github.com/jambonrose/django-decorator-plus
Author: Andrew Pinkham
Author-email: hello at andrewsforge dot com
License: Simplified BSD License
Keywords: django,decorator,http
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Framework :: Django :: 1.7
Classifier: Framework :: Django :: 1.8
Requires-Dist: Django (>=1.7)

`Package Documentation`_

Description
===========

This package provides decorators to make building websites in Django
even easier.

Installation
============

.. code:: console

    $ pip install django-decorator-plus

Basic Usage
===========

The package currently supplies decorators to improve your views.

View Decorators
---------------

The view decorators provided are meant to restrict the HTTP methods
allowed on a view. The ``require_safe_methods`` limits views to ``GET``
and ``HEAD`` and generates a proper response for ``OPTIONS``.

.. code-block:: python

    from decorator_plus import require_safe_methods

    @require_safe_methods
    def function_view_safe(request):
        ...

The package also supplies the ``require_form_methods`` decorator, which
limits views to ``GET``, ``HEAD``, and ``POST``. Both of these
decorators are actually just shortcuts on top of the
``require_http_methods()`` decorator, which is an enhanced version of
the `decorator supplied by Django`_ by the same name; the
``require_http_methods()`` decorator automatically supplies the
``OPTIONS`` HTTP method, and will automatically add the ``HEAD`` HTTP
method if the ``GET`` method is allowed.

For more information and examples, please see the full `Package
Documentation`_.

.. _`decorator supplied by Django`: https://docs.djangoproject.com/en/stable/topics/http/decorators/#django.views.decorators.http.require_http_methods
.. _`Package Documentation`: https://django-decorator-plus.readthedocs.org


