1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51
|
# Flask-JWT-Simple
[](https://travis-ci.org/vimalloc/flask-jwt-simple)
[](https://coveralls.io/github/vimalloc/flask-jwt-simple)
[](https://badge.fury.io/py/Flask-JWT-Simple)
[](http://flask-jwt-simple.readthedocs.io/en/latest/)
### When to use Flask-JWT-Simple?
Flask-JWT-Simple adds barebones support for protecting flask endpoints
with JSON Web Tokens. It is particularly good for fast prototyping or
consuming/producing JWTs that work with other providers and consumers.
### When *not* to use Flask-JWT-Simple?
If you are using JWTs with just your flask application, it may make more
sense to use the sister extension [Flask-JWT-Extended](https://github.com/vimalloc/flask-jwt-extended).
It provides several built in features to make working with JSON Web Tokens
easier. These include refresh tokens, fresh/unfresh tokens, tokens in cookies,
csrf protection when using cookies, and token revoking. The drawback is that
extension is a more opinionated on what needs to be in the JWT in order
to get all those extra features to work.
### Installation
[View Installation Instructions](http://flask-jwt-simple.readthedocs.io/en/latest/installation.html)
### Usage
[View the documentation online](http://flask-jwt-simple.readthedocs.io/en/latest/)
### 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. You can run the tests locally
with `tox` which will print out a code coverage report. Creating a pull request
will run the tests against python 2.7, 3.3, 3,4, 3,5, 3,6, and PyPy.
```
$ 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
```
|