Add a name on every route #762 (#774)

* Names for urls added

* Tests for Login/Logout Names

* Register Name Test

* tests/test_router_reset.py

* Tests to verify url names in users router

* Test Verify Router Names

* oauth routes updated with prefix

* Test for authorize.  Didn't right test for callback as covered under other tests

fastapi_users/router/auth.py

@@ -19,7 +19,7 @@ def get_auth_router(
         active=True, verified=requires_verification
     )
 
-    @router.post("/login")
+    @router.post("/login", name="auth:login")
     async def login(
         response: Response,
         credentials: OAuth2PasswordRequestForm = Depends(),
@@ -41,7 +41,7 @@ def get_auth_router(
 
     if backend.logout:
 
-        @router.post("/logout")
+        @router.post("/logout", name="auth:logout")
         async def logout(
             response: Response,
             user=Depends(get_current_user),

fastapi_users/router/oauth.py

@@ -30,7 +30,7 @@ def get_oauth_router(
 ) -> APIRouter:
     """Generate a router with the OAuth routes."""
     router = APIRouter()
-    callback_route_name = f"{oauth_client.name}-callback"
+    callback_route_name = f"oauth:{oauth_client.name}-callback"
 
     if redirect_url is not None:
         oauth2_authorize_callback = OAuth2AuthorizeCallback(
@@ -43,7 +43,7 @@ def get_oauth_router(
             route_name=callback_route_name,
         )
 
-    @router.get("/authorize")
+    @router.get("/authorize", name="oauth:authorize")
     async def authorize(
         request: Request,
         authentication_backend: str,
@@ -74,7 +74,7 @@ def get_oauth_router(
 
         return {"authorization_url": authorization_url}
 
-    @router.get("/callback", name=f"{oauth_client.name}-callback")
+    @router.get("/callback", name=f"oauth:{oauth_client.name}-callback")
     async def callback(
         request: Request,
         response: Response,

fastapi_users/router/register.py

@@ -21,7 +21,7 @@ def get_register_router(
     router = APIRouter()
 
     @router.post(
-        "/register", response_model=user_model, status_code=status.HTTP_201_CREATED
+        "/register", response_model=user_model, status_code=status.HTTP_201_CREATED, name="register:register"
     )
     async def register(
         request: Request,

fastapi_users/router/reset.py

@@ -19,7 +19,7 @@ def get_reset_password_router(
     """Generate a router with the reset password routes."""
     router = APIRouter()
 
-    @router.post("/forgot-password", status_code=status.HTTP_202_ACCEPTED)
+    @router.post("/forgot-password", status_code=status.HTTP_202_ACCEPTED, name="reset:forgot_password")
     async def forgot_password(
         request: Request,
         email: EmailStr = Body(..., embed=True),
@@ -37,7 +37,7 @@ def get_reset_password_router(
 
         return None
 
-    @router.post("/reset-password")
+    @router.post("/reset-password", name="reset:reset_password")
     async def reset_password(
         request: Request,
         token: str = Body(...),

fastapi_users/router/users.py

@@ -42,7 +42,7 @@ def get_users_router(
         except UserNotExists:
             raise HTTPException(status_code=status.HTTP_404_NOT_FOUND)
 
-    @router.get("/me", response_model=user_model)
+    @router.get("/me", response_model=user_model, name="users:current_user")
     async def me(
         user: user_db_model = Depends(get_current_active_user),  # type: ignore
     ):
@@ -52,6 +52,7 @@ def get_users_router(
         "/me",
         response_model=user_model,
         dependencies=[Depends(get_current_active_user)],
+        name="users:current_user"
     )
     async def update_me(
         request: Request,
@@ -81,6 +82,7 @@ def get_users_router(
         "/{id:uuid}",
         response_model=user_model,
         dependencies=[Depends(get_current_superuser)],
+        name="users:user"
     )
     async def get_user(user=Depends(get_user_or_404)):
         return user
@@ -89,6 +91,7 @@ def get_users_router(
         "/{id:uuid}",
         response_model=user_model,
         dependencies=[Depends(get_current_superuser)],
+        name="users:user"
     )
     async def update_user(
         user_update: user_update_model,  # type: ignore
@@ -119,6 +122,7 @@ def get_users_router(
         status_code=status.HTTP_204_NO_CONTENT,
         response_class=Response,
         dependencies=[Depends(get_current_superuser)],
+        name="users:user"
     )
     async def delete_user(
         user=Depends(get_user_or_404),

fastapi_users/router/verify.py

@@ -21,7 +21,7 @@ def get_verify_router(
 ):
     router = APIRouter()
 
-    @router.post("/request-verify-token", status_code=status.HTTP_202_ACCEPTED)
+    @router.post("/request-verify-token", status_code=status.HTTP_202_ACCEPTED, name="verify:request-token")
     async def request_verify_token(
         request: Request,
         email: EmailStr = Body(..., embed=True),
@@ -35,7 +35,7 @@ def get_verify_router(
 
         return None
 
-    @router.post("/verify", response_model=user_model)
+    @router.post("/verify", response_model=user_model, name="verify:verify")
     async def verify(
         request: Request,
         token: str = Body(..., embed=True),