UtilityLibAPI 1.2512.502__tar.gz → 1.2512.801__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: UtilityLibAPI
-Version: 1.2512.502
+Version: 1.2512.801
 Summary: UtilityLibAPI Python package
 Author-email: James Lin <tylin123@ms27.hinet.net>
 License: Copyright (c) 2025 James Lin **UtilityLibAPI**
@@ -33,6 +33,10 @@ Dynamic: license-file
 #UtilityLibAPI Classes
 
 ## History of version
+Version 1.2512.0801: 2025/12/08<BR>
+Modify CUF_Open() function for multi user accounts.
+
+
 Version 1.2512.0501: 2025/12/05<BR>
 Fixed break down when smtp server not auth or response time out.
 

{utilitylibapi-1.2512.502 → utilitylibapi-1.2512.801}/README.md

@@ -1,6 +1,10 @@
 #UtilityLibAPI Classes
 
 ## History of version
+Version 1.2512.0801: 2025/12/08<BR>
+Modify CUF_Open() function for multi user accounts.
+
+
 Version 1.2512.0501: 2025/12/05<BR>
 Fixed break down when smtp server not auth or response time out.
 

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

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

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

@@ -25,16 +25,88 @@ class CLASS_MailSender:
         :param Pms_Password: 登入密碼或應用程式密碼
         :param Pmb_UseSSL: 是否使用 SSL 連線 (預設 True)
         """
-        self.Pms_SMTP_Server = Pms_SMTP_Server
-        self.Pmi_Port        = Pmi_Port
-        self.Pms_Account     = Pms_Account
-        self.Pms_Password    = Pms_Password
-        self.Pmb_UseSSL      = Pmb_UseSSL
+        self.CVms_SMTP_Server = Pms_SMTP_Server
+        self.CVmi_Port        = Pmi_Port
+        self.CVms_Account     = Pms_Account          # 登入帳號
+        self.CVms_Password    = Pms_Password         # 登入密碼
+        self.CVmb_UseSSL      = Pmb_UseSSL
         # ======================================================================
         # 新增事件 
         # ======================================================================
         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, Pms_Account:str, Pms_PassWD:str) -> bool:
+        """建立 SMTP 連線（長連線模式）"""
+        self.CVms_Account  = Pms_Account;
+        self.CVms_Password = Pms_PassWD;
+        # ------------------------------------------------------------        
+        try:
+            if self.CVobj_Server:
+                return True
+
+            if self.CVmb_UseSSL:
+                server = smtplib.SMTP_SSL(self.CVms_SMTP_Server, self.CVmi_Port)
+            else:
+                server = smtplib.SMTP(self.CVms_SMTP_Server, self.CVmi_Port)
+                server.ehlo()
+                server.starttls()
+
+            server.login(self.CVms_Account, self.CVms_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(Pms_Account = self.CVms_Account,
+                             Pms_PassWD  = self.CVms_Password);
 
 
     #------------------------------------------------------------
@@ -53,7 +125,7 @@ class CLASS_MailSender:
         msg = MIMEMultipart("alternative")
 
         # 設定寄件者別名
-        from_addr = formataddr((Pms_From or self.Pms_Account, self.Pms_Account))
+        from_addr = formataddr((Pms_From or self.CVms_Account, self.CVms_Account))
         msg["From"] = from_addr
 
         msg["To"] = ", ".join(Pobj_To or [])
@@ -125,18 +197,18 @@ class CLASS_MailSender:
         )
 
         all_recipients = (Pobj_To or []) + (Pobj_Cc or []) + (Pobj_Bcc or [])
-        from_addr = formataddr((Pms_From or self.Pms_Account, self.Pms_Account))
+        from_addr = formataddr((Pms_From or self.CVms_Account, self.CVms_Account))
 
         try:
-            if self.Pmb_UseSSL:
-                with smtplib.SMTP_SSL(self.Pms_SMTP_Server, self.Pmi_Port) as server:
-                    server.login(self.Pms_Account, self.Pms_Password)
+            if self.CVmb_UseSSL:
+                with smtplib.SMTP_SSL(self.CVms_SMTP_Server, self.CVmi_Port) as server:
+                    server.login(self.CVms_Account, self.CVms_Password)
                     server.sendmail(from_addr, all_recipients, msg.as_string())
             else:
-                with smtplib.SMTP(self.Pms_SMTP_Server, self.Pmi_Port) as server:
+                with smtplib.SMTP(self.CVms_SMTP_Server, self.CVmi_Port) as server:
                     server.ehlo()
                     server.starttls()
-                    server.login(self.Pms_Account, self.Pms_Password)
+                    server.login(self.CVms_Account, self.CVms_Password)
                     server.sendmail(from_addr, all_recipients, msg.as_string())
 
             print("✅ Send Success!")
@@ -152,7 +224,6 @@ class CLASS_MailSender:
             return False
 
 
-
 # ================================================================================
 # [範例]
 # 匯入剛才寫好的 CLASS_MailSender

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: UtilityLibAPI
-Version: 1.2512.502
+Version: 1.2512.801
 Summary: UtilityLibAPI Python package
 Author-email: James Lin <tylin123@ms27.hinet.net>
 License: Copyright (c) 2025 James Lin **UtilityLibAPI**
@@ -33,6 +33,10 @@ Dynamic: license-file
 #UtilityLibAPI Classes
 
 ## History of version
+Version 1.2512.0801: 2025/12/08<BR>
+Modify CUF_Open() function for multi user accounts.
+
+
 Version 1.2512.0501: 2025/12/05<BR>
 Fixed break down when smtp server not auth or response time out.