METADATA 3.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113
  1. Metadata-Version: 2.1
  2. Name: Flask-JWT-Extended
  3. Version: 4.7.1
  4. Summary: Extended JWT integration with Flask
  5. Home-page: https://github.com/vimalloc/flask-jwt-extended
  6. Author: Lily Acadia Gilbert
  7. Author-email: lily.gilbert@hey.com
  8. License: MIT
  9. Keywords: flask,jwt,json web token
  10. Platform: any
  11. Classifier: Development Status :: 5 - Production/Stable
  12. Classifier: Environment :: Web Environment
  13. Classifier: Framework :: Flask
  14. Classifier: Intended Audience :: Developers
  15. Classifier: License :: OSI Approved :: MIT License
  16. Classifier: Operating System :: OS Independent
  17. Classifier: Programming Language :: Python
  18. Classifier: Programming Language :: Python :: 3
  19. Classifier: Programming Language :: Python :: 3 :: Only
  20. Classifier: Programming Language :: Python :: 3.6
  21. Classifier: Programming Language :: Python :: 3.7
  22. Classifier: Programming Language :: Python :: 3.8
  23. Classifier: Programming Language :: Python :: 3.9
  24. Classifier: Programming Language :: Python :: 3.10
  25. Classifier: Programming Language :: Python :: 3.11
  26. Classifier: Programming Language :: Python :: 3.12
  27. Classifier: Programming Language :: Python :: Implementation :: CPython
  28. Classifier: Programming Language :: Python :: Implementation :: PyPy
  29. Classifier: Topic :: Software Development :: Libraries :: Python Modules
  30. Requires-Python: >=3.9,<4
  31. Description-Content-Type: text/markdown
  32. License-File: LICENSE
  33. Requires-Dist: Werkzeug>=0.14
  34. Requires-Dist: Flask<4.0,>=2.0
  35. Requires-Dist: PyJWT<3.0,>=2.0
  36. Provides-Extra: asymmetric-crypto
  37. Requires-Dist: cryptography>=3.3.1; extra == "asymmetric-crypto"
  38. # Flask-JWT-Extended
  39. ### Features
  40. Flask-JWT-Extended not only adds support for using JSON Web Tokens (JWT) to Flask for protecting routes,
  41. but also many helpful (and **optional**) features built in to make working with JSON Web Tokens
  42. easier. These include:
  43. - Adding custom claims to JSON Web Tokens
  44. - Automatic user loading (`current_user`).
  45. - Custom claims validation on received tokens
  46. - [Refresh tokens](https://auth0.com/blog/refresh-tokens-what-are-they-and-when-to-use-them/)
  47. - First class support for fresh tokens for making sensitive changes.
  48. - Token revoking/blocklisting
  49. - Storing tokens in cookies and CSRF protection
  50. ### Usage
  51. [View the documentation online](https://flask-jwt-extended.readthedocs.io/en/stable/)
  52. ### Upgrading from 3.x.x to 4.0.0
  53. [View the changes](https://flask-jwt-extended.readthedocs.io/en/stable/v4_upgrade_guide/)
  54. ### Changelog
  55. You can view the changelog [here](https://github.com/vimalloc/flask-jwt-extended/releases).
  56. This project follows [semantic versioning](https://semver.org/).
  57. ### Chatting
  58. Come chat with the community or ask questions at https://discord.gg/EJBsbFd
  59. ### Contributing
  60. Before making any changes, make sure to install the development requirements
  61. and setup the git hooks which will automatically lint and format your changes.
  62. ```bash
  63. pip install -r requirements.txt
  64. pre-commit install
  65. ```
  66. We require 100% code coverage in our unit tests. You can run the tests locally
  67. with `tox` which ensures that all tests pass, tests provide complete code coverage,
  68. documentation builds, and style guide are adhered to
  69. ```bash
  70. tox
  71. ```
  72. A subset of checks can also be ran by adding an argument to tox. The available
  73. arguments are:
  74. - py37, py38, py39, py310, py311, py312, pypy3
  75. - Run unit tests on the given python version
  76. - mypy
  77. - Run mypy type checking
  78. - coverage
  79. - Run a code coverage check
  80. - docs
  81. - Ensure documentation builds and there are no broken links
  82. - style
  83. - Ensure style guide is adhered to
  84. ```bash
  85. tox -e py38
  86. ```
  87. We also require features to be well documented. You can generate a local copy
  88. of the documentation by going to the `docs` directory and running:
  89. ```bash
  90. make clean && make html && open _build/html/index.html
  91. ```