label-studio-sdk 2.0.2__py3-none-any.whl → 2.0.3__py3-none-any.whl

label_studio_sdk/__init__.py

@@ -123,6 +123,9 @@ from .types import (
     Prediction,
     PredictionRequest,
     Project,
+    ProjectGroup,
+    ProjectGroupRequest,
+    ProjectGroupRoleEnum,
     ProjectImport,
     ProjectLabelConfig,
     ProjectLabelConfigRequest,
@@ -148,7 +151,11 @@ from .types import (
     RoleBasedTask,
     S3ExportStorage,
     S3ImportStorage,
+    SamlSettings,
+    SamlSettingsUpdate,
     SamplingEnum,
+    ScimSettings,
+    ScimSettingsUpdate,
     ScopeEnum,
     SelectedItemsRequest,
     SerializationOption,
@@ -201,6 +208,7 @@ from . import (
     predictions,
     projects,
     prompts,
+    sso,
     tasks,
     tokens,
     users,
@@ -439,6 +447,9 @@ __all__ = [
     "Prediction",
     "PredictionRequest",
     "Project",
+    "ProjectGroup",
+    "ProjectGroupRequest",
+    "ProjectGroupRoleEnum",
     "ProjectImport",
     "ProjectLabelConfig",
     "ProjectLabelConfigRequest",
@@ -468,7 +479,11 @@ __all__ = [
     "RoleBasedTask",
     "S3ExportStorage",
     "S3ImportStorage",
+    "SamlSettings",
+    "SamlSettingsUpdate",
     "SamplingEnum",
+    "ScimSettings",
+    "ScimSettingsUpdate",
     "ScopeEnum",
     "SelectedItemsRequest",
     "SerializationOption",
@@ -548,6 +563,7 @@ __all__ = [
     "predictions",
     "projects",
     "prompts",
+    "sso",
     "tasks",
     "tokens",
     "users",

label_studio_sdk/base_client.py

@@ -27,6 +27,7 @@ from .tokens.client import TokensClient
 from .versions.client import VersionsClient
 from .webhooks.client import WebhooksClient
 from .workspaces.client import WorkspacesClient
+from .sso.client import SsoClient
 from .core.client_wrapper import AsyncClientWrapper
 from .annotations.client import AsyncAnnotationsClient
 from .billing.client import AsyncBillingClient
@@ -49,6 +50,7 @@ from .tokens.client import AsyncTokensClient
 from .versions.client import AsyncVersionsClient
 from .webhooks.client import AsyncWebhooksClient
 from .workspaces.client import AsyncWorkspacesClient
+from .sso.client import AsyncSsoClient
 
 
 class LabelStudioBase:
@@ -134,6 +136,7 @@ class LabelStudioBase:
         self.versions = VersionsClient(client_wrapper=self._client_wrapper)
         self.webhooks = WebhooksClient(client_wrapper=self._client_wrapper)
         self.workspaces = WorkspacesClient(client_wrapper=self._client_wrapper)
+        self.sso = SsoClient(client_wrapper=self._client_wrapper)
 
 
 class AsyncLabelStudioBase:
@@ -219,6 +222,7 @@ class AsyncLabelStudioBase:
         self.versions = AsyncVersionsClient(client_wrapper=self._client_wrapper)
         self.webhooks = AsyncWebhooksClient(client_wrapper=self._client_wrapper)
         self.workspaces = AsyncWorkspacesClient(client_wrapper=self._client_wrapper)
+        self.sso = AsyncSsoClient(client_wrapper=self._client_wrapper)
 
 
 def _get_base_url(*, base_url: typing.Optional[str] = None, environment: LabelStudioEnvironment) -> str:

label_studio_sdk/projects/__init__.py

@@ -9,7 +9,7 @@ from .types import (
     ProjectsImportTasksResponse,
     ProjectsListRequestFilter,
 )
-from . import assignments, exports, pauses, stats
+from . import assignments, exports, members, pauses, stats
 from .assignments import (
     AssignmentsAssignRequestType,
     AssignmentsBulkAssignRequestFilters,
@@ -23,6 +23,7 @@ from .assignments import (
     AssignmentsBulkAssignRequestSelectedItemsIncluded,
     AssignmentsBulkAssignRequestType,
     AssignmentsBulkAssignResponse,
+    AssignmentsDeleteRequestType,
     AssignmentsUpdateRequestType,
 )
 from .exports import ExportsConvertResponse
@@ -41,6 +42,7 @@ __all__ = [
     "AssignmentsBulkAssignRequestSelectedItemsIncluded",
     "AssignmentsBulkAssignRequestType",
     "AssignmentsBulkAssignResponse",
+    "AssignmentsDeleteRequestType",
     "AssignmentsUpdateRequestType",
     "ExportsConvertResponse",
     "LseProjectCreateRequestSampling",
@@ -56,6 +58,7 @@ __all__ = [
     "StatsIaaResponseStd",
     "assignments",
     "exports",
+    "members",
     "pauses",
     "stats",
 ]

label_studio_sdk/projects/assignments/__init__.py

@@ -13,6 +13,7 @@ from .types import (
     AssignmentsBulkAssignRequestSelectedItemsIncluded,
     AssignmentsBulkAssignRequestType,
     AssignmentsBulkAssignResponse,
+    AssignmentsDeleteRequestType,
     AssignmentsUpdateRequestType,
 )
 
@@ -29,5 +30,6 @@ __all__ = [
     "AssignmentsBulkAssignRequestSelectedItemsIncluded",
     "AssignmentsBulkAssignRequestType",
     "AssignmentsBulkAssignResponse",
+    "AssignmentsDeleteRequestType",
     "AssignmentsUpdateRequestType",
 ]

label_studio_sdk/projects/assignments/client.py

@@ -15,6 +15,7 @@ from json.decoder import JSONDecodeError
 from ...core.api_error import ApiError
 from ...types.task_assignment import TaskAssignment
 from .types.assignments_assign_request_type import AssignmentsAssignRequestType
+from .types.assignments_delete_request_type import AssignmentsDeleteRequestType
 from .types.assignments_update_request_type import AssignmentsUpdateRequestType
 from ...core.client_wrapper import AsyncClientWrapper
 
@@ -37,7 +38,7 @@ class AssignmentsClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AssignmentsBulkAssignResponse:
         """
-        Assign multiple tasks to a specific user for a specific project.
+        Assign multiple users to a collection of tasks within a specific project.
 
         Parameters
         ----------
@@ -253,9 +254,17 @@ class AssignmentsClient:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
 
-    def delete(self, id: int, task_pk: int, *, request_options: typing.Optional[RequestOptions] = None) -> None:
+    def delete(
+        self,
+        id: int,
+        task_pk: int,
+        *,
+        type: typing.Optional[AssignmentsDeleteRequestType] = None,
+        users: typing.Optional[str] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> None:
         """
-        Remove the assignee for a task for a specific project.
+        Remove assignees for a task within a specific project.
 
         Parameters
         ----------
@@ -265,6 +274,12 @@ class AssignmentsClient:
         task_pk : int
             A unique integer value identifying this task.
 
+        type : typing.Optional[AssignmentsDeleteRequestType]
+            Assignment type to delete (optional). If omitted, deletes all assignments for the task.
+
+        users : typing.Optional[str]
+            Comma separated list of user IDs to delete, as a string. If omitted, deletes all assignees for the given type.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -287,6 +302,10 @@ class AssignmentsClient:
         _response = self._client_wrapper.httpx_client.request(
             f"api/projects/{jsonable_encoder(id)}/tasks/{jsonable_encoder(task_pk)}/assignees",
             method="DELETE",
+            params={
+                "type": type,
+                "users": users,
+            },
             request_options=request_options,
         )
         try:
@@ -388,7 +407,7 @@ class AsyncAssignmentsClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AssignmentsBulkAssignResponse:
         """
-        Assign multiple tasks to a specific user for a specific project.
+        Assign multiple users to a collection of tasks within a specific project.
 
         Parameters
         ----------
@@ -628,9 +647,17 @@ class AsyncAssignmentsClient:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
 
-    async def delete(self, id: int, task_pk: int, *, request_options: typing.Optional[RequestOptions] = None) -> None:
+    async def delete(
+        self,
+        id: int,
+        task_pk: int,
+        *,
+        type: typing.Optional[AssignmentsDeleteRequestType] = None,
+        users: typing.Optional[str] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> None:
         """
-        Remove the assignee for a task for a specific project.
+        Remove assignees for a task within a specific project.
 
         Parameters
         ----------
@@ -640,6 +667,12 @@ class AsyncAssignmentsClient:
         task_pk : int
             A unique integer value identifying this task.
 
+        type : typing.Optional[AssignmentsDeleteRequestType]
+            Assignment type to delete (optional). If omitted, deletes all assignments for the task.
+
+        users : typing.Optional[str]
+            Comma separated list of user IDs to delete, as a string. If omitted, deletes all assignees for the given type.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -670,6 +703,10 @@ class AsyncAssignmentsClient:
         _response = await self._client_wrapper.httpx_client.request(
             f"api/projects/{jsonable_encoder(id)}/tasks/{jsonable_encoder(task_pk)}/assignees",
             method="DELETE",
+            params={
+                "type": type,
+                "users": users,
+            },
             request_options=request_options,
         )
         try:

label_studio_sdk/projects/assignments/types/__init__.py

@@ -16,6 +16,7 @@ from .assignments_bulk_assign_request_selected_items_excluded import Assignments
 from .assignments_bulk_assign_request_selected_items_included import AssignmentsBulkAssignRequestSelectedItemsIncluded
 from .assignments_bulk_assign_request_type import AssignmentsBulkAssignRequestType
 from .assignments_bulk_assign_response import AssignmentsBulkAssignResponse
+from .assignments_delete_request_type import AssignmentsDeleteRequestType
 from .assignments_update_request_type import AssignmentsUpdateRequestType
 
 __all__ = [
@@ -31,5 +32,6 @@ __all__ = [
     "AssignmentsBulkAssignRequestSelectedItemsIncluded",
     "AssignmentsBulkAssignRequestType",
     "AssignmentsBulkAssignResponse",
+    "AssignmentsDeleteRequestType",
     "AssignmentsUpdateRequestType",
 ]

label_studio_sdk/projects/assignments/types/assignments_delete_request_type.py

@@ -0,0 +1,5 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+AssignmentsDeleteRequestType = typing.Union[typing.Literal["AN", "RE"], typing.Any]

label_studio_sdk/projects/client.py

@@ -3,6 +3,7 @@
 import typing
 from ..core.client_wrapper import SyncClientWrapper
 from .exports.client import ExportsClient
+from .members.client import MembersClient
 from .stats.client import StatsClient
 from .assignments.client import AssignmentsClient
 from .pauses.client import PausesClient
@@ -35,6 +36,7 @@ from ..errors.bad_request_error import BadRequestError
 from ..types.project_label_config import ProjectLabelConfig
 from ..core.client_wrapper import AsyncClientWrapper
 from .exports.client import AsyncExportsClient
+from .members.client import AsyncMembersClient
 from .stats.client import AsyncStatsClient
 from .assignments.client import AsyncAssignmentsClient
 from .pauses.client import AsyncPausesClient
@@ -48,6 +50,7 @@ class ProjectsClient:
     def __init__(self, *, client_wrapper: SyncClientWrapper):
         self._client_wrapper = client_wrapper
         self.exports = ExportsClient(client_wrapper=self._client_wrapper)
+        self.members = MembersClient(client_wrapper=self._client_wrapper)
         self.stats = StatsClient(client_wrapper=self._client_wrapper)
         self.assignments = AssignmentsClient(client_wrapper=self._client_wrapper)
         self.pauses = PausesClient(client_wrapper=self._client_wrapper)
@@ -976,6 +979,7 @@ class AsyncProjectsClient:
     def __init__(self, *, client_wrapper: AsyncClientWrapper):
         self._client_wrapper = client_wrapper
         self.exports = AsyncExportsClient(client_wrapper=self._client_wrapper)
+        self.members = AsyncMembersClient(client_wrapper=self._client_wrapper)
         self.stats = AsyncStatsClient(client_wrapper=self._client_wrapper)
         self.assignments = AsyncAssignmentsClient(client_wrapper=self._client_wrapper)
         self.pauses = AsyncPausesClient(client_wrapper=self._client_wrapper)

label_studio_sdk/projects/members/__init__.py

@@ -0,0 +1,2 @@
+# This file was auto-generated by Fern from our API Definition.
+

label_studio_sdk/projects/members/client.py

@@ -0,0 +1,137 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ...core.client_wrapper import SyncClientWrapper
+import typing
+from ...core.request_options import RequestOptions
+from ...types.lse_user import LseUser
+from ...core.jsonable_encoder import jsonable_encoder
+from ...core.unchecked_base_model import construct_type
+from json.decoder import JSONDecodeError
+from ...core.api_error import ApiError
+from ...core.client_wrapper import AsyncClientWrapper
+
+
+class MembersClient:
+    def __init__(self, *, client_wrapper: SyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+    def get(
+        self, id: int, *, user_ids: typing.Optional[str] = None, request_options: typing.Optional[RequestOptions] = None
+    ) -> typing.List[LseUser]:
+        """
+        Retrieve the members for a specific project. Optionally filter by user IDs (comma-separated).
+
+        Parameters
+        ----------
+        id : int
+
+        user_ids : typing.Optional[str]
+            Comma-separated list of user IDs to include. Example: user_ids=1,2,3
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        typing.List[LseUser]
+            List of users with membership information
+
+        Examples
+        --------
+        from label_studio_sdk import LabelStudio
+
+        client = LabelStudio(
+            api_key="YOUR_API_KEY",
+        )
+        client.projects.members.get(
+            id=1,
+        )
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"api/projects/{jsonable_encoder(id)}/members/",
+            method="GET",
+            params={
+                "user_ids": user_ids,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    typing.List[LseUser],
+                    construct_type(
+                        type_=typing.List[LseUser],  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, body=_response.text)
+        raise ApiError(status_code=_response.status_code, body=_response_json)
+
+
+class AsyncMembersClient:
+    def __init__(self, *, client_wrapper: AsyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+    async def get(
+        self, id: int, *, user_ids: typing.Optional[str] = None, request_options: typing.Optional[RequestOptions] = None
+    ) -> typing.List[LseUser]:
+        """
+        Retrieve the members for a specific project. Optionally filter by user IDs (comma-separated).
+
+        Parameters
+        ----------
+        id : int
+
+        user_ids : typing.Optional[str]
+            Comma-separated list of user IDs to include. Example: user_ids=1,2,3
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        typing.List[LseUser]
+            List of users with membership information
+
+        Examples
+        --------
+        import asyncio
+
+        from label_studio_sdk import AsyncLabelStudio
+
+        client = AsyncLabelStudio(
+            api_key="YOUR_API_KEY",
+        )
+
+
+        async def main() -> None:
+            await client.projects.members.get(
+                id=1,
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"api/projects/{jsonable_encoder(id)}/members/",
+            method="GET",
+            params={
+                "user_ids": user_ids,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    typing.List[LseUser],
+                    construct_type(
+                        type_=typing.List[LseUser],  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, body=_response.text)
+        raise ApiError(status_code=_response.status_code, body=_response_json)

label_studio_sdk/sso/__init__.py

@@ -0,0 +1,5 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from . import saml, scim
+
+__all__ = ["saml", "scim"]

label_studio_sdk/sso/client.py

@@ -0,0 +1,22 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.client_wrapper import SyncClientWrapper
+from .saml.client import SamlClient
+from .scim.client import ScimClient
+from ..core.client_wrapper import AsyncClientWrapper
+from .saml.client import AsyncSamlClient
+from .scim.client import AsyncScimClient
+
+
+class SsoClient:
+    def __init__(self, *, client_wrapper: SyncClientWrapper):
+        self._client_wrapper = client_wrapper
+        self.saml = SamlClient(client_wrapper=self._client_wrapper)
+        self.scim = ScimClient(client_wrapper=self._client_wrapper)
+
+
+class AsyncSsoClient:
+    def __init__(self, *, client_wrapper: AsyncClientWrapper):
+        self._client_wrapper = client_wrapper
+        self.saml = AsyncSamlClient(client_wrapper=self._client_wrapper)
+        self.scim = AsyncScimClient(client_wrapper=self._client_wrapper)

label_studio_sdk/sso/saml/__init__.py

@@ -0,0 +1,2 @@
+# This file was auto-generated by Fern from our API Definition.
+