label-studio-sdk 2.0.4__py3-none-any.whl → 2.0.5__py3-none-any.whl

label_studio_sdk/projects/stats/client.py

@@ -8,6 +8,7 @@ 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 .types.stats_total_agreement_response import StatsTotalAgreementResponse
 from ...core.client_wrapper import AsyncClientWrapper
 
 
@@ -88,6 +89,66 @@ class StatsClient:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
 
+    def total_agreement(
+        self,
+        id: int,
+        *,
+        per_label: typing.Optional[bool] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> StatsTotalAgreementResponse:
+        """
+        Overall or per-label total agreement across the project.
+
+        NOTE: due to an open issue in Fern, SDK clients will raise ApiError upon handling a 204 response. As a workaround, wrap call to this function in a try-except block.
+
+        Parameters
+        ----------
+        id : int
+
+        per_label : typing.Optional[bool]
+            Return agreement per label
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        StatsTotalAgreementResponse
+            Total agreement
+
+        Examples
+        --------
+        from label_studio_sdk import LabelStudio
+
+        client = LabelStudio(
+            api_key="YOUR_API_KEY",
+        )
+        client.projects.stats.total_agreement(
+            id=1,
+        )
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"api/projects/{jsonable_encoder(id)}/stats/total_agreement",
+            method="GET",
+            params={
+                "per_label": per_label,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    StatsTotalAgreementResponse,
+                    construct_type(
+                        type_=StatsTotalAgreementResponse,  # 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 AsyncStatsClient:
     def __init__(self, *, client_wrapper: AsyncClientWrapper):
@@ -173,3 +234,71 @@ class AsyncStatsClient:
         except JSONDecodeError:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
+
+    async def total_agreement(
+        self,
+        id: int,
+        *,
+        per_label: typing.Optional[bool] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> StatsTotalAgreementResponse:
+        """
+        Overall or per-label total agreement across the project.
+
+        NOTE: due to an open issue in Fern, SDK clients will raise ApiError upon handling a 204 response. As a workaround, wrap call to this function in a try-except block.
+
+        Parameters
+        ----------
+        id : int
+
+        per_label : typing.Optional[bool]
+            Return agreement per label
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        StatsTotalAgreementResponse
+            Total agreement
+
+        Examples
+        --------
+        import asyncio
+
+        from label_studio_sdk import AsyncLabelStudio
+
+        client = AsyncLabelStudio(
+            api_key="YOUR_API_KEY",
+        )
+
+
+        async def main() -> None:
+            await client.projects.stats.total_agreement(
+                id=1,
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"api/projects/{jsonable_encoder(id)}/stats/total_agreement",
+            method="GET",
+            params={
+                "per_label": per_label,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    StatsTotalAgreementResponse,
+                    construct_type(
+                        type_=StatsTotalAgreementResponse,  # 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/projects/stats/types/__init__.py

@@ -4,5 +4,16 @@ from .stats_iaa_response import StatsIaaResponse
 from .stats_iaa_response_common_tasks import StatsIaaResponseCommonTasks
 from .stats_iaa_response_iaa import StatsIaaResponseIaa
 from .stats_iaa_response_std import StatsIaaResponseStd
+from .stats_total_agreement_response import StatsTotalAgreementResponse
+from .stats_total_agreement_response_one import StatsTotalAgreementResponseOne
+from .stats_total_agreement_response_zero import StatsTotalAgreementResponseZero
 
-__all__ = ["StatsIaaResponse", "StatsIaaResponseCommonTasks", "StatsIaaResponseIaa", "StatsIaaResponseStd"]
+__all__ = [
+    "StatsIaaResponse",
+    "StatsIaaResponseCommonTasks",
+    "StatsIaaResponseIaa",
+    "StatsIaaResponseStd",
+    "StatsTotalAgreementResponse",
+    "StatsTotalAgreementResponseOne",
+    "StatsTotalAgreementResponseZero",
+]

label_studio_sdk/projects/stats/types/stats_total_agreement_response.py

@@ -0,0 +1,7 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+from .stats_total_agreement_response_zero import StatsTotalAgreementResponseZero
+from .stats_total_agreement_response_one import StatsTotalAgreementResponseOne
+
+StatsTotalAgreementResponse = typing.Union[StatsTotalAgreementResponseZero, StatsTotalAgreementResponseOne]

label_studio_sdk/projects/stats/types/stats_total_agreement_response_one.py

@@ -0,0 +1,19 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ....core.unchecked_base_model import UncheckedBaseModel
+import typing
+from ....core.pydantic_utilities import IS_PYDANTIC_V2
+import pydantic
+
+
+class StatsTotalAgreementResponseOne(UncheckedBaseModel):
+    total_agreement: typing.Optional[typing.Dict[str, float]] = None
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

label_studio_sdk/projects/stats/types/stats_total_agreement_response_zero.py

@@ -0,0 +1,19 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ....core.unchecked_base_model import UncheckedBaseModel
+import typing
+from ....core.pydantic_utilities import IS_PYDANTIC_V2
+import pydantic
+
+
+class StatsTotalAgreementResponseZero(UncheckedBaseModel):
+    total_agreement: typing.Optional[float] = None
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

label_studio_sdk/types/__init__.py

@@ -1,6 +1,8 @@
 # This file was auto-generated by Fern from our API Definition.
 
 from .actions_enum import ActionsEnum
+from .activity_log import ActivityLog
+from .activity_log_response import ActivityLogResponse
 from .all_roles_project_list import AllRolesProjectList
 from .all_roles_project_list_sampling import AllRolesProjectListSampling
 from .all_roles_project_list_skip_queue import AllRolesProjectListSkipQueue
@@ -99,6 +101,7 @@ from .lseapi_token_create import LseapiTokenCreate
 from .lseapi_token_list import LseapiTokenList
 from .lsejwt_settings import LsejwtSettings
 from .maybe_expanded_comment import MaybeExpandedComment
+from .metric_param import MetricParam
 from .ml_backend import MlBackend
 from .mode_enum import ModeEnum
 from .model_interface import ModelInterface
@@ -192,6 +195,8 @@ from .workspace_member_list import WorkspaceMemberList
 
 __all__ = [
     "ActionsEnum",
+    "ActivityLog",
+    "ActivityLogResponse",
     "AllRolesProjectList",
     "AllRolesProjectListSampling",
     "AllRolesProjectListSkipQueue",
@@ -288,6 +293,7 @@ __all__ = [
     "LseapiTokenList",
     "LsejwtSettings",
     "MaybeExpandedComment",
+    "MetricParam",
     "MlBackend",
     "ModeEnum",
     "ModelInterface",

label_studio_sdk/types/activity_log.py

@@ -0,0 +1,49 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.unchecked_base_model import UncheckedBaseModel
+import datetime as dt
+import typing
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+
+
+class ActivityLog(UncheckedBaseModel):
+    datetime: dt.datetime
+    duration: typing.Optional[int] = pydantic.Field(default=None)
+    """
+    Duration of response generation in ms
+    """
+
+    email: str
+    extra_data: typing.Optional[typing.Optional[typing.Any]] = None
+    http_referer: typing.Optional[str] = None
+    id: int
+    ip_address: typing.Optional[str] = None
+    organization_id: typing.Optional[int] = pydantic.Field(default=None)
+    """
+    Organization id
+    """
+
+    project_id: typing.Optional[int] = pydantic.Field(default=None)
+    """
+    Project id if request has it
+    """
+
+    request_method: str
+    request_url: str
+    response_code: str
+    user_agent: typing.Optional[str] = None
+    user_id: int
+    workspace_owner_id: typing.Optional[int] = pydantic.Field(default=None)
+    """
+    Owner id of workspace where action performed
+    """
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

label_studio_sdk/types/activity_log_response.py

@@ -0,0 +1,28 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.unchecked_base_model import UncheckedBaseModel
+import typing
+from .activity_log import ActivityLog
+import typing_extensions
+from ..core.serialization import FieldMetadata
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+import pydantic
+
+
+class ActivityLogResponse(UncheckedBaseModel):
+    """
+    Serializer for ActivityLogAPI response.
+    """
+
+    data: typing.List[ActivityLog]
+    records_filtered: typing_extensions.Annotated[int, FieldMetadata(alias="recordsFiltered")]
+    records_total: typing_extensions.Annotated[int, FieldMetadata(alias="recordsTotal")]
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

label_studio_sdk/types/metric_param.py

@@ -0,0 +1,31 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.unchecked_base_model import UncheckedBaseModel
+import typing
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+
+
+class MetricParam(UncheckedBaseModel):
+    agreement_threshold: str
+    allowed: str
+    max_additional_annotators_assignable: typing.Optional[int] = pydantic.Field(default=None)
+    """
+    Maximum number of additional annotators that can be assigned to a low agreement task
+    """
+
+    metric_name: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    Evaluation metric chosen for this project
+    """
+
+    metric_params: typing.Optional[typing.Optional[typing.Any]] = None
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

label_studio_sdk/workspaces/members/__init__.py

@@ -1,2 +1,6 @@
 # This file was auto-generated by Fern from our API Definition.
 
+from . import bulk
+from .bulk import BulkDeleteResponse, BulkPostResponse
+
+__all__ = ["BulkDeleteResponse", "BulkPostResponse", "bulk"]

label_studio_sdk/workspaces/members/bulk/__init__.py

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

label_studio_sdk/workspaces/members/bulk/client.py

@@ -0,0 +1,273 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+from ....core.client_wrapper import SyncClientWrapper
+from ....core.request_options import RequestOptions
+from .types.bulk_post_response import BulkPostResponse
+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 .types.bulk_delete_response import BulkDeleteResponse
+from ....core.client_wrapper import AsyncClientWrapper
+
+# this is used as the default value for optional parameters
+OMIT = typing.cast(typing.Any, ...)
+
+
+class BulkClient:
+    def __init__(self, *, client_wrapper: SyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+    def post(
+        self,
+        id: int,
+        *,
+        all_: bool,
+        excluded: typing.Optional[typing.Sequence[int]] = OMIT,
+        included: typing.Optional[typing.Sequence[int]] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> BulkPostResponse:
+        """
+        Assign workspace members in bulk.
+
+        Parameters
+        ----------
+        id : int
+
+        all_ : bool
+
+        excluded : typing.Optional[typing.Sequence[int]]
+
+        included : typing.Optional[typing.Sequence[int]]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        BulkPostResponse
+
+
+        Examples
+        --------
+        from label_studio_sdk import LabelStudio
+
+        client = LabelStudio(
+            api_key="YOUR_API_KEY",
+        )
+        client.workspaces.members.bulk.post(
+            id=1,
+            all_=True,
+        )
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"api/workspaces/{jsonable_encoder(id)}/memberships/bulk/",
+            method="POST",
+            json={
+                "all": all_,
+                "excluded": excluded,
+                "included": included,
+            },
+            headers={
+                "content-type": "application/json",
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    BulkPostResponse,
+                    construct_type(
+                        type_=BulkPostResponse,  # 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)
+
+    def delete(self, id: int, *, request_options: typing.Optional[RequestOptions] = None) -> BulkDeleteResponse:
+        """
+        Unassign workspace members in bulk. Allows the same request body as bulk assign.
+
+        Parameters
+        ----------
+        id : int
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        BulkDeleteResponse
+
+
+        Examples
+        --------
+        from label_studio_sdk import LabelStudio
+
+        client = LabelStudio(
+            api_key="YOUR_API_KEY",
+        )
+        client.workspaces.members.bulk.delete(
+            id=1,
+        )
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"api/workspaces/{jsonable_encoder(id)}/memberships/bulk/",
+            method="DELETE",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    BulkDeleteResponse,
+                    construct_type(
+                        type_=BulkDeleteResponse,  # 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 AsyncBulkClient:
+    def __init__(self, *, client_wrapper: AsyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+    async def post(
+        self,
+        id: int,
+        *,
+        all_: bool,
+        excluded: typing.Optional[typing.Sequence[int]] = OMIT,
+        included: typing.Optional[typing.Sequence[int]] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> BulkPostResponse:
+        """
+        Assign workspace members in bulk.
+
+        Parameters
+        ----------
+        id : int
+
+        all_ : bool
+
+        excluded : typing.Optional[typing.Sequence[int]]
+
+        included : typing.Optional[typing.Sequence[int]]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        BulkPostResponse
+
+
+        Examples
+        --------
+        import asyncio
+
+        from label_studio_sdk import AsyncLabelStudio
+
+        client = AsyncLabelStudio(
+            api_key="YOUR_API_KEY",
+        )
+
+
+        async def main() -> None:
+            await client.workspaces.members.bulk.post(
+                id=1,
+                all_=True,
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"api/workspaces/{jsonable_encoder(id)}/memberships/bulk/",
+            method="POST",
+            json={
+                "all": all_,
+                "excluded": excluded,
+                "included": included,
+            },
+            headers={
+                "content-type": "application/json",
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    BulkPostResponse,
+                    construct_type(
+                        type_=BulkPostResponse,  # 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)
+
+    async def delete(self, id: int, *, request_options: typing.Optional[RequestOptions] = None) -> BulkDeleteResponse:
+        """
+        Unassign workspace members in bulk. Allows the same request body as bulk assign.
+
+        Parameters
+        ----------
+        id : int
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        BulkDeleteResponse
+
+
+        Examples
+        --------
+        import asyncio
+
+        from label_studio_sdk import AsyncLabelStudio
+
+        client = AsyncLabelStudio(
+            api_key="YOUR_API_KEY",
+        )
+
+
+        async def main() -> None:
+            await client.workspaces.members.bulk.delete(
+                id=1,
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"api/workspaces/{jsonable_encoder(id)}/memberships/bulk/",
+            method="DELETE",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    BulkDeleteResponse,
+                    construct_type(
+                        type_=BulkDeleteResponse,  # 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/workspaces/members/bulk/types/__init__.py

@@ -0,0 +1,6 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from .bulk_delete_response import BulkDeleteResponse
+from .bulk_post_response import BulkPostResponse
+
+__all__ = ["BulkDeleteResponse", "BulkPostResponse"]

label_studio_sdk/workspaces/members/bulk/types/bulk_delete_response.py

@@ -0,0 +1,19 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from .....core.unchecked_base_model import UncheckedBaseModel
+import typing
+from .....core.pydantic_utilities import IS_PYDANTIC_V2
+import pydantic
+
+
+class BulkDeleteResponse(UncheckedBaseModel):
+    unassignments: typing.Optional[int] = None
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

label_studio_sdk/workspaces/members/bulk/types/bulk_post_response.py

@@ -0,0 +1,19 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from .....core.unchecked_base_model import UncheckedBaseModel
+import typing
+from .....core.pydantic_utilities import IS_PYDANTIC_V2
+import pydantic
+
+
+class BulkPostResponse(UncheckedBaseModel):
+    assignments: typing.Optional[int] = None
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow