UtilityLibAPI 1.2511.291__tar.gz → 1.2511.292__tar.gz

{utilitylibapi-1.2511.291/src/UtilityLibAPI.egg-info → utilitylibapi-1.2511.292}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: UtilityLibAPI
-Version: 1.2511.291
+Version: 1.2511.292
 Summary: UtilityLibAPI Python package
 Author-email: James Lin <tylin123@ms27.hinet.net>
 License: Copyright (c) 2025 James Lin **UtilityLibAPI**
@@ -33,6 +33,9 @@ Dynamic: license-file
 #UtilityLibAPI Classes
 
 ## History of version
+Version 1.2511.292: 2025/11/29<BR>
+Add Event for send mail when success or failure.
+
 Version 1.2511.291: 2025/11/29<BR>
 Fixed MailSenderLib: Attachement file name encode problem.
 Add function for user can modify mail caption of from field.

{utilitylibapi-1.2511.291 → utilitylibapi-1.2511.292}/README.md

@@ -1,6 +1,9 @@
 #UtilityLibAPI Classes
 
 ## History of version
+Version 1.2511.292: 2025/11/29<BR>
+Add Event for send mail when success or failure.
+
 Version 1.2511.291: 2025/11/29<BR>
 Fixed MailSenderLib: Attachement file name encode problem.
 Add function for user can modify mail caption of from field.

{utilitylibapi-1.2511.291 → utilitylibapi-1.2511.292}/pyproject.toml

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

{utilitylibapi-1.2511.291 → utilitylibapi-1.2511.292}/src/UtilityLibAPI/MailSenderLib.py

@@ -30,6 +30,12 @@ class CLASS_MailSender:
         self.Pms_Account     = Pms_Account
         self.Pms_Password    = Pms_Password
         self.Pmb_UseSSL      = Pmb_UseSSL
+        # ======================================================================
+        # 新增事件 
+        # ======================================================================
+        self.OnAfterSendSuccess: Optional[Callable[[str], None]] = None
+        self.OnAfterSendFailure: Optional[Callable[[str], None]] = None
+
 
     #------------------------------------------------------------
     def CUF_CreateMessage(self,
@@ -134,32 +140,51 @@ class CLASS_MailSender:
                     server.sendmail(from_addr, all_recipients, msg.as_string())
 
             print("✅ Send Success!")
+            # ===== 觸發事件 =====
+            if self.OnAfterSendSuccess:
+                self.OnAfterSendSuccess(Pms_Subject)
             return True
         except Exception as e:
             print("❌ Failure:", e)
+            # ===== 觸發事件 =====
+            if self.OnAfterSendFailure:
+                self.OnAfterSendFailure(str(e))
             return False
 
 # ================================================================================
 # [範例]
 # 匯入剛才寫好的 CLASS_MailSender
 #from MailSender import CLASS_MailSender  # 假設你把上面的 class 儲存為 MailSender.py
-if __name__ == "__main__":
+
+def GE_OnSendSuccess(Pms_Subject : str):
+    print("[事件]:成功寄出了!");
+
+
+def GE_OnSendFailure(Pms_ErrMsg : str):
+    print("[事件]: 寄送失敗 ...");
+    print("Err Msg:"+ Pms_ErrMsg);
+
+
+if(__name__ == "__main__"):
     # === 初始化郵件傳送物件 ===
     mailer = CLASS_MailSender(
-        Pms_SMTP_Server="msr.hinet.net",
+        Pms_SMTP_Server="mxr.hxxxt.xxt",
         Pmi_Port=465,
-        Pms_Account="gxxxx.xz@msa.hinet.net",
-        Pms_Password="xxxxx",
+        Pms_Account="xxxxch.xxz@xxa.xxxet.xxt",
+        Pms_Password="xxxxxxxxx",
         Pmb_UseSSL=True
     )
 
+    mailer.OnAfterSendSuccess = GE_OnSendSuccess;
+    mailer.OnAfterSendFailure = GE_OnSendFailure;
+
     # === 郵件收件者設定 ===
-    ml_To  = ["xxxx4@xxxxxh.xxz", "xxxxxx23@xxx7.hxxxx.net"]
-    ml_Cc  = ["exxxxx03@hotmail.com.tw"]
-    ml_Bcc = ["xxxxxxy.lin@msa.hxxxx.net"]  # 密件副本，不會顯示在郵件中
+    ml_To  = ["gxxx4@goxxxx.bxz", "xxxxnxxx@xx27.xxxxx.xxt"]
+    ml_Cc  = ["exxxxxx3@hotmail.com.tw"]
+    ml_Bcc = ["jxxxxxx.xxx@mxx.xxxet.xet"]  # 密件副本，不會顯示在郵件中
 
     # === 郵件主題與內容 ===
-    ms_Subject = "團隊週報通知 wahaha 123*()F"
+    ms_Subject = "團隊週報通知 有事件 wahaha 123*()F"
 
     ms_BodyText = """
 這是一封自動寄出的團隊週報通知。
@@ -193,7 +218,7 @@ if __name__ == "__main__":
         Pms_Subject=ms_Subject,
         Pms_BodyText=ms_BodyText,
         Pms_BodyHTML=ms_BodyHTML,
-        Pms_From = "太棒了!!abcdefg123",
+        Pms_From = "太棒了!!a會觸發事件",
         Pobj_To=ml_To,
         Pobj_Cc=ml_Cc,
         Pobj_Bcc=ml_Bcc,

{utilitylibapi-1.2511.291 → utilitylibapi-1.2511.292/src/UtilityLibAPI.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: UtilityLibAPI
-Version: 1.2511.291
+Version: 1.2511.292
 Summary: UtilityLibAPI Python package
 Author-email: James Lin <tylin123@ms27.hinet.net>
 License: Copyright (c) 2025 James Lin **UtilityLibAPI**
@@ -33,6 +33,9 @@ Dynamic: license-file
 #UtilityLibAPI Classes
 
 ## History of version
+Version 1.2511.292: 2025/11/29<BR>
+Add Event for send mail when success or failure.
+
 Version 1.2511.291: 2025/11/29<BR>
 Fixed MailSenderLib: Attachement file name encode problem.
 Add function for user can modify mail caption of from field.