UtilityLibAPI 1.2511.282__tar.gz → 1.2511.292__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: UtilityLibAPI
-Version: 1.2511.282
+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,13 @@ 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.
+
 Version 1.2511.282: 2025/11/27<BR>
 Fixed MailSenderLib: Attachement file name encode problem.
 

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

@@ -1,6 +1,13 @@
 #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.
+
 Version 1.2511.282: 2025/11/27<BR>
 Fixed MailSenderLib: Attachement file name encode problem.
 

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

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

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

@@ -2,8 +2,10 @@ import smtplib
 from email.mime.text import MIMEText
 from email.mime.multipart import MIMEMultipart
 from email.mime.application import MIMEApplication
+from email.mime.base import MIMEBase
 from email.utils import formataddr
 from email.header import Header
+from email import encoders
 from typing import List, Optional
 import os
 import mimetypes
@@ -24,10 +26,16 @@ class CLASS_MailSender:
         :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.Pmi_Port        = Pmi_Port
+        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,
@@ -40,10 +48,14 @@ class CLASS_MailSender:
                           Pobj_Bcc: Optional[List[str]] = None,
                           Pobj_Attachments: Optional[List[str]] = None) -> MIMEMultipart:
         """
-        建立郵件內容（支援 HTML / 附件）
+        建立郵件內容（支援 HTML / 附件 / 顯示別名）
         """
         msg = MIMEMultipart("alternative")
-        msg["From"] = formataddr((Pms_From or self.Pms_Account, self.Pms_Account))
+
+        # 設定寄件者別名
+        from_addr = formataddr((Pms_From or self.Pms_Account, self.Pms_Account))
+        msg["From"] = from_addr
+
         msg["To"] = ", ".join(Pobj_To or [])
         if Pobj_Cc:
             msg["Cc"] = ", ".join(Pobj_Cc)
@@ -56,7 +68,7 @@ class CLASS_MailSender:
         if Pms_BodyHTML:
             msg.attach(MIMEText(Pms_BodyHTML, "html", "utf-8"))
 
-        # 附件
+        # 附件（支援中文檔名 & Outlook）
         if Pobj_Attachments:
             for ms_path in Pobj_Attachments:
                 try:
@@ -86,7 +98,6 @@ class CLASS_MailSender:
                         msg.attach(part)
                 except Exception as e:
                     print(f"⚠️ Can not add attachment: {ms_path} ({e})")
-
         return msg
 
     #------------------------------------------------------------
@@ -95,16 +106,18 @@ class CLASS_MailSender:
                      Pms_BodyText: str,
                      Pms_BodyHTML: Optional[str],
                      Pobj_To: List[str],
+                     Pms_From: Optional[str] = None,
                      Pobj_Cc: Optional[List[str]] = None,
                      Pobj_Bcc: Optional[List[str]] = None,
                      Pobj_Attachments: Optional[List[str]] = None) -> bool:
         """
-        實際寄送郵件
+        實際寄送郵件，支援寄件者別名
         """
         msg = self.CUF_CreateMessage(
             Pms_Subject=Pms_Subject,
             Pms_BodyText=Pms_BodyText,
             Pms_BodyHTML=Pms_BodyHTML,
+            Pms_From=Pms_From,
             Pobj_To=Pobj_To,
             Pobj_Cc=Pobj_Cc,
             Pobj_Bcc=Pobj_Bcc,
@@ -112,47 +125,66 @@ 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))
 
         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)
-                    server.sendmail(self.Pms_Account, all_recipients, msg.as_string())
+                    server.sendmail(from_addr, all_recipients, msg.as_string())
             else:
                 with smtplib.SMTP(self.Pms_SMTP_Server, self.Pmi_Port) as server:
                     server.ehlo()
                     server.starttls()
                     server.login(self.Pms_Account, self.Pms_Password)
-                    server.sendmail(self.Pms_Account, all_recipients, msg.as_string())
+                    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.xxxx.net",
+        Pms_SMTP_Server="mxr.hxxxt.xxt",
         Pmi_Port=465,
-        Pms_Account="xxx.biz@xx.hxxxt.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  = ["gt504@gxxxxxh.biz", "txxxxx@ms27.xxxt.net"]
-    ml_Cc  = ["ebooxxx3@hotmail.com.tw"]
-    ml_Bcc = ["xxxxsty.lin@xxx.hinet.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 = "團隊週報通知"
+    ms_Subject = "團隊週報通知 有事件 wahaha 123*()F"
 
     ms_BodyText = """
 這是一封自動寄出的團隊週報通知。
@@ -178,8 +210,7 @@ if __name__ == "__main__":
 
     # === 附件路徑 ===
     ml_Attachments = [
-        "X:\\TEMP\\BOOK\\RCR6000_匯出外部資料_RCR6000EXT_XXX.pdf",
-        "X:\\TEMP\\BOOK\\K9AKW4.jpg"
+        "X:\\TEMP\\112年縣檸檬幼申報收入.jpg"
     ]
 
     # === 寄送 ===
@@ -187,6 +218,7 @@ if __name__ == "__main__":
         Pms_Subject=ms_Subject,
         Pms_BodyText=ms_BodyText,
         Pms_BodyHTML=ms_BodyHTML,
+        Pms_From = "太棒了!!a會觸發事件",
         Pobj_To=ml_To,
         Pobj_Cc=ml_Cc,
         Pobj_Bcc=ml_Bcc,

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: UtilityLibAPI
-Version: 1.2511.282
+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,13 @@ 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.
+
 Version 1.2511.282: 2025/11/27<BR>
 Fixed MailSenderLib: Attachement file name encode problem.