runqy-python 0.2.0__tar.gz → 0.2.1__tar.gz

{runqy_python-0.2.0/src/runqy_python.egg-info → runqy_python-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: runqy-python
-Version: 0.2.0
+Version: 0.2.1
 Summary: Python SDK for runqy - write distributed task handlers with simple decorators
 Author: Publikey
 Project-URL: Documentation, https://docs.runqy.com
@@ -118,7 +118,7 @@ from runqy_python import RunqyClient
 client = RunqyClient("http://localhost:3000", api_key="your-api-key")
 
 # Enqueue a task
-task = client.enqueue("inference_default", {"input": "hello"})
+task = client.enqueue("inference.default", {"input": "hello"})
 print(f"Task ID: {task.task_id}")
 
 # Check result
@@ -132,7 +132,7 @@ Or use the convenience function:
 from runqy_python import enqueue
 
 task = enqueue(
-    "inference_default",
+    "inference.default",
     {"input": "hello"},
     server_url="http://localhost:3000",
     api_key="your-api-key"
@@ -147,7 +147,7 @@ task = enqueue(
 - `timeout`: Default request timeout in seconds
 
 **client.enqueue(queue, payload, timeout=300)**
-- `queue`: Queue name (e.g., `"inference_default"`)
+- `queue`: Queue name (e.g., `"inference.default"`)
 - `payload`: Task payload as a dict
 - `timeout`: Task execution timeout in seconds
 - Returns: `TaskInfo` with `task_id`, `queue`, `state`

{runqy_python-0.2.0 → runqy_python-0.2.1}/README.md

@@ -95,7 +95,7 @@ from runqy_python import RunqyClient
 client = RunqyClient("http://localhost:3000", api_key="your-api-key")
 
 # Enqueue a task
-task = client.enqueue("inference_default", {"input": "hello"})
+task = client.enqueue("inference.default", {"input": "hello"})
 print(f"Task ID: {task.task_id}")
 
 # Check result
@@ -109,7 +109,7 @@ Or use the convenience function:
 from runqy_python import enqueue
 
 task = enqueue(
-    "inference_default",
+    "inference.default",
     {"input": "hello"},
     server_url="http://localhost:3000",
     api_key="your-api-key"
@@ -124,7 +124,7 @@ task = enqueue(
 - `timeout`: Default request timeout in seconds
 
 **client.enqueue(queue, payload, timeout=300)**
-- `queue`: Queue name (e.g., `"inference_default"`)
+- `queue`: Queue name (e.g., `"inference.default"`)
 - `payload`: Task payload as a dict
 - `timeout`: Task execution timeout in seconds
 - Returns: `TaskInfo` with `task_id`, `queue`, `state`

{runqy_python-0.2.0 → runqy_python-0.2.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "runqy-python"
-version = "0.2.0"
+version = "0.2.1"
 description = "Python SDK for runqy - write distributed task handlers with simple decorators"
 readme = "README.md"
 requires-python = ">=3.8"

{runqy_python-0.2.0 → runqy_python-0.2.1}/src/runqy_python/__init__.py

@@ -8,10 +8,12 @@ from .runner import run, run_once
 from .client import (
     RunqyClient,
     TaskInfo,
+    BatchResult,
     RunqyError,
     AuthenticationError,
     TaskNotFoundError,
     enqueue,
+    enqueue_batch,
 )
 
 __all__ = [
@@ -23,10 +25,12 @@ __all__ = [
     # Client
     "RunqyClient",
     "TaskInfo",
+    "BatchResult",
     "RunqyError",
     "AuthenticationError",
     "TaskNotFoundError",
     "enqueue",
+    "enqueue_batch",
 ]
 
 __version__ = "0.2.0"

{runqy_python-0.2.0 → runqy_python-0.2.1}/src/runqy_python/client.py

@@ -42,6 +42,22 @@ class TaskInfo:
     payload: Optional[Dict[str, Any]] = None
 
 
+@dataclass
+class BatchResult:
+    """Result of a batch enqueue operation.
+
+    Attributes:
+        enqueued: Number of successfully enqueued tasks
+        failed: Number of failed tasks
+        task_ids: List of task IDs for successful tasks
+        errors: List of error messages for failed tasks
+    """
+    enqueued: int
+    failed: int
+    task_ids: list
+    errors: list
+
+
 class RunqyClient:
     """Client for interacting with runqy server.
 
@@ -49,7 +65,7 @@ class RunqyClient:
         client = RunqyClient("http://localhost:3000", api_key="your-api-key")
 
         # Enqueue a task
-        task = client.enqueue("inference_default", {"input": "hello"})
+        task = client.enqueue("inference.default", {"input": "hello"})
         print(f"Task ID: {task.task_id}")
 
         # Check result
@@ -128,7 +144,7 @@ class RunqyClient:
         """Enqueue a task to a queue.
 
         Args:
-            queue: Queue name (e.g., "inference_default")
+            queue: Queue name (e.g., "inference.default")
             payload: Task payload data
             timeout: Task execution timeout in seconds (default: 300)
 
@@ -140,7 +156,7 @@ class RunqyClient:
             RunqyError: For other errors
 
         Example:
-            task = client.enqueue("inference_default", {"input": "hello"})
+            task = client.enqueue("inference.default", {"input": "hello"})
             print(f"Enqueued task: {task.task_id}")
         """
         data = {
@@ -159,6 +175,58 @@ class RunqyClient:
             payload=payload,
         )
 
+    def enqueue_batch(
+        self,
+        queue: str,
+        payloads: list,
+        timeout: int = 300
+    ) -> BatchResult:
+        """Enqueue multiple tasks in a single request.
+
+        Uses the batch endpoint for high-throughput job submission.
+        This is significantly faster than calling enqueue() multiple times.
+
+        Args:
+            queue: Queue name (e.g., "inference.default")
+            payloads: List of task payload dictionaries
+            timeout: Task execution timeout in seconds (default: 300)
+
+        Returns:
+            BatchResult with counts and task IDs
+
+        Raises:
+            AuthenticationError: If API key is invalid
+            RunqyError: For other errors
+
+        Example:
+            result = client.enqueue_batch("inference.default", [
+                {"input": "hello"},
+                {"input": "world"},
+                {"input": "foo"},
+            ])
+            print(f"Enqueued: {result.enqueued}, Task IDs: {result.task_ids}")
+        """
+        # Build jobs array with proper structure
+        jobs = [
+            {"timeout": timeout, "data": payload}
+            for payload in payloads
+        ]
+
+        data = {
+            "queue": queue,
+            "timeout": timeout,
+            "jobs": jobs,
+        }
+
+        response = self._request("POST", "/queue/add-batch", data)
+
+        return BatchResult(
+            enqueued=response.get("enqueued", 0),
+            failed=response.get("failed", 0),
+            task_ids=response.get("task_ids", []),
+            errors=response.get("errors", []),
+        )
+
     def get_task(self, task_id: str) -> TaskInfo:
         """Get task status and result.
 
@@ -217,7 +285,7 @@ def enqueue(
     """Quick enqueue without creating a client instance.
 
     Args:
-        queue: Queue name (e.g., "inference_default")
+        queue: Queue name (e.g., "inference.default")
         payload: Task payload data
         server_url: Base URL of the runqy server
         api_key: API key for authentication
@@ -230,7 +298,7 @@ def enqueue(
         from runqy_python import enqueue
 
         task = enqueue(
-            "inference_default",
+            "inference.default",
             {"input": "hello"},
             server_url="http://localhost:3000",
             api_key="your-api-key"
@@ -238,3 +306,36 @@ def enqueue(
         print(f"Task ID: {task.task_id}")
     """
     return RunqyClient(server_url, api_key).enqueue(queue, payload, timeout)
+
+
+def enqueue_batch(
+    queue: str,
+    payloads: list,
+    server_url: str,
+    api_key: str,
+    timeout: int = 300
+) -> BatchResult:
+    """Quick batch enqueue without creating a client instance.
+
+    Args:
+        queue: Queue name (e.g., "inference.default")
+        payloads: List of task payload dictionaries
+        server_url: Base URL of the runqy server
+        api_key: API key for authentication
+        timeout: Task execution timeout in seconds (default: 300)
+
+    Returns:
+        BatchResult with counts and task IDs
+
+    Example:
+        from runqy_python import enqueue_batch
+
+        result = enqueue_batch(
+            "inference.default",
+            [{"input": "hello"}, {"input": "world"}],
+            server_url="http://localhost:3000",
+            api_key="your-api-key"
+        )
+        print(f"Enqueued {result.enqueued} tasks")
+    """
+    return RunqyClient(server_url, api_key).enqueue_batch(queue, payloads, timeout)

{runqy_python-0.2.0 → runqy_python-0.2.1/src/runqy_python.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: runqy-python
-Version: 0.2.0
+Version: 0.2.1
 Summary: Python SDK for runqy - write distributed task handlers with simple decorators
 Author: Publikey
 Project-URL: Documentation, https://docs.runqy.com
@@ -118,7 +118,7 @@ from runqy_python import RunqyClient
 client = RunqyClient("http://localhost:3000", api_key="your-api-key")
 
 # Enqueue a task
-task = client.enqueue("inference_default", {"input": "hello"})
+task = client.enqueue("inference.default", {"input": "hello"})
 print(f"Task ID: {task.task_id}")
 
 # Check result
@@ -132,7 +132,7 @@ Or use the convenience function:
 from runqy_python import enqueue
 
 task = enqueue(
-    "inference_default",
+    "inference.default",
     {"input": "hello"},
     server_url="http://localhost:3000",
     api_key="your-api-key"
@@ -147,7 +147,7 @@ task = enqueue(
 - `timeout`: Default request timeout in seconds
 
 **client.enqueue(queue, payload, timeout=300)**
-- `queue`: Queue name (e.g., `"inference_default"`)
+- `queue`: Queue name (e.g., `"inference.default"`)
 - `payload`: Task payload as a dict
 - `timeout`: Task execution timeout in seconds
 - Returns: `TaskInfo` with `task_id`, `queue`, `state`