hatchet-sdk 0.42.2__tar.gz → 0.42.4__tar.gz

{hatchet_sdk-0.42.2 → hatchet_sdk-0.42.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: hatchet-sdk
-Version: 0.42.2
+Version: 0.42.4
 Summary: 
 Author: Alexander Belanger
 Author-email: alexander@hatchet.run
@@ -12,6 +12,7 @@ Classifier: Programming Language :: Python :: 3.12
 Requires-Dist: aiohttp (>=3.10.5,<4.0.0)
 Requires-Dist: aiohttp-retry (>=2.8.3,<3.0.0)
 Requires-Dist: aiostream (>=0.5.2,<0.6.0)
+Requires-Dist: cel-python (>=0.1.5,<0.2.0)
 Requires-Dist: grpcio (>=1.64.1,<2.0.0)
 Requires-Dist: grpcio-tools (>=1.60.0,<2.0.0)
 Requires-Dist: loguru (>=0.7.2,<0.8.0)

{hatchet_sdk-0.42.2 → hatchet_sdk-0.42.4}/hatchet_sdk/clients/admin.py

@@ -41,7 +41,7 @@ def new_admin(config: ClientConfig):
     return AdminClient(config)
 
 
-class ScheduleTriggerWorkflowOptions(TypedDict):
+class ScheduleTriggerWorkflowOptions(TypedDict, total=False):
     parent_id: Optional[str]
     parent_step_run_id: Optional[str]
     child_index: Optional[int]
@@ -49,25 +49,25 @@ class ScheduleTriggerWorkflowOptions(TypedDict):
     namespace: Optional[str]
 
 
-class ChildTriggerWorkflowOptions(TypedDict):
+class ChildTriggerWorkflowOptions(TypedDict, total=False):
     additional_metadata: Dict[str, str] | None = None
     sticky: bool | None = None
 
 
-class ChildWorkflowRunDict(TypedDict):
+class ChildWorkflowRunDict(TypedDict, total=False):
     workflow_name: str
     input: Any
     options: ChildTriggerWorkflowOptions
     key: str | None = None
 
 
-class TriggerWorkflowOptions(ScheduleTriggerWorkflowOptions, TypedDict):
+class TriggerWorkflowOptions(ScheduleTriggerWorkflowOptions, total=False):
     additional_metadata: Dict[str, str] | None = None
     desired_worker_id: str | None = None
     namespace: str | None = None
 
 
-class WorkflowRunDict(TypedDict):
+class WorkflowRunDict(TypedDict, total=False):
     workflow_name: str
     input: Any
     options: TriggerWorkflowOptions | None
@@ -425,7 +425,7 @@ class AdminClient(AdminClientBase):
         self,
         key: str,
         limit: int,
-        duration: RateLimitDuration = RateLimitDuration.SECOND,
+        duration: Union[RateLimitDuration.Value, str] = RateLimitDuration.SECOND,
     ):
         try:
             self.client.PutRateLimit(

{hatchet_sdk-0.42.2 → hatchet_sdk-0.42.4}/hatchet_sdk/clients/dispatcher/dispatcher.py

@@ -1,3 +1,5 @@
+from typing import Any, cast
+
 from google.protobuf.timestamp_pb2 import Timestamp
 
 from hatchet_sdk.clients.dispatcher.action_listener import (
@@ -31,7 +33,7 @@ from ...metadata import get_metadata
 DEFAULT_REGISTER_TIMEOUT = 30
 
 
-def new_dispatcher(config: ClientConfig):
+def new_dispatcher(config: ClientConfig) -> "DispatcherClient":
     return DispatcherClient(config=config)
 
 
@@ -40,10 +42,10 @@ class DispatcherClient:
 
     def __init__(self, config: ClientConfig):
         conn = new_conn(config)
-        self.client = DispatcherStub(conn)
+        self.client = DispatcherStub(conn)  # type: ignore[no-untyped-call]
 
         aio_conn = new_conn(config, True)
-        self.aio_client = DispatcherStub(aio_conn)
+        self.aio_client = DispatcherStub(aio_conn)  # type: ignore[no-untyped-call]
         self.token = config.token
         self.config = config
 
@@ -67,7 +69,7 @@ class DispatcherClient:
 
     async def send_step_action_event(
         self, action: Action, event_type: StepActionEventType, payload: str
-    ):
+    ) -> Any:
         try:
             return await self._try_send_step_action_event(action, event_type, payload)
         except Exception as e:
@@ -87,7 +89,7 @@ class DispatcherClient:
     @tenacity_retry
     async def _try_send_step_action_event(
         self, action: Action, event_type: StepActionEventType, payload: str
-    ):
+    ) -> Any:
         eventTimestamp = Timestamp()
         eventTimestamp.GetCurrentTime()
 
@@ -103,6 +105,7 @@ class DispatcherClient:
             eventPayload=payload,
         )
 
+        ## TODO: What does this return?
         return await self.aio_client.SendStepActionEvent(
             event,
             metadata=get_metadata(self.token),
@@ -110,7 +113,7 @@ class DispatcherClient:
 
     async def send_group_key_action_event(
         self, action: Action, event_type: GroupKeyActionEventType, payload: str
-    ):
+    ) -> Any:
         eventTimestamp = Timestamp()
         eventTimestamp.GetCurrentTime()
 
@@ -124,19 +127,21 @@ class DispatcherClient:
             eventPayload=payload,
         )
 
+        ## TODO: What does this return?
         return await self.aio_client.SendGroupKeyActionEvent(
             event,
             metadata=get_metadata(self.token),
         )
 
-    def put_overrides_data(self, data: OverridesData):
-        response: ActionEventResponse = self.client.PutOverridesData(
-            data,
-            metadata=get_metadata(self.token),
+    def put_overrides_data(self, data: OverridesData) -> ActionEventResponse:
+        return cast(
+            ActionEventResponse,
+            self.client.PutOverridesData(
+                data,
+                metadata=get_metadata(self.token),
+            ),
         )
 
-        return response
-
     def release_slot(self, step_run_id: str) -> None:
         self.client.ReleaseSlot(
             ReleaseSlotRequest(stepRunId=step_run_id),
@@ -154,7 +159,9 @@ class DispatcherClient:
             metadata=get_metadata(self.token),
         )
 
-    def upsert_worker_labels(self, worker_id: str, labels: dict[str, str | int]):
+    def upsert_worker_labels(
+        self, worker_id: str | None, labels: dict[str, str | int]
+    ) -> None:
         worker_labels = {}
 
         for key, value in labels.items():
@@ -171,9 +178,9 @@ class DispatcherClient:
 
     async def async_upsert_worker_labels(
         self,
-        worker_id: str,
+        worker_id: str | None,
         labels: dict[str, str | int],
-    ):
+    ) -> None:
         worker_labels = {}
 
         for key, value in labels.items():

{hatchet_sdk-0.42.2 → hatchet_sdk-0.42.4}/hatchet_sdk/clients/events.py

@@ -43,16 +43,16 @@ def proto_timestamp_now():
     return timestamp_pb2.Timestamp(seconds=seconds, nanos=nanos)
 
 
-class PushEventOptions(TypedDict):
+class PushEventOptions(TypedDict, total=False):
     additional_metadata: Dict[str, str] | None = None
     namespace: str | None = None
 
 
-class BulkPushEventOptions(TypedDict):
+class BulkPushEventOptions(TypedDict, total=False):
     namespace: str | None = None
 
 
-class BulkPushEventWithMetadata(TypedDict):
+class BulkPushEventWithMetadata(TypedDict, total=False):
     key: str
     payload: Any
     additional_metadata: Optional[Dict[str, Any]]  # Optional metadata

{hatchet_sdk-0.42.2 → hatchet_sdk-0.42.4}/hatchet_sdk/clients/rest/__init__.py

@@ -60,10 +60,10 @@ from hatchet_sdk.clients.rest.models.api_token import APIToken
 from hatchet_sdk.clients.rest.models.bulk_create_event_request import (
     BulkCreateEventRequest,
 )
-from hatchet_sdk.clients.rest.models.bulk_create_event_response import (
-    BulkCreateEventResponse,
-)
 from hatchet_sdk.clients.rest.models.cancel_event_request import CancelEventRequest
+from hatchet_sdk.clients.rest.models.concurrency_limit_strategy import (
+    ConcurrencyLimitStrategy,
+)
 from hatchet_sdk.clients.rest.models.create_api_token_request import (
     CreateAPITokenRequest,
 )
@@ -89,6 +89,7 @@ from hatchet_sdk.clients.rest.models.create_tenant_invite_request import (
 from hatchet_sdk.clients.rest.models.create_tenant_request import CreateTenantRequest
 from hatchet_sdk.clients.rest.models.cron_workflows import CronWorkflows
 from hatchet_sdk.clients.rest.models.cron_workflows_list import CronWorkflowsList
+from hatchet_sdk.clients.rest.models.cron_workflows_method import CronWorkflowsMethod
 from hatchet_sdk.clients.rest.models.cron_workflows_order_by_field import (
     CronWorkflowsOrderByField,
 )
@@ -106,6 +107,7 @@ from hatchet_sdk.clients.rest.models.event_update_cancel200_response import (
 from hatchet_sdk.clients.rest.models.event_workflow_run_summary import (
     EventWorkflowRunSummary,
 )
+from hatchet_sdk.clients.rest.models.events import Events
 from hatchet_sdk.clients.rest.models.get_step_run_diff_response import (
     GetStepRunDiffResponse,
 )
@@ -157,6 +159,9 @@ from hatchet_sdk.clients.rest.models.scheduled_workflows import ScheduledWorkflo
 from hatchet_sdk.clients.rest.models.scheduled_workflows_list import (
     ScheduledWorkflowsList,
 )
+from hatchet_sdk.clients.rest.models.scheduled_workflows_method import (
+    ScheduledWorkflowsMethod,
+)
 from hatchet_sdk.clients.rest.models.scheduled_workflows_order_by_field import (
     ScheduledWorkflowsOrderByField,
 )
@@ -240,6 +245,7 @@ from hatchet_sdk.clients.rest.models.worker_label import WorkerLabel
 from hatchet_sdk.clients.rest.models.worker_list import WorkerList
 from hatchet_sdk.clients.rest.models.worker_runtime_info import WorkerRuntimeInfo
 from hatchet_sdk.clients.rest.models.worker_runtime_sdks import WorkerRuntimeSDKs
+from hatchet_sdk.clients.rest.models.worker_type import WorkerType
 from hatchet_sdk.clients.rest.models.workflow import Workflow
 from hatchet_sdk.clients.rest.models.workflow_concurrency import WorkflowConcurrency
 from hatchet_sdk.clients.rest.models.workflow_kind import WorkflowKind

{hatchet_sdk-0.42.2 → hatchet_sdk-0.42.4}/hatchet_sdk/clients/rest/api/event_api.py

@@ -22,9 +22,6 @@ from hatchet_sdk.clients.rest.api_response import ApiResponse
 from hatchet_sdk.clients.rest.models.bulk_create_event_request import (
     BulkCreateEventRequest,
 )
-from hatchet_sdk.clients.rest.models.bulk_create_event_response import (
-    BulkCreateEventResponse,
-)
 from hatchet_sdk.clients.rest.models.cancel_event_request import CancelEventRequest
 from hatchet_sdk.clients.rest.models.create_event_request import CreateEventRequest
 from hatchet_sdk.clients.rest.models.event import Event
@@ -38,6 +35,7 @@ from hatchet_sdk.clients.rest.models.event_order_by_field import EventOrderByFie
 from hatchet_sdk.clients.rest.models.event_update_cancel200_response import (
     EventUpdateCancel200Response,
 )
+from hatchet_sdk.clients.rest.models.events import Events
 from hatchet_sdk.clients.rest.models.replay_event_request import ReplayEventRequest
 from hatchet_sdk.clients.rest.models.workflow_run_status import WorkflowRunStatus
 from hatchet_sdk.clients.rest.rest import RESTResponseType
@@ -375,7 +373,7 @@ class EventApi:
         _content_type: Optional[StrictStr] = None,
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
-    ) -> BulkCreateEventResponse:
+    ) -> Events:
         """Bulk Create events
 
         Bulk creates new events.
@@ -416,7 +414,7 @@ class EventApi:
         )
 
         _response_types_map: Dict[str, Optional[str]] = {
-            "200": "BulkCreateEventResponse",
+            "200": "Events",
             "400": "APIErrors",
             "403": "APIErrors",
             "429": "APIErrors",
@@ -453,7 +451,7 @@ class EventApi:
         _content_type: Optional[StrictStr] = None,
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
-    ) -> ApiResponse[BulkCreateEventResponse]:
+    ) -> ApiResponse[Events]:
         """Bulk Create events
 
         Bulk creates new events.
@@ -494,7 +492,7 @@ class EventApi:
         )
 
         _response_types_map: Dict[str, Optional[str]] = {
-            "200": "BulkCreateEventResponse",
+            "200": "Events",
             "400": "APIErrors",
             "403": "APIErrors",
             "429": "APIErrors",
@@ -572,7 +570,7 @@ class EventApi:
         )
 
         _response_types_map: Dict[str, Optional[str]] = {
-            "200": "BulkCreateEventResponse",
+            "200": "Events",
             "400": "APIErrors",
             "403": "APIErrors",
             "429": "APIErrors",

{hatchet_sdk-0.42.2 → hatchet_sdk-0.42.4}/hatchet_sdk/clients/rest/api/workflow_api.py

@@ -2540,6 +2540,15 @@ class WorkflowApi:
                 min_length=36, strict=True, max_length=36, description="The tenant id"
             ),
         ],
+        offset: Annotated[
+            Optional[StrictInt], Field(description="The number to skip")
+        ] = None,
+        limit: Annotated[
+            Optional[StrictInt], Field(description="The number to limit by")
+        ] = None,
+        name: Annotated[
+            Optional[StrictStr], Field(description="Search by name")
+        ] = None,
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -2558,6 +2567,12 @@ class WorkflowApi:
 
         :param tenant: The tenant id (required)
         :type tenant: str
+        :param offset: The number to skip
+        :type offset: int
+        :param limit: The number to limit by
+        :type limit: int
+        :param name: Search by name
+        :type name: str
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
                                  timeout. It can also be a pair (tuple) of
@@ -2582,6 +2597,9 @@ class WorkflowApi:
 
         _param = self._workflow_list_serialize(
             tenant=tenant,
+            offset=offset,
+            limit=limit,
+            name=name,
             _request_auth=_request_auth,
             _content_type=_content_type,
             _headers=_headers,
@@ -2611,6 +2629,15 @@ class WorkflowApi:
                 min_length=36, strict=True, max_length=36, description="The tenant id"
             ),
         ],
+        offset: Annotated[
+            Optional[StrictInt], Field(description="The number to skip")
+        ] = None,
+        limit: Annotated[
+            Optional[StrictInt], Field(description="The number to limit by")
+        ] = None,
+        name: Annotated[
+            Optional[StrictStr], Field(description="Search by name")
+        ] = None,
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -2629,6 +2656,12 @@ class WorkflowApi:
 
         :param tenant: The tenant id (required)
         :type tenant: str
+        :param offset: The number to skip
+        :type offset: int
+        :param limit: The number to limit by
+        :type limit: int
+        :param name: Search by name
+        :type name: str
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
                                  timeout. It can also be a pair (tuple) of
@@ -2653,6 +2686,9 @@ class WorkflowApi:
 
         _param = self._workflow_list_serialize(
             tenant=tenant,
+            offset=offset,
+            limit=limit,
+            name=name,
             _request_auth=_request_auth,
             _content_type=_content_type,
             _headers=_headers,
@@ -2682,6 +2718,15 @@ class WorkflowApi:
                 min_length=36, strict=True, max_length=36, description="The tenant id"
             ),
         ],
+        offset: Annotated[
+            Optional[StrictInt], Field(description="The number to skip")
+        ] = None,
+        limit: Annotated[
+            Optional[StrictInt], Field(description="The number to limit by")
+        ] = None,
+        name: Annotated[
+            Optional[StrictStr], Field(description="Search by name")
+        ] = None,
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -2700,6 +2745,12 @@ class WorkflowApi:
 
         :param tenant: The tenant id (required)
         :type tenant: str
+        :param offset: The number to skip
+        :type offset: int
+        :param limit: The number to limit by
+        :type limit: int
+        :param name: Search by name
+        :type name: str
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
                                  timeout. It can also be a pair (tuple) of
@@ -2724,6 +2775,9 @@ class WorkflowApi:
 
         _param = self._workflow_list_serialize(
             tenant=tenant,
+            offset=offset,
+            limit=limit,
+            name=name,
             _request_auth=_request_auth,
             _content_type=_content_type,
             _headers=_headers,
@@ -2743,6 +2797,9 @@ class WorkflowApi:
     def _workflow_list_serialize(
         self,
         tenant,
+        offset,
+        limit,
+        name,
         _request_auth,
         _content_type,
         _headers,
@@ -2766,6 +2823,18 @@ class WorkflowApi:
         if tenant is not None:
             _path_params["tenant"] = tenant
         # process the query parameters
+        if offset is not None:
+
+            _query_params.append(("offset", offset))
+
+        if limit is not None:
+
+            _query_params.append(("limit", limit))
+
+        if name is not None:
+
+            _query_params.append(("name", name))
+
         # process the header parameters
         # process the form parameters
         # process the body parameter

{hatchet_sdk-0.42.2 → hatchet_sdk-0.42.4}/hatchet_sdk/clients/rest/models/__init__.py

@@ -27,10 +27,10 @@ from hatchet_sdk.clients.rest.models.api_token import APIToken
 from hatchet_sdk.clients.rest.models.bulk_create_event_request import (
     BulkCreateEventRequest,
 )
-from hatchet_sdk.clients.rest.models.bulk_create_event_response import (
-    BulkCreateEventResponse,
-)
 from hatchet_sdk.clients.rest.models.cancel_event_request import CancelEventRequest
+from hatchet_sdk.clients.rest.models.concurrency_limit_strategy import (
+    ConcurrencyLimitStrategy,
+)
 from hatchet_sdk.clients.rest.models.create_api_token_request import (
     CreateAPITokenRequest,
 )
@@ -56,6 +56,7 @@ from hatchet_sdk.clients.rest.models.create_tenant_invite_request import (
 from hatchet_sdk.clients.rest.models.create_tenant_request import CreateTenantRequest
 from hatchet_sdk.clients.rest.models.cron_workflows import CronWorkflows
 from hatchet_sdk.clients.rest.models.cron_workflows_list import CronWorkflowsList
+from hatchet_sdk.clients.rest.models.cron_workflows_method import CronWorkflowsMethod
 from hatchet_sdk.clients.rest.models.cron_workflows_order_by_field import (
     CronWorkflowsOrderByField,
 )
@@ -73,6 +74,7 @@ from hatchet_sdk.clients.rest.models.event_update_cancel200_response import (
 from hatchet_sdk.clients.rest.models.event_workflow_run_summary import (
     EventWorkflowRunSummary,
 )
+from hatchet_sdk.clients.rest.models.events import Events
 from hatchet_sdk.clients.rest.models.get_step_run_diff_response import (
     GetStepRunDiffResponse,
 )
@@ -124,6 +126,9 @@ from hatchet_sdk.clients.rest.models.scheduled_workflows import ScheduledWorkflo
 from hatchet_sdk.clients.rest.models.scheduled_workflows_list import (
     ScheduledWorkflowsList,
 )
+from hatchet_sdk.clients.rest.models.scheduled_workflows_method import (
+    ScheduledWorkflowsMethod,
+)
 from hatchet_sdk.clients.rest.models.scheduled_workflows_order_by_field import (
     ScheduledWorkflowsOrderByField,
 )
@@ -207,6 +212,7 @@ from hatchet_sdk.clients.rest.models.worker_label import WorkerLabel
 from hatchet_sdk.clients.rest.models.worker_list import WorkerList
 from hatchet_sdk.clients.rest.models.worker_runtime_info import WorkerRuntimeInfo
 from hatchet_sdk.clients.rest.models.worker_runtime_sdks import WorkerRuntimeSDKs
+from hatchet_sdk.clients.rest.models.worker_type import WorkerType
 from hatchet_sdk.clients.rest.models.workflow import Workflow
 from hatchet_sdk.clients.rest.models.workflow_concurrency import WorkflowConcurrency
 from hatchet_sdk.clients.rest.models.workflow_kind import WorkflowKind

hatchet_sdk-0.42.4/hatchet_sdk/clients/rest/models/concurrency_limit_strategy.py

@@ -0,0 +1,39 @@
+# coding: utf-8
+
+"""
+    Hatchet API
+
+    The Hatchet API
+
+    The version of the OpenAPI document: 1.0.0
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from __future__ import annotations
+
+import json
+from enum import Enum
+
+from typing_extensions import Self
+
+
+class ConcurrencyLimitStrategy(str, Enum):
+    """
+    ConcurrencyLimitStrategy
+    """
+
+    """
+    allowed enum values
+    """
+    CANCEL_IN_PROGRESS = "CANCEL_IN_PROGRESS"
+    DROP_NEWEST = "DROP_NEWEST"
+    QUEUE_NEWEST = "QUEUE_NEWEST"
+    GROUP_ROUND_ROBIN = "GROUP_ROUND_ROBIN"
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Self:
+        """Create an instance of ConcurrencyLimitStrategy from a JSON string"""
+        return cls(json.loads(json_str))

{hatchet_sdk-0.42.2 → hatchet_sdk-0.42.4}/hatchet_sdk/clients/rest/models/cron_workflows.py

@@ -19,17 +19,11 @@ import pprint
 import re  # noqa: F401
 from typing import Any, ClassVar, Dict, List, Optional, Set
 
-from pydantic import (
-    BaseModel,
-    ConfigDict,
-    Field,
-    StrictBool,
-    StrictStr,
-    field_validator,
-)
+from pydantic import BaseModel, ConfigDict, Field, StrictBool, StrictStr
 from typing_extensions import Self
 
 from hatchet_sdk.clients.rest.models.api_resource_meta import APIResourceMeta
+from hatchet_sdk.clients.rest.models.cron_workflows_method import CronWorkflowsMethod
 
 
 class CronWorkflows(BaseModel):
@@ -49,7 +43,7 @@ class CronWorkflows(BaseModel):
         default=None, alias="additionalMetadata"
     )
     enabled: StrictBool
-    method: StrictStr
+    method: CronWorkflowsMethod
     __properties: ClassVar[List[str]] = [
         "metadata",
         "tenantId",
@@ -64,13 +58,6 @@ class CronWorkflows(BaseModel):
         "method",
     ]
 
-    @field_validator("method")
-    def method_validate_enum(cls, value):
-        """Validates the enum"""
-        if value not in set(["DEFAULT", "API"]):
-            raise ValueError("must be one of enum values ('DEFAULT', 'API')")
-        return value
-
     model_config = ConfigDict(
         populate_by_name=True,
         validate_assignment=True,

hatchet_sdk-0.42.4/hatchet_sdk/clients/rest/models/cron_workflows_method.py

@@ -0,0 +1,37 @@
+# coding: utf-8
+
+"""
+    Hatchet API
+
+    The Hatchet API
+
+    The version of the OpenAPI document: 1.0.0
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from __future__ import annotations
+
+import json
+from enum import Enum
+
+from typing_extensions import Self
+
+
+class CronWorkflowsMethod(str, Enum):
+    """
+    CronWorkflowsMethod
+    """
+
+    """
+    allowed enum values
+    """
+    DEFAULT = "DEFAULT"
+    API = "API"
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Self:
+        """Create an instance of CronWorkflowsMethod from a JSON string"""
+        return cls(json.loads(json_str))