plain.email 0.11.1__tar.gz → 0.12.0__tar.gz

{plain_email-0.11.1 → plain_email-0.12.0}/.gitignore

@@ -1,5 +1,5 @@
 .venv
-.env
+/.env
 *.egg-info
 *.py[co]
 __pycache__
@@ -8,8 +8,8 @@ __pycache__
 # Test apps
 plain*/tests/.plain
 
-# Ottobot
-.aider*
+# Agent scratch files
+/scratch
 
 # Plain temp dirs
 .plain

{plain_email-0.11.1 → plain_email-0.12.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plain.email
-Version: 0.11.1
+Version: 0.12.0
 Summary: Everything you need to send email in Plain.
 Author-email: Dave Gaeddert <dave.gaeddert@dropseed.dev>
 License-Expression: BSD-3-Clause

{plain_email-0.11.1 → plain_email-0.12.0}/plain/email/CHANGELOG.md

@@ -1,5 +1,16 @@
 # plain-email changelog
 
+## [0.12.0](https://github.com/dropseed/plain/releases/plain-email@0.12.0) (2025-11-12)
+
+### What's changed
+
+- The filebased email backend now requires `EMAIL_FILE_PATH` to be set and raises `ImproperlyConfigured` if not provided ([f4dbcef](https://github.com/dropseed/plain/commit/f4dbcefa929058be517cb1d4ab35bd73a89f26b8))
+- `BaseEmailBackend` now uses Python's abstract base class with `@abstractmethod` for better type checking ([245b5f4](https://github.com/dropseed/plain/commit/245b5f472c89178b8b764869f1624f8fc885b0f7))
+
+### Upgrade instructions
+
+- If using the filebased email backend, ensure `EMAIL_FILE_PATH` is configured in your settings or passed when initializing the backend
+
 ## [0.11.1](https://github.com/dropseed/plain/releases/plain-email@0.11.1) (2025-10-06)
 
 ### What's changed

{plain_email-0.11.1 → plain_email-0.12.0}/plain/email/backends/base.py

@@ -2,6 +2,7 @@
 
 from __future__ import annotations
 
+from abc import ABC, abstractmethod
 from typing import TYPE_CHECKING, Any
 
 if TYPE_CHECKING:
@@ -10,7 +11,7 @@ if TYPE_CHECKING:
     from ..message import EmailMessage
 
 
-class BaseEmailBackend:
+class BaseEmailBackend(ABC):
     """
     Base class for email backend implementations.
 
@@ -66,11 +67,10 @@ class BaseEmailBackend:
     ) -> None:
         self.close()
 
+    @abstractmethod
     def send_messages(self, email_messages: list[EmailMessage]) -> int:
         """
         Send one or more EmailMessage objects and return the number of email
         messages sent.
         """
-        raise NotImplementedError(
-            "subclasses of BaseEmailBackend must override send_messages() method"
-        )
+        ...

{plain_email-0.11.1 → plain_email-0.12.0}/plain/email/backends/filebased.py

@@ -22,6 +22,10 @@ class EmailBackend(ConsoleEmailBackend):
             self.file_path = file_path
         else:
             self.file_path = getattr(settings, "EMAIL_FILE_PATH", None)
+        if not self.file_path:
+            raise ImproperlyConfigured(
+                "EMAIL_FILE_PATH must be set for the filebased email backend"
+            )
         self.file_path = os.path.abspath(self.file_path)
         try:
             os.makedirs(self.file_path, exist_ok=True)
@@ -45,6 +49,7 @@ class EmailBackend(ConsoleEmailBackend):
         super().__init__(*args, **kwargs)
 
     def write_message(self, message: EmailMessage) -> None:
+        assert self.stream is not None, "stream should be opened before writing"
         self.stream.write(message.message().as_bytes() + b"\n")
         self.stream.write(b"-" * 79)
         self.stream.write(b"\n")

{plain_email-0.11.1 → plain_email-0.12.0}/plain/email/backends/smtp.py

@@ -84,7 +84,7 @@ class EmailBackend(BaseEmailBackend):
 
         # If local_hostname is not specified, socket.getfqdn() gets used.
         # For performance, we use the cached FQDN for local_hostname.
-        connection_params = {"local_hostname": DNS_NAME.get_fqdn()}
+        connection_params: dict[str, Any] = {"local_hostname": DNS_NAME.get_fqdn()}
         if self.timeout is not None:
             connection_params["timeout"] = self.timeout
         if self.use_ssl:
@@ -158,6 +158,7 @@ class EmailBackend(BaseEmailBackend):
             sanitize_address(addr, encoding) for addr in email_message.recipients()
         ]
         message = email_message.message()
+        assert self.connection is not None, "connection should be open before sending"
         try:
             self.connection.sendmail(
                 from_email, recipients, message.as_bytes(linesep="\r\n")

{plain_email-0.11.1 → plain_email-0.12.0}/plain/email/message.py

@@ -439,7 +439,7 @@ class EmailMessage:
         return attachment
 
     def _create_attachment(
-        self, filename: str | None, content: str | bytes, mimetype: str | None = None
+        self, filename: str | None, content: str | bytes, mimetype: str
     ) -> SafeMIMEText | SafeMIMEMessage | MIMEBase:
         """
         Convert the filename, content, mimetype triple into a MIME attachment

{plain_email-0.11.1 → plain_email-0.12.0}/pyproject.toml

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