Refactor user endpoint tests to include pagination and response structure validation

- Updated tests for listing users to validate pagination and response format.
- Changed mock return values to include total count and pagination details.
- Refactored user creation mocks for clarity and consistency.
- Enhanced assertions to check for presence of pagination fields in responses.
- Adjusted test cases for user retrieval and updates to ensure proper handling of user data.
- Improved readability by restructuring mock definitions and assertions across various test files.

app/api/v1/admin/users.py

@@ -10,7 +10,7 @@ from app.core.dependencies import get_admin_user
 from app.models.plan import Plan
 from app.models.user import User
 from app.repositories.plan import PlanRepository
-from app.repositories.user import UserRepository, UserSortField, SortOrder, UserStatus
+from app.repositories.user import SortOrder, UserRepository, UserSortField, UserStatus
 from app.schemas.auth import UserResponse
 from app.schemas.user import UserUpdate
 
@@ -36,21 +36,27 @@ def _user_to_response(user: User) -> UserResponse:
             "name": user.plan.name,
             "max_credits": user.plan.max_credits,
             "features": [],  # Add features if needed
-        } if user.plan else {},
+        }
+        if user.plan
+        else {},
         created_at=user.created_at,
         updated_at=user.updated_at,
     )
 
 
 @router.get("/")
-async def list_users(
+async def list_users(  # noqa: PLR0913
     session: Annotated[AsyncSession, Depends(get_db)],
     page: Annotated[int, Query(description="Page number", ge=1)] = 1,
     limit: Annotated[int, Query(description="Items per page", ge=1, le=100)] = 50,
     search: Annotated[str | None, Query(description="Search in name or email")] = None,
-    sort_by: Annotated[UserSortField, Query(description="Sort by field")] = UserSortField.NAME,
+    sort_by: Annotated[
+        UserSortField, Query(description="Sort by field"),
+    ] = UserSortField.NAME,
     sort_order: Annotated[SortOrder, Query(description="Sort order")] = SortOrder.ASC,
-    status_filter: Annotated[UserStatus, Query(description="Filter by status")] = UserStatus.ALL,
+    status_filter: Annotated[
+        UserStatus, Query(description="Filter by status"),
+    ] = UserStatus.ALL,
 ) -> dict[str, Any]:
     """Get all users with pagination, search, and filters (admin only)."""
     user_repo = UserRepository(session)
@@ -62,9 +68,9 @@ async def list_users(
         sort_order=sort_order,
         status_filter=status_filter,
     )
-    
+
     total_pages = (total_count + limit - 1) // limit  # Ceiling division
-    
+
     return {
         "users": [_user_to_response(user) for user in users],
         "total": total_count,