codemie-sdk-python 0.1.440__tar.gz → 0.1.446__tar.gz

{codemie_sdk_python-0.1.440 → codemie_sdk_python-0.1.446}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: codemie-sdk-python
-Version: 0.1.440
+Version: 0.1.446
 Summary: CodeMie SDK for Python
 Author: Vadym Vlasenko
 Author-email: vadym_vlasenko@epam.com

{codemie_sdk_python-0.1.440 → codemie_sdk_python-0.1.446}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "codemie-sdk-python"
-version = "0.1.440"
+version = "0.1.446"
 description = "CodeMie SDK for Python"
 authors = [
     "Vadym Vlasenko <vadym_vlasenko@epam.com>",

codemie_sdk_python-0.1.446/src/codemie_sdk/models/user.py

@@ -0,0 +1,123 @@
+"""Models for user-related data structures."""
+
+from typing import List, Optional
+
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class PaginationInfo(BaseModel):
+    model_config = ConfigDict(extra="ignore")
+
+    total: int
+    page: int
+    per_page: int
+
+
+class AdminUserListItem(BaseModel):
+    model_config = ConfigDict(extra="ignore")
+
+    id: str
+    username: str
+    email: str
+    name: Optional[str] = None
+    user_type: Optional[str] = None
+    is_active: bool
+    is_admin: bool
+    is_maintainer: bool = False
+    auth_source: Optional[str] = None
+    last_login_at: Optional[str] = None
+    date: Optional[str] = None
+
+
+class PaginatedUserListResponse(BaseModel):
+    model_config = ConfigDict(extra="ignore")
+
+    data: List[AdminUserListItem]
+    pagination: PaginationInfo
+
+
+class AdminUserProjectInfo(BaseModel):
+    model_config = ConfigDict(extra="ignore")
+
+    name: str
+    is_project_admin: bool = False
+
+
+class CodeMieUserDetail(BaseModel):
+    model_config = ConfigDict(extra="ignore")
+
+    id: str
+    username: str
+    email: str
+    name: Optional[str] = None
+    picture: Optional[str] = None
+    user_type: Optional[str] = None
+    is_active: bool
+    is_admin: bool
+    is_maintainer: bool = False
+    auth_source: Optional[str] = None
+    email_verified: bool = False
+    last_login_at: Optional[str] = None
+    projects: List[AdminUserProjectInfo] = []
+    project_limit: Optional[int] = None
+    knowledge_bases: List[str] = []
+    date: Optional[str] = None
+    update_date: Optional[str] = None
+    deleted_at: Optional[str] = None
+
+
+class AdminUserProject(BaseModel):
+    model_config = ConfigDict(extra="ignore")
+
+    project_name: str
+    is_project_admin: bool = False
+    date: Optional[str] = None
+
+
+class UserProjectsResponse(BaseModel):
+    model_config = ConfigDict(extra="ignore")
+
+    projects: List[AdminUserProject] = []
+
+
+class User(BaseModel):
+    """Model representing a user profile."""
+
+    model_config = ConfigDict(populate_by_name=True, extra="ignore")
+
+    user_id: str = Field(
+        description="Unique identifier of the user", validation_alias="userId"
+    )
+    name: str = Field(description="Full name of the user")
+    username: str = Field(description="Username for authentication")
+    email: str = Field(description="User email")
+    is_admin: bool = Field(
+        description="Whether the user has admin privileges", validation_alias="isAdmin"
+    )
+    applications: list[str] = Field(
+        default_factory=list, description="List of applications the user has access to"
+    )
+    applications_admin: list[str] = Field(
+        default_factory=list,
+        description="List of applications where user has admin rights",
+        validation_alias="applicationsAdmin",
+    )
+    picture: str = Field(default="", description="URL to user's profile picture")
+    knowledge_bases: list[str] = Field(
+        default_factory=list,
+        description="List of knowledge bases the user has access to",
+        validation_alias="knowledgeBases",
+    )
+
+
+class UserData(BaseModel):
+    """Model representing user data."""
+
+    model_config = ConfigDict(populate_by_name=True, extra="ignore")
+
+    id: str | None = Field(
+        default=None, description="Unique identifier of the user data record"
+    )
+    date: str | None = Field(default=None, description="Creation timestamp")
+    update_date: str | None = Field(default=None, description="Last update timestamp")
+    user_id: str | None = Field(default=None, description="Associated user identifier")

codemie_sdk_python-0.1.446/src/codemie_sdk/services/user.py

@@ -0,0 +1,172 @@
+"""User service implementation."""
+
+from typing import Any, Dict, List, Optional
+
+from ..models.user import (
+    AdminUserProject,
+    CodeMieUserDetail,
+    PaginatedUserListResponse,
+    User,
+    UserData,
+    UserProjectsResponse,
+)
+from ..utils.http import ApiRequestHandler, TokenSource
+
+
+class UserService:
+    """Service for managing user profile and preferences."""
+
+    def __init__(self, api_domain: str, token: TokenSource, verify_ssl: bool = True):
+        """Initialize the User service.
+
+        Args:
+            api_domain: Base URL for the CodeMie API
+            token: Authentication token
+            verify_ssl: Whether to verify SSL certificates. Default: True
+        """
+        self._api = ApiRequestHandler(api_domain, token, verify_ssl)
+
+    def about_me(self) -> User:
+        """Get current user profile.
+
+        Returns:
+            User profile information
+        """
+        return self._api.get("/v1/user", User, wrap_response=False)
+
+    def get_data(self) -> UserData:
+        """Get user data and preferences.
+
+        Returns:
+            User data and preferences
+        """
+        return self._api.get("/v1/user/data", UserData, wrap_response=False)
+
+    def list_admin_users(
+        self,
+        page: int = 0,
+        per_page: int = 20,
+        search: Optional[str] = None,
+        filters: Optional[str] = None,
+    ) -> PaginatedUserListResponse:
+        """List all users with pagination and filtering (admin only).
+
+        Args:
+            page: Page number (0-indexed)
+            per_page: Results per page (10, 20, 50, or 100)
+            search: Search string matching email, username, or name
+            filters: Stringified JSON with filter keys: projects, user_type, is_active, platform_role, budgets
+        """
+        params: Dict[str, Any] = {"page": page, "per_page": per_page}
+        if search is not None:
+            params["search"] = search
+        if filters is not None:
+            params["filters"] = filters
+        return self._api.get(
+            "/v1/admin/users",
+            PaginatedUserListResponse,
+            params=params,
+            wrap_response=False,
+        )
+
+    def get_admin_user(self, user_id: str) -> CodeMieUserDetail:
+        """Get full details for a specific user (admin only).
+
+        Args:
+            user_id: The user's unique identifier
+        """
+        return self._api.get(
+            f"/v1/admin/users/{user_id}", CodeMieUserDetail, wrap_response=False
+        )
+
+    def update_admin_user(self, user_id: str, **kwargs: Any) -> CodeMieUserDetail:
+        """Update editable fields of a user (SuperAdmin only).
+
+        Args:
+            user_id: The user's unique identifier
+            **kwargs: Fields to update (name, picture, is_admin, is_maintainer, is_active, project_limit, etc.)
+        """
+        return self._api.put(
+            f"/v1/admin/users/{user_id}",
+            CodeMieUserDetail,
+            json_data=kwargs,
+            wrap_response=False,
+        )
+
+    def get_user_projects(self, user_id: str) -> List[AdminUserProject]:
+        """Get a user's project memberships (admin only).
+
+        Args:
+            user_id: The user's unique identifier
+        """
+        response = self._api.get(
+            f"/v1/admin/users/{user_id}/projects",
+            UserProjectsResponse,
+            wrap_response=False,
+        )
+        return response.projects
+
+    def assign_user_to_project(
+        self,
+        user_id: str,
+        project_name: str,
+        is_project_admin: bool = False,
+    ) -> dict:
+        """Grant a user access to a project (SuperAdmin only).
+
+        Args:
+            user_id: The user's unique identifier
+            project_name: Name of the project to grant access to
+            is_project_admin: Whether the user should be a project admin
+        """
+        return self._api.post(
+            f"/v1/admin/users/{user_id}/projects",
+            dict,
+            json_data={
+                "project_name": project_name,
+                "is_project_admin": is_project_admin,
+            },
+            wrap_response=False,
+        )
+
+    def remove_user_from_project(self, user_id: str, project_name: str) -> None:
+        """Remove a user's access to a project (SuperAdmin only).
+
+        Args:
+            user_id: The user's unique identifier
+            project_name: Name of the project to remove access from
+        """
+        self._api.delete(
+            f"/v1/admin/users/{user_id}/projects/{project_name}",
+            dict,
+            wrap_response=False,
+        )
+
+    def update_user_project_role(
+        self, user_id: str, project_name: str, is_project_admin: bool
+    ) -> None:
+        """Change a user's role within a project (SuperAdmin only).
+
+        Args:
+            user_id: The user's unique identifier
+            project_name: Name of the project
+            is_project_admin: Whether the user should be a project admin
+        """
+        self._api.put(
+            f"/v1/admin/users/{user_id}/projects/{project_name}",
+            dict,
+            json_data={"is_project_admin": is_project_admin},
+            wrap_response=False,
+        )
+
+    def deactivate_user(self, user_id: str) -> None:
+        """Deactivate (soft-delete) a user (SuperAdmin only).
+
+        Args:
+            user_id: The user's unique identifier
+        """
+        self._api.delete(
+            f"/v1/admin/users/{user_id}",
+            dict,
+            wrap_response=False,
+        )

codemie_sdk_python-0.1.440/src/codemie_sdk/models/user.py

@@ -1,46 +0,0 @@
-"""Models for user-related data structures."""
-
-from pydantic import BaseModel, ConfigDict, Field
-
-
-class User(BaseModel):
-    """Model representing a user profile."""
-
-    model_config = ConfigDict(populate_by_name=True, extra="ignore")
-
-    user_id: str = Field(
-        description="Unique identifier of the user", validation_alias="userId"
-    )
-    name: str = Field(description="Full name of the user")
-    username: str = Field(description="Username for authentication")
-    email: str = Field(description="User email")
-    is_admin: bool = Field(
-        description="Whether the user has admin privileges", validation_alias="isAdmin"
-    )
-    applications: list[str] = Field(
-        default_factory=list, description="List of applications the user has access to"
-    )
-    applications_admin: list[str] = Field(
-        default_factory=list,
-        description="List of applications where user has admin rights",
-        validation_alias="applicationsAdmin",
-    )
-    picture: str = Field(default="", description="URL to user's profile picture")
-    knowledge_bases: list[str] = Field(
-        default_factory=list,
-        description="List of knowledge bases the user has access to",
-        validation_alias="knowledgeBases",
-    )
-
-
-class UserData(BaseModel):
-    """Model representing user data."""
-
-    model_config = ConfigDict(populate_by_name=True, extra="ignore")
-
-    id: str | None = Field(
-        default=None, description="Unique identifier of the user data record"
-    )
-    date: str | None = Field(default=None, description="Creation timestamp")
-    update_date: str | None = Field(default=None, description="Last update timestamp")
-    user_id: str | None = Field(default=None, description="Associated user identifier")

codemie_sdk_python-0.1.440/src/codemie_sdk/services/user.py

@@ -1,34 +0,0 @@
-"""User service implementation."""
-
-from ..models.user import User, UserData
-from ..utils.http import ApiRequestHandler, TokenSource
-
-
-class UserService:
-    """Service for managing user profile and preferences."""
-
-    def __init__(self, api_domain: str, token: TokenSource, verify_ssl: bool = True):
-        """Initialize the User service.
-
-        Args:
-            api_domain: Base URL for the CodeMie API
-            token: Authentication token
-            verify_ssl: Whether to verify SSL certificates. Default: True
-        """
-        self._api = ApiRequestHandler(api_domain, token, verify_ssl)
-
-    def about_me(self) -> User:
-        """Get current user profile.
-
-        Returns:
-            User profile information
-        """
-        return self._api.get("/v1/user", User, wrap_response=False)
-
-    def get_data(self) -> UserData:
-        """Get user data and preferences.
-
-        Returns:
-            User data and preferences
-        """
-        return self._api.get("/v1/user/data", UserData, wrap_response=False)