reloop-email 0.2.0__tar.gz

reloop_email-0.2.0/.github/workflows/publish.yml

@@ -0,0 +1,35 @@
+name: Publish Python Package
+
+on:
+  push:
+    branches: [ main ]
+    paths:
+      - 'reloop_email/**'
+      - 'pyproject.toml'
+      - '.github/workflows/publish.yml'
+  workflow_dispatch:
+
+jobs:
+  build-and-publish:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.10'
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install hatch
+
+      - name: Build package
+        run: hatch build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

reloop_email-0.2.0/.gitignore

@@ -0,0 +1,24 @@
+# Python bytecode and envs
+__pycache__/
+tests/__pycache__/
+reloop_email/__pycache__/
+*.pyc
+*.pyo
+*.pyd
+.Python
+env/
+venv/
+.venv/
+pip-log.txt
+*.egg-info/
+.eggs/
+build/
+dist/
+__pycache__
+
+# IDE and OS
+.DS_Store
+.idea/
+.vscode/
+__pycache__
+*.log

reloop_email-0.2.0/PKG-INFO

@@ -0,0 +1,159 @@
+Metadata-Version: 2.4
+Name: reloop-email
+Version: 0.2.0
+Summary: Reloop Python SDK
+Project-URL: Homepage, https://reloop.sh
+Project-URL: Repository, https://github.com/reloop-labs/reloop-python
+Author: Reloop Labs
+Requires-Python: >=3.9
+Requires-Dist: httpx>=0.24.0
+Description-Content-Type: text/markdown
+
+# Reloop Python SDK
+
+The official Python SDK for [Reloop](https://reloop.sh), modeled after the Stripe Python SDK with snake_case parameters and typed resource responses.
+
+## Requirements
+
+- Python 3.9 or higher
+
+## Installation
+
+```bash
+pip install reloop-email
+```
+
+## Getting Started
+
+```python
+from reloop_email import Reloop
+
+reloop = Reloop(api_key="re_123456789")
+# or
+reloop = Reloop.client("re_123456789")
+```
+
+## API Keys
+
+```python
+reloop = Reloop(api_key="rl_123456789")
+
+reloop.api_keys.list(page=1, limit=10)
+
+reloop.api_keys.create(
+    name="Production key",
+    enabled=True,
+    rate_limit_enabled=True,
+)
+
+reloop.api_keys.get("key_123456789")
+reloop.api_keys.update("key_123456789", name="Renamed key")
+reloop.api_keys.rotate("key_123456789")
+reloop.api_keys.disable("key_123456789")
+reloop.api_keys.pause("key_123456789")
+reloop.api_keys.enable("key_123456789")
+reloop.api_keys.delete("key_123456789")
+```
+
+## Domains
+
+Add, verify, and manage sending domains. Request parameters use snake_case; responses expose snake_case attributes.
+
+```python
+reloop = Reloop(api_key="rl_123456789")
+
+created = reloop.domain.create(
+    domain="send.example.com",
+    custom_return_path="inbound",
+    click_tracking=True,
+    open_tracking=True,
+    tls="opportunistic",
+    sending_email=True,
+    receiving_email=True,
+)
+
+domains = reloop.domain.list(page=1, limit=10, status="active")
+one = reloop.domain.get("domain_123456789")
+
+reloop.domain.update(
+    "domain_123456789",
+    click_tracking=False,
+    sending_email=True,
+)
+
+reloop.domain.verify("domain_123456789")
+
+reloop.domain.forward_dns("domain_123456789", email="admin@example.com")
+
+nameservers = reloop.domain.get_nameservers("domain_123456789")
+print(nameservers.dns_provider, nameservers.nameservers)
+
+reloop.domain.delete("domain_123456789")
+```
+
+## Contacts
+
+Manage contacts, custom properties, groups, and channels. Methods accept snake_case keyword arguments and return resource objects with snake_case attributes.
+
+### Create a contact
+
+```python
+reloop = Reloop(api_key="re_123456789")
+
+contact = reloop.contacts.create(
+    email="steve.wozniak@gmail.com",
+    first_name="Steve",
+    last_name="Wozniak",
+    unsubscribed=False,
+)
+
+print(contact.email)
+print(contact.first_name)
+```
+
+### List and update contacts
+
+```python
+contacts = reloop.contacts.list(page=1, limit=10)
+print(contacts.contacts, contacts.total)
+
+reloop.contacts.update(
+    "cont_123456789",
+    first_name="Steve",
+    unsubscribed=False,
+)
+```
+
+### Groups and channels
+
+```python
+reloop.contacts.groups.add_contact(
+    "grp_123456789",
+    contact_id="cont_123456789",
+)
+
+reloop.contacts.channels.create(
+    name="Product Updates",
+    default_subscription="opt_in",
+)
+```
+
+## Error Handling
+
+```python
+from reloop_email import Reloop, ReloopApiError
+
+reloop = Reloop(api_key="re_123456789")
+
+try:
+    reloop.contacts.get("cont_invalid")
+except ReloopApiError as error:
+    print(error.status_code, error.body)
+```
+
+## Context Manager
+
+```python
+with Reloop(api_key="re_123456789") as reloop:
+    reloop.contacts.list(limit=10)
+```

reloop_email-0.2.0/README.md

@@ -0,0 +1,148 @@
+# Reloop Python SDK
+
+The official Python SDK for [Reloop](https://reloop.sh), modeled after the Stripe Python SDK with snake_case parameters and typed resource responses.
+
+## Requirements
+
+- Python 3.9 or higher
+
+## Installation
+
+```bash
+pip install reloop-email
+```
+
+## Getting Started
+
+```python
+from reloop_email import Reloop
+
+reloop = Reloop(api_key="re_123456789")
+# or
+reloop = Reloop.client("re_123456789")
+```
+
+## API Keys
+
+```python
+reloop = Reloop(api_key="rl_123456789")
+
+reloop.api_keys.list(page=1, limit=10)
+
+reloop.api_keys.create(
+    name="Production key",
+    enabled=True,
+    rate_limit_enabled=True,
+)
+
+reloop.api_keys.get("key_123456789")
+reloop.api_keys.update("key_123456789", name="Renamed key")
+reloop.api_keys.rotate("key_123456789")
+reloop.api_keys.disable("key_123456789")
+reloop.api_keys.pause("key_123456789")
+reloop.api_keys.enable("key_123456789")
+reloop.api_keys.delete("key_123456789")
+```
+
+## Domains
+
+Add, verify, and manage sending domains. Request parameters use snake_case; responses expose snake_case attributes.
+
+```python
+reloop = Reloop(api_key="rl_123456789")
+
+created = reloop.domain.create(
+    domain="send.example.com",
+    custom_return_path="inbound",
+    click_tracking=True,
+    open_tracking=True,
+    tls="opportunistic",
+    sending_email=True,
+    receiving_email=True,
+)
+
+domains = reloop.domain.list(page=1, limit=10, status="active")
+one = reloop.domain.get("domain_123456789")
+
+reloop.domain.update(
+    "domain_123456789",
+    click_tracking=False,
+    sending_email=True,
+)
+
+reloop.domain.verify("domain_123456789")
+
+reloop.domain.forward_dns("domain_123456789", email="admin@example.com")
+
+nameservers = reloop.domain.get_nameservers("domain_123456789")
+print(nameservers.dns_provider, nameservers.nameservers)
+
+reloop.domain.delete("domain_123456789")
+```
+
+## Contacts
+
+Manage contacts, custom properties, groups, and channels. Methods accept snake_case keyword arguments and return resource objects with snake_case attributes.
+
+### Create a contact
+
+```python
+reloop = Reloop(api_key="re_123456789")
+
+contact = reloop.contacts.create(
+    email="steve.wozniak@gmail.com",
+    first_name="Steve",
+    last_name="Wozniak",
+    unsubscribed=False,
+)
+
+print(contact.email)
+print(contact.first_name)
+```
+
+### List and update contacts
+
+```python
+contacts = reloop.contacts.list(page=1, limit=10)
+print(contacts.contacts, contacts.total)
+
+reloop.contacts.update(
+    "cont_123456789",
+    first_name="Steve",
+    unsubscribed=False,
+)
+```
+
+### Groups and channels
+
+```python
+reloop.contacts.groups.add_contact(
+    "grp_123456789",
+    contact_id="cont_123456789",
+)
+
+reloop.contacts.channels.create(
+    name="Product Updates",
+    default_subscription="opt_in",
+)
+```
+
+## Error Handling
+
+```python
+from reloop_email import Reloop, ReloopApiError
+
+reloop = Reloop(api_key="re_123456789")
+
+try:
+    reloop.contacts.get("cont_invalid")
+except ReloopApiError as error:
+    print(error.status_code, error.body)
+```
+
+## Context Manager
+
+```python
+with Reloop(api_key="re_123456789") as reloop:
+    reloop.contacts.list(limit=10)
+```

reloop_email-0.2.0/pyproject.toml

@@ -0,0 +1,21 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "reloop-email"
+version = "0.2.0"
+description = "Reloop Python SDK"
+readme = "README.md"
+requires-python = ">=3.9"
+authors = [{ name = "Reloop Labs" }]
+dependencies = [
+    "httpx>=0.24.0",
+]
+
+[project.urls]
+Homepage = "https://reloop.sh"
+Repository = "https://github.com/reloop-labs/reloop-python"
+
+[tool.hatch.build.targets.wheel]
+packages = ["reloop_email"]

reloop_email-0.2.0/reloop_email/__init__.py

@@ -0,0 +1,12 @@
+from .errors import ReloopApiError, ReloopError, ReloopNetworkError
+from .reloop import Reloop
+
+ReloopClient = Reloop
+
+__all__ = [
+    "Reloop",
+    "ReloopClient",
+    "ReloopError",
+    "ReloopApiError",
+    "ReloopNetworkError",
+]

reloop_email-0.2.0/reloop_email/_http_client.py

@@ -0,0 +1,74 @@
+from __future__ import annotations
+
+from typing import Any, Optional
+
+import httpx
+
+from .errors import ReloopApiError, ReloopNetworkError
+
+
+class HTTPClient:
+    """Internal HTTP transport for the Reloop SDK."""
+
+    def __init__(self, api_key: str, base_url: str = "https://reloop.sh") -> None:
+        if not api_key:
+            raise ValueError("Reloop SDK requires an api_key.")
+
+        self.api_key = api_key
+        self.base_url = base_url.rstrip("/")
+        self._http = httpx.Client(
+            base_url=self.base_url,
+            headers={
+                "x-api-key": self.api_key,
+                "Content-Type": "application/json",
+                "Accept": "application/json",
+            },
+            timeout=30.0,
+        )
+
+    def request(
+        self,
+        method: str,
+        path: str,
+        *,
+        params: Optional[dict[str, Any]] = None,
+        json: Optional[dict[str, Any]] = None,
+    ) -> dict[str, Any]:
+        try:
+            response = self._http.request(method, path, params=params, json=json)
+        except httpx.RequestError as exc:
+            raise ReloopNetworkError(f"Reloop network error: {exc}") from exc
+
+        if response.status_code >= 400:
+            body: Any = None
+            try:
+                body = response.json()
+            except ValueError:
+                body = response.text
+
+            message = response.reason_phrase
+            if isinstance(body, dict) and body.get("message"):
+                message = str(body["message"])
+
+            raise ReloopApiError(
+                f"Reloop API error ({response.status_code}): {message}",
+                status_code=response.status_code,
+                body=body,
+            )
+
+        if response.status_code == 204 or not response.content:
+            return {}
+
+        data = response.json()
+        if not isinstance(data, dict):
+            return {"data": data}
+        return data
+
+    def close(self) -> None:
+        self._http.close()
+
+    def __enter__(self) -> "HTTPClient":
+        return self
+
+    def __exit__(self, *args: object) -> None:
+        self.close()

reloop_email-0.2.0/reloop_email/_parameters.py

@@ -0,0 +1,86 @@
+from __future__ import annotations
+
+import re
+from typing import Any
+
+REQUEST_KEY_MAP = {
+    "first_name": "firstName",
+    "last_name": "lastName",
+    "group_ids": "groupIds",
+    "group_id": "groupId",
+    "fallback_value": "fallbackValue",
+    "default_subscription": "defaultSubscription",
+    "channel_id": "channelId",
+    "property_name": "propertyName",
+    "property_type": "propertyType",
+    "contact_id": "contactId",
+    "rate_limit_enabled": "rateLimitEnabled",
+    "user_id": "userId",
+}
+
+
+def for_request(parameters: dict[str, Any]) -> dict[str, Any]:
+    normalized: dict[str, Any] = {}
+
+    for key, value in parameters.items():
+        if key == "unsubscribed":
+            if "status" not in parameters:
+                normalized["status"] = "unsubscribed" if value else "subscribed"
+            continue
+
+        api_key = REQUEST_KEY_MAP.get(key, _to_camel_case(key))
+        normalized[api_key] = _normalize_value(value, is_request=True)
+
+    return {key: value for key, value in normalized.items() if value is not None}
+
+
+def for_query(options: dict[str, Any]) -> dict[str, Any]:
+    return for_request(options)
+
+
+def for_snake_request(parameters: dict[str, Any]) -> dict[str, Any]:
+    """Pass parameters through without camelCase conversion (domain API)."""
+    return {key: value for key, value in parameters.items() if value is not None}
+
+
+def for_response(data: dict[str, Any]) -> dict[str, Any]:
+    normalized: dict[str, Any] = {}
+
+    for key, value in data.items():
+        normalized[_to_snake_case(key)] = _normalize_value(value, is_request=False)
+
+    return normalized
+
+
+def _normalize_value(value: Any, *, is_request: bool) -> Any:
+    if not isinstance(value, dict):
+        return value
+
+    if _is_list(value):
+        return [
+            _normalize_value(item, is_request=is_request) if isinstance(item, dict) else item
+            for item in value
+        ]
+
+    return for_request(value) if is_request else for_response(value)
+
+
+def _is_list(value: dict[str, Any]) -> bool:
+    if not value:
+        return True
+    return list(value.keys()) == list(range(len(value)))
+
+
+def _to_camel_case(key: str) -> str:
+    if key in REQUEST_KEY_MAP:
+        return REQUEST_KEY_MAP[key]
+    if "_" not in key:
+        return key
+    parts = key.split("_")
+    return parts[0] + "".join(part.capitalize() for part in parts[1:])
+
+
+def _to_snake_case(key: str) -> str:
+    if "_" in key:
+        return key
+    return re.sub(r"([a-z0-9])([A-Z])", r"\1_\2", key).lower()

reloop_email-0.2.0/reloop_email/_resource.py

@@ -0,0 +1,98 @@
+from __future__ import annotations
+
+from typing import Any, Iterator, Mapping
+
+
+class Resource(Mapping[str, Any]):
+    """StripeObject-style resource with snake_case attribute access."""
+
+    _repr_attr = "id"
+
+    def __init__(self, **attributes: Any) -> None:
+        self._values = dict(attributes)
+        for key, value in attributes.items():
+            object.__setattr__(self, key, value)
+
+    @classmethod
+    def from_dict(cls, data: dict[str, Any]) -> Resource:
+        return cls(**data)
+
+    def __getitem__(self, key: str) -> Any:
+        return self._values[key]
+
+    def __iter__(self) -> Iterator[str]:
+        return iter(self._values)
+
+    def __len__(self) -> int:
+        return len(self._values)
+
+    def __repr__(self) -> str:
+        ident = getattr(self, self._repr_attr, None)
+        class_name = self.__class__.__name__
+        if ident is not None:
+            return f"<{class_name} {self._repr_attr}={ident!r}>"
+        return f"<{class_name}>"
+
+
+class ApiKey(Resource):
+    pass
+
+
+class ApiKeyList(Resource):
+    pass
+
+
+class Contact(Resource):
+    pass
+
+
+class ContactList(Resource):
+    pass
+
+
+class ContactProperty(Resource):
+    pass
+
+
+class PropertyList(Resource):
+    pass
+
+
+class ContactGroup(Resource):
+    pass
+
+
+class GroupList(Resource):
+    pass
+
+
+class ContactChannel(Resource):
+    pass
+
+
+class ChannelList(Resource):
+    pass
+
+
+class DnsRecord(Resource):
+    pass
+
+
+class Domain(Resource):
+    pass
+
+
+class DomainList(Resource):
+    pass
+
+
+class DomainStatus(Resource):
+    pass
+
+
+class DomainNameservers(Resource):
+    pass
+
+
+class ForwardDnsResponse(Resource):
+    pass