UtilityLibAPI 1.2512.502__tar.gz → 1.2512.503__tar.gz

{utilitylibapi-1.2512.502/src/UtilityLibAPI.egg-info → utilitylibapi-1.2512.503}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: UtilityLibAPI
-Version: 1.2512.502
+Version: 1.2512.503
 Summary: UtilityLibAPI Python package
 Author-email: James Lin <tylin123@ms27.hinet.net>
 License: Copyright (c) 2025 James Lin **UtilityLibAPI**

{utilitylibapi-1.2512.502 → utilitylibapi-1.2512.503}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "UtilityLibAPI"
-version = "1.2512.0502"
+version = "1.2512.0503"
 description = "UtilityLibAPI Python package"
 authors = [
   { name="James Lin", email="tylin123@ms27.hinet.net" }

{utilitylibapi-1.2512.502 → utilitylibapi-1.2512.503}/src/UtilityLibAPI/MailSenderLib.py

@@ -35,6 +35,74 @@ class CLASS_MailSender:
         # ======================================================================
         self.OnAfterSendSuccess: Optional[Callable[[str], None]] = None
         self.OnAfterSendFailure: Optional[Callable[[str], None]] = None
+        # ============================================================
+        # ⭐⭐ 新增：維持 SMTP 連線用變數
+        # ============================================================
+        self.CVobj_Server: Optional[smtplib.SMTP] = None
+
+    # ################################################################################
+    # [預防 Mail Server 中斷連線]
+    # 手動控制連線
+    # mailer.CUF_Open()
+    # mailer.CUF_SendMail(...)
+    # mailer.CUF_Close()
+    # ------------------------------------------------------------
+    # 每 5 分鐘預防性重連
+    # mailer.CUF_Reconnect()
+    # ------------------------------------------------------------
+    # 如果 SendMail 失敗，要重連
+    # if not mailer.CUF_SendMail(...):
+    #     mailer.CUF_Reconnect()
+    # ################################################################################
+
+    # ================================================================================
+    # ⭐⭐⭐ 新增函數：CUF_Open() ⭐⭐⭐
+    # ================================================================================
+    def CUF_Open(self) -> bool:
+        """建立 SMTP 連線（長連線模式）"""
+        try:
+            if self.CVobj_Server:
+                return True
+
+            if self.Pmb_UseSSL:
+                server = smtplib.SMTP_SSL(self.Pms_SMTP_Server, self.Pmi_Port)
+            else:
+                server = smtplib.SMTP(self.Pms_SMTP_Server, self.Pmi_Port)
+                server.ehlo()
+                server.starttls()
+
+            server.login(self.Pms_Account, self.Pms_Password)
+            self.CVobj_Server = server
+            return True
+        except Exception as e:
+            print("❌ CUF_Open Error:", e)
+            self.CVobj_Server = None
+            return False
+
+
+    # ================================================================================
+    # ⭐⭐⭐ 新增函數：CUF_Close() ⭐⭐⭐
+    # ================================================================================
+    def CUF_Close(self):
+        """關閉 SMTP 長連線"""
+        try:
+            if self.CVobj_Server:
+                try:
+                    self.CVobj_Server.quit()
+                except:
+                    pass
+            self.CVobj_Server = None
+        except:
+            self.CVobj_Server = None
+
+
+    # ================================================================================
+    # ⭐⭐⭐ 新增函數：CUF_Reconnect() ⭐⭐⭐
+    # ================================================================================
+    def CUF_Reconnect(self) -> bool:
+        """強制重新連線"""
+        self.CUF_Close()
+        return self.CUF_Open()
 
 
     #------------------------------------------------------------
@@ -152,7 +220,6 @@ class CLASS_MailSender:
             return False
 
 
-
 # ================================================================================
 # [範例]
 # 匯入剛才寫好的 CLASS_MailSender

{utilitylibapi-1.2512.502 → utilitylibapi-1.2512.503/src/UtilityLibAPI.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: UtilityLibAPI
-Version: 1.2512.502
+Version: 1.2512.503
 Summary: UtilityLibAPI Python package
 Author-email: James Lin <tylin123@ms27.hinet.net>
 License: Copyright (c) 2025 James Lin **UtilityLibAPI**