/flask-jwt-extended

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

Primary LanguagePythonMIT LicenseMIT

Flask-JWT-Extended

Build Status Coverage Status PyPI version Documentation Status

Why 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

Upgrading to the 3.x.x releases

See here for help upgrading to the 3.x.x releases.

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. After installing the requirements, go to the docs directory and run:

$ make clean && make html