codemie-sdk-python 0.1.418__tar.gz → 0.1.419__tar.gz

{codemie_sdk_python-0.1.418 → codemie_sdk_python-0.1.419}/PKG-INFO

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

{codemie_sdk_python-0.1.418 → codemie_sdk_python-0.1.419}/pyproject.toml

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

{codemie_sdk_python-0.1.418 → codemie_sdk_python-0.1.419}/src/codemie_sdk/client/client.py

@@ -12,6 +12,7 @@ from ..services.datasource import DatasourceService
 from ..services.llm import LLMService
 from ..services.integration import IntegrationService
 from ..services.mermaid import MermaidService
+from ..services.project import ProjectService
 from ..services.skill import SkillService
 from ..services.task import TaskService
 from ..services.user import UserService
@@ -98,6 +99,9 @@ class CodeMieClient:
         self.integrations = IntegrationService(
             self._api_domain, self._token, verify_ssl=verify_ssl
         )
+        self.projects = ProjectService(
+            self._api_domain, self._token, verify_ssl=verify_ssl
+        )
         self.skills = SkillService(self._api_domain, self._token, verify_ssl=verify_ssl)
         self.tasks = TaskService(self._api_domain, self._token, verify_ssl=verify_ssl)
         self.users = UserService(self._api_domain, self._token, verify_ssl=verify_ssl)

codemie_sdk_python-0.1.419/src/codemie_sdk/models/project.py

@@ -0,0 +1,233 @@
+# Copyright 2026 EPAM Systems, Inc. ("EPAM")
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Project management models for the CodeMie SDK."""
+
+from datetime import datetime
+from typing import Literal, Optional
+from uuid import UUID
+
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class ProjectCounters(BaseModel):
+    """Resource counters for a project."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    assistants_count: int = 0
+    workflows_count: int = 0
+    integrations_count: int = 0
+    datasources_count: int = 0
+    skills_count: int = 0
+
+
+class ProjectMember(BaseModel):
+    """Project member with role."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    user_id: str
+    is_project_admin: bool
+    date: Optional[datetime] = None
+
+
+class ProjectListItem(BaseModel):
+    """Project list response item."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    name: str
+    description: Optional[str] = None
+    project_type: str
+    created_by: Optional[str] = None
+    user_count: int
+    admin_count: int
+    created_at: Optional[datetime] = None
+    counters: Optional[ProjectCounters] = None
+    cost_center_id: Optional[UUID] = None
+    cost_center_name: Optional[str] = None
+
+
+class PaginationInfo(BaseModel):
+    """Pagination metadata for list responses."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    total: int
+    page: int
+    per_page: int
+
+
+class PaginatedProjectListResponse(BaseModel):
+    """Paginated project list response."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    data: list[ProjectListItem]
+    pagination: PaginationInfo
+
+
+class ProjectDetailResponse(BaseModel):
+    """Project detail response with member list."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    name: str
+    description: Optional[str] = None
+    project_type: str
+    created_by: Optional[str] = None
+    user_count: int
+    admin_count: int
+    created_at: Optional[datetime] = None
+    cost_center_id: Optional[UUID] = None
+    cost_center_name: Optional[str] = None
+    members: list[ProjectMember]
+
+
+class ProjectCreateRequest(BaseModel):
+    """Request to create a new project."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    name: str
+    description: str = Field(description="Project description")
+    cost_center_id: Optional[UUID] = None
+
+
+class ProjectCreateResponse(BaseModel):
+    """Response after creating a project."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    name: str
+    description: str
+    project_type: str
+    created_by: str
+    created_at: datetime
+    cost_center_id: Optional[UUID] = None
+    cost_center_name: Optional[str] = None
+
+
+# PATCH /v1/projects/{name} returns the same shape as the create response
+ProjectUpdateResponse = ProjectCreateResponse
+
+
+class ProjectUpdateRequest(BaseModel):
+    """Request to update a project."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    name: Optional[str] = None
+    description: Optional[str] = None
+    cost_center_id: Optional[UUID] = None
+    clear_cost_center: bool = False
+
+
+class ProjectDeleteResponse(BaseModel):
+    """Response after deleting a project."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    message: str
+    name: str
+
+
+class ProjectAssignmentRequest(BaseModel):
+    """Request to assign a user to a project."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    user_id: str
+    is_project_admin: bool
+
+
+class ProjectAssignmentUpdateRequest(BaseModel):
+    """Request to update a user's project role."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    is_project_admin: bool
+
+
+class ProjectAssignmentResponse(BaseModel):
+    """Response after project assignment operation."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    message: str
+    user_id: str
+    project_name: str
+    is_project_admin: Optional[bool] = None
+
+
+class BulkAssignmentUserItem(BaseModel):
+    """Single user entry in bulk assignment request."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    user_id: str
+    is_project_admin: bool
+
+
+class BulkAssignmentRequest(BaseModel):
+    """Bulk assignment request body."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    users: list[BulkAssignmentUserItem] = Field(
+        ...,
+        min_length=1,
+        max_length=1000,
+        description="List of users to assign/update (1-1000)",
+    )
+
+
+class BulkAssignmentResultItem(BaseModel):
+    """Per-user result in bulk assignment response."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    user_id: str
+    action: Literal["assigned", "updated", "removed"]
+    is_project_admin: Optional[bool] = None
+
+
+class BulkAssignmentResponse(BaseModel):
+    """Response for bulk assignment operations."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    message: str
+    project_name: str
+    total: int
+    results: list[BulkAssignmentResultItem]
+
+
+class CsvImportRowResult(BaseModel):
+    """Per-row result from a CSV import validation."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    email: str
+    role: str
+    error: Optional[str] = None
+
+
+class CsvImportValidationResponse(BaseModel):
+    """Response for CSV import dry-run validation."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    users: list[CsvImportRowResult]

{codemie_sdk_python-0.1.418 → codemie_sdk_python-0.1.419}/src/codemie_sdk/models/user.py

@@ -14,6 +14,7 @@ class User(BaseModel):
     )
     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"
     )

codemie_sdk_python-0.1.419/src/codemie_sdk/services/project.py

@@ -0,0 +1,390 @@
+# Copyright 2026 EPAM Systems, Inc. ("EPAM")
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Project management service for the CodeMie SDK."""
+
+from typing import Literal, Optional
+from uuid import UUID
+
+from ..models.project import (
+    BulkAssignmentRequest,
+    BulkAssignmentResponse,
+    BulkAssignmentUserItem,
+    CsvImportValidationResponse,
+    PaginatedProjectListResponse,
+    ProjectAssignmentRequest,
+    ProjectAssignmentResponse,
+    ProjectAssignmentUpdateRequest,
+    ProjectCreateRequest,
+    ProjectCreateResponse,
+    ProjectDeleteResponse,
+    ProjectDetailResponse,
+    ProjectUpdateRequest,
+    ProjectUpdateResponse,
+)
+from ..utils.http import ApiRequestHandler
+
+
+class ProjectService:
+    """Service for managing projects in CodeMie."""
+
+    def __init__(self, api_domain: str, token: str, verify_ssl: bool = True):
+        """Initialize the ProjectService.
+
+        Args:
+            api_domain: Base URL for the CodeMie API
+            token: Authentication token
+            verify_ssl: Whether to verify SSL certificates
+        """
+        self._api = ApiRequestHandler(api_domain, token, verify_ssl)
+
+    def create_project(
+        self,
+        name: str,
+        description: str,
+        cost_center_id: Optional[UUID] = None,
+    ) -> ProjectCreateResponse:
+        """Create a new shared project.
+
+        Args:
+            name: Project name
+            description: Project description
+            cost_center_id: Optional cost center ID
+
+        Returns:
+            ProjectCreateResponse with project details
+
+        Raises:
+            HTTPException: If project creation fails
+        """
+        payload = ProjectCreateRequest(
+            name=name,
+            description=description,
+            cost_center_id=cost_center_id,
+        )
+
+        return self._api.post(
+            "/v1/projects",
+            response_model=ProjectCreateResponse,
+            json_data=payload.model_dump(exclude_none=True),
+        )
+
+    def list_projects(
+        self,
+        search: Optional[str] = None,
+        page: int = 0,
+        per_page: int = 20,
+        include_counters: bool = True,
+        sort_by: Optional[Literal["name", "created_at"]] = None,
+        sort_order: Literal["asc", "desc"] = "asc",
+    ) -> PaginatedProjectListResponse:
+        """List projects visible to current user with pagination and search.
+
+        Args:
+            search: Search by project name or description (substring match)
+            page: Page number (0-indexed)
+            per_page: Items per page (10-100)
+            sort_by: Sort field (name or created_at); ignored when search is active
+            sort_order: Sort direction (asc or desc)
+
+        Returns:
+            PaginatedProjectListResponse with projects and pagination info
+        """
+        params = {
+            "page": page,
+            "per_page": per_page,
+            "include_counters": include_counters,
+            "sort_order": sort_order,
+        }
+
+        if search is not None:
+            params["search"] = search
+        if sort_by is not None:
+            params["sort_by"] = sort_by
+
+        return self._api.get(
+            "/v1/projects",
+            response_model=PaginatedProjectListResponse,
+            params=params,
+            wrap_response=False,
+        )
+
+    def get_project_detail(
+        self,
+        project_name: str,
+    ) -> ProjectDetailResponse:
+        """Get project detail with member list.
+
+        Args:
+            project_name: Project name
+
+        Returns:
+            ProjectDetailResponse with project details and member list
+
+        Raises:
+            HTTPException: If project not found or user doesn't have access (404)
+        """
+        return self._api.get(
+            f"/v1/projects/{project_name}",
+            response_model=ProjectDetailResponse,
+        )
+
+    def update_project(
+        self,
+        project_name: str,
+        name: Optional[str] = None,
+        description: Optional[str] = None,
+        cost_center_id: Optional[UUID] = None,
+        clear_cost_center: bool = False,
+    ) -> ProjectUpdateResponse:
+        """Update a project.
+
+        Args:
+            project_name: Current project name
+            name: New project name (optional)
+            description: New description (optional)
+            cost_center_id: New cost center ID (optional)
+            clear_cost_center: Set to True to remove cost center
+
+        Returns:
+            ProjectUpdateResponse with updated project details
+
+        Raises:
+            HTTPException: If project update fails
+        """
+        payload = ProjectUpdateRequest(
+            name=name,
+            description=description,
+            cost_center_id=cost_center_id,
+            clear_cost_center=clear_cost_center,
+        )
+
+        return self._api.patch(
+            f"/v1/projects/{project_name}",
+            response_model=ProjectUpdateResponse,
+            json_data=payload.model_dump(exclude_none=True),
+        )
+
+    def delete_project(self, project_name: str) -> ProjectDeleteResponse:
+        """Hard-delete a project if it has no assigned resources.
+
+        Args:
+            project_name: Project name
+
+        Returns:
+            ProjectDeleteResponse with deletion confirmation
+
+        Raises:
+            HTTPException: If project has assigned resources (409) or is personal (403)
+        """
+        return self._api.delete(
+            f"/v1/projects/{project_name}",
+            response_model=ProjectDeleteResponse,
+        )
+
+    # Assignment endpoints
+
+    def assign_user_to_project(
+        self,
+        project_name: str,
+        user_id: str,
+        is_project_admin: bool,
+    ) -> ProjectAssignmentResponse:
+        """Assign a user to a project.
+
+        Args:
+            project_name: Project name
+            user_id: User ID to assign
+            is_project_admin: Whether user should be project admin
+
+        Returns:
+            ProjectAssignmentResponse with assignment details
+
+        Raises:
+            HTTPException: If assignment fails
+        """
+        payload = ProjectAssignmentRequest(
+            user_id=user_id,
+            is_project_admin=is_project_admin,
+        )
+
+        return self._api.post(
+            f"/v1/projects/{project_name}/assignment",
+            response_model=ProjectAssignmentResponse,
+            json_data=payload.model_dump(exclude_none=True),
+        )
+
+    def update_user_project_assignment(
+        self,
+        project_name: str,
+        user_id: str,
+        is_project_admin: bool,
+    ) -> ProjectAssignmentResponse:
+        """Update a user's project-admin flag.
+
+        Args:
+            project_name: Project name
+            user_id: User ID to update
+            is_project_admin: New project admin flag value
+
+        Returns:
+            ProjectAssignmentResponse with updated assignment
+
+        Raises:
+            HTTPException: If user is not assigned to project (404)
+        """
+        payload = ProjectAssignmentUpdateRequest(is_project_admin=is_project_admin)
+
+        return self._api.put(
+            f"/v1/projects/{project_name}/assignment/{user_id}",
+            response_model=ProjectAssignmentResponse,
+            json_data=payload.model_dump(exclude_none=True),
+        )
+
+    def remove_user_from_project(
+        self,
+        project_name: str,
+        user_id: str,
+    ) -> ProjectAssignmentResponse:
+        """Remove a user from a project.
+
+        Args:
+            project_name: Project name
+            user_id: User ID to remove
+
+        Returns:
+            ProjectAssignmentResponse with removal confirmation
+
+        Raises:
+            HTTPException: If user is not assigned to project (404)
+        """
+        return self._api.delete(
+            f"/v1/projects/{project_name}/assignment/{user_id}",
+            response_model=ProjectAssignmentResponse,
+        )
+
+    def bulk_assign_users_to_project(
+        self,
+        project_name: str,
+        users: list[BulkAssignmentUserItem],
+    ) -> BulkAssignmentResponse:
+        """Bulk assign/upsert users to a project.
+
+        Assigns new users and updates roles for existing members in a single
+        atomic operation.
+
+        Args:
+            project_name: Project name
+            users: List of BulkAssignmentUserItem with user_id and is_project_admin (1-1000)
+
+        Returns:
+            BulkAssignmentResponse with per-user results
+
+        Raises:
+            HTTPException: If bulk assignment fails
+        """
+        payload = BulkAssignmentRequest(users=users)
+
+        return self._api.post(
+            f"/v1/projects/{project_name}/assignments",
+            response_model=BulkAssignmentResponse,
+            json_data=payload.model_dump(),
+        )
+
+    def bulk_remove_users_from_project(
+        self,
+        project_name: str,
+        user_ids: list[str],
+    ) -> BulkAssignmentResponse:
+        """Bulk remove users from a project.
+
+        Args:
+            project_name: Project name
+            user_ids: List of user IDs to remove (1-100)
+
+        Returns:
+            BulkAssignmentResponse with per-user results
+
+        Raises:
+            HTTPException: If bulk removal fails
+        """
+        params = [("user_id", user_id) for user_id in user_ids]
+
+        return self._api.delete(
+            f"/v1/projects/{project_name}/assignments",
+            response_model=BulkAssignmentResponse,
+            params=params,
+        )
+
+    # CSV import endpoints
+
+    def validate_users_from_csv(
+        self,
+        project_name: str,
+        file_content: bytes,
+        filename: str = "users.csv",
+    ) -> CsvImportValidationResponse:
+        """Dry-run validation of a CSV file for user import.
+
+        Validates each row (email format, role, system user existence) without
+        modifying any data.
+
+        Args:
+            project_name: Project name
+            file_content: CSV file content as bytes
+            filename: CSV filename
+
+        Returns:
+            CsvImportValidationResponse with per-row validation results
+
+        Raises:
+            HTTPException: If file too large (413) or structural CSV error (422)
+        """
+        files = {"file": (filename, file_content, "text/csv")}
+
+        return self._api.post_multipart(
+            f"/v1/projects/{project_name}/import-users/validate",
+            response_model=CsvImportValidationResponse,
+            files=files,
+        )
+
+    def import_users_from_csv(
+        self,
+        project_name: str,
+        file_content: bytes,
+        filename: str = "users.csv",
+    ) -> BulkAssignmentResponse:
+        """Assign users to a project from a CSV file upload.
+
+        CSV must include a header row with 'email' and 'role' columns.
+        Allowed roles: 'administrator' (project admin), 'user' (regular member).
+
+        Args:
+            project_name: Project name
+            file_content: CSV file content as bytes
+            filename: CSV filename
+
+        Returns:
+            BulkAssignmentResponse with per-user results
+
+        Raises:
+            HTTPException: If file too large (413) or validation fails (422)
+        """
+        files = {"file": (filename, file_content, "text/csv")}
+
+        return self._api.post_multipart(
+            f"/v1/projects/{project_name}/import-users",
+            response_model=BulkAssignmentResponse,
+            files=files,
+        )

{codemie_sdk_python-0.1.418 → codemie_sdk_python-0.1.419}/src/codemie_sdk/utils/http.py

@@ -292,15 +292,52 @@ class ApiRequestHandler:
         response.raise_for_status()
         return self._parse_response(response, response_model, wrap_response)
 
+    @log_request
+    def patch(
+        self,
+        endpoint: str,
+        response_model: Type[T],
+        json_data: Dict[str, Any],
+        params: Optional[Dict[str, Any]] = None,
+        wrap_response: bool = True,
+    ) -> T:
+        """Makes a PATCH request and parses the response.
+
+        Args:
+            endpoint: API endpoint path
+            response_model: Pydantic model class or List[Model] for response
+            json_data: JSON request body
+            params: Optional query parameters (e.g., filters, pagination)
+            wrap_response: Whether response is wrapped in 'data' field
+
+        Returns:
+            Parsed response object or list of objects
+        """
+        logger.debug(f"Request body: {json_data}")
+        response = requests.patch(
+            url=f"{self._base_url}{endpoint}",
+            headers=self._get_headers(),
+            json=json_data,
+            params=params,
+            verify=self._verify_ssl,
+        )
+        response.raise_for_status()
+        return self._parse_response(response, response_model, wrap_response)
+
     @log_request
     def delete(
-        self, endpoint: str, response_model: Type[T], wrap_response: bool = True
+        self,
+        endpoint: str,
+        response_model: Type[T],
+        params: Optional[Dict[str, Any]] = None,
+        wrap_response: bool = True,
     ) -> T:
         """Makes a DELETE request and parses the response.
 
         Args:
             endpoint: API endpoint path
             response_model: Pydantic model class or List[Model] for response
+            params: Query parameters (for passing multiple user_id params for bulk delete)
             wrap_response: Whether response is wrapped in 'data' field
 
         Returns:
@@ -309,6 +346,7 @@ class ApiRequestHandler:
         response = requests.delete(
             url=f"{self._base_url}{endpoint}",
             headers=self._get_headers(),
+            params=params,
             verify=self._verify_ssl,
         )
         response.raise_for_status()