UtilityLibAPI 1.2511.282__tar.gz → 1.2511.291__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: UtilityLibAPI
-Version: 1.2511.282
+Version: 1.2511.291
 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.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.291}/README.md

@@ -1,6 +1,10 @@
 #UtilityLibAPI Classes
 
 ## History of version
+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.291}/pyproject.toml

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

{utilitylibapi-1.2511.282 → utilitylibapi-1.2511.291}/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,10 @@ 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
 
     #------------------------------------------------------------
     def CUF_CreateMessage(self,
@@ -40,10 +42,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 +62,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 +92,6 @@ class CLASS_MailSender:
                         msg.attach(part)
                 except Exception as e:
                     print(f"⚠️ Can not add attachment: {ms_path} ({e})")
-
         return msg
 
     #------------------------------------------------------------
@@ -95,16 +100,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,18 +119,19 @@ 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!")
             return True
@@ -131,7 +139,6 @@ class CLASS_MailSender:
             print("❌ Failure:", e)
             return False
 
-
 # ================================================================================
 # [範例]
 # 匯入剛才寫好的 CLASS_MailSender
@@ -139,20 +146,20 @@ class CLASS_MailSender:
 if __name__ == "__main__":
     # === 初始化郵件傳送物件 ===
     mailer = CLASS_MailSender(
-        Pms_SMTP_Server="msr.xxxx.net",
+        Pms_SMTP_Server="msr.hinet.net",
         Pmi_Port=465,
-        Pms_Account="xxx.biz@xx.hxxxt.net",
-        Pms_Password="xxxxx*",
+        Pms_Account="gxxxx.xz@msa.hinet.net",
+        Pms_Password="xxxxx",
         Pmb_UseSSL=True
     )
 
     # === 郵件收件者設定 ===
-    ml_To  = ["gt504@gxxxxxh.biz", "txxxxx@ms27.xxxt.net"]
-    ml_Cc  = ["ebooxxx3@hotmail.com.tw"]
-    ml_Bcc = ["xxxxsty.lin@xxx.hinet.net"]  # 密件副本，不會顯示在郵件中
+    ml_To  = ["xxxx4@xxxxxh.xxz", "xxxxxx23@xxx7.hxxxx.net"]
+    ml_Cc  = ["exxxxx03@hotmail.com.tw"]
+    ml_Bcc = ["xxxxxxy.lin@msa.hxxxx.net"]  # 密件副本，不會顯示在郵件中
 
     # === 郵件主題與內容 ===
-    ms_Subject = "團隊週報通知"
+    ms_Subject = "團隊週報通知 wahaha 123*()F"
 
     ms_BodyText = """
 這是一封自動寄出的團隊週報通知。
@@ -178,8 +185,7 @@ if __name__ == "__main__":
 
     # === 附件路徑 ===
     ml_Attachments = [
-        "X:\\TEMP\\BOOK\\RCR6000_匯出外部資料_RCR6000EXT_XXX.pdf",
-        "X:\\TEMP\\BOOK\\K9AKW4.jpg"
+        "X:\\TEMP\\112年縣檸檬幼申報收入.jpg"
     ]
 
     # === 寄送 ===
@@ -187,6 +193,7 @@ if __name__ == "__main__":
         Pms_Subject=ms_Subject,
         Pms_BodyText=ms_BodyText,
         Pms_BodyHTML=ms_BodyHTML,
+        Pms_From = "太棒了!!abcdefg123",
         Pobj_To=ml_To,
         Pobj_Cc=ml_Cc,
         Pobj_Bcc=ml_Bcc,

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: UtilityLibAPI
-Version: 1.2511.282
+Version: 1.2511.291
 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.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.