pennypost 0.1.0__tar.gz

pennypost-0.1.0/PKG-INFO

@@ -0,0 +1,17 @@
+Metadata-Version: 2.4
+Name: pennypost
+Version: 0.1.0
+Summary: Official Python SDK for PennyPost, the affordable email API. Zero dependencies.
+License: MIT
+Project-URL: Homepage, https://pennypost.io/docs
+Keywords: email,transactional-email,email-api,pennypost
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+pennypost — official Python SDK for [PennyPost](https://pennypost.io).
+
+```python
+from pennypost import PennyPost
+pp = PennyPost("pp_live_...")
+pp.send_email({"from": "Receipts <r@yourdomain.com>", "to": ["a@b.com"], "subject": "Hi", "text": "Hello"})
+```

pennypost-0.1.0/README.md

@@ -0,0 +1,7 @@
+pennypost — official Python SDK for [PennyPost](https://pennypost.io).
+
+```python
+from pennypost import PennyPost
+pp = PennyPost("pp_live_...")
+pp.send_email({"from": "Receipts <r@yourdomain.com>", "to": ["a@b.com"], "subject": "Hi", "text": "Hello"})
+```

pennypost-0.1.0/pennypost/__init__.py

@@ -0,0 +1,86 @@
+# Generated from api/openapi.json (sha 7c58f5917c4b) by sdk/generate.ts — do not edit by hand.
+# PennyPost: the affordable email API. https://pennypost.io/docs
+
+from __future__ import annotations
+import json
+import urllib.error
+import urllib.parse
+import urllib.request
+
+SPEC_SHA = "7c58f5917c4b"
+_DEFAULT_BASE = "https://api.pennypost.io"
+
+
+def _q(v):
+    return urllib.parse.quote(str(v), safe="")
+
+
+class PennyPostError(Exception):
+    """Typed API error: .status, .type, .code, .param, .retryable, .detail."""
+
+    def __init__(self, status: int, body: dict):
+        err = body.get("error", {}) if isinstance(body, dict) else {}
+        super().__init__(err.get("message") or f"HTTP {status}")
+        self.status = status
+        self.type = err.get("type", "provider")
+        self.code = err.get("code", "unknown_error")
+        self.param = err.get("param")
+        self.retryable = bool(err.get("retryable", status >= 500))
+        self.detail = err.get("detail")
+
+
+class PennyPost:
+    """PennyPost client. Zero dependencies (stdlib only).
+
+    pp = PennyPost("pp_live_...")
+    pp.send_email({"from": "Receipts <r@yourdomain.com>", "to": ["a@b.com"],
+                   "subject": "Hi", "text": "Hello"})
+    """
+
+    def __init__(self, api_key: str, base_url: str = _DEFAULT_BASE):
+        if not api_key.startswith("pp_"):
+            raise ValueError("pass your API key (pp_live_... or pp_test_...)")
+        self._key = api_key
+        self._base = base_url.rstrip("/")
+
+    def _request(self, method: str, path: str, body, query, idempotency_key) -> dict:
+        url = self._base + path
+        if query:
+            qs = urllib.parse.urlencode({k: v for k, v in query.items() if v is not None})
+            if qs:
+                url += "?" + qs
+        headers = {"Authorization": f"Bearer {self._key}"}
+        data = None
+        if body is not None:
+            headers["Content-Type"] = "application/json"
+            data = json.dumps(body).encode()
+        if idempotency_key:
+            headers["Idempotency-Key"] = idempotency_key
+        req = urllib.request.Request(url, data=data, headers=headers, method=method)
+        try:
+            with urllib.request.urlopen(req) as res:
+                return json.loads(res.read() or b"{}")
+        except urllib.error.HTTPError as e:
+            try:
+                parsed = json.loads(e.read() or b"{}")
+            except json.JSONDecodeError:
+                parsed = {}
+            raise PennyPostError(e.code, parsed) from None
+
+    def send_email(self, req: dict, idempotency_key: str | None = None) -> dict:
+        return self._request("POST", f"/v1/emails", req, None, idempotency_key)
+
+    def list_emails(self, to: str | int | None = None, limit: str | int | None = None, cursor: str | int | None = None) -> dict:
+        return self._request("GET", f"/v1/emails", None, {"to": to, "limit": limit, "cursor": cursor}, None)
+
+    def get_email(self, id: str) -> dict:
+        return self._request("GET", f"/v1/emails/{_q(id)}", None, None, None)
+
+    def list_suppressions(self, limit: str | int | None = None, cursor: str | int | None = None) -> dict:
+        return self._request("GET", f"/v1/suppressions", None, {"limit": limit, "cursor": cursor}, None)
+
+    def add_suppression(self, email: str) -> dict:
+        return self._request("POST", f"/v1/suppressions", {"email": email}, None, None)
+
+    def remove_suppression(self, email: str) -> dict:
+        return self._request("DELETE", f"/v1/suppressions/{_q(email)}", None, None, None)

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

@@ -0,0 +1,17 @@
+Metadata-Version: 2.4
+Name: pennypost
+Version: 0.1.0
+Summary: Official Python SDK for PennyPost, the affordable email API. Zero dependencies.
+License: MIT
+Project-URL: Homepage, https://pennypost.io/docs
+Keywords: email,transactional-email,email-api,pennypost
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+pennypost — official Python SDK for [PennyPost](https://pennypost.io).
+
+```python
+from pennypost import PennyPost
+pp = PennyPost("pp_live_...")
+pp.send_email({"from": "Receipts <r@yourdomain.com>", "to": ["a@b.com"], "subject": "Hi", "text": "Hello"})
+```

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

@@ -0,0 +1,8 @@
+README.md
+pyproject.toml
+pennypost/__init__.py
+pennypost/py.typed
+pennypost.egg-info/PKG-INFO
+pennypost.egg-info/SOURCES.txt
+pennypost.egg-info/dependency_links.txt
+pennypost.egg-info/top_level.txt

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

@@ -0,0 +1 @@
+

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

@@ -0,0 +1 @@
+pennypost

pennypost-0.1.0/pyproject.toml

@@ -0,0 +1,14 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pennypost"
+version = "0.1.0"
+description = "Official Python SDK for PennyPost, the affordable email API. Zero dependencies."
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+keywords = ["email", "transactional-email", "email-api", "pennypost"]
+[project.urls]
+Homepage = "https://pennypost.io/docs"

pennypost-0.1.0/setup.cfg

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