Metadata-Version: 2.3
Name: jemail
Version: 0.1a1
Summary: Django app to store emails in db
Project-URL: Repository, https://github.com/kotify/jemail
Project-URL: Changelog, https://github.com/kotify/jemail/blob/main/CHANGELOG.md
Author-email: Konstantin Alekseev <mail@kalekseev.com>
License-Expression: MIT
License-File: LICENSE
Keywords: django,email
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Web Environment
Classifier: Framework :: Django :: 4.2
Classifier: Framework :: Django :: 5.0
Classifier: Framework :: Django :: 5.1
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
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: Programming Language :: Python :: 3.13
Classifier: Typing :: Typed
Requires-Python: >=3.8
Requires-Dist: django-anymail
Requires-Dist: django>=4.2
Requires-Dist: html2text
Provides-Extra: dev
Requires-Dist: django-stubs; extra == 'dev'
Requires-Dist: mypy; extra == 'dev'
Requires-Dist: pdbpp; extra == 'dev'
Requires-Dist: pre-commit; extra == 'dev'
Requires-Dist: ruff; extra == 'dev'
Provides-Extra: test
Requires-Dist: pytest; extra == 'test'
Requires-Dist: pytest-cov; extra == 'test'
Requires-Dist: pytest-django; extra == 'test'
Description-Content-Type: text/markdown

# Jemail

Django app to store emails in db


## Installation

```sh
pip install jemail
pip install django-anymail[sendgrid]
```

Anymail used as email backend, for now jemail tested only with `sendgrid` backend.

Update settings with:

```python
EMAIL_BACKEND = "anymail.backends.sendgrid.EmailBackend"

# defaults
JEMAIL = {
    "METADATA_ID_KEY": "message_id",  # tag name for EmailMessage.pk in message metadata
    "HTML_MESSAGE_UPLOAD_TO": "emails/messages/",  # path to save html messages to
    "ATTACHMENT_UPLOAD_TO": "emails/attachments/",  # path to save attachments to
    # "IMPORT_HTML_MESSAGE_UPLOAD_TO": "myproject.utils.message_upload_to",  # callable option
    # "IMPORT_ATTACHMENT_UPLOAD_TO": "myproject.utils.attachment_upload_to",  # callable option
}
```

## Usage

```python
from jemail import EmailMessage, EmailAttachment

# save email in db
message = EmailMessage.objects.create_with_objects(
    from_email='no-reply@example.com',
    to=['user@example.com'],
    subject='Subject',
    body='Hi User,...',
    html_message='<p>Hi User...',
    cc=['cc@example.com'],
    reply_to='support@example.com',
    attachments=[EmailAttachment.objects.create(
        filename='doc.pdf',
        mimetype='application/pdf',
        file=ContentFile(b'...', name='doc.pdf')
    )],

# build EmailMultiAlternatives from db
msg = message.build_message()
# send email
msg.send()
)
```

## Development

nix-direnv:

```sh
echo "use flake" >> .envrc
direnv allow
app.install
pytest
```

nix:

```sh
nix develop
app.install
pytest
```

uv:

```sh
uv -q venv .venv
source .venv/bin/activate
uv pip install -e .[dev,test]
pre-commit install
pytest
```
