Metadata-Version: 2.5
Name: groundmail
Version: 0.8.3
Summary: Groundmail transactional email API client for Python
Project-URL: Homepage, https://groundmail.dev
Project-URL: Documentation, https://docs.groundmail.dev/sdks/python
Project-URL: Repository, https://github.com/Groundmail/groundmail-sdks
Project-URL: Issues, https://github.com/Groundmail/groundmail-sdks/issues
Author: Groundmail
License-Expression: MIT
Keywords: email,groundmail,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
Requires-Python: >=3.10
Provides-Extra: dev
Requires-Dist: django>=4.2; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Provides-Extra: django
Requires-Dist: django>=4.2; extra == 'django'
Description-Content-Type: text/markdown

# Groundmail Python SDK

Official Python client for the [Groundmail](https://groundmail.dev) transactional email API.

```bash
pip install groundmail
```

```python
from groundmail import Groundmail

tx = Groundmail("gm_your_key_here")

result = tx.emails.send(
    from_="you@yourdomain.com",
    to="user@example.com",
    subject="Hello",
    html="<p>It works.</p>",
)

print(result["id"], result["status"])
```

## Django

```bash
pip install 'groundmail[django]'
```

```python
EMAIL_BACKEND = "groundmail.django.EmailBackend"
# GROUNDMAIL_API_KEY in the environment
```

Docs: https://docs.groundmail.dev/sdks/python
