poststack 0.4.0__tar.gz

poststack-0.4.0/.gitignore

@@ -0,0 +1,9 @@
+__pycache__/
+*.py[cod]
+*$py.class
+.pytest_cache/
+*.egg-info/
+dist/
+build/
+.venv/
+.env

poststack-0.4.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 MICCI (PostStack)
+
+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.

poststack-0.4.0/PKG-INFO

@@ -0,0 +1,155 @@
+Metadata-Version: 2.4
+Name: poststack
+Version: 0.4.0
+Summary: Official Python SDK for the PostStack Email API
+Project-URL: Homepage, https://poststack.dev
+Project-URL: Documentation, https://poststack.dev/docs
+Project-URL: Repository, https://github.com/getpoststack/python-sdk
+Project-URL: Issues, https://github.com/getpoststack/python-sdk/issues
+Author: PostStack
+License: MIT
+License-File: LICENSE
+Keywords: api,email,poststack,smtp,transactional
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+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 :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.25.0
+Requires-Dist: pydantic>=2.0.0
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Requires-Dist: respx>=0.20.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# PostStack Python SDK
+
+Official Python SDK for the [PostStack](https://poststack.dev) Email API —
+an [EU-hosted, GDPR-compliant](https://poststack.dev/security)
+[email API for Python](https://poststack.dev) with sync and async clients,
+full type hints, and drop-in compatibility with Django, FastAPI, Flask,
+and Starlette. Up to 75% cheaper than Resend, SendGrid, and Postmark.
+
+Docs: [poststack.dev/docs/sdk](https://poststack.dev/docs/sdk).
+
+## Installation
+
+```bash
+pip install poststack
+```
+
+Requires Python 3.10+.
+
+## Quick start
+
+```python
+from poststack import PostStack
+
+client = PostStack(api_key="sk_live_...")
+
+result = client.emails.send({
+    "from": "hello@example.com",
+    "to": ["user@example.com"],
+    "subject": "Hello from PostStack",
+    "html": "<p>Welcome!</p>",
+})
+
+print(result["id"])
+```
+
+## Async usage
+
+```python
+import asyncio
+from poststack import AsyncPostStack
+
+async def main():
+    client = AsyncPostStack(api_key="sk_live_...")
+    try:
+        result = await client.emails.send({
+            "from": "hello@example.com",
+            "to": ["user@example.com"],
+            "subject": "Hello from PostStack",
+            "html": "<p>Welcome!</p>",
+        })
+        print(result["id"])
+    finally:
+        await client.aclose()
+
+asyncio.run(main())
+```
+
+Or use it as an async context manager:
+
+```python
+async with AsyncPostStack(api_key="sk_live_...") as client:
+    result = await client.emails.send({...})
+```
+
+## Error handling
+
+Any non-2xx response raises `PostStackError`:
+
+```python
+from poststack import PostStack, PostStackError
+
+client = PostStack(api_key="sk_live_...")
+
+try:
+    client.emails.send({"from": "x@y.com", "to": ["z@w.com"], "subject": "hi"})
+except PostStackError as e:
+    print(e.status_code, e.error, e.request_id)
+```
+
+## Configuration
+
+```python
+client = PostStack(
+    api_key="sk_live_...",
+    base_url="https://api.poststack.dev",  # default
+    timeout=30.0,                           # default (seconds)
+)
+```
+
+Override timeout per call:
+
+```python
+client.emails.send({...}, timeout=60.0)
+```
+
+## Resources
+
+- `client.emails` — send, get, list, cancel, reschedule, batch, events, insights
+- `client.domains` — create, list, get, verify, update, delete, DMARC
+- `client.contacts` — CRUD, import, export, unsubscribe
+- `client.contact_properties` — custom properties
+- `client.segments` — create, list, get, update, delete, contacts, preview
+- `client.templates` — CRUD, publish, duplicate, presets
+- `client.webhooks` — CRUD, test, deliveries, replay
+- `client.broadcasts` — CRUD, send, test, variants
+- `client.suppressions` — list, add, remove
+- `client.api_keys` — CRUD
+- `client.mailboxes` — CRUD, aliases, password
+- `client.subscription_topics` — topics + contact subscriptions
+- `client.workflows` — CRUD, steps, activate, pause, trigger
+- `client.signup_forms` — CRUD, submit
+- `client.email_validations` — validate, validate_batch
+
+## Links
+
+- [PostStack — EU-hosted email API](https://poststack.dev)
+- [API documentation](https://poststack.dev/docs)
+- [Pricing](https://poststack.dev/pricing) · [Compare providers](https://poststack.dev/pricing/compare)
+- [Migrate from Resend](https://poststack.dev/migrate/resend) · [from SendGrid](https://poststack.dev/migrate/sendgrid) · [from Postmark](https://poststack.dev/migrate/postmark)
+- [Status](https://poststack.dev/status) · [Security](https://poststack.dev/security) · [DPA](https://poststack.dev/dpa)
+
+## License
+
+MIT — see [LICENSE](./LICENSE).

poststack-0.4.0/README.md

@@ -0,0 +1,124 @@
+# PostStack Python SDK
+
+Official Python SDK for the [PostStack](https://poststack.dev) Email API —
+an [EU-hosted, GDPR-compliant](https://poststack.dev/security)
+[email API for Python](https://poststack.dev) with sync and async clients,
+full type hints, and drop-in compatibility with Django, FastAPI, Flask,
+and Starlette. Up to 75% cheaper than Resend, SendGrid, and Postmark.
+
+Docs: [poststack.dev/docs/sdk](https://poststack.dev/docs/sdk).
+
+## Installation
+
+```bash
+pip install poststack
+```
+
+Requires Python 3.10+.
+
+## Quick start
+
+```python
+from poststack import PostStack
+
+client = PostStack(api_key="sk_live_...")
+
+result = client.emails.send({
+    "from": "hello@example.com",
+    "to": ["user@example.com"],
+    "subject": "Hello from PostStack",
+    "html": "<p>Welcome!</p>",
+})
+
+print(result["id"])
+```
+
+## Async usage
+
+```python
+import asyncio
+from poststack import AsyncPostStack
+
+async def main():
+    client = AsyncPostStack(api_key="sk_live_...")
+    try:
+        result = await client.emails.send({
+            "from": "hello@example.com",
+            "to": ["user@example.com"],
+            "subject": "Hello from PostStack",
+            "html": "<p>Welcome!</p>",
+        })
+        print(result["id"])
+    finally:
+        await client.aclose()
+
+asyncio.run(main())
+```
+
+Or use it as an async context manager:
+
+```python
+async with AsyncPostStack(api_key="sk_live_...") as client:
+    result = await client.emails.send({...})
+```
+
+## Error handling
+
+Any non-2xx response raises `PostStackError`:
+
+```python
+from poststack import PostStack, PostStackError
+
+client = PostStack(api_key="sk_live_...")
+
+try:
+    client.emails.send({"from": "x@y.com", "to": ["z@w.com"], "subject": "hi"})
+except PostStackError as e:
+    print(e.status_code, e.error, e.request_id)
+```
+
+## Configuration
+
+```python
+client = PostStack(
+    api_key="sk_live_...",
+    base_url="https://api.poststack.dev",  # default
+    timeout=30.0,                           # default (seconds)
+)
+```
+
+Override timeout per call:
+
+```python
+client.emails.send({...}, timeout=60.0)
+```
+
+## Resources
+
+- `client.emails` — send, get, list, cancel, reschedule, batch, events, insights
+- `client.domains` — create, list, get, verify, update, delete, DMARC
+- `client.contacts` — CRUD, import, export, unsubscribe
+- `client.contact_properties` — custom properties
+- `client.segments` — create, list, get, update, delete, contacts, preview
+- `client.templates` — CRUD, publish, duplicate, presets
+- `client.webhooks` — CRUD, test, deliveries, replay
+- `client.broadcasts` — CRUD, send, test, variants
+- `client.suppressions` — list, add, remove
+- `client.api_keys` — CRUD
+- `client.mailboxes` — CRUD, aliases, password
+- `client.subscription_topics` — topics + contact subscriptions
+- `client.workflows` — CRUD, steps, activate, pause, trigger
+- `client.signup_forms` — CRUD, submit
+- `client.email_validations` — validate, validate_batch
+
+## Links
+
+- [PostStack — EU-hosted email API](https://poststack.dev)
+- [API documentation](https://poststack.dev/docs)
+- [Pricing](https://poststack.dev/pricing) · [Compare providers](https://poststack.dev/pricing/compare)
+- [Migrate from Resend](https://poststack.dev/migrate/resend) · [from SendGrid](https://poststack.dev/migrate/sendgrid) · [from Postmark](https://poststack.dev/migrate/postmark)
+- [Status](https://poststack.dev/status) · [Security](https://poststack.dev/security) · [DPA](https://poststack.dev/dpa)
+
+## License
+
+MIT — see [LICENSE](./LICENSE).

poststack-0.4.0/pyproject.toml

@@ -0,0 +1,58 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "poststack"
+version = "0.4.0"
+description = "Official Python SDK for the PostStack Email API"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [{ name = "PostStack" }]
+keywords = ["email", "api", "poststack", "smtp", "transactional"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Communications :: Email",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = [
+    "httpx>=0.25.0",
+    "pydantic>=2.0.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-asyncio>=0.21.0",
+    "respx>=0.20.0",
+]
+
+[project.urls]
+Homepage = "https://poststack.dev"
+Documentation = "https://poststack.dev/docs"
+Repository = "https://github.com/getpoststack/python-sdk"
+Issues = "https://github.com/getpoststack/python-sdk/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/poststack"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "/src",
+    "/tests",
+    "/README.md",
+    "/LICENSE",
+    "/pyproject.toml",
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+asyncio_mode = "auto"

poststack-0.4.0/src/poststack/__init__.py

@@ -0,0 +1,159 @@
+"""PostStack Python SDK.
+
+Public API::
+
+    from poststack import PostStack, AsyncPostStack, PostStackError
+
+    client = PostStack(api_key="sk_live_...")
+    client.emails.send({"from": "a@b.com", "to": ["c@d.com"], "subject": "hi"})
+"""
+
+from __future__ import annotations
+
+from typing import Optional
+
+from ._client import (
+    DEFAULT_BASE_URL,
+    AsyncPostStackClient,
+    PostStackClient,
+)
+from ._errors import APIError, PostStackError
+from .resources import (
+    ApiKeysResource,
+    AsyncApiKeysResource,
+    AsyncBroadcastsResource,
+    AsyncContactPropertiesResource,
+    AsyncContactsResource,
+    AsyncDomainsResource,
+    AsyncEmailsResource,
+    AsyncEmailValidationsResource,
+    AsyncMailboxesResource,
+    AsyncSegmentsResource,
+    AsyncSignupFormsResource,
+    AsyncSubscriptionTopicsResource,
+    AsyncSuppressionsResource,
+    AsyncTemplatesResource,
+    AsyncWebhooksResource,
+    AsyncWorkflowsResource,
+    BroadcastsResource,
+    ContactPropertiesResource,
+    ContactsResource,
+    DomainsResource,
+    EmailsResource,
+    EmailValidationsResource,
+    MailboxesResource,
+    SegmentsResource,
+    SignupFormsResource,
+    SubscriptionTopicsResource,
+    SuppressionsResource,
+    TemplatesResource,
+    WebhooksResource,
+    WorkflowsResource,
+)
+
+__version__ = "0.4.0"
+
+__all__ = [
+    "PostStack",
+    "AsyncPostStack",
+    "PostStackError",
+    "APIError",
+    "__version__",
+]
+
+
+class PostStack:
+    """Synchronous PostStack client.
+
+    Example::
+
+        client = PostStack(api_key="sk_live_...")
+        client.emails.send({
+            "from": "hello@example.com",
+            "to": ["user@example.com"],
+            "subject": "Hello",
+            "html": "<p>Hi</p>",
+        })
+    """
+
+    def __init__(
+        self,
+        api_key: str,
+        base_url: str = DEFAULT_BASE_URL,
+        timeout: float = 30.0,
+    ) -> None:
+        self._client = PostStackClient(
+            api_key=api_key, base_url=base_url, timeout=timeout
+        )
+        self.emails = EmailsResource(self._client)
+        self.domains = DomainsResource(self._client)
+        self.contacts = ContactsResource(self._client)
+        self.contact_properties = ContactPropertiesResource(self._client)
+        self.segments = SegmentsResource(self._client)
+        self.templates = TemplatesResource(self._client)
+        self.webhooks = WebhooksResource(self._client)
+        self.broadcasts = BroadcastsResource(self._client)
+        self.suppressions = SuppressionsResource(self._client)
+        self.api_keys = ApiKeysResource(self._client)
+        self.mailboxes = MailboxesResource(self._client)
+        self.subscription_topics = SubscriptionTopicsResource(self._client)
+        self.workflows = WorkflowsResource(self._client)
+        self.signup_forms = SignupFormsResource(self._client)
+        self.email_validations = EmailValidationsResource(self._client)
+
+    def close(self) -> None:
+        self._client.close()
+
+    def __enter__(self) -> "PostStack":
+        return self
+
+    def __exit__(self, *args: object) -> None:
+        self.close()
+
+
+class AsyncPostStack:
+    """Asynchronous PostStack client.
+
+    Example::
+
+        async with AsyncPostStack(api_key="sk_live_...") as client:
+            await client.emails.send({...})
+    """
+
+    def __init__(
+        self,
+        api_key: str,
+        base_url: str = DEFAULT_BASE_URL,
+        timeout: float = 30.0,
+    ) -> None:
+        self._client = AsyncPostStackClient(
+            api_key=api_key, base_url=base_url, timeout=timeout
+        )
+        self.emails = AsyncEmailsResource(self._client)
+        self.domains = AsyncDomainsResource(self._client)
+        self.contacts = AsyncContactsResource(self._client)
+        self.contact_properties = AsyncContactPropertiesResource(self._client)
+        self.segments = AsyncSegmentsResource(self._client)
+        self.templates = AsyncTemplatesResource(self._client)
+        self.webhooks = AsyncWebhooksResource(self._client)
+        self.broadcasts = AsyncBroadcastsResource(self._client)
+        self.suppressions = AsyncSuppressionsResource(self._client)
+        self.api_keys = AsyncApiKeysResource(self._client)
+        self.mailboxes = AsyncMailboxesResource(self._client)
+        self.subscription_topics = AsyncSubscriptionTopicsResource(self._client)
+        self.workflows = AsyncWorkflowsResource(self._client)
+        self.signup_forms = AsyncSignupFormsResource(self._client)
+        self.email_validations = AsyncEmailValidationsResource(self._client)
+
+    async def aclose(self) -> None:
+        await self._client.aclose()
+
+    async def __aenter__(self) -> "AsyncPostStack":
+        return self
+
+    async def __aexit__(self, *args: object) -> None:
+        await self.aclose()
+
+
+# Re-export for advanced callers.
+_: Optional[type] = None  # noqa: E305 - keeps ruff/mypy happy with Optional import