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

label_studio_sdk/__init__.py

@@ -2,6 +2,8 @@
 
 from .types import (
     ActionsEnum,
+    ActivityLog,
+    ActivityLogResponse,
     AllRolesProjectList,
     AllRolesProjectListSampling,
     AllRolesProjectListSkipQueue,
@@ -98,6 +100,7 @@ from .types import (
     LseapiTokenList,
     LsejwtSettings,
     MaybeExpandedComment,
+    MetricParam,
     MlBackend,
     ModeEnum,
     ModelInterface,
@@ -199,6 +202,7 @@ from .errors import (
 )
 from . import (
     actions,
+    activity_logs,
     annotations,
     billing,
     comments,
@@ -237,6 +241,7 @@ from .actions import (
     ActionsListResponseItem,
     ActionsListResponseItemDialog,
 )
+from .activity_logs import ActivityLogsListRequestMethod
 from .annotations import AnnotationBulkSerializerWithSelectedItemsRequestLastAction, AnnotationsCreateBulkResponseItem
 from .client import AsyncLabelStudio, LabelStudio
 from .environment import LabelStudioEnvironment
@@ -309,6 +314,9 @@ __all__ = [
     "ActionsEnum",
     "ActionsListResponseItem",
     "ActionsListResponseItemDialog",
+    "ActivityLog",
+    "ActivityLogResponse",
+    "ActivityLogsListRequestMethod",
     "AllRolesProjectList",
     "AllRolesProjectListSampling",
     "AllRolesProjectListSkipQueue",
@@ -419,6 +427,7 @@ __all__ = [
     "LsejwtSettings",
     "MaybeExpandedComment",
     "MethodNotAllowedError",
+    "MetricParam",
     "MlBackend",
     "MlCreateRequestAuthMethod",
     "MlListModelVersionsResponse",
@@ -558,6 +567,7 @@ __all__ = [
     "WorkspaceMemberList",
     "__version__",
     "actions",
+    "activity_logs",
     "annotations",
     "billing",
     "comments",

label_studio_sdk/activity_logs/__init__.py

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

label_studio_sdk/activity_logs/client.py

@@ -0,0 +1,246 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.client_wrapper import SyncClientWrapper
+import typing
+from .types.activity_logs_list_request_method import ActivityLogsListRequestMethod
+from ..core.request_options import RequestOptions
+from ..types.activity_log_response import ActivityLogResponse
+from ..core.unchecked_base_model import construct_type
+from ..errors.not_found_error import NotFoundError
+from json.decoder import JSONDecodeError
+from ..core.api_error import ApiError
+from ..core.client_wrapper import AsyncClientWrapper
+
+
+class ActivityLogsClient:
+    def __init__(self, *, client_wrapper: SyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+    def list(
+        self,
+        *,
+        end_date: typing.Optional[str] = None,
+        method: typing.Optional[ActivityLogsListRequestMethod] = None,
+        ordering: typing.Optional[str] = None,
+        page: typing.Optional[int] = None,
+        page_size: typing.Optional[int] = None,
+        project: typing.Optional[int] = None,
+        search: typing.Optional[str] = None,
+        start_date: typing.Optional[str] = None,
+        user: typing.Optional[int] = None,
+        workspace: typing.Optional[int] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> typing.List[ActivityLogResponse]:
+        """
+        Retrieve activity logs filtered by workspace, project, user, HTTP method, date range or search query.
+
+        Parameters
+        ----------
+        end_date : typing.Optional[str]
+            End date/time (ISO-8601) for log filtering.
+
+        method : typing.Optional[ActivityLogsListRequestMethod]
+            HTTP request method used in the log.
+
+        ordering : typing.Optional[str]
+            Which field to use when ordering the results.
+
+        page : typing.Optional[int]
+            [or "start"] Current page index.
+
+        page_size : typing.Optional[int]
+            [or "length"] Logs per page, use -1 to obtain all logs (might be slow).
+
+        project : typing.Optional[int]
+            Project ID to filter logs.
+
+        search : typing.Optional[str]
+            Search expression using "AND"/"OR" to filter by request URL.
+
+        start_date : typing.Optional[str]
+            Start date/time (ISO-8601) for log filtering.
+
+        user : typing.Optional[int]
+            User ID to filter logs.
+
+        workspace : typing.Optional[int]
+            Workspace owner ID to filter logs.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        typing.List[ActivityLogResponse]
+            Activity logs
+
+        Examples
+        --------
+        from label_studio_sdk import LabelStudio
+
+        client = LabelStudio(
+            api_key="YOUR_API_KEY",
+        )
+        client.activity_logs.list()
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            "api/activity-logs/",
+            method="GET",
+            params={
+                "end_date": end_date,
+                "method": method,
+                "ordering": ordering,
+                "page": page,
+                "page_size": page_size,
+                "project": project,
+                "search": search,
+                "start_date": start_date,
+                "user": user,
+                "workspace": workspace,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    typing.List[ActivityLogResponse],
+                    construct_type(
+                        type_=typing.List[ActivityLogResponse],  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            if _response.status_code == 404:
+                raise NotFoundError(
+                    typing.cast(
+                        typing.Optional[typing.Any],
+                        construct_type(
+                            type_=typing.Optional[typing.Any],  # 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 AsyncActivityLogsClient:
+    def __init__(self, *, client_wrapper: AsyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+    async def list(
+        self,
+        *,
+        end_date: typing.Optional[str] = None,
+        method: typing.Optional[ActivityLogsListRequestMethod] = None,
+        ordering: typing.Optional[str] = None,
+        page: typing.Optional[int] = None,
+        page_size: typing.Optional[int] = None,
+        project: typing.Optional[int] = None,
+        search: typing.Optional[str] = None,
+        start_date: typing.Optional[str] = None,
+        user: typing.Optional[int] = None,
+        workspace: typing.Optional[int] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> typing.List[ActivityLogResponse]:
+        """
+        Retrieve activity logs filtered by workspace, project, user, HTTP method, date range or search query.
+
+        Parameters
+        ----------
+        end_date : typing.Optional[str]
+            End date/time (ISO-8601) for log filtering.
+
+        method : typing.Optional[ActivityLogsListRequestMethod]
+            HTTP request method used in the log.
+
+        ordering : typing.Optional[str]
+            Which field to use when ordering the results.
+
+        page : typing.Optional[int]
+            [or "start"] Current page index.
+
+        page_size : typing.Optional[int]
+            [or "length"] Logs per page, use -1 to obtain all logs (might be slow).
+
+        project : typing.Optional[int]
+            Project ID to filter logs.
+
+        search : typing.Optional[str]
+            Search expression using "AND"/"OR" to filter by request URL.
+
+        start_date : typing.Optional[str]
+            Start date/time (ISO-8601) for log filtering.
+
+        user : typing.Optional[int]
+            User ID to filter logs.
+
+        workspace : typing.Optional[int]
+            Workspace owner ID to filter logs.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        typing.List[ActivityLogResponse]
+            Activity logs
+
+        Examples
+        --------
+        import asyncio
+
+        from label_studio_sdk import AsyncLabelStudio
+
+        client = AsyncLabelStudio(
+            api_key="YOUR_API_KEY",
+        )
+
+
+        async def main() -> None:
+            await client.activity_logs.list()
+
+
+        asyncio.run(main())
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            "api/activity-logs/",
+            method="GET",
+            params={
+                "end_date": end_date,
+                "method": method,
+                "ordering": ordering,
+                "page": page,
+                "page_size": page_size,
+                "project": project,
+                "search": search,
+                "start_date": start_date,
+                "user": user,
+                "workspace": workspace,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    typing.List[ActivityLogResponse],
+                    construct_type(
+                        type_=typing.List[ActivityLogResponse],  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            if _response.status_code == 404:
+                raise NotFoundError(
+                    typing.cast(
+                        typing.Optional[typing.Any],
+                        construct_type(
+                            type_=typing.Optional[typing.Any],  # 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/activity_logs/types/__init__.py

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

label_studio_sdk/activity_logs/types/activity_logs_list_request_method.py

@@ -0,0 +1,5 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+ActivityLogsListRequestMethod = typing.Union[typing.Literal["DELETE", "GET", "PATCH", "POST", "PUT", "all"], typing.Any]

label_studio_sdk/base_client.py

@@ -6,6 +6,7 @@ import os
 import httpx
 from .core.api_error import ApiError
 from .core.client_wrapper import SyncClientWrapper
+from .activity_logs.client import ActivityLogsClient
 from .annotations.client import AnnotationsClient
 from .billing.client import BillingClient
 from .comments.client import CommentsClient
@@ -29,6 +30,7 @@ from .webhooks.client import WebhooksClient
 from .workspaces.client import WorkspacesClient
 from .sso.client import SsoClient
 from .core.client_wrapper import AsyncClientWrapper
+from .activity_logs.client import AsyncActivityLogsClient
 from .annotations.client import AsyncAnnotationsClient
 from .billing.client import AsyncBillingClient
 from .comments.client import AsyncCommentsClient
@@ -115,6 +117,7 @@ class LabelStudioBase:
             else httpx.Client(timeout=_defaulted_timeout),
             timeout=_defaulted_timeout,
         )
+        self.activity_logs = ActivityLogsClient(client_wrapper=self._client_wrapper)
         self.annotations = AnnotationsClient(client_wrapper=self._client_wrapper)
         self.billing = BillingClient(client_wrapper=self._client_wrapper)
         self.comments = CommentsClient(client_wrapper=self._client_wrapper)
@@ -201,6 +204,7 @@ class AsyncLabelStudioBase:
             else httpx.AsyncClient(timeout=_defaulted_timeout),
             timeout=_defaulted_timeout,
         )
+        self.activity_logs = AsyncActivityLogsClient(client_wrapper=self._client_wrapper)
         self.annotations = AsyncAnnotationsClient(client_wrapper=self._client_wrapper)
         self.billing = AsyncBillingClient(client_wrapper=self._client_wrapper)
         self.comments = AsyncCommentsClient(client_wrapper=self._client_wrapper)

label_studio_sdk/errors/internal_server_error.py

@@ -1,8 +1,9 @@
 # This file was auto-generated by Fern from our API Definition.
 
 from ..core.api_error import ApiError
+import typing
 
 
 class InternalServerError(ApiError):
-    def __init__(self, body: str):
+    def __init__(self, body: typing.Optional[typing.Any]):
         super().__init__(status_code=500, body=body)

label_studio_sdk/ml/client.py

@@ -516,9 +516,9 @@ class MlClient:
             if _response.status_code == 500:
                 raise InternalServerError(
                     typing.cast(
-                        str,
+                        typing.Optional[typing.Any],
                         construct_type(
-                            type_=str,  # type: ignore
+                            type_=typing.Optional[typing.Any],  # type: ignore
                             object_=_response.json(),
                         ),
                     )
@@ -1131,9 +1131,9 @@ class AsyncMlClient:
             if _response.status_code == 500:
                 raise InternalServerError(
                     typing.cast(
-                        str,
+                        typing.Optional[typing.Any],
                         construct_type(
-                            type_=str,  # type: ignore
+                            type_=typing.Optional[typing.Any],  # type: ignore
                             object_=_response.json(),
                         ),
                     )

label_studio_sdk/projects/__init__.py

@@ -9,7 +9,7 @@ from .types import (
     ProjectsImportTasksResponse,
     ProjectsListRequestFilter,
 )
-from . import assignments, exports, members, pauses, stats
+from . import assignments, exports, members, metrics, pauses, stats
 from .assignments import (
     AssignmentsAssignRequestType,
     AssignmentsBulkAssignRequestFilters,
@@ -27,7 +27,15 @@ from .assignments import (
     AssignmentsUpdateRequestType,
 )
 from .exports import ExportsConvertResponse
-from .stats import StatsIaaResponse, StatsIaaResponseCommonTasks, StatsIaaResponseIaa, StatsIaaResponseStd
+from .stats import (
+    StatsIaaResponse,
+    StatsIaaResponseCommonTasks,
+    StatsIaaResponseIaa,
+    StatsIaaResponseStd,
+    StatsTotalAgreementResponse,
+    StatsTotalAgreementResponseOne,
+    StatsTotalAgreementResponseZero,
+)
 
 __all__ = [
     "AssignmentsAssignRequestType",
@@ -56,9 +64,13 @@ __all__ = [
     "StatsIaaResponseCommonTasks",
     "StatsIaaResponseIaa",
     "StatsIaaResponseStd",
+    "StatsTotalAgreementResponse",
+    "StatsTotalAgreementResponseOne",
+    "StatsTotalAgreementResponseZero",
     "assignments",
     "exports",
     "members",
+    "metrics",
     "pauses",
     "stats",
 ]

label_studio_sdk/projects/client.py

@@ -4,6 +4,7 @@ import typing
 from ..core.client_wrapper import SyncClientWrapper
 from .exports.client import ExportsClient
 from .members.client import MembersClient
+from .metrics.client import MetricsClient
 from .stats.client import StatsClient
 from .assignments.client import AssignmentsClient
 from .pauses.client import PausesClient
@@ -37,6 +38,7 @@ from ..types.project_label_config import ProjectLabelConfig
 from ..core.client_wrapper import AsyncClientWrapper
 from .exports.client import AsyncExportsClient
 from .members.client import AsyncMembersClient
+from .metrics.client import AsyncMetricsClient
 from .stats.client import AsyncStatsClient
 from .assignments.client import AsyncAssignmentsClient
 from .pauses.client import AsyncPausesClient
@@ -51,6 +53,7 @@ class ProjectsClient:
         self._client_wrapper = client_wrapper
         self.exports = ExportsClient(client_wrapper=self._client_wrapper)
         self.members = MembersClient(client_wrapper=self._client_wrapper)
+        self.metrics = MetricsClient(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)
@@ -980,6 +983,7 @@ class AsyncProjectsClient:
         self._client_wrapper = client_wrapper
         self.exports = AsyncExportsClient(client_wrapper=self._client_wrapper)
         self.members = AsyncMembersClient(client_wrapper=self._client_wrapper)
+        self.metrics = AsyncMetricsClient(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/metrics/__init__.py

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