refactor: move auth.py into legacy and auth directories for soft merging

Author: kwonkwonn

changes/8353.enhance.md

@@ -0,0 +1 @@
+On perpose of soft merging for manager's auth apis, defining DTO's and actions, moving auth into seperated directory.

src/ai/backend/manager/api/auth/__init__.py

@@ -0,0 +1,32 @@
+"""
+Auth API package.
+
+Re-exports from auth.auth (legacy function-based handlers) for backward compatibility.
+"""
+
+from .auth import (  # noqa: F401
+    _extract_auth_params,
+    admin_required,
+    admin_required_for_method,
+    auth_middleware,
+    auth_required,
+    auth_required_for_method,
+    authorize,
+    check_date,
+    create_app,
+    generate_ssh_keypair,
+    get_role,
+    get_ssh_keypair,
+    sign_request,
+    signout,
+    signup,
+    superadmin_required,
+    superadmin_required_for_method,
+    test,
+    update_full_name,
+    update_password,
+    update_password_no_auth,
+    upload_ssh_keypair,
+    validate_ip,
+    whois_timezone_info,
+)

src/ai/backend/manager/api/auth.py src/ai/backend/manager/api/auth/auth.pysrc/ai/backend/manager/api/auth.py renamed to src/ai/backend/manager/api/auth/auth.py

@@ -1,3 +1,10 @@
+"""
+Legacy auth handlers (function-based).
+
+DEPRECATED: This module is preserved for regression testing only.
+Use ai.backend.manager.api.auth (class-based handlers) for production.
+"""
+
 from __future__ import annotations
 
 import functools
@@ -23,7 +30,7 @@
 from ai.backend.common import validators as tx
 from ai.backend.common.contexts.user import with_user
 from ai.backend.common.data.user.types import UserData, UserRole
-from ai.backend.common.dto.manager.auth.field import (
+from ai.backend.common.dto.manager.auth.types import (
     AuthResponseType,
     AuthSuccessResponse,
     AuthTokenType,
@@ -34,6 +41,8 @@
 from ai.backend.common.types import ReadableCIDR
 from ai.backend.logging import BraceStyleAdapter
 from ai.backend.logging.utils import with_log_context_fields
+from ai.backend.manager.api.types import CORSOptions, WebMiddleware
+from ai.backend.manager.api.utils import check_api_params, get_handler_attr, set_handler_attr
 from ai.backend.manager.errors.auth import (
     AuthorizationFailed,
     InvalidAuthParameters,
@@ -60,11 +69,8 @@
 )
 from ai.backend.manager.services.auth.actions.upload_ssh_keypair import UploadSSHKeypairAction
 
-from .types import CORSOptions, WebMiddleware
-from .utils import check_api_params, get_handler_attr, set_handler_attr
-
 if TYPE_CHECKING:
-    from .context import RootContext
+    from ai.backend.manager.api.context import RootContext
 
 log: Final = BraceStyleAdapter(logging.getLogger(__spec__.name))  # type: ignore[name-defined]
 

src/ai/backend/manager/api/legacy/__init__.py

@@ -0,0 +1,15 @@
+"""
+Legacy API handlers.
+
+This module contains old function-based handlers preserved for regression testing.
+These handlers should NOT be used in production - use the new class-based handlers instead.
+
+Contents:
+- auth: Legacy auth handlers (replaced by api/auth/ package)
+"""
+
+from __future__ import annotations
+
+from . import auth
+
+__all__ = ("auth",)