mailsuite 2.2.0__tar.gz → 2.2.2__tar.gz

{mailsuite-2.2.0 → mailsuite-2.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mailsuite
-Version: 2.2.0
+Version: 2.2.2
 Summary: A Python package for retrieving, parsing, and sending emails
 Project-URL: Homepage, https://github.com/seanthegeek/mailsuite/
 Project-URL: Documentation, https://seanthegeek.github.io/mailsuite/
@@ -24,7 +24,7 @@ Requires-Dist: dnspython>=2.0.0
 Requires-Dist: expiringdict==1.2.2
 Requires-Dist: html2text>=2020.1.16
 Requires-Dist: imapclient>=3.1.0
-Requires-Dist: mail-parser>=4.1.2
+Requires-Dist: mail-parser>=4.2.1
 Requires-Dist: publicsuffix2>=2.20190812
 Provides-Extra: all
 Requires-Dist: azure-identity>=1.15.0; extra == 'all'

{mailsuite-2.2.0 → mailsuite-2.2.2}/mailsuite/__init__.py

@@ -1,3 +1,3 @@
 """A Python package to simplify receiving, parsing, and sending email"""
 
-__version__ = "2.2.0"
+__version__ = "2.2.2"

{mailsuite-2.2.0 → mailsuite-2.2.2}/mailsuite/imap.py

@@ -96,13 +96,17 @@ class IMAPClient(imapclient.IMAPClient):
             return result.decode("utf-8", "replace")
         return str(result)
 
-    def _start_idle(self, idle_callback, idle_timeout: int = 30):
+    def _start_idle(self, idle_callback, idle_timeout: int = 30, config_reloading=None):
         """
         Starts an IMAP IDLE session
 
         Args:
             idle_callback: A callback function
             idle_timeout: Number of seconds to wait for an IDLE response
+            config_reloading: Optional zero-arg callable; when it returns a
+                truthy value the IDLE loop exits cleanly so the caller can
+                reload config or shut down. Checked at the top of each cycle,
+                while IDLE is active, so idle_done() stays valid.
         """
         if self._idle_supported is False:
             raise imapclient.exceptions.IMAPClientError(
@@ -115,6 +119,8 @@ class IMAPClient(imapclient.IMAPClient):
         # re-arms this loop in place instead of starting a nested IDLE loop.
         self._idle_running = True
         while True:
+            if config_reloading and config_reloading():
+                break
             try:
                 # Refresh the IDLE session every 5 minutes to stay connected
                 if time.monotonic() - idle_start_time > 5 * 60:
@@ -183,6 +189,7 @@ class IMAPClient(imapclient.IMAPClient):
         oauth2_token_provider: Optional[Callable[[], str]] = None,
         oauth2_mechanism: str = "XOAUTH2",
         oauth2_vendor: Optional[str] = None,
+        config_reloading: Optional[Callable[[], bool]] = None,
     ):
         """
         Connects to an IMAP server
@@ -339,7 +346,11 @@ class IMAPClient(imapclient.IMAPClient):
         # reset_connection() re-runs __init__ from inside the loop, and a
         # nested _start_idle would stack IDLE loops on every reconnect.
         if idle_callback is not None and not getattr(self, "_idle_running", False):
-            self._start_idle(idle_callback, idle_timeout=idle_timeout)
+            self._start_idle(
+                idle_callback,
+                idle_timeout=idle_timeout,
+                config_reloading=config_reloading,
+            )
 
     def reset_connection(self):
         """Resets the connection to the IMAP server"""

{mailsuite-2.2.0 → mailsuite-2.2.2}/mailsuite/mailbox/imap.py

@@ -174,6 +174,7 @@ class IMAPConnection(MailboxConnection):
                     oauth2_token_provider=self._oauth2_token_provider,
                     oauth2_mechanism=self._oauth2_mechanism,
                     oauth2_vendor=self._oauth2_vendor,
+                    config_reloading=config_reloading,
                 )
             except (timeout, IMAPClientError):
                 logger.warning("IMAP connection timeout. Reconnecting...")

{mailsuite-2.2.0 → mailsuite-2.2.2}/pyproject.toml

@@ -35,7 +35,7 @@ dependencies = [
     "expiringdict==1.2.2",
     "html2text>=2020.1.16",
     "IMAPClient>=3.1.0",
-    "mail-parser>=4.1.2",
+    "mail-parser>=4.2.1",
     "publicsuffix2>=2.20190812",
 ]
 dynamic = [