novamail 0.1.0__tar.gz

novamail-0.1.0/PKG-INFO

@@ -0,0 +1,58 @@
+Metadata-Version: 2.4
+Name: novamail
+Version: 0.1.0
+Summary: Official Python SDK for the NovaMail API
+Author-email: NovaMail API <support@novamail.app>
+Project-URL: Homepage, https://novamail.app
+Project-URL: Source Code, https://github.com/yourusername/novamail-python
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.25.0
+
+# NovaMail Python SDK
+
+The official Python library for the NovaMail API. Easily integrate transactional emails into your Python applications.
+
+## Installation
+
+You can install the package directly via `pip`:
+
+```bash
+pip install novamail
+```
+
+## Usage
+
+Create an API key in your NovaMail dashboard and use it to initialize the client.
+
+```python
+from novamail import NovaMailClient
+
+# Initialize the client with your API key
+client = NovaMailClient(api_key="nm_live_your_api_key_here")
+
+# Send an email
+response = client.send_email(
+    to="recipient@example.com",
+    from_email="sender@your-verified-domain.com",
+    subject="Welcome to NovaMail",
+    html="<h1>Hello!</h1><p>This is a test email sent from the Python SDK.</p>"
+)
+
+print("Email sent successfully!")
+print(response)
+```
+
+## Advanced Usage
+
+If you need to point the SDK to a different base URL (for example, for local testing), you can pass it to the client:
+
+```python
+client = NovaMailClient(
+    api_key="nm_test_...",
+    base_url="http://localhost:54321/functions/v1"
+)
+```

novamail-0.1.0/README.md

@@ -0,0 +1,44 @@
+# NovaMail Python SDK
+
+The official Python library for the NovaMail API. Easily integrate transactional emails into your Python applications.
+
+## Installation
+
+You can install the package directly via `pip`:
+
+```bash
+pip install novamail
+```
+
+## Usage
+
+Create an API key in your NovaMail dashboard and use it to initialize the client.
+
+```python
+from novamail import NovaMailClient
+
+# Initialize the client with your API key
+client = NovaMailClient(api_key="nm_live_your_api_key_here")
+
+# Send an email
+response = client.send_email(
+    to="recipient@example.com",
+    from_email="sender@your-verified-domain.com",
+    subject="Welcome to NovaMail",
+    html="<h1>Hello!</h1><p>This is a test email sent from the Python SDK.</p>"
+)
+
+print("Email sent successfully!")
+print(response)
+```
+
+## Advanced Usage
+
+If you need to point the SDK to a different base URL (for example, for local testing), you can pass it to the client:
+
+```python
+client = NovaMailClient(
+    api_key="nm_test_...",
+    base_url="http://localhost:54321/functions/v1"
+)
+```

novamail-0.1.0/pyproject.toml

@@ -0,0 +1,25 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "novamail"
+version = "0.1.0"
+authors = [
+  { name="NovaMail API", email="support@novamail.app" },
+]
+description = "Official Python SDK for the NovaMail API"
+readme = "README.md"
+requires-python = ">=3.7"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+dependencies = [
+    "requests>=2.25.0",
+]
+
+[project.urls]
+"Homepage" = "https://novamail.app"
+"Source Code" = "https://github.com/yourusername/novamail-python"

novamail-0.1.0/setup.cfg

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

novamail-0.1.0/src/novamail/__init__.py

@@ -0,0 +1,3 @@
+from .client import NovaMailClient
+
+__all__ = ["NovaMailClient"]

novamail-0.1.0/src/novamail/client.py

@@ -0,0 +1,62 @@
+import requests
+from typing import Optional, Union, List
+
+class NovaMailClient:
+    def __init__(self, api_key: str, base_url: str = "https://api.novamail.app/v1"):
+        """
+        Initialize the NovaMail API client.
+        
+        :param api_key: Your NovaMail API Key
+        :param base_url: The base URL of the NovaMail API (defaults to https://api.novamail.app/v1)
+        """
+        self.api_key = api_key
+        self.base_url = base_url.rstrip('/')
+        
+    def send_email(
+        self, 
+        to: Union[str, List[str]], 
+        from_email: str, 
+        subject: str, 
+        html: Optional[str] = None, 
+        text: Optional[str] = None
+    ):
+        """
+        Send an email using NovaMail.
+        
+        :param to: Recipient email address or list of addresses
+        :param from_email: Sender email address (must be a verified domain)
+        :param subject: Email subject
+        :param html: HTML content of the email
+        :param text: Plain text content of the email (used as fallback if html not provided, though the API expects HTML currently)
+        :return: JSON response from the API
+        """
+        if not html and not text:
+            raise ValueError("You must provide either 'html' or 'text' content for the email.")
+            
+        url = f"{self.base_url}/email"
+        
+        headers = {
+            "Authorization": f"Bearer {self.api_key}",
+            "Content-Type": "application/json"
+        }
+        
+        payload = {
+            "to": to,
+            "from": from_email,
+            "subject": subject,
+            "html": html or text or ""
+        }
+        
+        response = requests.post(url, json=payload, headers=headers)
+        
+        try:
+            response.raise_for_status()
+        except requests.exceptions.HTTPError as e:
+            # Try to get more descriptive error from JSON response
+            try:
+                error_data = response.json()
+                raise requests.exceptions.HTTPError(f"{e} - API Error: {error_data}", response=response)
+            except ValueError:
+                raise e
+                
+        return response.json()

novamail-0.1.0/src/novamail.egg-info/PKG-INFO

@@ -0,0 +1,58 @@
+Metadata-Version: 2.4
+Name: novamail
+Version: 0.1.0
+Summary: Official Python SDK for the NovaMail API
+Author-email: NovaMail API <support@novamail.app>
+Project-URL: Homepage, https://novamail.app
+Project-URL: Source Code, https://github.com/yourusername/novamail-python
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.25.0
+
+# NovaMail Python SDK
+
+The official Python library for the NovaMail API. Easily integrate transactional emails into your Python applications.
+
+## Installation
+
+You can install the package directly via `pip`:
+
+```bash
+pip install novamail
+```
+
+## Usage
+
+Create an API key in your NovaMail dashboard and use it to initialize the client.
+
+```python
+from novamail import NovaMailClient
+
+# Initialize the client with your API key
+client = NovaMailClient(api_key="nm_live_your_api_key_here")
+
+# Send an email
+response = client.send_email(
+    to="recipient@example.com",
+    from_email="sender@your-verified-domain.com",
+    subject="Welcome to NovaMail",
+    html="<h1>Hello!</h1><p>This is a test email sent from the Python SDK.</p>"
+)
+
+print("Email sent successfully!")
+print(response)
+```
+
+## Advanced Usage
+
+If you need to point the SDK to a different base URL (for example, for local testing), you can pass it to the client:
+
+```python
+client = NovaMailClient(
+    api_key="nm_test_...",
+    base_url="http://localhost:54321/functions/v1"
+)
+```

novamail-0.1.0/src/novamail.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+README.md
+pyproject.toml
+src/novamail/__init__.py
+src/novamail/client.py
+src/novamail.egg-info/PKG-INFO
+src/novamail.egg-info/SOURCES.txt
+src/novamail.egg-info/dependency_links.txt
+src/novamail.egg-info/requires.txt
+src/novamail.egg-info/top_level.txt

novamail-0.1.0/src/novamail.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

novamail-0.1.0/src/novamail.egg-info/requires.txt

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

novamail-0.1.0/src/novamail.egg-info/top_level.txt

@@ -0,0 +1 @@
+novamail