plain.email 0.15.0__tar.gz → 0.15.2__tar.gz

{plain_email-0.15.0 → plain_email-0.15.2}/.gitignore

@@ -17,5 +17,5 @@ plain*/tests/.plain
 .plain
 
 .vscode
-/.claude/skills/plain-*
+/.claude/settings.local.json
 /.benchmarks

{plain_email-0.15.0 → plain_email-0.15.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plain.email
-Version: 0.15.0
+Version: 0.15.2
 Summary: Everything you need to send email in Plain.
 Author-email: Dave Gaeddert <dave.gaeddert@dropseed.dev>
 License-Expression: BSD-3-Clause
@@ -18,8 +18,7 @@ Description-Content-Type: text/markdown
     - [Sending HTML emails](#sending-html-emails)
     - [Template-based emails](#template-based-emails)
     - [Attachments](#attachments)
-- [Configuration](#configuration)
-    - [SMTP settings](#smtp-settings)
+- [Settings](#settings)
 - [Email backends](#email-backends)
     - [SMTP backend](#smtp-backend)
     - [Console backend](#console-backend)
@@ -131,43 +130,25 @@ email.attach_file("/path/to/report.pdf")
 email.send()
 ```
 
-## Configuration
-
-Configure email settings in your `settings.py`:
-
-```python
-# settings.py
-
-# Required: The backend to use for sending emails
-EMAIL_BACKEND = "plain.email.backends.smtp.EmailBackend"
-
-# Required: Default "From" address for outgoing emails
-EMAIL_DEFAULT_FROM = "noreply@example.com"
-
-# Optional: Default "Reply-To" addresses
-EMAIL_DEFAULT_REPLY_TO = ["support@example.com"]
-```
-
-### SMTP settings
-
-When using the SMTP backend, configure your mail server:
-
-```python
-# settings.py
-
-EMAIL_HOST = "smtp.example.com"
-EMAIL_PORT = 587
-EMAIL_HOST_USER = "your-username"
-EMAIL_HOST_PASSWORD = "your-password"
-EMAIL_USE_TLS = True  # Use STARTTLS
-EMAIL_USE_SSL = False  # Use implicit SSL (mutually exclusive with TLS)
-
-# Optional settings
-EMAIL_TIMEOUT = 10  # Connection timeout in seconds
-EMAIL_SSL_CERTFILE = None  # Path to SSL certificate file
-EMAIL_SSL_KEYFILE = None  # Path to SSL key file
-EMAIL_USE_LOCALTIME = False  # Use local time in Date header (default: UTC)
-```
+## Settings
+
+| Setting                  | Default       | Env var                        |
+| ------------------------ | ------------- | ------------------------------ |
+| `EMAIL_BACKEND`          | Required      | `PLAIN_EMAIL_BACKEND`          |
+| `EMAIL_DEFAULT_FROM`     | Required      | `PLAIN_EMAIL_DEFAULT_FROM`     |
+| `EMAIL_DEFAULT_REPLY_TO` | `None`        | `PLAIN_EMAIL_DEFAULT_REPLY_TO` |
+| `EMAIL_HOST`             | `"localhost"` | `PLAIN_EMAIL_HOST`             |
+| `EMAIL_PORT`             | `587`         | `PLAIN_EMAIL_PORT`             |
+| `EMAIL_HOST_USER`        | `""`          | `PLAIN_EMAIL_HOST_USER`        |
+| `EMAIL_HOST_PASSWORD`    | `""`          | `PLAIN_EMAIL_HOST_PASSWORD`    |
+| `EMAIL_USE_TLS`          | `True`        | `PLAIN_EMAIL_USE_TLS`          |
+| `EMAIL_USE_SSL`          | `False`       | `PLAIN_EMAIL_USE_SSL`          |
+| `EMAIL_TIMEOUT`          | `None`        | `PLAIN_EMAIL_TIMEOUT`          |
+| `EMAIL_SSL_CERTFILE`     | `None`        | `PLAIN_EMAIL_SSL_CERTFILE`     |
+| `EMAIL_SSL_KEYFILE`      | `None`        | `PLAIN_EMAIL_SSL_KEYFILE`      |
+| `EMAIL_USE_LOCALTIME`    | `False`       | `PLAIN_EMAIL_USE_LOCALTIME`    |
+
+See [`default_settings.py`](./default_settings.py) for more details.
 
 ## Email backends
 

{plain_email-0.15.0 → plain_email-0.15.2}/plain/email/CHANGELOG.md

@@ -1,5 +1,26 @@
 # plain-email changelog
 
+## [0.15.2](https://github.com/dropseed/plain/releases/plain-email@0.15.2) (2026-02-04)
+
+### What's changed
+
+- Added `__all__` export to `backends/base` module ([e7164d3891b2](https://github.com/dropseed/plain/commit/e7164d3891b2))
+- Removed `@internalcode` decorator from internal MIME helper classes ([e7164d3891b2](https://github.com/dropseed/plain/commit/e7164d3891b2))
+
+### Upgrade instructions
+
+- No changes required.
+
+## [0.15.1](https://github.com/dropseed/plain/releases/plain-email@0.15.1) (2026-01-28)
+
+### What's changed
+
+- Added Settings section to README ([803fee1ad5](https://github.com/dropseed/plain/commit/803fee1ad5))
+
+### Upgrade instructions
+
+- No changes required.
+
 ## [0.15.0](https://github.com/dropseed/plain/releases/plain-email@0.15.0) (2026-01-15)
 
 ### What's changed

{plain_email-0.15.0 → plain_email-0.15.2}/plain/email/README.md

@@ -7,8 +7,7 @@
     - [Sending HTML emails](#sending-html-emails)
     - [Template-based emails](#template-based-emails)
     - [Attachments](#attachments)
-- [Configuration](#configuration)
-    - [SMTP settings](#smtp-settings)
+- [Settings](#settings)
 - [Email backends](#email-backends)
     - [SMTP backend](#smtp-backend)
     - [Console backend](#console-backend)
@@ -120,43 +119,25 @@ email.attach_file("/path/to/report.pdf")
 email.send()
 ```
 
-## Configuration
-
-Configure email settings in your `settings.py`:
-
-```python
-# settings.py
-
-# Required: The backend to use for sending emails
-EMAIL_BACKEND = "plain.email.backends.smtp.EmailBackend"
-
-# Required: Default "From" address for outgoing emails
-EMAIL_DEFAULT_FROM = "noreply@example.com"
-
-# Optional: Default "Reply-To" addresses
-EMAIL_DEFAULT_REPLY_TO = ["support@example.com"]
-```
-
-### SMTP settings
-
-When using the SMTP backend, configure your mail server:
-
-```python
-# settings.py
-
-EMAIL_HOST = "smtp.example.com"
-EMAIL_PORT = 587
-EMAIL_HOST_USER = "your-username"
-EMAIL_HOST_PASSWORD = "your-password"
-EMAIL_USE_TLS = True  # Use STARTTLS
-EMAIL_USE_SSL = False  # Use implicit SSL (mutually exclusive with TLS)
-
-# Optional settings
-EMAIL_TIMEOUT = 10  # Connection timeout in seconds
-EMAIL_SSL_CERTFILE = None  # Path to SSL certificate file
-EMAIL_SSL_KEYFILE = None  # Path to SSL key file
-EMAIL_USE_LOCALTIME = False  # Use local time in Date header (default: UTC)
-```
+## Settings
+
+| Setting                  | Default       | Env var                        |
+| ------------------------ | ------------- | ------------------------------ |
+| `EMAIL_BACKEND`          | Required      | `PLAIN_EMAIL_BACKEND`          |
+| `EMAIL_DEFAULT_FROM`     | Required      | `PLAIN_EMAIL_DEFAULT_FROM`     |
+| `EMAIL_DEFAULT_REPLY_TO` | `None`        | `PLAIN_EMAIL_DEFAULT_REPLY_TO` |
+| `EMAIL_HOST`             | `"localhost"` | `PLAIN_EMAIL_HOST`             |
+| `EMAIL_PORT`             | `587`         | `PLAIN_EMAIL_PORT`             |
+| `EMAIL_HOST_USER`        | `""`          | `PLAIN_EMAIL_HOST_USER`        |
+| `EMAIL_HOST_PASSWORD`    | `""`          | `PLAIN_EMAIL_HOST_PASSWORD`    |
+| `EMAIL_USE_TLS`          | `True`        | `PLAIN_EMAIL_USE_TLS`          |
+| `EMAIL_USE_SSL`          | `False`       | `PLAIN_EMAIL_USE_SSL`          |
+| `EMAIL_TIMEOUT`          | `None`        | `PLAIN_EMAIL_TIMEOUT`          |
+| `EMAIL_SSL_CERTFILE`     | `None`        | `PLAIN_EMAIL_SSL_CERTFILE`     |
+| `EMAIL_SSL_KEYFILE`      | `None`        | `PLAIN_EMAIL_SSL_KEYFILE`      |
+| `EMAIL_USE_LOCALTIME`    | `False`       | `PLAIN_EMAIL_USE_LOCALTIME`    |
+
+See [`default_settings.py`](./default_settings.py) for more details.
 
 ## Email backends
 

{plain_email-0.15.0 → plain_email-0.15.2}/plain/email/backends/base.py

@@ -10,6 +10,8 @@ if TYPE_CHECKING:
 
     from ..message import EmailMessage
 
+__all__ = ["BaseEmailBackend"]
+
 
 class BaseEmailBackend(ABC):
     """

{plain_email-0.15.0 → plain_email-0.15.2}/plain/email/message.py

@@ -20,7 +20,6 @@ from io import BytesIO, StringIO
 from pathlib import Path
 from typing import TYPE_CHECKING, Any
 
-from plain.internal import internalcode
 from plain.runtime import settings
 from plain.templates import Template, TemplateFileMissing
 from plain.utils.encoding import force_str, punycode
@@ -136,7 +135,6 @@ def _sanitize_address(addr: str | tuple[str, str], encoding: str) -> str:
     return formataddr((nm, parsed_address.addr_spec))
 
 
-@internalcode
 class MIMEMixin:
     def as_string(self, unixfrom: bool = False, linesep: str = "\n") -> str:
         """Return the entire formatted message as a string.
@@ -165,7 +163,6 @@ class MIMEMixin:
         return fp.getvalue()
 
 
-@internalcode
 class SafeMIMEMessage(MIMEMixin, MIMEMessage):
     def __setitem__(self, name: str, val: str) -> None:
         # message/rfc822 attachments must be ASCII
@@ -173,7 +170,6 @@ class SafeMIMEMessage(MIMEMixin, MIMEMessage):
         MIMEMessage.__setitem__(self, name, val)
 
 
-@internalcode
 class SafeMIMEText(MIMEMixin, MIMEText):
     def __init__(
         self, _text: str, _subtype: str = "plain", _charset: str | None = None
@@ -199,7 +195,6 @@ class SafeMIMEText(MIMEMixin, MIMEText):
         MIMEText.set_payload(self, payload, charset=charset)
 
 
-@internalcode
 class SafeMIMEMultipart(MIMEMixin, MIMEMultipart):
     def __init__(
         self,

{plain_email-0.15.0 → plain_email-0.15.2}/plain/email/utils.py

@@ -6,13 +6,11 @@ from __future__ import annotations
 
 import socket
 
-from plain.internal import internalcode
 from plain.utils.encoding import punycode
 
 
 # Cache the hostname, but do it lazily: socket.getfqdn() can take a couple of
 # seconds, which slows down the restart of the server.
-@internalcode
 class CachedDnsName:
     def __str__(self) -> str:
         return self.get_fqdn()

{plain_email-0.15.0 → plain_email-0.15.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "plain.email"
-version = "0.15.0"
+version = "0.15.2"
 description = "Everything you need to send email in Plain."
 authors = [{name = "Dave Gaeddert", email = "dave.gaeddert@dropseed.dev"}]
 license = "BSD-3-Clause"