procedere-mq-sdk 0.1.0__tar.gz

procedere_mq_sdk-0.1.0/PKG-INFO

@@ -0,0 +1,73 @@
+Metadata-Version: 2.4
+Name: procedere-mq-sdk
+Version: 0.1.0
+Summary: Python SDK para LiteMQ/ProcedereMQ
+Project-URL: Homepage, https://github.com/jeffersontadeuleite/procedereMQ
+Project-URL: Repository, https://github.com/jeffersontadeuleite/procedereMQ
+Project-URL: Issues, https://github.com/jeffersontadeuleite/procedereMQ/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.31.0
+
+# ProcedereMQ
+
+Broker de filas leve com transporte HTTP/TCP e SDKs para Go e Python.
+
+## SDK Go
+
+Import:
+
+```go
+import "github.com/jeffersontadeuleite/procedereMQ/pkg/sdk"
+```
+
+Exemplo:
+
+```go
+client := sdk.NewClient("http://127.0.0.1:65090")
+job, err := client.Dequeue(ctx, "emails")
+if err != nil {
+    return err
+}
+_ = client.Ack(ctx, job.ID)
+```
+
+## SDK Python
+
+Instalação:
+
+```bash
+pip install procedere-mq-sdk
+```
+
+Exemplo:
+
+```python
+from python_sdk import LiteMQClient
+
+client = LiteMQClient("http://127.0.0.1:65090")
+job = client.dequeue("emails")
+client.ack(job["id"])
+```
+
+## Publicação
+
+### Go SDK
+
+```bash
+make publish-go-sdk VERSION=0.2.0
+```
+
+### Python SDK (PyPI)
+
+```bash
+make check-python-sdk
+make publish-python-sdk TWINE_REPOSITORY=pypi
+```

procedere_mq_sdk-0.1.0/README.md

@@ -0,0 +1,55 @@
+# ProcedereMQ
+
+Broker de filas leve com transporte HTTP/TCP e SDKs para Go e Python.
+
+## SDK Go
+
+Import:
+
+```go
+import "github.com/jeffersontadeuleite/procedereMQ/pkg/sdk"
+```
+
+Exemplo:
+
+```go
+client := sdk.NewClient("http://127.0.0.1:65090")
+job, err := client.Dequeue(ctx, "emails")
+if err != nil {
+    return err
+}
+_ = client.Ack(ctx, job.ID)
+```
+
+## SDK Python
+
+Instalação:
+
+```bash
+pip install procedere-mq-sdk
+```
+
+Exemplo:
+
+```python
+from python_sdk import LiteMQClient
+
+client = LiteMQClient("http://127.0.0.1:65090")
+job = client.dequeue("emails")
+client.ack(job["id"])
+```
+
+## Publicação
+
+### Go SDK
+
+```bash
+make publish-go-sdk VERSION=0.2.0
+```
+
+### Python SDK (PyPI)
+
+```bash
+make check-python-sdk
+make publish-python-sdk TWINE_REPOSITORY=pypi
+```

procedere_mq_sdk-0.1.0/procedere_mq_sdk.egg-info/PKG-INFO

@@ -0,0 +1,73 @@
+Metadata-Version: 2.4
+Name: procedere-mq-sdk
+Version: 0.1.0
+Summary: Python SDK para LiteMQ/ProcedereMQ
+Project-URL: Homepage, https://github.com/jeffersontadeuleite/procedereMQ
+Project-URL: Repository, https://github.com/jeffersontadeuleite/procedereMQ
+Project-URL: Issues, https://github.com/jeffersontadeuleite/procedereMQ/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.31.0
+
+# ProcedereMQ
+
+Broker de filas leve com transporte HTTP/TCP e SDKs para Go e Python.
+
+## SDK Go
+
+Import:
+
+```go
+import "github.com/jeffersontadeuleite/procedereMQ/pkg/sdk"
+```
+
+Exemplo:
+
+```go
+client := sdk.NewClient("http://127.0.0.1:65090")
+job, err := client.Dequeue(ctx, "emails")
+if err != nil {
+    return err
+}
+_ = client.Ack(ctx, job.ID)
+```
+
+## SDK Python
+
+Instalação:
+
+```bash
+pip install procedere-mq-sdk
+```
+
+Exemplo:
+
+```python
+from python_sdk import LiteMQClient
+
+client = LiteMQClient("http://127.0.0.1:65090")
+job = client.dequeue("emails")
+client.ack(job["id"])
+```
+
+## Publicação
+
+### Go SDK
+
+```bash
+make publish-go-sdk VERSION=0.2.0
+```
+
+### Python SDK (PyPI)
+
+```bash
+make check-python-sdk
+make publish-python-sdk TWINE_REPOSITORY=pypi
+```

procedere_mq_sdk-0.1.0/procedere_mq_sdk.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+README.md
+pyproject.toml
+procedere_mq_sdk.egg-info/PKG-INFO
+procedere_mq_sdk.egg-info/SOURCES.txt
+procedere_mq_sdk.egg-info/dependency_links.txt
+procedere_mq_sdk.egg-info/requires.txt
+procedere_mq_sdk.egg-info/top_level.txt
+python_sdk/__init__.py
+python_sdk/client.py

procedere_mq_sdk-0.1.0/procedere_mq_sdk.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

procedere_mq_sdk-0.1.0/procedere_mq_sdk.egg-info/requires.txt

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

procedere_mq_sdk-0.1.0/procedere_mq_sdk.egg-info/top_level.txt

@@ -0,0 +1 @@
+python_sdk

procedere_mq_sdk-0.1.0/pyproject.toml

@@ -0,0 +1,30 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "procedere-mq-sdk"
+version = "0.1.0"
+description = "Python SDK para LiteMQ/ProcedereMQ"
+readme = "README.md"
+requires-python = ">=3.9"
+dependencies = [
+  "requests>=2.31.0",
+]
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.9",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Intended Audience :: Developers",
+  "Topic :: Software Development :: Libraries",
+]
+
+[project.urls]
+Homepage = "https://github.com/jeffersontadeuleite/procedereMQ"
+Repository = "https://github.com/jeffersontadeuleite/procedereMQ"
+Issues = "https://github.com/jeffersontadeuleite/procedereMQ/issues"
+
+[tool.setuptools]
+packages = ["python_sdk"]

procedere_mq_sdk-0.1.0/python_sdk/__init__.py

@@ -0,0 +1,8 @@
+from .client import LiteMQClient, LiteMQError, NotFoundError, QueueEmptyError
+
+__all__ = [
+    "LiteMQClient",
+    "LiteMQError",
+    "NotFoundError",
+    "QueueEmptyError",
+]

procedere_mq_sdk-0.1.0/python_sdk/client.py

@@ -0,0 +1,99 @@
+from __future__ import annotations
+
+from datetime import datetime, timezone
+from typing import Any
+
+import requests
+
+
+class LiteMQError(Exception):
+    pass
+
+
+class QueueEmptyError(LiteMQError):
+    pass
+
+
+class NotFoundError(LiteMQError):
+    pass
+
+
+class LiteMQClient:
+    def __init__(self, base_url: str, timeout: float = 10.0) -> None:
+        self.base_url = base_url.rstrip("/")
+        self.timeout = timeout
+        self.session = requests.Session()
+
+    def enqueue(
+        self,
+        queue: str,
+        payload: dict[str, Any] | list[Any] | str | int | float | bool | None = None,
+        *,
+        job_id: str | None = None,
+        max_retry: int | None = None,
+        run_at: datetime | None = None,
+    ) -> dict[str, Any]:
+        if not queue or not queue.strip():
+            raise ValueError("queue is required")
+        body: dict[str, Any] = {"queue": queue}
+        if payload is not None:
+            body["payload"] = payload
+        if job_id:
+            body["id"] = job_id
+        if max_retry is not None:
+            body["max_retry"] = max_retry
+        if run_at is not None:
+            body["run_at"] = self._format_datetime(run_at)
+        return self._request("POST", "/enqueue", json=body, expected_status=201)
+
+    def dequeue(self, queue: str) -> dict[str, Any]:
+        if not queue or not queue.strip():
+            raise ValueError("queue is required")
+        return self._request("GET", "/dequeue", params={"queue": queue}, expected_status=200)
+
+    def ack(self, job_id: str) -> dict[str, Any]:
+        if not job_id or not job_id.strip():
+            raise ValueError("job_id is required")
+        return self._request("POST", "/ack", json={"id": job_id}, expected_status=200)
+
+    def fail(self, job_id: str) -> dict[str, Any]:
+        if not job_id or not job_id.strip():
+            raise ValueError("job_id is required")
+        return self._request("POST", "/fail", json={"id": job_id}, expected_status=200)
+
+    def _request(self, method: str, path: str, expected_status: int, **kwargs: Any) -> dict[str, Any]:
+        url = f"{self.base_url}{path}"
+        response = self.session.request(method, url, timeout=self.timeout, **kwargs)
+
+        if response.status_code == 204:
+            raise QueueEmptyError("queue empty")
+        if response.status_code == 404:
+            raise NotFoundError(self._extract_error(response))
+        if response.status_code != expected_status:
+            raise LiteMQError(self._extract_error(response))
+
+        if not response.content:
+            return {}
+
+        data = response.json()
+        if isinstance(data, dict):
+            return data
+        return {"data": data}
+
+    @staticmethod
+    def _extract_error(response: requests.Response) -> str:
+        try:
+            payload = response.json()
+        except ValueError:
+            return response.text or response.reason
+        if isinstance(payload, dict):
+            message = payload.get("error")
+            if isinstance(message, str) and message.strip():
+                return message
+        return response.text or response.reason
+
+    @staticmethod
+    def _format_datetime(value: datetime) -> str:
+        if value.tzinfo is None:
+            value = value.replace(tzinfo=timezone.utc)
+        return value.astimezone(timezone.utc).isoformat().replace("+00:00", "Z")

procedere_mq_sdk-0.1.0/setup.cfg

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