zasend 0.1.0__tar.gz

zasend-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 zaSend
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

zasend-0.1.0/PKG-INFO

@@ -0,0 +1,204 @@
+Metadata-Version: 2.4
+Name: zasend
+Version: 0.1.0
+Summary: Python transactional email API client for zaSend
+Author-email: zaSend <support@zasend.com>
+License-Expression: MIT
+Project-URL: Homepage, https://zasend.com
+Project-URL: Documentation, https://zasend.com/docs
+Project-URL: Repository, https://github.com/lr2bmail/firemail-api/tree/master/clients/python
+Project-URL: Issues, https://github.com/lr2bmail/firemail-api/issues
+Project-URL: Changelog, https://github.com/lr2bmail/firemail-api/commits/master/clients/python
+Keywords: email,transactional-email,email-api,smtp,python-email,django-email,flask-email,fastapi-email,webhooks,dkim,zasend
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Communications :: Email
+Classifier: Topic :: Communications :: Email :: Mail Transport Agents
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.25
+Dynamic: license-file
+
+# zasend
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+[![Python](https://img.shields.io/badge/python-3.8%2B-blue.svg)](pyproject.toml)
+
+Official Python client for the [zaSend](https://zasend.com) transactional email API.
+
+zaSend is a developer-focused email delivery service for sending product, auth, billing, notification, and lifecycle emails from your application. This package is a small wrapper around the zaSend REST API for Python apps, Django, Flask, FastAPI, background jobs, and scripts.
+
+Use it to:
+
+- Send transactional email from verified domains
+- Send template-based email with variables
+- Check message status and events
+- Manage suppressions, webhooks, templates, and domains
+- Verify zaSend webhook signatures
+
+The client stays close to the raw API. It has no heavy framework dependencies and uses `requests`.
+
+## Install
+
+```bash
+pip install zasend
+```
+
+## Quick Start
+
+```python
+from zasend import ZaSend
+
+client = ZaSend(api_key="sk_live_...")
+
+result = client.send_email(
+    from_email="zaSend <noreply@zasend.com>",
+    to="user@example.com",
+    subject="Welcome",
+    text="Thanks for signing up.",
+)
+
+print(result["message_id"])
+```
+
+You can use an Account API Key (`sk_live_...`) for all methods. A Domain Sending Key (`dsk_live_...`) is restricted to sending email from one verified domain.
+
+## Send HTML Email
+
+```python
+client.send_email(
+    from_email="Acme <noreply@acme.com>",
+    to="customer@example.com",
+    subject="Your receipt",
+    html="<h1>Thanks for your order</h1><p>Your receipt is attached.</p>",
+    text="Thanks for your order. Your receipt is attached.",
+)
+```
+
+## Send to Multiple Recipients
+
+```python
+client.send_email(
+    from_email="Acme <noreply@acme.com>",
+    to=["one@example.com", "two@example.com"],
+    subject="Product update",
+    text="A new update is available.",
+)
+```
+
+zaSend returns one queued message per `to` recipient. Suppressed recipients reject the whole request so you can fix the list before sending.
+
+## Template Send
+
+```python
+client.send_template_email(
+    from_email="Acme <noreply@acme.com>",
+    to="customer@example.com",
+    template="welcome",
+    variables={"name": "Ada"},
+)
+```
+
+## Django Example
+
+```python
+# settings.py
+ZASEND_API_KEY = "sk_live_..."
+
+# anywhere in your app
+from django.conf import settings
+from zasend import ZaSend
+
+zasend = ZaSend(settings.ZASEND_API_KEY)
+zasend.send_email(
+    from_email="Acme <noreply@acme.com>",
+    to=user.email,
+    subject="Reset your password",
+    text="Use this link to reset your password.",
+)
+```
+
+## Flask or FastAPI Example
+
+```python
+import os
+from zasend import ZaSend
+
+zasend = ZaSend(os.environ["ZASEND_API_KEY"])
+
+def send_signup_email(email):
+    return zasend.send_template_email(
+        from_email="Acme <noreply@acme.com>",
+        to=email,
+        template="welcome",
+        variables={"product": "Acme"},
+    )
+```
+
+## Webhook Verification
+
+zaSend signs webhook payloads with HMAC-SHA256. Verify the raw request body before trusting webhook data.
+
+```python
+from zasend import verify_webhook_signature
+
+ok = verify_webhook_signature(
+    request.get_data(),
+    "whsec_...",
+    request.headers.get("X-zaSend-Signature"),
+)
+```
+
+## API Methods
+
+| Method | Description |
+| --- | --- |
+| `send_email(**message)` | Send direct content or a template email |
+| `send_template_email(...)` | Convenience wrapper for template sends |
+| `get_email(message_id)` | Fetch email status and events |
+| `get_rate_limits()` | Fetch daily usage and limits |
+| `list_domains()` / `add_domain(domain)` / `verify_domain(id)` / `delete_domain(id)` | Manage sending domains |
+| `list_suppressions(...)` / `add_suppression(email, ...)` / `delete_suppression(id)` | Manage suppression list entries |
+| `list_webhooks()` / `create_webhook(url, events)` / `delete_webhook(id)` | Manage signed delivery webhooks |
+| `list_templates()` / `create_template(...)` / `get_template(id)` / `update_template(id, ...)` / `delete_template(id)` | Manage email templates |
+
+## Error Handling
+
+```python
+from zasend import APIError, RateLimitError, ValidationError, ZaSend
+
+try:
+    ZaSend("sk_live_...").send_email(
+        from_email="Acme <noreply@acme.com>",
+        to="user@example.com",
+        subject="Hello",
+        text="Body",
+    )
+except RateLimitError as exc:
+    print("Rate limited:", exc)
+except ValidationError as exc:
+    print("Invalid request:", exc)
+except APIError as exc:
+    print("zaSend API error:", exc)
+```
+
+## Links
+
+- Website: [zasend.com](https://zasend.com)
+- API documentation: [zasend.com/docs](https://zasend.com/docs)
+- Source: [GitHub](https://github.com/lr2bmail/firemail-api/tree/master/clients/python)
+
+## License
+
+MIT

zasend-0.1.0/README.md

@@ -0,0 +1,172 @@
+# zasend
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+[![Python](https://img.shields.io/badge/python-3.8%2B-blue.svg)](pyproject.toml)
+
+Official Python client for the [zaSend](https://zasend.com) transactional email API.
+
+zaSend is a developer-focused email delivery service for sending product, auth, billing, notification, and lifecycle emails from your application. This package is a small wrapper around the zaSend REST API for Python apps, Django, Flask, FastAPI, background jobs, and scripts.
+
+Use it to:
+
+- Send transactional email from verified domains
+- Send template-based email with variables
+- Check message status and events
+- Manage suppressions, webhooks, templates, and domains
+- Verify zaSend webhook signatures
+
+The client stays close to the raw API. It has no heavy framework dependencies and uses `requests`.
+
+## Install
+
+```bash
+pip install zasend
+```
+
+## Quick Start
+
+```python
+from zasend import ZaSend
+
+client = ZaSend(api_key="sk_live_...")
+
+result = client.send_email(
+    from_email="zaSend <noreply@zasend.com>",
+    to="user@example.com",
+    subject="Welcome",
+    text="Thanks for signing up.",
+)
+
+print(result["message_id"])
+```
+
+You can use an Account API Key (`sk_live_...`) for all methods. A Domain Sending Key (`dsk_live_...`) is restricted to sending email from one verified domain.
+
+## Send HTML Email
+
+```python
+client.send_email(
+    from_email="Acme <noreply@acme.com>",
+    to="customer@example.com",
+    subject="Your receipt",
+    html="<h1>Thanks for your order</h1><p>Your receipt is attached.</p>",
+    text="Thanks for your order. Your receipt is attached.",
+)
+```
+
+## Send to Multiple Recipients
+
+```python
+client.send_email(
+    from_email="Acme <noreply@acme.com>",
+    to=["one@example.com", "two@example.com"],
+    subject="Product update",
+    text="A new update is available.",
+)
+```
+
+zaSend returns one queued message per `to` recipient. Suppressed recipients reject the whole request so you can fix the list before sending.
+
+## Template Send
+
+```python
+client.send_template_email(
+    from_email="Acme <noreply@acme.com>",
+    to="customer@example.com",
+    template="welcome",
+    variables={"name": "Ada"},
+)
+```
+
+## Django Example
+
+```python
+# settings.py
+ZASEND_API_KEY = "sk_live_..."
+
+# anywhere in your app
+from django.conf import settings
+from zasend import ZaSend
+
+zasend = ZaSend(settings.ZASEND_API_KEY)
+zasend.send_email(
+    from_email="Acme <noreply@acme.com>",
+    to=user.email,
+    subject="Reset your password",
+    text="Use this link to reset your password.",
+)
+```
+
+## Flask or FastAPI Example
+
+```python
+import os
+from zasend import ZaSend
+
+zasend = ZaSend(os.environ["ZASEND_API_KEY"])
+
+def send_signup_email(email):
+    return zasend.send_template_email(
+        from_email="Acme <noreply@acme.com>",
+        to=email,
+        template="welcome",
+        variables={"product": "Acme"},
+    )
+```
+
+## Webhook Verification
+
+zaSend signs webhook payloads with HMAC-SHA256. Verify the raw request body before trusting webhook data.
+
+```python
+from zasend import verify_webhook_signature
+
+ok = verify_webhook_signature(
+    request.get_data(),
+    "whsec_...",
+    request.headers.get("X-zaSend-Signature"),
+)
+```
+
+## API Methods
+
+| Method | Description |
+| --- | --- |
+| `send_email(**message)` | Send direct content or a template email |
+| `send_template_email(...)` | Convenience wrapper for template sends |
+| `get_email(message_id)` | Fetch email status and events |
+| `get_rate_limits()` | Fetch daily usage and limits |
+| `list_domains()` / `add_domain(domain)` / `verify_domain(id)` / `delete_domain(id)` | Manage sending domains |
+| `list_suppressions(...)` / `add_suppression(email, ...)` / `delete_suppression(id)` | Manage suppression list entries |
+| `list_webhooks()` / `create_webhook(url, events)` / `delete_webhook(id)` | Manage signed delivery webhooks |
+| `list_templates()` / `create_template(...)` / `get_template(id)` / `update_template(id, ...)` / `delete_template(id)` | Manage email templates |
+
+## Error Handling
+
+```python
+from zasend import APIError, RateLimitError, ValidationError, ZaSend
+
+try:
+    ZaSend("sk_live_...").send_email(
+        from_email="Acme <noreply@acme.com>",
+        to="user@example.com",
+        subject="Hello",
+        text="Body",
+    )
+except RateLimitError as exc:
+    print("Rate limited:", exc)
+except ValidationError as exc:
+    print("Invalid request:", exc)
+except APIError as exc:
+    print("zaSend API error:", exc)
+```
+
+## Links
+
+- Website: [zasend.com](https://zasend.com)
+- API documentation: [zasend.com/docs](https://zasend.com/docs)
+- Source: [GitHub](https://github.com/lr2bmail/firemail-api/tree/master/clients/python)
+
+## License
+
+MIT

zasend-0.1.0/pyproject.toml

@@ -0,0 +1,56 @@
+[build-system]
+requires = ["setuptools>=64", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "zasend"
+version = "0.1.0"
+description = "Python transactional email API client for zaSend"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.8"
+authors = [
+    {name = "zaSend", email = "support@zasend.com"},
+]
+keywords = [
+    "email",
+    "transactional-email",
+    "email-api",
+    "smtp",
+    "python-email",
+    "django-email",
+    "flask-email",
+    "fastapi-email",
+    "webhooks",
+    "dkim",
+    "zasend",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Communications :: Email",
+    "Topic :: Communications :: Email :: Mail Transport Agents",
+    "Topic :: Internet :: WWW/HTTP",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = [
+    "requests>=2.25",
+]
+
+[project.urls]
+Homepage = "https://zasend.com"
+Documentation = "https://zasend.com/docs"
+Repository = "https://github.com/lr2bmail/firemail-api/tree/master/clients/python"
+Issues = "https://github.com/lr2bmail/firemail-api/issues"
+Changelog = "https://github.com/lr2bmail/firemail-api/commits/master/clients/python"
+
+[tool.setuptools.packages.find]
+include = ["zasend*"]

zasend-0.1.0/setup.cfg

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

zasend-0.1.0/tests/test_client.py

@@ -0,0 +1,91 @@
+import hashlib
+import hmac
+
+import pytest
+
+from zasend import APIError, RateLimitError, ValidationError, ZaSend, ZaSendError, verify_webhook_signature
+
+
+class Response:
+    def __init__(self, body=None, status_code=200, ok=True, reason="OK"):
+        self._body = body
+        self.status_code = status_code
+        self.ok = ok
+        self.reason = reason
+
+    def json(self):
+        if isinstance(self._body, Exception):
+            raise self._body
+        return self._body
+
+
+class Session:
+    def __init__(self, response):
+        self.response = response
+        self.calls = []
+
+    def request(self, *args, **kwargs):
+        self.calls.append((args, kwargs))
+        return self.response
+
+
+def test_send_email_posts_json_with_bearer_auth():
+    session = Session(Response({"success": True, "message_id": "msg_123"}))
+    client = ZaSend("key", base_url="https://example.test/api/v1", session=session)
+
+    result = client.send_email(
+        **{
+            "from": "noreply@example.com",
+            "to": "user@example.com",
+            "subject": "Hello",
+            "text": "Body",
+        }
+    )
+
+    args, kwargs = session.calls[0]
+    assert args == ("POST", "https://example.test/api/v1/emails/send")
+    assert kwargs["headers"]["Authorization"] == "Bearer key"
+    assert kwargs["json"]["subject"] == "Hello"
+    assert result["message_id"] == "msg_123"
+
+
+def test_list_suppressions_sends_query_parameters():
+    session = Session(Response({"suppressions": []}))
+    client = ZaSend("key", base_url="https://example.test/api/v1", session=session)
+
+    client.list_suppressions(page=2, per_page=100, reason="bounce")
+
+    _, kwargs = session.calls[0]
+    assert kwargs["params"] == {"page": 2, "per_page": 100, "reason": "bounce"}
+
+
+def test_typed_errors():
+    with pytest.raises(RateLimitError):
+        ZaSend("key", session=Session(Response({"message": "slow down"}, 429, False))).get_rate_limits()
+
+    with pytest.raises(ValidationError):
+        ZaSend("key", session=Session(Response({"message": "bad email"}, 422, False))).send_email()
+
+    with pytest.raises(APIError):
+        ZaSend("key", session=Session(Response({"message": "missing"}, 404, False))).get_email("missing")
+
+
+def test_delete_methods_return_none_for_204():
+    client = ZaSend("key", session=Session(Response(None, 204, True)))
+
+    assert client.delete_webhook("hook_123") is None
+
+
+def test_webhook_signature_verification_accepts_valid_signature():
+    body = b'{"event":"accepted_by_postfix"}'
+    secret = "secret"
+    signature = hmac.new(secret.encode(), body, hashlib.sha256).hexdigest()
+
+    assert verify_webhook_signature(body, secret, "sha256={0}".format(signature))
+
+
+def test_client_errors_still_behave_like_value_error():
+    assert issubclass(APIError, ZaSendError)
+    assert issubclass(RateLimitError, APIError)
+    assert issubclass(ValidationError, APIError)
+    assert issubclass(ZaSendError, ValueError)

zasend-0.1.0/zasend/__init__.py

@@ -0,0 +1,12 @@
+from .client import APIError, RateLimitError, ValidationError, ZaSend, ZaSendError, verify_webhook_signature
+
+__all__ = [
+    "APIError",
+    "RateLimitError",
+    "ValidationError",
+    "ZaSend",
+    "ZaSendError",
+    "verify_webhook_signature",
+]
+
+__version__ = "0.1.0"

zasend-0.1.0/zasend/client.py

@@ -0,0 +1,171 @@
+import hashlib
+import hmac
+
+import requests
+
+
+DEFAULT_BASE_URL = "https://zasend.com/api/v1"
+
+
+class ZaSendError(ValueError):
+    """Base exception for zaSend client errors."""
+
+
+class APIError(ZaSendError):
+    """Raised when the zaSend API returns an error response."""
+
+    def __init__(self, message, status_code=None, body=None):
+        super().__init__(message)
+        self.status_code = status_code
+        self.body = body
+
+
+class RateLimitError(APIError):
+    """Raised when the API returns 429."""
+
+
+class ValidationError(APIError):
+    """Raised when the API returns a validation-style error."""
+
+
+class ZaSend:
+    """Lightweight client for the zaSend API."""
+
+    def __init__(self, api_key, base_url=None, timeout=10, session=None):
+        if not api_key:
+            raise ZaSendError("API key is required")
+        self.api_key = api_key
+        self.base_url = (base_url or DEFAULT_BASE_URL).rstrip("/")
+        self.timeout = timeout
+        self._session = session or requests.Session()
+
+    def send_email(self, **message):
+        if "from_email" in message and "from" not in message:
+            message["from"] = message.pop("from_email")
+        return self._request("POST", "/emails/send", json=message)
+
+    def send_template_email(
+        self,
+        from_email,
+        to,
+        template,
+        variables=None,
+        cc=None,
+        bcc=None,
+        list_unsubscribe=None,
+        list_unsubscribe_post=None,
+    ):
+        return self.send_email(
+            **{
+                "from": from_email,
+                "to": to,
+                "template": template,
+                "variables": variables or {},
+                "cc": cc,
+                "bcc": bcc,
+                "list_unsubscribe": list_unsubscribe,
+                "list_unsubscribe_post": list_unsubscribe_post,
+            }
+        )
+
+    def get_email(self, message_id):
+        return self._request("GET", "/emails/{0}".format(message_id))
+
+    def get_rate_limits(self):
+        return self._request("GET", "/rate-limits")
+
+    def list_domains(self):
+        return self._request("GET", "/domains")
+
+    def add_domain(self, domain):
+        return self._request("POST", "/domains", json={"domain": domain})
+
+    def verify_domain(self, domain_id):
+        return self._request("POST", "/domains/{0}/verify".format(domain_id))
+
+    def delete_domain(self, domain_id):
+        return self._request("DELETE", "/domains/{0}".format(domain_id))
+
+    def list_suppressions(self, page=None, per_page=None, reason=None):
+        return self._request(
+            "GET",
+            "/suppressions",
+            params={"page": page, "per_page": per_page, "reason": reason},
+        )
+
+    def add_suppression(self, email, reason="manual", details=None):
+        return self._request(
+            "POST",
+            "/suppressions",
+            json={"email": email, "reason": reason, "details": details},
+        )
+
+    def delete_suppression(self, suppression_id):
+        return self._request("DELETE", "/suppressions/{0}".format(suppression_id))
+
+    def list_webhooks(self):
+        return self._request("GET", "/webhooks")
+
+    def create_webhook(self, url, events):
+        return self._request("POST", "/webhooks", json={"url": url, "events": events})
+
+    def delete_webhook(self, webhook_id):
+        return self._request("DELETE", "/webhooks/{0}".format(webhook_id))
+
+    def list_templates(self):
+        return self._request("GET", "/templates")
+
+    def create_template(self, **template):
+        return self._request("POST", "/templates", json=template)
+
+    def get_template(self, template_id):
+        return self._request("GET", "/templates/{0}".format(template_id))
+
+    def update_template(self, template_id, **template):
+        return self._request("PUT", "/templates/{0}".format(template_id), json=template)
+
+    def delete_template(self, template_id):
+        return self._request("DELETE", "/templates/{0}".format(template_id))
+
+    def _request(self, method, path, json=None, params=None):
+        headers = {
+            "Authorization": "Bearer {0}".format(self.api_key),
+            "Accept": "application/json",
+        }
+        clean_params = {k: v for k, v in (params or {}).items() if v is not None}
+        response = self._session.request(
+            method,
+            "{0}{1}".format(self.base_url, path),
+            headers=headers,
+            json={k: v for k, v in (json or {}).items() if v is not None} if json is not None else None,
+            params=clean_params or None,
+            timeout=self.timeout,
+        )
+
+        if response.status_code == 204:
+            return None
+
+        try:
+            data = response.json()
+        except ValueError as exc:
+            if response.ok:
+                raise APIError("API returned invalid JSON", response.status_code) from exc
+            data = None
+
+        if not response.ok:
+            message = data.get("message") if isinstance(data, dict) else response.reason
+            if response.status_code == 429:
+                raise RateLimitError(message, response.status_code, data)
+            if response.status_code in (400, 422):
+                raise ValidationError(message, response.status_code, data)
+            raise APIError("API error {0}: {1}".format(response.status_code, message), response.status_code, data)
+
+        return data
+
+
+def verify_webhook_signature(payload_body, secret, signature_header):
+    received = (signature_header or "").replace("sha256=", "", 1)
+    if isinstance(payload_body, str):
+        payload_body = payload_body.encode()
+    expected = hmac.new(secret.encode(), payload_body, hashlib.sha256).hexdigest()
+    return hmac.compare_digest(expected, received)

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

@@ -0,0 +1,204 @@
+Metadata-Version: 2.4
+Name: zasend
+Version: 0.1.0
+Summary: Python transactional email API client for zaSend
+Author-email: zaSend <support@zasend.com>
+License-Expression: MIT
+Project-URL: Homepage, https://zasend.com
+Project-URL: Documentation, https://zasend.com/docs
+Project-URL: Repository, https://github.com/lr2bmail/firemail-api/tree/master/clients/python
+Project-URL: Issues, https://github.com/lr2bmail/firemail-api/issues
+Project-URL: Changelog, https://github.com/lr2bmail/firemail-api/commits/master/clients/python
+Keywords: email,transactional-email,email-api,smtp,python-email,django-email,flask-email,fastapi-email,webhooks,dkim,zasend
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Communications :: Email
+Classifier: Topic :: Communications :: Email :: Mail Transport Agents
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.25
+Dynamic: license-file
+
+# zasend
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+[![Python](https://img.shields.io/badge/python-3.8%2B-blue.svg)](pyproject.toml)
+
+Official Python client for the [zaSend](https://zasend.com) transactional email API.
+
+zaSend is a developer-focused email delivery service for sending product, auth, billing, notification, and lifecycle emails from your application. This package is a small wrapper around the zaSend REST API for Python apps, Django, Flask, FastAPI, background jobs, and scripts.
+
+Use it to:
+
+- Send transactional email from verified domains
+- Send template-based email with variables
+- Check message status and events
+- Manage suppressions, webhooks, templates, and domains
+- Verify zaSend webhook signatures
+
+The client stays close to the raw API. It has no heavy framework dependencies and uses `requests`.
+
+## Install
+
+```bash
+pip install zasend
+```
+
+## Quick Start
+
+```python
+from zasend import ZaSend
+
+client = ZaSend(api_key="sk_live_...")
+
+result = client.send_email(
+    from_email="zaSend <noreply@zasend.com>",
+    to="user@example.com",
+    subject="Welcome",
+    text="Thanks for signing up.",
+)
+
+print(result["message_id"])
+```
+
+You can use an Account API Key (`sk_live_...`) for all methods. A Domain Sending Key (`dsk_live_...`) is restricted to sending email from one verified domain.
+
+## Send HTML Email
+
+```python
+client.send_email(
+    from_email="Acme <noreply@acme.com>",
+    to="customer@example.com",
+    subject="Your receipt",
+    html="<h1>Thanks for your order</h1><p>Your receipt is attached.</p>",
+    text="Thanks for your order. Your receipt is attached.",
+)
+```
+
+## Send to Multiple Recipients
+
+```python
+client.send_email(
+    from_email="Acme <noreply@acme.com>",
+    to=["one@example.com", "two@example.com"],
+    subject="Product update",
+    text="A new update is available.",
+)
+```
+
+zaSend returns one queued message per `to` recipient. Suppressed recipients reject the whole request so you can fix the list before sending.
+
+## Template Send
+
+```python
+client.send_template_email(
+    from_email="Acme <noreply@acme.com>",
+    to="customer@example.com",
+    template="welcome",
+    variables={"name": "Ada"},
+)
+```
+
+## Django Example
+
+```python
+# settings.py
+ZASEND_API_KEY = "sk_live_..."
+
+# anywhere in your app
+from django.conf import settings
+from zasend import ZaSend
+
+zasend = ZaSend(settings.ZASEND_API_KEY)
+zasend.send_email(
+    from_email="Acme <noreply@acme.com>",
+    to=user.email,
+    subject="Reset your password",
+    text="Use this link to reset your password.",
+)
+```
+
+## Flask or FastAPI Example
+
+```python
+import os
+from zasend import ZaSend
+
+zasend = ZaSend(os.environ["ZASEND_API_KEY"])
+
+def send_signup_email(email):
+    return zasend.send_template_email(
+        from_email="Acme <noreply@acme.com>",
+        to=email,
+        template="welcome",
+        variables={"product": "Acme"},
+    )
+```
+
+## Webhook Verification
+
+zaSend signs webhook payloads with HMAC-SHA256. Verify the raw request body before trusting webhook data.
+
+```python
+from zasend import verify_webhook_signature
+
+ok = verify_webhook_signature(
+    request.get_data(),
+    "whsec_...",
+    request.headers.get("X-zaSend-Signature"),
+)
+```
+
+## API Methods
+
+| Method | Description |
+| --- | --- |
+| `send_email(**message)` | Send direct content or a template email |
+| `send_template_email(...)` | Convenience wrapper for template sends |
+| `get_email(message_id)` | Fetch email status and events |
+| `get_rate_limits()` | Fetch daily usage and limits |
+| `list_domains()` / `add_domain(domain)` / `verify_domain(id)` / `delete_domain(id)` | Manage sending domains |
+| `list_suppressions(...)` / `add_suppression(email, ...)` / `delete_suppression(id)` | Manage suppression list entries |
+| `list_webhooks()` / `create_webhook(url, events)` / `delete_webhook(id)` | Manage signed delivery webhooks |
+| `list_templates()` / `create_template(...)` / `get_template(id)` / `update_template(id, ...)` / `delete_template(id)` | Manage email templates |
+
+## Error Handling
+
+```python
+from zasend import APIError, RateLimitError, ValidationError, ZaSend
+
+try:
+    ZaSend("sk_live_...").send_email(
+        from_email="Acme <noreply@acme.com>",
+        to="user@example.com",
+        subject="Hello",
+        text="Body",
+    )
+except RateLimitError as exc:
+    print("Rate limited:", exc)
+except ValidationError as exc:
+    print("Invalid request:", exc)
+except APIError as exc:
+    print("zaSend API error:", exc)
+```
+
+## Links
+
+- Website: [zasend.com](https://zasend.com)
+- API documentation: [zasend.com/docs](https://zasend.com/docs)
+- Source: [GitHub](https://github.com/lr2bmail/firemail-api/tree/master/clients/python)
+
+## License
+
+MIT

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

@@ -0,0 +1,11 @@
+LICENSE
+README.md
+pyproject.toml
+tests/test_client.py
+zasend/__init__.py
+zasend/client.py
+zasend.egg-info/PKG-INFO
+zasend.egg-info/SOURCES.txt
+zasend.egg-info/dependency_links.txt
+zasend.egg-info/requires.txt
+zasend.egg-info/top_level.txt

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

@@ -0,0 +1 @@
+

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

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

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

@@ -0,0 +1 @@
+zasend