plain.email 0.12.0__tar.gz → 0.13.0__tar.gz

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

@@ -5,6 +5,8 @@
 __pycache__
 *.DS_Store
 
+/*.code-workspace
+
 # Test apps
 plain*/tests/.plain
 

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plain.email
-Version: 0.12.0
+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.12.0 → plain_email-0.13.0}/plain/email/CHANGELOG.md

@@ -1,5 +1,15 @@
 # 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

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

@@ -28,7 +28,7 @@ class BaseEmailBackend(ABC):
     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.
 

{plain_email-0.12.0 → 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.12.0 → plain_email-0.13.0}/plain/email/backends/filebased.py

@@ -16,17 +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)
-        if not 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(self.file_path)
+        self.file_path = os.path.abspath(_file_path)
         try:
             os.makedirs(self.file_path, exist_ok=True)
         except FileExistsError:

{plain_email-0.12.0 → 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,6 +433,7 @@ 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

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

@@ -1,6 +1,6 @@
 [project]
 name = "plain.email"
-version = "0.12.0"
+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"