postiee 0.1.0__tar.gz

postiee-0.1.0/LICENSE

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

postiee-0.1.0/MANIFEST.in

@@ -0,0 +1,2 @@
+include README.md
+include LICENSE

postiee-0.1.0/PKG-INFO

@@ -0,0 +1,209 @@
+Metadata-Version: 2.4
+Name: postiee
+Version: 0.1.0
+Summary: A minimal Python client for the Postmark API
+Author-email: Nomadic Influence <support@nomadicinfluence.com>
+License: MIT
+Project-URL: Homepage, https://github.com/roddy-devs/postie
+Project-URL: Repository, https://github.com/roddy-devs/postie
+Project-URL: Issues, https://github.com/roddy-devs/postie/issues
+Keywords: postmark,email,api,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.7
+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: Topic :: Communications :: Email
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.25.0
+Dynamic: license-file
+
+# Postie
+
+A minimal Python client for the Postmark API.
+
+## Installation
+
+```bash
+pip install postie
+```
+
+## Quick Start
+
+```python
+from postie import PostieClient
+
+# Initialize client
+client = PostieClient(server_token="your-postmark-server-token")
+
+# Send a simple email
+response = client.send_email(
+    from_email="support@nomadicinfluence.com",
+    to="user@example.com",
+    subject="Hello from Postie",
+    html_body="<h1>Hello!</h1><p>This is a test email.</p>",
+    text_body="Hello! This is a test email."
+)
+
+print(response)
+```
+
+## Features
+
+- ✅ Send single emails
+- ✅ Send batch emails (up to 500)
+- ✅ Send template-based emails
+- ✅ HTML and plain text support
+- ✅ CC, BCC, Reply-To
+- ✅ Email tagging and metadata
+- ✅ Open and link tracking
+- ✅ Type hints
+- ✅ Minimal dependencies (only `requests`)
+
+## Usage
+
+### Send Email
+
+```python
+client.send_email(
+    from_email="support@nomadicinfluence.com",
+    to="user@example.com",
+    subject="Welcome!",
+    html_body="<h1>Welcome to our platform</h1>",
+    text_body="Welcome to our platform",
+    tag="onboarding",
+    track_opens=True
+)
+```
+
+### Send Batch Emails
+
+```python
+emails = [
+    {
+        "From": "support@nomadicinfluence.com",
+        "To": "user1@example.com",
+        "Subject": "Hello User 1",
+        "HtmlBody": "<p>Hello User 1</p>"
+    },
+    {
+        "From": "support@nomadicinfluence.com",
+        "To": "user2@example.com",
+        "Subject": "Hello User 2",
+        "HtmlBody": "<p>Hello User 2</p>"
+    }
+]
+
+responses = client.send_batch(emails)
+```
+
+### Send Template Email
+
+```python
+client.send_template_email(
+    from_email="support@nomadicinfluence.com",
+    to="user@example.com",
+    template_id=123456,
+    template_model={
+        "name": "John Doe",
+        "action_url": "https://example.com/verify"
+    }
+)
+```
+
+## Django Integration
+
+### Option 1: Use Django Email Backend (Recommended)
+
+Configure Postie as your Django email backend:
+
+```python
+# settings.py
+EMAIL_BACKEND = 'postie.django_backend.PostieEmailBackend'
+POSTMARK_SERVER_TOKEN = os.getenv('POSTMARK_SERVER_TOKEN')
+DEFAULT_FROM_EMAIL = 'support@nomadicinfluence.com'
+```
+
+Then use Django's standard email functions:
+
+```python
+from django.core.mail import send_mail, EmailMultiAlternatives
+
+# Simple email
+send_mail(
+    subject='Welcome!',
+    message='Welcome to our platform',
+    from_email='support@nomadicinfluence.com',
+    recipient_list=['user@example.com'],
+)
+
+# HTML email
+email = EmailMultiAlternatives(
+    subject='Welcome!',
+    body='Welcome to our platform',
+    from_email='support@nomadicinfluence.com',
+    to=['user@example.com'],
+)
+email.attach_alternative('<h1>Welcome!</h1>', "text/html")
+email.send()
+```
+
+### Option 2: Use PostieClient Directly
+
+```python
+# utils/email.py
+from postie import PostieClient
+from django.conf import settings
+
+postmark = PostieClient(server_token=settings.POSTMARK_SERVER_TOKEN)
+
+def send_welcome_email(user_email, user_name):
+    postmark.send_email(
+        from_email="support@nomadicinfluence.com",
+        to=user_email,
+        subject=f"Welcome {user_name}!",
+        html_body=f"<h1>Welcome {user_name}!</h1>",
+        text_body=f"Welcome {user_name}!"
+    )
+```
+
+## Error Handling
+
+```python
+from postie import PostieClient, PostieAPIError, PostieError
+
+try:
+    client.send_email(...)
+except PostieAPIError as e:
+    print(f"API Error: {e}")
+    print(f"Error Code: {e.error_code}")
+    print(f"Status Code: {e.status_code}")
+except PostieError as e:
+    print(f"Client Error: {e}")
+```
+
+## Requirements
+
+- Python 3.7+
+- requests
+
+## License
+
+MIT
+
+## Contributing
+
+Contributions welcome! Please open an issue or PR.
+
+## Links
+
+- [Postmark API Documentation](https://postmarkapp.com/developer)
+- [GitHub Repository](https://github.com/roddy-devs/postie)

postiee-0.1.0/README.md

@@ -0,0 +1,181 @@
+# Postie
+
+A minimal Python client for the Postmark API.
+
+## Installation
+
+```bash
+pip install postie
+```
+
+## Quick Start
+
+```python
+from postie import PostieClient
+
+# Initialize client
+client = PostieClient(server_token="your-postmark-server-token")
+
+# Send a simple email
+response = client.send_email(
+    from_email="support@nomadicinfluence.com",
+    to="user@example.com",
+    subject="Hello from Postie",
+    html_body="<h1>Hello!</h1><p>This is a test email.</p>",
+    text_body="Hello! This is a test email."
+)
+
+print(response)
+```
+
+## Features
+
+- ✅ Send single emails
+- ✅ Send batch emails (up to 500)
+- ✅ Send template-based emails
+- ✅ HTML and plain text support
+- ✅ CC, BCC, Reply-To
+- ✅ Email tagging and metadata
+- ✅ Open and link tracking
+- ✅ Type hints
+- ✅ Minimal dependencies (only `requests`)
+
+## Usage
+
+### Send Email
+
+```python
+client.send_email(
+    from_email="support@nomadicinfluence.com",
+    to="user@example.com",
+    subject="Welcome!",
+    html_body="<h1>Welcome to our platform</h1>",
+    text_body="Welcome to our platform",
+    tag="onboarding",
+    track_opens=True
+)
+```
+
+### Send Batch Emails
+
+```python
+emails = [
+    {
+        "From": "support@nomadicinfluence.com",
+        "To": "user1@example.com",
+        "Subject": "Hello User 1",
+        "HtmlBody": "<p>Hello User 1</p>"
+    },
+    {
+        "From": "support@nomadicinfluence.com",
+        "To": "user2@example.com",
+        "Subject": "Hello User 2",
+        "HtmlBody": "<p>Hello User 2</p>"
+    }
+]
+
+responses = client.send_batch(emails)
+```
+
+### Send Template Email
+
+```python
+client.send_template_email(
+    from_email="support@nomadicinfluence.com",
+    to="user@example.com",
+    template_id=123456,
+    template_model={
+        "name": "John Doe",
+        "action_url": "https://example.com/verify"
+    }
+)
+```
+
+## Django Integration
+
+### Option 1: Use Django Email Backend (Recommended)
+
+Configure Postie as your Django email backend:
+
+```python
+# settings.py
+EMAIL_BACKEND = 'postie.django_backend.PostieEmailBackend'
+POSTMARK_SERVER_TOKEN = os.getenv('POSTMARK_SERVER_TOKEN')
+DEFAULT_FROM_EMAIL = 'support@nomadicinfluence.com'
+```
+
+Then use Django's standard email functions:
+
+```python
+from django.core.mail import send_mail, EmailMultiAlternatives
+
+# Simple email
+send_mail(
+    subject='Welcome!',
+    message='Welcome to our platform',
+    from_email='support@nomadicinfluence.com',
+    recipient_list=['user@example.com'],
+)
+
+# HTML email
+email = EmailMultiAlternatives(
+    subject='Welcome!',
+    body='Welcome to our platform',
+    from_email='support@nomadicinfluence.com',
+    to=['user@example.com'],
+)
+email.attach_alternative('<h1>Welcome!</h1>', "text/html")
+email.send()
+```
+
+### Option 2: Use PostieClient Directly
+
+```python
+# utils/email.py
+from postie import PostieClient
+from django.conf import settings
+
+postmark = PostieClient(server_token=settings.POSTMARK_SERVER_TOKEN)
+
+def send_welcome_email(user_email, user_name):
+    postmark.send_email(
+        from_email="support@nomadicinfluence.com",
+        to=user_email,
+        subject=f"Welcome {user_name}!",
+        html_body=f"<h1>Welcome {user_name}!</h1>",
+        text_body=f"Welcome {user_name}!"
+    )
+```
+
+## Error Handling
+
+```python
+from postie import PostieClient, PostieAPIError, PostieError
+
+try:
+    client.send_email(...)
+except PostieAPIError as e:
+    print(f"API Error: {e}")
+    print(f"Error Code: {e.error_code}")
+    print(f"Status Code: {e.status_code}")
+except PostieError as e:
+    print(f"Client Error: {e}")
+```
+
+## Requirements
+
+- Python 3.7+
+- requests
+
+## License
+
+MIT
+
+## Contributing
+
+Contributions welcome! Please open an issue or PR.
+
+## Links
+
+- [Postmark API Documentation](https://postmarkapp.com/developer)
+- [GitHub Repository](https://github.com/roddy-devs/postie)

postiee-0.1.0/postie/__init__.py

@@ -0,0 +1,10 @@
+"""Postie - A minimal Python client for Postmark API"""
+
+from .client import PostieClient
+from .exceptions import PostieError, PostieAPIError
+
+__version__ = "0.1.0"
+__all__ = ["PostieClient", "PostieError", "PostieAPIError"]
+
+# Django backend is imported separately to avoid Django dependency
+# from postie.django_backend import PostieEmailBackend

postiee-0.1.0/postie/client.py

@@ -0,0 +1,196 @@
+"""Postie client for Postmark API"""
+
+import requests
+from typing import Optional, Dict, Any, List
+from .exceptions import PostieAPIError, PostieError
+
+
+class PostieClient:
+    """Minimal client for Postmark API"""
+    
+    BASE_URL = "https://api.postmarkapp.com"
+    
+    def __init__(self, server_token: str, timeout: int = 30):
+        """
+        Initialize Postie client
+        
+        Args:
+            server_token: Postmark server API token
+            timeout: Request timeout in seconds (default: 30)
+        """
+        if not server_token:
+            raise PostieError("server_token is required")
+        
+        self.server_token = server_token
+        self.timeout = timeout
+        self.session = requests.Session()
+        self.session.headers.update({
+            "Accept": "application/json",
+            "Content-Type": "application/json",
+            "X-Postmark-Server-Token": server_token
+        })
+    
+    def _request(self, method: str, endpoint: str, data: Optional[Dict] = None) -> Dict[str, Any]:
+        """Make API request"""
+        url = f"{self.BASE_URL}{endpoint}"
+        
+        try:
+            response = self.session.request(
+                method=method,
+                url=url,
+                json=data,
+                timeout=self.timeout
+            )
+            
+            if response.status_code >= 400:
+                error_data = response.json() if response.content else {}
+                raise PostieAPIError(
+                    message=error_data.get("Message", "Unknown error"),
+                    error_code=error_data.get("ErrorCode"),
+                    status_code=response.status_code
+                )
+            
+            return response.json()
+            
+        except requests.RequestException as e:
+            raise PostieError(f"Request failed: {str(e)}")
+    
+    def send_email(
+        self,
+        from_email: str,
+        to: str,
+        subject: str,
+        html_body: Optional[str] = None,
+        text_body: Optional[str] = None,
+        cc: Optional[str] = None,
+        bcc: Optional[str] = None,
+        reply_to: Optional[str] = None,
+        tag: Optional[str] = None,
+        metadata: Optional[Dict[str, str]] = None,
+        track_opens: Optional[bool] = None,
+        track_links: Optional[str] = None,
+    ) -> Dict[str, Any]:
+        """
+        Send a single email
+        
+        Args:
+            from_email: Sender email address
+            to: Recipient email address
+            subject: Email subject
+            html_body: HTML email body
+            text_body: Plain text email body
+            cc: CC recipients (comma-separated)
+            bcc: BCC recipients (comma-separated)
+            reply_to: Reply-To address
+            tag: Tag for categorizing emails
+            metadata: Custom metadata dictionary
+            track_opens: Enable open tracking
+            track_links: Link tracking ("None", "HtmlAndText", "HtmlOnly", "TextOnly")
+        
+        Returns:
+            API response dictionary
+        """
+        if not html_body and not text_body:
+            raise PostieError("Either html_body or text_body is required")
+        
+        payload = {
+            "From": from_email,
+            "To": to,
+            "Subject": subject,
+        }
+        
+        if html_body:
+            payload["HtmlBody"] = html_body
+        if text_body:
+            payload["TextBody"] = text_body
+        if cc:
+            payload["Cc"] = cc
+        if bcc:
+            payload["Bcc"] = bcc
+        if reply_to:
+            payload["ReplyTo"] = reply_to
+        if tag:
+            payload["Tag"] = tag
+        if metadata:
+            payload["Metadata"] = metadata
+        if track_opens is not None:
+            payload["TrackOpens"] = track_opens
+        if track_links:
+            payload["TrackLinks"] = track_links
+        
+        return self._request("POST", "/email", payload)
+    
+    def send_batch(self, emails: List[Dict[str, Any]]) -> List[Dict[str, Any]]:
+        """
+        Send multiple emails in a batch
+        
+        Args:
+            emails: List of email dictionaries (same format as send_email args)
+        
+        Returns:
+            List of API response dictionaries
+        """
+        if not emails:
+            raise PostieError("emails list cannot be empty")
+        
+        if len(emails) > 500:
+            raise PostieError("Maximum 500 emails per batch")
+        
+        return self._request("POST", "/email/batch", emails)
+    
+    def send_template_email(
+        self,
+        from_email: str,
+        to: str,
+        template_id: int,
+        template_model: Dict[str, Any],
+        cc: Optional[str] = None,
+        bcc: Optional[str] = None,
+        reply_to: Optional[str] = None,
+        tag: Optional[str] = None,
+        metadata: Optional[Dict[str, str]] = None,
+        track_opens: Optional[bool] = None,
+        track_links: Optional[str] = None,
+    ) -> Dict[str, Any]:
+        """
+        Send email using a Postmark template
+        
+        Args:
+            from_email: Sender email address
+            to: Recipient email address
+            template_id: Postmark template ID
+            template_model: Template variables dictionary
+            cc: CC recipients (comma-separated)
+            bcc: BCC recipients (comma-separated)
+            reply_to: Reply-To address
+            tag: Tag for categorizing emails
+            metadata: Custom metadata dictionary
+            track_opens: Enable open tracking
+            track_links: Link tracking ("None", "HtmlAndText", "HtmlOnly", "TextOnly")
+        
+        Returns:
+            API response dictionary
+        """
+        payload = {
+            "From": from_email,
+            "To": to,
+            "TemplateId": template_id,
+            "TemplateModel": template_model,
+        }
+        
+        if cc:
+            payload["Cc"] = cc
+        if bcc:
+            payload["Bcc"] = bcc
+        if reply_to:
+            payload["ReplyTo"] = reply_to
+        if tag:
+            payload["Tag"] = tag
+        if metadata:
+            payload["Metadata"] = metadata
+        if track_opens is not None:
+            payload["TrackOpens"] = track_opens
+        if track_links:
+            payload["TrackLinks"] = track_links
+        
+        return self._request("POST", "/email/withTemplate", payload)

postiee-0.1.0/postie/django_backend.py

@@ -0,0 +1,64 @@
+"""Django email backend for Postie"""
+
+from django.conf import settings
+from django.core.mail.backends.base import BaseEmailBackend
+from django.core.mail import EmailMultiAlternatives
+from .client import PostieClient
+from .exceptions import PostieError
+
+
+class PostieEmailBackend(BaseEmailBackend):
+    """Django email backend using Postie/Postmark"""
+    
+    def __init__(self, fail_silently=False, **kwargs):
+        super().__init__(fail_silently=fail_silently, **kwargs)
+        
+        server_token = getattr(settings, 'POSTMARK_SERVER_TOKEN', None)
+        if not server_token:
+            raise PostieError("POSTMARK_SERVER_TOKEN setting is required")
+        
+        self.client = PostieClient(server_token=server_token)
+    
+    def send_messages(self, email_messages):
+        """Send one or more EmailMessage objects"""
+        if not email_messages:
+            return 0
+        
+        sent_count = 0
+        
+        for message in email_messages:
+            try:
+                self._send(message)
+                sent_count += 1
+            except Exception as e:
+                if not self.fail_silently:
+                    raise
+        
+        return sent_count
+    
+    def _send(self, message):
+        """Send a single email message"""
+        # Get HTML body if available
+        html_body = None
+        if isinstance(message, EmailMultiAlternatives):
+            for content, mimetype in message.alternatives:
+                if mimetype == 'text/html':
+                    html_body = content
+                    break
+        
+        # Prepare recipients
+        to = ', '.join(message.to) if message.to else None
+        cc = ', '.join(message.cc) if message.cc else None
+        bcc = ', '.join(message.bcc) if message.bcc else None
+        
+        # Send via Postie
+        self.client.send_email(
+            from_email=message.from_email,
+            to=to,
+            subject=message.subject,
+            html_body=html_body,
+            text_body=message.body if message.body else None,
+            cc=cc,
+            bcc=bcc,
+            reply_to=message.reply_to[0] if message.reply_to else None,
+        )

postiee-0.1.0/postie/exceptions.py

@@ -0,0 +1,15 @@
+"""Postie exceptions"""
+
+
+class PostieError(Exception):
+    """Base exception for Postie"""
+    pass
+
+
+class PostieAPIError(PostieError):
+    """Raised when Postmark API returns an error"""
+    
+    def __init__(self, message, error_code=None, status_code=None):
+        super().__init__(message)
+        self.error_code = error_code
+        self.status_code = status_code

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

@@ -0,0 +1,209 @@
+Metadata-Version: 2.4
+Name: postiee
+Version: 0.1.0
+Summary: A minimal Python client for the Postmark API
+Author-email: Nomadic Influence <support@nomadicinfluence.com>
+License: MIT
+Project-URL: Homepage, https://github.com/roddy-devs/postie
+Project-URL: Repository, https://github.com/roddy-devs/postie
+Project-URL: Issues, https://github.com/roddy-devs/postie/issues
+Keywords: postmark,email,api,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.7
+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: Topic :: Communications :: Email
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.25.0
+Dynamic: license-file
+
+# Postie
+
+A minimal Python client for the Postmark API.
+
+## Installation
+
+```bash
+pip install postie
+```
+
+## Quick Start
+
+```python
+from postie import PostieClient
+
+# Initialize client
+client = PostieClient(server_token="your-postmark-server-token")
+
+# Send a simple email
+response = client.send_email(
+    from_email="support@nomadicinfluence.com",
+    to="user@example.com",
+    subject="Hello from Postie",
+    html_body="<h1>Hello!</h1><p>This is a test email.</p>",
+    text_body="Hello! This is a test email."
+)
+
+print(response)
+```
+
+## Features
+
+- ✅ Send single emails
+- ✅ Send batch emails (up to 500)
+- ✅ Send template-based emails
+- ✅ HTML and plain text support
+- ✅ CC, BCC, Reply-To
+- ✅ Email tagging and metadata
+- ✅ Open and link tracking
+- ✅ Type hints
+- ✅ Minimal dependencies (only `requests`)
+
+## Usage
+
+### Send Email
+
+```python
+client.send_email(
+    from_email="support@nomadicinfluence.com",
+    to="user@example.com",
+    subject="Welcome!",
+    html_body="<h1>Welcome to our platform</h1>",
+    text_body="Welcome to our platform",
+    tag="onboarding",
+    track_opens=True
+)
+```
+
+### Send Batch Emails
+
+```python
+emails = [
+    {
+        "From": "support@nomadicinfluence.com",
+        "To": "user1@example.com",
+        "Subject": "Hello User 1",
+        "HtmlBody": "<p>Hello User 1</p>"
+    },
+    {
+        "From": "support@nomadicinfluence.com",
+        "To": "user2@example.com",
+        "Subject": "Hello User 2",
+        "HtmlBody": "<p>Hello User 2</p>"
+    }
+]
+
+responses = client.send_batch(emails)
+```
+
+### Send Template Email
+
+```python
+client.send_template_email(
+    from_email="support@nomadicinfluence.com",
+    to="user@example.com",
+    template_id=123456,
+    template_model={
+        "name": "John Doe",
+        "action_url": "https://example.com/verify"
+    }
+)
+```
+
+## Django Integration
+
+### Option 1: Use Django Email Backend (Recommended)
+
+Configure Postie as your Django email backend:
+
+```python
+# settings.py
+EMAIL_BACKEND = 'postie.django_backend.PostieEmailBackend'
+POSTMARK_SERVER_TOKEN = os.getenv('POSTMARK_SERVER_TOKEN')
+DEFAULT_FROM_EMAIL = 'support@nomadicinfluence.com'
+```
+
+Then use Django's standard email functions:
+
+```python
+from django.core.mail import send_mail, EmailMultiAlternatives
+
+# Simple email
+send_mail(
+    subject='Welcome!',
+    message='Welcome to our platform',
+    from_email='support@nomadicinfluence.com',
+    recipient_list=['user@example.com'],
+)
+
+# HTML email
+email = EmailMultiAlternatives(
+    subject='Welcome!',
+    body='Welcome to our platform',
+    from_email='support@nomadicinfluence.com',
+    to=['user@example.com'],
+)
+email.attach_alternative('<h1>Welcome!</h1>', "text/html")
+email.send()
+```
+
+### Option 2: Use PostieClient Directly
+
+```python
+# utils/email.py
+from postie import PostieClient
+from django.conf import settings
+
+postmark = PostieClient(server_token=settings.POSTMARK_SERVER_TOKEN)
+
+def send_welcome_email(user_email, user_name):
+    postmark.send_email(
+        from_email="support@nomadicinfluence.com",
+        to=user_email,
+        subject=f"Welcome {user_name}!",
+        html_body=f"<h1>Welcome {user_name}!</h1>",
+        text_body=f"Welcome {user_name}!"
+    )
+```
+
+## Error Handling
+
+```python
+from postie import PostieClient, PostieAPIError, PostieError
+
+try:
+    client.send_email(...)
+except PostieAPIError as e:
+    print(f"API Error: {e}")
+    print(f"Error Code: {e.error_code}")
+    print(f"Status Code: {e.status_code}")
+except PostieError as e:
+    print(f"Client Error: {e}")
+```
+
+## Requirements
+
+- Python 3.7+
+- requests
+
+## License
+
+MIT
+
+## Contributing
+
+Contributions welcome! Please open an issue or PR.
+
+## Links
+
+- [Postmark API Documentation](https://postmarkapp.com/developer)
+- [GitHub Repository](https://github.com/roddy-devs/postie)

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

@@ -0,0 +1,13 @@
+LICENSE
+MANIFEST.in
+README.md
+pyproject.toml
+postie/__init__.py
+postie/client.py
+postie/django_backend.py
+postie/exceptions.py
+postiee.egg-info/PKG-INFO
+postiee.egg-info/SOURCES.txt
+postiee.egg-info/dependency_links.txt
+postiee.egg-info/requires.txt
+postiee.egg-info/top_level.txt

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

@@ -0,0 +1 @@
+

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

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

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

@@ -0,0 +1 @@
+postie

postiee-0.1.0/pyproject.toml

@@ -0,0 +1,40 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "postiee"
+version = "0.1.0"
+description = "A minimal Python client for the Postmark API"
+readme = "README.md"
+authors = [
+    {name = "Nomadic Influence", email = "support@nomadicinfluence.com"}
+]
+license = {text = "MIT"}
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.7",
+    "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",
+    "Topic :: Communications :: Email",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+keywords = ["postmark", "email", "api", "transactional"]
+requires-python = ">=3.7"
+dependencies = [
+    "requests>=2.25.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/roddy-devs/postie"
+Repository = "https://github.com/roddy-devs/postie"
+Issues = "https://github.com/roddy-devs/postie/issues"
+
+[tool.setuptools.packages.find]
+include = ["postie*"]

postiee-0.1.0/setup.cfg

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