plain.email 0.11.1__tar.gz → 0.13.0__tar.gz

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

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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plain.email
-Version: 0.11.1
+Version: 0.13.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.13.0}/plain/email/CHANGELOG.md

@@ -1,5 +1,26 @@
 # plain-email changelog
 
+## [0.13.0](https://github.com/dropseed/plain/releases/plain-email@0.13.0) (2025-12-04)
+
+### What's changed
+
+- Internal typing improvements for better type checker compatibility ([ac1eeb0](https://github.com/dropseed/plain/commit/ac1eeb0ea05b26dfc7e32c50f2a5a5bc7e098ceb))
+
+### Upgrade instructions
+
+- No changes required
+
+## [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.13.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.
 
@@ -27,7 +28,7 @@ class BaseEmailBackend:
     def __init__(self, fail_silently: bool = False, **kwargs: Any) -> None:
         self.fail_silently = fail_silently
 
-    def open(self) -> None:
+    def open(self) -> bool | None:
         """
         Open a network connection.
 
@@ -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.13.0}/plain/email/backends/console.py

@@ -23,9 +23,13 @@ class EmailBackend(BaseEmailBackend):
     def write_message(self, message: EmailMessage) -> None:
         msg = message.message()
         msg_data = msg.as_bytes()
-        charset = (
-            msg.get_charset().get_output_charset() if msg.get_charset() else "utf-8"
-        )
+        msg_charset = msg.get_charset()
+        if msg_charset is None:
+            charset = "utf-8"
+        elif isinstance(msg_charset, str):
+            charset = msg_charset
+        else:
+            charset = msg_charset.get_output_charset() or "utf-8"
         msg_data = msg_data.decode(charset)
         self.stream.write(f"{msg_data}\n")
         self.stream.write("-" * 79)

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

@@ -16,13 +16,16 @@ if TYPE_CHECKING:
 
 
 class EmailBackend(ConsoleEmailBackend):
+    file_path: str  # Set during __init__, validated to be non-None
+
     def __init__(self, *args: Any, file_path: str | None = None, **kwargs: Any) -> None:
-        self._fname = None
-        if file_path is not None:
-            self.file_path = file_path
-        else:
-            self.file_path = getattr(settings, "EMAIL_FILE_PATH", None)
-        self.file_path = os.path.abspath(self.file_path)
+        self._fname: str | None = None
+        _file_path: str | None = file_path or getattr(settings, "EMAIL_FILE_PATH", None)
+        if not _file_path:
+            raise ImproperlyConfigured(
+                "EMAIL_FILE_PATH must be set for the filebased email backend"
+            )
+        self.file_path = os.path.abspath(_file_path)
         try:
             os.makedirs(self.file_path, exist_ok=True)
         except FileExistsError:
@@ -45,6 +48,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.13.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.13.0}/plain/email/message.py

@@ -181,7 +181,7 @@ class SafeMIMEText(MIMEMixin, MIMEText):
         name, val = forbid_multi_line_headers(name, val, self.encoding)
         MIMEText.__setitem__(self, name, val)
 
-    def set_payload(
+    def set_payload(  # type: ignore[override]
         self, payload: str, charset: str | Charset.Charset | None = None
     ) -> None:
         if charset == "utf-8" and not isinstance(charset, Charset.Charset):
@@ -349,11 +349,10 @@ class EmailMessage:
         elif content is None:
             raise ValueError("content must be provided.")
         else:
-            mimetype = (
-                mimetype
-                or mimetypes.guess_type(filename)[0]
-                or DEFAULT_ATTACHMENT_MIME_TYPE
-            )
+            if filename is not None and mimetype is None:
+                mimetype = mimetypes.guess_type(filename)[0]
+            if mimetype is None:
+                mimetype = DEFAULT_ATTACHMENT_MIME_TYPE
             basetype, subtype = mimetype.split("/", 1)
 
             if basetype == "text":
@@ -434,12 +433,13 @@ class EmailMessage:
         else:
             # Encode non-text attachments with base64.
             attachment = MIMEBase(basetype, subtype)
+            assert isinstance(content, bytes), "Non-text attachments must be bytes"
             attachment.set_payload(content)
             Encoders.encode_base64(attachment)
         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.13.0}/pyproject.toml

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