Spaces:
Sleeping
Sleeping
Download sdk/python/openwa/__init__.py from jinksQspider/openWa: direct link, hf CLI and curl.
- Browser
- Download file 3.6 kB
-
https://huggingface.co/spaces/jinksQspider/openWa/resolve/main/sdk/python/openwa/__init__.py
- Command line
-
hf download hf://spaces/jinksQspider/openWa/sdk/python/openwa/__init__.py
-
curl -L -o __init__.py https://huggingface.co/spaces/jinksQspider/openWa/resolve/main/sdk/python/openwa/__init__.py
3.6 kB
| """ | |
| OpenWA Python SDK | |
| Official client library for the OpenWA WhatsApp API Gateway. | |
| Example usage:: | |
| from openwa import OpenWAClient | |
| client = OpenWAClient( | |
| base_url="http://localhost:2785", | |
| api_key="your-api-key", | |
| ) | |
| # Send a text message | |
| result = client.messages.send_text("session-1", { | |
| "chatId": "628123456789@c.us", | |
| "text": "Hello from OpenWA Python SDK!", | |
| }) | |
| """ | |
| from __future__ import annotations | |
| from dataclasses import dataclass, field | |
| from typing import Any | |
| class OpenWAClientConfig: | |
| """Configuration for the OpenWA client.""" | |
| base_url: str | |
| api_key: str | |
| timeout: float = 30.0 | |
| class MessageResponse: | |
| """Response from sending a message.""" | |
| message_id: str | |
| timestamp: int | |
| class OpenWAClient: | |
| """OpenWA API client. | |
| This is a scaffold — methods will be auto-generated from the OpenAPI spec. | |
| """ | |
| def __init__(self, base_url: str, api_key: str, timeout: float = 30.0) -> None: | |
| self.config = OpenWAClientConfig( | |
| base_url=base_url.rstrip("/"), | |
| api_key=api_key, | |
| timeout=timeout, | |
| ) | |
| # Placeholder — will be auto-generated from OpenAPI spec | |
| def sessions(self) -> "_SessionsResource": | |
| return _SessionsResource(self) | |
| def messages(self) -> "_MessagesResource": | |
| return _MessagesResource(self) | |
| def _request(self, method: str, path: str, json: Any = None) -> Any: | |
| """Internal HTTP request helper. Requires httpx.""" | |
| try: | |
| import httpx | |
| except ImportError: | |
| raise ImportError( | |
| "httpx is required for the OpenWA SDK. " | |
| "Install it with: pip install openwa-sdk" | |
| ) | |
| with httpx.Client(timeout=self.config.timeout) as client: | |
| response = client.request( | |
| method, | |
| f"{self.config.base_url}{path}", | |
| headers={ | |
| "Content-Type": "application/json", | |
| "X-API-Key": self.config.api_key, | |
| }, | |
| json=json, | |
| ) | |
| response.raise_for_status() | |
| if response.status_code == 204: | |
| return None | |
| return response.json() | |
| class _SessionsResource: | |
| def __init__(self, client: OpenWAClient) -> None: | |
| self._client = client | |
| def list(self) -> list[dict]: | |
| return self._client._request("GET", "/api/sessions") | |
| def get(self, session_id: str) -> dict: | |
| return self._client._request("GET", f"/api/sessions/{session_id}") | |
| def create(self, name: str) -> dict: | |
| return self._client._request("POST", "/api/sessions", {"name": name}) | |
| def start(self, session_id: str) -> dict: | |
| return self._client._request("POST", f"/api/sessions/{session_id}/start") | |
| def stop(self, session_id: str) -> dict: | |
| return self._client._request("POST", f"/api/sessions/{session_id}/stop") | |
| def delete(self, session_id: str) -> None: | |
| self._client._request("DELETE", f"/api/sessions/{session_id}") | |
| class _MessagesResource: | |
| def __init__(self, client: OpenWAClient) -> None: | |
| self._client = client | |
| def send_text( | |
| self, session_id: str, data: dict[str, str] | |
| ) -> MessageResponse: | |
| result = self._client._request( | |
| "POST", f"/api/sessions/{session_id}/messages/text", data | |
| ) | |
| return MessageResponse( | |
| message_id=result["messageId"], | |
| timestamp=result["timestamp"], | |
| ) | |