bafredo-devsms 0.1.0__tar.gz

bafredo_devsms-0.1.0/.gitignore

@@ -0,0 +1,25 @@
+.env
+.env.local
+.DS_Store
+backend/.env
+backend/bin/
+backend/.cache/
+backend/coverage.out
+backend/devsms
+backend/tmp/
+firmware/.pio/
+firmware/.vscode/
+frontend/node_modules/
+frontend/dist/
+frontend/*.tsbuildinfo
+frontend/vite.config.js
+frontend/vite.config.d.ts
+mosquitto/data/
+mosquitto/log/
+postgres-data/
+sdks/java/target/
+sdks/nodejs/*.tgz
+sdks/python/**/__pycache__/
+sdks/python/build/
+sdks/python/dist/
+testtext_muyoma_me/

bafredo_devsms-0.1.0/PKG-INFO

@@ -0,0 +1,41 @@
+Metadata-Version: 2.4
+Name: bafredo-devsms
+Version: 0.1.0
+Summary: Official DevSMS SDK for Python
+Project-URL: Homepage, https://github.com/Bafredo/devsms-python
+Project-URL: Repository, https://github.com/Bafredo/devsms-python
+Author: Bafredo
+License: MIT
+Keywords: api,devsms,sdk,sms
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# DevSMS Python SDK
+
+Package: `bafredo-devsms`
+
+## Install
+
+```bash
+pip install bafredo-devsms
+```
+
+## Usage
+
+```python
+from devsms import DevSMSClient
+
+client = DevSMSClient(api_key="YOUR_API_KEY")
+
+response = client.send(
+    to="+254712345678",
+    message="Hello from Python",
+    correlation_id="order-1001",
+)
+
+print(response.message_id, response.status)
+```

bafredo_devsms-0.1.0/README.md

@@ -0,0 +1,25 @@
+# DevSMS Python SDK
+
+Package: `bafredo-devsms`
+
+## Install
+
+```bash
+pip install bafredo-devsms
+```
+
+## Usage
+
+```python
+from devsms import DevSMSClient
+
+client = DevSMSClient(api_key="YOUR_API_KEY")
+
+response = client.send(
+    to="+254712345678",
+    message="Hello from Python",
+    correlation_id="order-1001",
+)
+
+print(response.message_id, response.status)
+```

bafredo_devsms-0.1.0/devsms/__init__.py

@@ -0,0 +1,8 @@
+from .client import DEFAULT_BASE_URL, DevSMSClient, DevSMSError, SendSMSResponse
+
+__all__ = [
+    "DEFAULT_BASE_URL",
+    "DevSMSClient",
+    "DevSMSError",
+    "SendSMSResponse",
+]

bafredo_devsms-0.1.0/devsms/client.py

@@ -0,0 +1,101 @@
+from __future__ import annotations
+
+import json
+from dataclasses import dataclass
+from typing import Any, Optional
+from urllib import error, request
+
+DEFAULT_BASE_URL = "https://devtext.site"
+
+
+class DevSMSError(Exception):
+    def __init__(
+        self,
+        message: str,
+        status_code: int = 0,
+        details: Optional[dict[str, Any]] = None,
+    ) -> None:
+        super().__init__(message)
+        self.status_code = status_code
+        self.details = details or {}
+
+
+@dataclass(frozen=True)
+class SendSMSResponse:
+    message_id: str
+    status: str
+    to: str
+    message: str
+    correlation_id: Optional[str]
+    provider_reference: Optional[str]
+    created_at: Optional[str]
+    updated_at: Optional[str]
+
+    @classmethod
+    def from_api_payload(cls, payload: dict[str, Any]) -> "SendSMSResponse":
+        return cls(
+            message_id=str(payload.get("id", "")),
+            status=str(payload.get("status", "")),
+            to=str(payload.get("to_number", "")),
+            message=str(payload.get("message", "")),
+            correlation_id=payload.get("correlation_id"),
+            provider_reference=payload.get("provider_reference"),
+            created_at=payload.get("created_at"),
+            updated_at=payload.get("updated_at"),
+        )
+
+
+class DevSMSClient:
+    def __init__(self, api_key: str, base_url: str = DEFAULT_BASE_URL, timeout: int = 30) -> None:
+        if not str(api_key or "").strip():
+            raise DevSMSError("api_key is required")
+
+        self.api_key = str(api_key).strip()
+        self.base_url = str(base_url or DEFAULT_BASE_URL).rstrip("/")
+        self.timeout = timeout
+
+    def send(
+        self,
+        *,
+        to: str,
+        message: str,
+        correlation_id: Optional[str] = None,
+    ) -> SendSMSResponse:
+        if not str(to or "").strip():
+            raise DevSMSError("to is required")
+        if not str(message or "").strip():
+            raise DevSMSError("message is required")
+
+        payload: dict[str, Any] = {
+            "to": str(to).strip(),
+            "message": str(message).strip(),
+        }
+        if str(correlation_id or "").strip():
+            payload["correlation_id"] = str(correlation_id).strip()
+
+        body = json.dumps(payload).encode("utf-8")
+        req = request.Request(
+            url=f"{self.base_url}/v1/sms/send",
+            data=body,
+            method="POST",
+            headers={
+                "Content-Type": "application/json",
+                "X-API-Key": self.api_key,
+            },
+        )
+
+        try:
+            with request.urlopen(req, timeout=self.timeout) as response:
+                raw = response.read().decode("utf-8")
+                parsed = json.loads(raw) if raw else {}
+                return SendSMSResponse.from_api_payload(parsed)
+        except error.HTTPError as exc:
+            raw = exc.read().decode("utf-8")
+            details = json.loads(raw) if raw else {}
+            raise DevSMSError(
+                details.get("error", f"DevSMS request failed with status {exc.code}"),
+                status_code=exc.code,
+                details=details,
+            ) from exc
+        except error.URLError as exc:
+            raise DevSMSError(str(exc.reason), status_code=0) from exc

bafredo_devsms-0.1.0/pyproject.toml

@@ -0,0 +1,28 @@
+[build-system]
+requires = ["hatchling>=1.25.0"]
+build-backend = "hatchling.build"
+
+[project]
+name = "bafredo-devsms"
+version = "0.1.0"
+description = "Official DevSMS SDK for Python"
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+authors = [
+  { name = "Bafredo" }
+]
+keywords = ["devsms", "sms", "sdk", "api"]
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "License :: OSI Approved :: MIT License",
+  "Operating System :: OS Independent"
+]
+
+[project.urls]
+Homepage = "https://github.com/Bafredo/devsms-python"
+Repository = "https://github.com/Bafredo/devsms-python"
+
+[tool.hatch.build.targets.wheel]
+packages = ["devsms"]