Skip to main content

Impose authorization requirements on Flask routes

Project description

.. image:: https://travis-ci.org/justanr/flask-allows.svg?branch=master
:target: https://travis-ci.org/justanr/flask-allows

.. image:: https://coveralls.io/repos/github/justanr/flask-allows/badge.svg?branch=master
:target: https://coveralls.io/github/justanr/flask-allows?branch=master



flask-allows
============

Are you permissions making too much noise all the time? Are your permissions
stomping all over your actual code? Are your permission decorators clawing
at your line count all the time? Think there's no answer? There is! Flask-Allows.


Flask-Allows is an authorization tool for Flask inspired by
`django-rest-framework <https://github.com/tomchristie/django-rest-framework>`_'s
permissioning system and `rest_condition <https://github.com/caxap/rest_condition>`_'s
ability to compose simple requirements into more complex ones.

Installation
------------

Flask-Allows is available on `pypi <https://pypi.org/project/flask-allows/>`_ and
installable with::

pip install flask-allows

Flask Allows supports 2.7, and 3.4+. Support for 3.3 was ended in the version
0.3 release.

.. note::

If you are installing ``flask-allows`` outside of a virtual environment,
consider installing it with ``pip install --user flask-allows`` rather
than using sudo or adminstrator privileges to avoid installing it into
your system Python.


More Information
----------------

- For more information, `please visit the documentation <https://flask-allows.readthedocs.io/en/latest/>`_.
- Found a bug, have a question, or want to request a feature? Here is our `issue tracker <https://github.com/justanr/flask-allows/issues>`_.
- Need the source code? Here is the `repository <https://github.com/justanr/flask-allows>`_


Change Log
==========


Version 0.5 (2018-04-17)
------------------------

* Real documentation
* Accepting request in requirements is now deprecated, pending removal in
1.0
* Promoted internal ``_allows`` context local to part of the public interface
* Bug Fix: ConditionalRequirement returned False when no requirements were provided
it now returns True and mimics the behavior of ``all`` better


Version 0.4 (2017-08-29)
------------------------

* Clarify deprecation message for PermissionedView, will be removed in 0.6
* Deprecate Permission.throw_type for 0.6 removak
* Add optional on_fail for `allows.requires` and `requires` decoration
* Fix coverage path problem with local testing

Version 0.3.2 (2017-08-29)
--------------------------

* Fix package data not being included


Version 0.3.1 (2017-08-20)
--------------------------

* Fix error that prevent sdist builds on 2.7


Version 0.3 (2017-08-20)
------------------------

* Drop official support for Python 3.3
* Deprecate implicit decoration on class based views via the requirements attribute


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

flask-allows-0.5.1.tar.gz (7.8 kB view hashes)

Uploaded Source

Built Distribution

flask_allows-0.5.1-py2.py3-none-any.whl (8.4 kB view hashes)

Uploaded Python 2 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