Changed documentation to the new middleware. Upgraded version to 0.1.4

HISTORY.md

@@ -1,5 +1,10 @@
 # HISTORY
 
+## 0.1.4
+
+Supports now starlette>=0.9.3 and uses the AuthenticationMiddleware.
+This package must use starletter>=0.9.3
+
 ## 0.1.3
 
 Release for Starlette 0.9.x

README.md

@@ -27,11 +27,12 @@ Register the Middleware with your app.
 
 ```python
 from starlette.applications import Starlette
-from starlette_jwt import JWTAuthenticationMiddleware, authentication_required, anonymous_allowed
-
+from starlette_jwt import JWTAuthenticationBackend
+from starlette.middleware.authentication import AuthenticationMiddleware
 
 app = Starlette()
-app.add_middleware(JWTAuthenticationMiddleware, secret_key='secret', prefix='JWT')
+app.add_middleware(AuthenticationMiddleware, backend=JWTAuthenticationBackend(secret_key='secret', prefix='JWT'))
+
 ```
 
 Access the JWT payload in a request,
@@ -42,17 +43,18 @@ The `@authentication_required` decorator will enforce the user to be logged in f
 The default behavior is `@anonymous_allowed` so your code be explicit.
 
 ```python
+from starlette.authentication import requires
+
 def my_handler(request):
 @app.route('/noauth')
-@authentication_required
+@requires('authenticated')
 async def homepage(request):
     return JSONResponse({'payload': request.session})
 ```
 
 Not all handlers must be with authentication
 ```python
 @app.route('/noauth')
-@anonymous_allowed
 async def homepage(request):
     return JSONResponse({'payload': None})
 ```
@@ -63,15 +65,23 @@ async def homepage(request):
 
 Store your secret key in this setting while creating the middleware:
 ```python
-app.add_middleware(JWTAuthenticationMiddleware, secret_key='MY SECRET KEY')
+app.add_middleware(AuthenticationMiddleware, backend=JWTAuthenticationBackend(secret_key='MY SECRET KEY'))
 ```
 
 *prefix*
 
 Change the Authorization header prefix string (defualts to "JWT"):
 ```python
 # Example: changes the prefix to Bearer
-app.add_middleware(JWTAuthenticationMiddleware, secret_key='secret', prefix='Bearer')
+app.add_middleware(AuthenticationMiddleware, backend=JWTAuthenticationBackend(secret_key='secret', prefix='Bearer'))
+```
+
+*username_field*
+
+The user name field in the JWT token payload:
+```python
+# Example: changes the username field to "user"
+app.add_middleware(AuthenticationMiddleware, backend=JWTAuthenticationBackend(secret_key='secret', username_field='user'))
 ```
 
 ## Todo

setup.py

@@ -27,7 +27,7 @@
 
 setup(
     name='starlette_jwt',
-    version='0.1.3',
+    version='0.1.4',
     description="A JSON Web Token Middleware for Starlette",
     long_description=readme,
     author="Amit Ripshtos",