carlegbert / flask-jwt-extended

A Flask JWT extension that supports refresh tokens, blacklisting/revoking tokens, and token freshness (for accessing critical views)

Flask-JWT-Extended

Flask-JWT-Extended adds support for using JSON Web Tokens (JWT) to Flask for protecting views.

This has several optional features built it to make working with JSON Web Tokens easier. These include:

• Support for adding custom claims to JSON Web Tokens
• Refresh tokens
• Token freshness and separate view decorators to only allow fresh tokens
• Token revoking
• Storing tokens in cookies and CSRF protection

Installation

View Installation Instructions

Usage

View the documentation online

Chatting

We are on irc! You can come chat with us in the #flask-jwt-extended channel on freenode.

Testing and Code Coverage

We require 100% code coverage in our unit tests. We run all the unit tests with tox, which will test against python2.7, 3.3, 3.4, 3.5 and 3.6. Running tox will print out a code coverage report

$ tox

Generating Documentation

You can generate a local copy of the documentation. First, make sure you have the flask sphinx theme cloned

$ git submodule update --init

Then, in the docs directory, run

$ make clean && make html