render_sdk 0.1.2__py3-none-any.whl → 0.2.0__py3-none-any.whl

render_sdk/public_api/models/workflow_update.py

@@ -0,0 +1,90 @@
+from collections.abc import Mapping
+from typing import TYPE_CHECKING, Any, TypeVar, Union
+
+from attrs import define as _attrs_define
+from attrs import field as _attrs_field
+
+from ..types import UNSET, Unset
+
+if TYPE_CHECKING:
+    from ..models.build_config import BuildConfig
+
+
+T = TypeVar("T", bound="WorkflowUpdate")
+
+
+@_attrs_define
+class WorkflowUpdate:
+    """
+    Attributes:
+        name (Union[Unset, str]):
+        build_config (Union[Unset, BuildConfig]):
+        run_command (Union[Unset, str]): The command to run the workflow
+    """
+
+    name: Union[Unset, str] = UNSET
+    build_config: Union[Unset, "BuildConfig"] = UNSET
+    run_command: Union[Unset, str] = UNSET
+    additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
+
+    def to_dict(self) -> dict[str, Any]:
+        name = self.name
+
+        build_config: Union[Unset, dict[str, Any]] = UNSET
+        if not isinstance(self.build_config, Unset):
+            build_config = self.build_config.to_dict()
+
+        run_command = self.run_command
+
+        field_dict: dict[str, Any] = {}
+        field_dict.update(self.additional_properties)
+        field_dict.update({})
+        if name is not UNSET:
+            field_dict["name"] = name
+        if build_config is not UNSET:
+            field_dict["buildConfig"] = build_config
+        if run_command is not UNSET:
+            field_dict["runCommand"] = run_command
+
+        return field_dict
+
+    @classmethod
+    def from_dict(cls: type[T], src_dict: Mapping[str, Any]) -> T:
+        from ..models.build_config import BuildConfig
+
+        d = dict(src_dict)
+        name = d.pop("name", UNSET)
+
+        _build_config = d.pop("buildConfig", UNSET)
+        build_config: Union[Unset, BuildConfig]
+        if isinstance(_build_config, Unset):
+            build_config = UNSET
+        else:
+            build_config = BuildConfig.from_dict(_build_config)
+
+        run_command = d.pop("runCommand", UNSET)
+
+        workflow_update = cls(
+            name=name,
+            build_config=build_config,
+            run_command=run_command,
+        )
+
+        workflow_update.additional_properties = d
+        return workflow_update
+
+    @property
+    def additional_keys(self) -> list[str]:
+        return list(self.additional_properties.keys())
+
+    def __getitem__(self, key: str) -> Any:
+        return self.additional_properties[key]
+
+    def __setitem__(self, key: str, value: Any) -> None:
+        self.additional_properties[key] = value
+
+    def __delitem__(self, key: str) -> None:
+        del self.additional_properties[key]
+
+    def __contains__(self, key: str) -> bool:
+        return key in self.additional_properties

render_sdk/public_api/models/workflow_version.py

@@ -1,14 +1,12 @@
 import datetime
 from collections.abc import Mapping
-from typing import TYPE_CHECKING, Any, TypeVar
+from typing import Any, TypeVar
 
 from attrs import define as _attrs_define
 from attrs import field as _attrs_field
 from dateutil.parser import isoparse
 
-if TYPE_CHECKING:
-    from ..models.image_version import ImageVersion
-
+from ..models.workflow_version_status import WorkflowVersionStatus
 
 T = TypeVar("T", bound="WorkflowVersion")
 
@@ -20,15 +18,15 @@ class WorkflowVersion:
         id (str):
         workflow_id (str):
         name (str):
-        image (ImageVersion):
         created_at (datetime.datetime):
+        status (WorkflowVersionStatus):
     """
 
     id: str
     workflow_id: str
     name: str
-    image: "ImageVersion"
     created_at: datetime.datetime
+    status: WorkflowVersionStatus
     additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
 
     def to_dict(self) -> dict[str, Any]:
@@ -38,10 +36,10 @@ class WorkflowVersion:
 
         name = self.name
 
-        image = self.image.to_dict()
-
         created_at = self.created_at.isoformat()
 
+        status = self.status.value
+
         field_dict: dict[str, Any] = {}
         field_dict.update(self.additional_properties)
         field_dict.update(
@@ -49,8 +47,8 @@ class WorkflowVersion:
                 "id": id,
                 "workflowId": workflow_id,
                 "name": name,
-                "image": image,
                 "createdAt": created_at,
+                "status": status,
             }
         )
 
@@ -58,8 +56,6 @@ class WorkflowVersion:
 
     @classmethod
     def from_dict(cls: type[T], src_dict: Mapping[str, Any]) -> T:
-        from ..models.image_version import ImageVersion
-
         d = dict(src_dict)
         id = d.pop("id")
 
@@ -67,16 +63,16 @@ class WorkflowVersion:
 
         name = d.pop("name")
 
-        image = ImageVersion.from_dict(d.pop("image"))
-
         created_at = isoparse(d.pop("createdAt"))
 
+        status = WorkflowVersionStatus(d.pop("status"))
+
         workflow_version = cls(
             id=id,
             workflow_id=workflow_id,
             name=name,
-            image=image,
             created_at=created_at,
+            status=status,
         )
 
         workflow_version.additional_properties = d

render_sdk/public_api/models/workflow_version_status.py

@@ -0,0 +1,13 @@
+from enum import Enum
+
+
+class WorkflowVersionStatus(str, Enum):
+    BUILDING = "building"
+    BUILD_FAILED = "build_failed"
+    CREATED = "created"
+    READY = "ready"
+    REGISTERING = "registering"
+    REGISTRATION_FAILED = "registration_failed"
+
+    def __str__(self) -> str:
+        return str(self.value)

render_sdk/public_api/models/workflow_version_with_cursor.py

@@ -0,0 +1,73 @@
+from collections.abc import Mapping
+from typing import TYPE_CHECKING, Any, TypeVar
+
+from attrs import define as _attrs_define
+from attrs import field as _attrs_field
+
+if TYPE_CHECKING:
+    from ..models.workflow_version import WorkflowVersion
+
+
+T = TypeVar("T", bound="WorkflowVersionWithCursor")
+
+
+@_attrs_define
+class WorkflowVersionWithCursor:
+    """
+    Attributes:
+        workflow_version (WorkflowVersion):
+        cursor (str):
+    """
+
+    workflow_version: "WorkflowVersion"
+    cursor: str
+    additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
+
+    def to_dict(self) -> dict[str, Any]:
+        workflow_version = self.workflow_version.to_dict()
+
+        cursor = self.cursor
+
+        field_dict: dict[str, Any] = {}
+        field_dict.update(self.additional_properties)
+        field_dict.update(
+            {
+                "workflowVersion": workflow_version,
+                "cursor": cursor,
+            }
+        )
+
+        return field_dict
+
+    @classmethod
+    def from_dict(cls: type[T], src_dict: Mapping[str, Any]) -> T:
+        from ..models.workflow_version import WorkflowVersion
+
+        d = dict(src_dict)
+        workflow_version = WorkflowVersion.from_dict(d.pop("workflowVersion"))
+
+        cursor = d.pop("cursor")
+
+        workflow_version_with_cursor = cls(
+            workflow_version=workflow_version,
+            cursor=cursor,
+        )
+
+        workflow_version_with_cursor.additional_properties = d
+        return workflow_version_with_cursor
+
+    @property
+    def additional_keys(self) -> list[str]:
+        return list(self.additional_properties.keys())
+
+    def __getitem__(self, key: str) -> Any:
+        return self.additional_properties[key]
+
+    def __setitem__(self, key: str, value: Any) -> None:
+        self.additional_properties[key] = value
+
+    def __delitem__(self, key: str) -> None:
+        del self.additional_properties[key]
+
+    def __contains__(self, key: str) -> bool:
+        return key in self.additional_properties

render_sdk/public_api/models/workflow_with_cursor.py

@@ -0,0 +1,73 @@
+from collections.abc import Mapping
+from typing import TYPE_CHECKING, Any, TypeVar
+
+from attrs import define as _attrs_define
+from attrs import field as _attrs_field
+
+if TYPE_CHECKING:
+    from ..models.workflow import Workflow
+
+
+T = TypeVar("T", bound="WorkflowWithCursor")
+
+
+@_attrs_define
+class WorkflowWithCursor:
+    """
+    Attributes:
+        workflow (Workflow):
+        cursor (str):
+    """
+
+    workflow: "Workflow"
+    cursor: str
+    additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
+
+    def to_dict(self) -> dict[str, Any]:
+        workflow = self.workflow.to_dict()
+
+        cursor = self.cursor
+
+        field_dict: dict[str, Any] = {}
+        field_dict.update(self.additional_properties)
+        field_dict.update(
+            {
+                "workflow": workflow,
+                "cursor": cursor,
+            }
+        )
+
+        return field_dict
+
+    @classmethod
+    def from_dict(cls: type[T], src_dict: Mapping[str, Any]) -> T:
+        from ..models.workflow import Workflow
+
+        d = dict(src_dict)
+        workflow = Workflow.from_dict(d.pop("workflow"))
+
+        cursor = d.pop("cursor")
+
+        workflow_with_cursor = cls(
+            workflow=workflow,
+            cursor=cursor,
+        )
+
+        workflow_with_cursor.additional_properties = d
+        return workflow_with_cursor
+
+    @property
+    def additional_keys(self) -> list[str]:
+        return list(self.additional_properties.keys())
+
+    def __getitem__(self, key: str) -> Any:
+        return self.additional_properties[key]
+
+    def __setitem__(self, key: str, value: Any) -> None:
+        self.additional_properties[key] = value
+
+    def __delitem__(self, key: str) -> None:
+        del self.additional_properties[key]
+
+    def __contains__(self, key: str) -> bool:
+        return key in self.additional_properties

render_sdk/render.py

@@ -0,0 +1,65 @@
+"""Unified REST API client for Render services."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from render_sdk.client import Client
+    from render_sdk.client.workflows import WorkflowsService
+
+
+class Render:
+    """
+    Unified REST API client for all Render services.
+
+    This is the primary entry point for interacting with Render's APIs.
+
+    Example:
+        render = Render()  # Uses RENDER_API_KEY from environment
+
+        # Run a task
+        result = await render.workflows.run_task("my-workflow/my-task", [42])
+
+        # Direct client access for advanced use cases
+        render.client.workflows.run_task(...)
+    """
+
+    _client: Client
+
+    def __init__(
+        self,
+        *,
+        token: str | None = None,
+        base_url: str = "https://api.render.com",
+    ) -> None:
+        """
+        Initialize the Render SDK.
+
+        Args:
+            token: API token. If not provided, uses RENDER_API_KEY env var.
+            base_url: API base URL (rarely needed).
+        """
+        from render_sdk.client import Client
+
+        self._client = Client(token=token, base_url=base_url)
+
+    @property
+    def client(self) -> Client:
+        """
+        Access to the underlying API client.
+
+        Use this for fine-grained control or advanced use cases.
+
+        Example:
+            render = Render()
+
+            # Access client directly
+            render.client.workflows.run_task(...)
+        """
+        return self._client
+
+    @property
+    def workflows(self) -> WorkflowsService:
+        """REST API for workflow operations (run tasks, get status)."""
+        return self._client.workflows

render_sdk/version.py

@@ -0,0 +1,27 @@
+"""Version information for the Render SDK."""
+
+import importlib.metadata
+import platform
+
+
+def get_version() -> str:
+    """Get the SDK version from package metadata."""
+    try:
+        return importlib.metadata.version("render_sdk")
+    except importlib.metadata.PackageNotFoundError:
+        return "unknown"
+
+
+def get_user_agent() -> str:
+    """Get the User-Agent string for the SDK.
+
+    Returns a string like:
+        render-sdk-python/0.1.3 (cpython/3.11.4; darwin/arm64)
+    """
+    version = get_version()
+    impl = platform.python_implementation().lower()
+    py_version = platform.python_version()
+    os_name = platform.system().lower()
+    arch = platform.machine().lower()
+
+    return f"render-sdk-python/{version} ({impl}/{py_version}; {os_name}/{arch})"

render_sdk/workflows/__init__.py

@@ -1,3 +1,6 @@
+"""Render SDK - Durable Workflows Task Definition"""
+
+from render_sdk.workflows.app import Workflows
 from render_sdk.workflows.runner import start
 from render_sdk.workflows.task import Options, Retry, TaskRegistry, task
 
@@ -5,7 +8,8 @@ __all__ = [
     "Options",
     "Retry",
     "TaskRegistry",
-    "create_task_decorator",
+    "Workflows",
+    # Deprecated: use Workflows.task and Workflows.start() instead
     "start",
     "task",
 ]