oomol-cloud-task-sdk 0.1.0__tar.gz

oomol_cloud_task_sdk-0.1.0/PKG-INFO

@@ -0,0 +1,46 @@
+Metadata-Version: 2.4
+Name: oomol-cloud-task-sdk
+Version: 0.1.0
+Summary: Python SDK for Oomol Cloud Task API
+License-Expression: MIT
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.25.0
+
+# Oomol Cloud Task SDK (Python)
+
+A lightweight, developer-friendly Python SDK for `https://cloud-task.oomol.com/v1`.
+
+## Installation
+
+```bash
+pip install oomol-cloud-task-sdk
+```
+
+(Note: You need to build the package locally first or publish it to PyPI)
+
+## Usage
+
+```python
+from oomol_cloud_task import OomolTaskClient, BackoffStrategy
+
+client = OomolTaskClient(api_key="YOUR_API_KEY")
+
+task_id, result = client.create_and_wait(
+    applet_id="54dfbca0-6b2a-4738-bc38-c602981d9be6",
+    input_values={
+        "input_pdf": "...",
+        "output_path": "..."
+    },
+    interval_ms=2000,
+    backoff_strategy=BackoffStrategy.EXPONENTIAL
+)
+
+print(result)
+```
+
+## Features
+
+- **Automatic Polling**: `create_and_wait` handles creation and polling in one step.
+- **Backoff Strategies**: Supports `Fixed` and `Exponential` backoff to reduce server load.
+- **Type Hints**: Fully typed for better IDE support.

oomol_cloud_task_sdk-0.1.0/README.md

@@ -0,0 +1,37 @@
+# Oomol Cloud Task SDK (Python)
+
+A lightweight, developer-friendly Python SDK for `https://cloud-task.oomol.com/v1`.
+
+## Installation
+
+```bash
+pip install oomol-cloud-task-sdk
+```
+
+(Note: You need to build the package locally first or publish it to PyPI)
+
+## Usage
+
+```python
+from oomol_cloud_task import OomolTaskClient, BackoffStrategy
+
+client = OomolTaskClient(api_key="YOUR_API_KEY")
+
+task_id, result = client.create_and_wait(
+    applet_id="54dfbca0-6b2a-4738-bc38-c602981d9be6",
+    input_values={
+        "input_pdf": "...",
+        "output_path": "..."
+    },
+    interval_ms=2000,
+    backoff_strategy=BackoffStrategy.EXPONENTIAL
+)
+
+print(result)
+```
+
+## Features
+
+- **Automatic Polling**: `create_and_wait` handles creation and polling in one step.
+- **Backoff Strategies**: Supports `Fixed` and `Exponential` backoff to reduce server load.
+- **Type Hints**: Fully typed for better IDE support.

oomol_cloud_task_sdk-0.1.0/pyproject.toml

@@ -0,0 +1,14 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "oomol-cloud-task-sdk"
+version = "0.1.0"
+description = "Python SDK for Oomol Cloud Task API"
+readme = "README.md"
+requires-python = ">=3.7"
+license = "MIT"
+dependencies = [
+    "requests>=2.25.0",
+]

oomol_cloud_task_sdk-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

oomol_cloud_task_sdk-0.1.0/src/oomol_cloud_task/__init__.py

@@ -0,0 +1,12 @@
+from .client import OomolTaskClient
+from .errors import ApiError, TaskFailedError, TimeoutError
+from .types import BackoffStrategy, TaskStatus
+
+__all__ = [
+    "OomolTaskClient",
+    "ApiError",
+    "TaskFailedError",
+    "TimeoutError",
+    "BackoffStrategy",
+    "TaskStatus",
+]

oomol_cloud_task_sdk-0.1.0/src/oomol_cloud_task/client.py

@@ -0,0 +1,154 @@
+import time
+import requests
+from typing import Optional, Callable, Dict, Any, Tuple
+from .errors import ApiError, TaskFailedError, TimeoutError
+from .types import BackoffStrategy, TaskStatus, InputValues, Metadata
+
+DEFAULT_BASE_URL = "https://cloud-task.oomol.com/v1"
+
+class OomolTaskClient:
+    def __init__(
+        self,
+        api_key: str,
+        base_url: str = DEFAULT_BASE_URL,
+        default_headers: Optional[Dict[str, str]] = None
+    ):
+        self.api_key = api_key
+        self.base_url = base_url.rstrip("/")
+        self.default_headers = default_headers or {}
+        self.session = requests.Session()
+
+    def create_task(
+        self,
+        applet_id: str,
+        input_values: InputValues,
+        webhook_url: Optional[str] = None,
+        metadata: Optional[Metadata] = None
+    ) -> str:
+        """
+        Creates a task and returns the task ID.
+        """
+        url = f"{self.base_url}/task/applet"
+        
+        body = {
+            "appletID": applet_id,
+            "inputValues": input_values
+        }
+        if webhook_url:
+            body["webhookUrl"] = webhook_url
+        if metadata:
+            body["metadata"] = metadata
+
+        headers = self._get_headers()
+        
+        response = self.session.post(url, json=body, headers=headers)
+        
+        if not response.ok:
+            self._handle_error(response)
+
+        data = response.json()
+        return data["taskID"]
+
+    def get_task_result(self, task_id: str) -> Dict[str, Any]:
+        """
+        Fetches the result of a task.
+        """
+        url = f"{self.base_url}/task/{task_id}/result"
+        headers = self._get_headers()
+        
+        response = self.session.get(url, headers=headers)
+        
+        if not response.ok:
+            self._handle_error(response)
+            
+        return response.json()
+
+    def await_result(
+        self,
+        task_id: str,
+        interval_ms: int = 2000,
+        timeout_ms: Optional[int] = None,
+        backoff_strategy: BackoffStrategy = BackoffStrategy.FIXED,
+        max_interval_ms: int = 15000,
+        on_progress: Optional[Callable[[Optional[float], str], None]] = None
+    ) -> Dict[str, Any]:
+        """
+        Polls for the task result until completion or timeout.
+        """
+        start_time = time.time()
+        attempt = 0
+        current_interval = interval_ms / 1000.0
+        max_interval = max_interval_ms / 1000.0
+
+        while True:
+            # Check timeout
+            if timeout_ms is not None:
+                elapsed = (time.time() - start_time) * 1000
+                if elapsed > timeout_ms:
+                    raise TimeoutError()
+
+            result = self.get_task_result(task_id)
+            status = result.get("status")
+            progress = result.get("progress")
+
+            if status == TaskStatus.SUCCESS.value:
+                return result
+            
+            if status == TaskStatus.FAILED.value:
+                raise TaskFailedError(task_id, result.get("error") or result)
+
+            if on_progress:
+                on_progress(progress, status)
+
+            attempt += 1
+            
+            # Backoff logic
+            if backoff_strategy == BackoffStrategy.EXPONENTIAL:
+                # 1.5x multiplier
+                next_interval = min(max_interval, (interval_ms / 1000.0) * (1.5 ** attempt))
+            else:
+                next_interval = current_interval
+
+            time.sleep(next_interval)
+
+    def create_and_wait(
+        self,
+        applet_id: str,
+        input_values: InputValues,
+        webhook_url: Optional[str] = None,
+        metadata: Optional[Metadata] = None,
+        interval_ms: int = 2000,
+        timeout_ms: Optional[int] = None,
+        backoff_strategy: BackoffStrategy = BackoffStrategy.FIXED,
+        max_interval_ms: int = 15000,
+        on_progress: Optional[Callable[[Optional[float], str], None]] = None
+    ) -> Tuple[str, Dict[str, Any]]:
+        """
+        Creates a task and waits for its completion.
+        Returns (task_id, result).
+        """
+        task_id = self.create_task(applet_id, input_values, webhook_url, metadata)
+        result = self.await_result(
+            task_id=task_id,
+            interval_ms=interval_ms,
+            timeout_ms=timeout_ms,
+            backoff_strategy=backoff_strategy,
+            max_interval_ms=max_interval_ms,
+            on_progress=on_progress
+        )
+        return task_id, result
+
+    def _get_headers(self) -> Dict[str, str]:
+        headers = {
+            "Content-Type": "application/json",
+            "Authorization": f"Bearer {self.api_key}",
+        }
+        headers.update(self.default_headers)
+        return headers
+
+    def _handle_error(self, response: requests.Response):
+        try:
+            body = response.json()
+        except ValueError:
+            body = response.text
+        raise ApiError(f"Request failed: {response.status_code}", response.status_code, body)

oomol_cloud_task_sdk-0.1.0/src/oomol_cloud_task/errors.py

@@ -0,0 +1,17 @@
+class ApiError(Exception):
+    def __init__(self, message: str, status: int, body: any = None):
+        super().__init__(message)
+        self.status = status
+        self.body = body
+
+
+class TaskFailedError(Exception):
+    def __init__(self, task_id: str, detail: any = None):
+        super().__init__(f"Task execution failed: {task_id}")
+        self.task_id = task_id
+        self.detail = detail
+
+
+class TimeoutError(Exception):
+    def __init__(self, message: str = "Operation timed out"):
+        super().__init__(message)

oomol_cloud_task_sdk-0.1.0/src/oomol_cloud_task/types.py

@@ -0,0 +1,16 @@
+from enum import Enum
+from typing import Dict, Optional, Any, Union
+
+class BackoffStrategy(Enum):
+    FIXED = "fixed"
+    EXPONENTIAL = "exp"
+
+class TaskStatus(str, Enum):
+    PENDING = "pending"
+    RUNNING = "running"
+    SUCCESS = "success"
+    FAILED = "failed"
+
+# Type aliases for better readability
+InputValues = Dict[str, Any]
+Metadata = Dict[str, Any]

oomol_cloud_task_sdk-0.1.0/src/oomol_cloud_task_sdk.egg-info/PKG-INFO

@@ -0,0 +1,46 @@
+Metadata-Version: 2.4
+Name: oomol-cloud-task-sdk
+Version: 0.1.0
+Summary: Python SDK for Oomol Cloud Task API
+License-Expression: MIT
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.25.0
+
+# Oomol Cloud Task SDK (Python)
+
+A lightweight, developer-friendly Python SDK for `https://cloud-task.oomol.com/v1`.
+
+## Installation
+
+```bash
+pip install oomol-cloud-task-sdk
+```
+
+(Note: You need to build the package locally first or publish it to PyPI)
+
+## Usage
+
+```python
+from oomol_cloud_task import OomolTaskClient, BackoffStrategy
+
+client = OomolTaskClient(api_key="YOUR_API_KEY")
+
+task_id, result = client.create_and_wait(
+    applet_id="54dfbca0-6b2a-4738-bc38-c602981d9be6",
+    input_values={
+        "input_pdf": "...",
+        "output_path": "..."
+    },
+    interval_ms=2000,
+    backoff_strategy=BackoffStrategy.EXPONENTIAL
+)
+
+print(result)
+```
+
+## Features
+
+- **Automatic Polling**: `create_and_wait` handles creation and polling in one step.
+- **Backoff Strategies**: Supports `Fixed` and `Exponential` backoff to reduce server load.
+- **Type Hints**: Fully typed for better IDE support.

oomol_cloud_task_sdk-0.1.0/src/oomol_cloud_task_sdk.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+README.md
+pyproject.toml
+src/oomol_cloud_task/__init__.py
+src/oomol_cloud_task/client.py
+src/oomol_cloud_task/errors.py
+src/oomol_cloud_task/types.py
+src/oomol_cloud_task_sdk.egg-info/PKG-INFO
+src/oomol_cloud_task_sdk.egg-info/SOURCES.txt
+src/oomol_cloud_task_sdk.egg-info/dependency_links.txt
+src/oomol_cloud_task_sdk.egg-info/requires.txt
+src/oomol_cloud_task_sdk.egg-info/top_level.txt

oomol_cloud_task_sdk-0.1.0/src/oomol_cloud_task_sdk.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

oomol_cloud_task_sdk-0.1.0/src/oomol_cloud_task_sdk.egg-info/requires.txt

@@ -0,0 +1 @@
+requests>=2.25.0

oomol_cloud_task_sdk-0.1.0/src/oomol_cloud_task_sdk.egg-info/top_level.txt

@@ -0,0 +1 @@
+oomol_cloud_task