functions for JWT validation 🛡️

Author: RobertoPrevato

.github/workflows/build.yml

@@ -18,8 +18,9 @@ jobs:
   build:
     runs-on: ubuntu-18.04
     strategy:
+      fail-fast: false
       matrix:
-        python-version: [3.6, 3.7, 3.8, 3.9]
+        python-version: [3.6, 3.7, 3.8, 3.9, "3.10"]
 
     steps:
       - uses: actions/checkout@v1
@@ -47,9 +48,20 @@ jobs:
         run: |
           pip install -U --no-index --find-links=deps deps/*
 
+      - name: Run linters
+        run: |
+          echo "Running linters - if build fails here, please be patient! Feel free to ask for assistance."
+
+          flake8 $PROJECT_NAME
+          flake8 tests
+          isort --check-only $PROJECT_NAME 2>&1
+          isort --check-only tests 2>&1
+          black --check $PROJECT_NAME 2>&1
+          black --check tests 2>&1
+
       - name: Run tests
         run: |
-          flake8 && pytest --doctest-modules --junitxml=junit/pytest-results-${{ matrix.python-version }}.xml --cov=$PROJECT_NAME --cov-report=xml tests/
+          pytest --doctest-modules --junitxml=junit/pytest-results-${{ matrix.python-version }}.xml --cov=$PROJECT_NAME --cov-report=xml tests/
 
       - name: Upload pytest test results
         uses: actions/upload-artifact@master

.isort.cfg

@@ -0,0 +1,3 @@
+[settings]
+profile = black
+multi_line_output = 3

CHANGELOG.md

@@ -5,8 +5,11 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [0.0.8] - 2021-05-??
+## [0.0.8] - 2021-10-31 :shield:
+- Adds classes to handle `JWT`s validation, but only for `RSA` keys
 - Fixes issue (wrong arrangement in test) #5
+- Includes `Python 3.10` in the CI/CD matrix
+- Enforces `black` and `isort` in the CI pipeline
 
 ## [0.0.7] - 2021-01-31 :grapes:
 - Corrects a bug in the `Policy` class (#2)

README.md

@@ -12,6 +12,12 @@ in any kind of Python application.
 pip install guardpost
 ```
 
+To install with support for `JSON Web Tokens (JWTs)` validation:
+
+```
+pip install guardpost[jwt]
+```
+
 This library is freely inspired by [authorization in ASP.NET
 Core](https://docs.microsoft.com/en-us/aspnet/core/security/authorization/policies?view=aspnetcore-2.2);
 although its implementation is extremely different.

guardpost/__init__.py

@@ -1,8 +1,8 @@
-from .authentication import User, Identity
+from .authentication import Identity, User
 from .authorization import (
+    AuthorizationError,
+    BaseRequirement,
     Policy,
     PolicyNotFoundError,
-    AuthorizationError,
     UnauthorizedError,
-    BaseRequirement,
 )

guardpost/asynchronous/authentication.py

@@ -1,9 +1,10 @@
 from abc import abstractmethod
 from typing import Any, Optional, Sequence
+
 from guardpost.authentication import (
-    Identity,
     BaseAuthenticationHandler,
     BaseAuthenticationStrategy,
+    Identity,
 )
 
 

guardpost/asynchronous/authorization.py

@@ -1,14 +1,15 @@
-from functools import wraps
 from abc import abstractmethod
+from functools import wraps
 from typing import Dict, Optional
+
 from guardpost.authentication import Identity
 from guardpost.authorization import (
+    AuthorizationContext,
+    BaseAuthorizationStrategy,
+    BaseRequirement,
     Policy,
     PolicyNotFoundError,
-    AuthorizationContext,
     UnauthorizedError,
-    BaseRequirement,
-    BaseAuthorizationStrategy,
 )
 from guardpost.funchelper import args_to_dict_getter
 from guardpost.synchronous.authorization import Requirement as SyncRequirement

guardpost/authorization.py

@@ -1,5 +1,6 @@
 from abc import ABC
-from typing import Sequence, Optional, List, Dict, Callable
+from typing import Callable, Dict, List, Optional, Sequence
+
 from guardpost.authentication import Identity
 
 

guardpost/errors.py

@@ -0,0 +1,6 @@
+class AuthException(Exception):
+    """Base class for all exception risen by the library."""
+
+
+class UnsupportedFeatureError(AuthException):
+    """Exception risen for unsupported features."""

guardpost/funchelper.py

@@ -1,5 +1,5 @@
-from typing import Tuple, Dict, Callable
 from inspect import Signature
+from typing import Callable, Dict, Tuple
 
 
 def args_to_dict_getter(method: Callable):