UtilityLibAPI 1.2511.27__tar.gz → 1.2511.29__tar.gz

{utilitylibapi-1.2511.27/src/UtilityLibAPI.egg-info → utilitylibapi-1.2511.29}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: UtilityLibAPI
-Version: 1.2511.27
+Version: 1.2511.29
 Summary: UtilityLibAPI Python package
 Author-email: James Lin <tylin123@ms27.hinet.net>
 License: Copyright (c) 2025 James Lin **UtilityLibAPI**
@@ -33,6 +33,19 @@ Dynamic: license-file
 #UtilityLibAPI Classes
 
 ## History of version
+Version 1.2511.29: 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.
+
+Version 1.2511.281: 2025/11/27<BR>
+Modified 7zArchiveLib to Archive7zLib --> 7z Archive tools library
+
+Version 1.2511.28: 2025/11/27<BR>
+Fixed 7zArchiveLib --> 7z Archive tools library
+
 Version 1.2511.27: 2025/11/27<BR>
 Add 7zArchiveLib --> 7z Archive tools library
 

utilitylibapi-1.2511.29/README.md

@@ -0,0 +1,30 @@
+#UtilityLibAPI Classes
+
+## History of version
+Version 1.2511.29: 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.
+
+Version 1.2511.281: 2025/11/27<BR>
+Modified 7zArchiveLib to Archive7zLib --> 7z Archive tools library
+
+Version 1.2511.28: 2025/11/27<BR>
+Fixed 7zArchiveLib --> 7z Archive tools library
+
+Version 1.2511.27: 2025/11/27<BR>
+Add 7zArchiveLib --> 7z Archive tools library
+
+Version 1.2510.22: 2025/10/21<BR>
+Add ExtWrapper7zLib --> 7z Archive tools library
+
+Version 1.2510.22: 2025/10/21<BR>
+Add MailSenderLib --> CLASS_MailSender library
+
+Version 0.1.1: 2025/10/13<BR>
+Fixed export class path<BR>
+
+Version 0.1.0: 2025/10/13<BR>
+Create UtilityLibAPI -- EnDeCodeLib + SessionVARLib<BR>

{utilitylibapi-1.2511.27 → utilitylibapi-1.2511.29}/pyproject.toml

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

utilitylibapi-1.2511.27/src/UtilityLibAPI/7zArchiveLib.py → utilitylibapi-1.2511.29/src/UtilityLibAPI/Archive7zLib.py

@@ -5,7 +5,7 @@ import subprocess
 import re
 import glob
 
-class CLASS_7zArchive:
+class CLASS_Archive7z:
     def __init__(self):
         self.on_progress = None
         self.seven_zip_path = self._find_7z_exe()
@@ -316,7 +316,7 @@ def GE_ProgressEvent(Pmf_Percent):
 if(__name__=="__main__"):
     ms_Path_7z: str;
     
-    obj_7z = CLASS_7zArchive();
+    obj_7z = CLASS_Archive7z();
 
     obj_7z.CUF_SET_ProgressEvent(GE_ProgressEvent);
 

{utilitylibapi-1.2511.27 → utilitylibapi-1.2511.29}/src/UtilityLibAPI/MailSenderLib.py

@@ -2,7 +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
@@ -23,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,
@@ -39,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)
@@ -55,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:
@@ -71,15 +78,20 @@ class CLASS_MailSender:
                     with open(ms_path, "rb") as f:
                         part = MIMEApplication(f.read(), _subtype=subtype)
                         filename = os.path.basename(ms_path)
+                        #part.add_header(
+                        #    "Content-Disposition",
+                        #    "attachment",
+                        #    filename=("utf-8", "", filename)
+                        #)
+                        filename_header = Header(filename, "utf-8").encode()
                         part.add_header(
                             "Content-Disposition",
-                            "attachment",
-                            filename=("utf-8", "", filename)
+                            "attachement",
+                            filename=filename_header
                         )
                         msg.attach(part)
                 except Exception as e:
                     print(f"⚠️ Can not add attachment: {ms_path} ({e})")
-
         return msg
 
     #------------------------------------------------------------
@@ -88,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,
@@ -105,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
@@ -124,7 +139,6 @@ class CLASS_MailSender:
             print("❌ Failure:", e)
             return False
 
-
 # ================================================================================
 # [範例]
 # 匯入剛才寫好的 CLASS_MailSender
@@ -132,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 = """
 這是一封自動寄出的團隊週報通知。
@@ -171,8 +185,7 @@ if __name__ == "__main__":
 
     # === 附件路徑 ===
     ml_Attachments = [
-        "X:\\TEMP\\BOOK\\RCR6000_匯出外部資料_RCR6000EXT_XXX.pdf",
-        "X:\\TEMP\\BOOK\\K9AKW4.jpg"
+        "X:\\TEMP\\112年縣檸檬幼申報收入.jpg"
     ]
 
     # === 寄送 ===
@@ -180,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.27 → utilitylibapi-1.2511.29}/src/UtilityLibAPI/__init__.py

@@ -2,9 +2,11 @@ from .EnDeCodeLib     import CLASS_EnDeCodeLib
 from .SessionVARLib   import CLASS_SessionVAR
 from .MailSenderLib   import CLASS_MailSender
 from .ExtWrapper7zLib import CLASS_ExtWrapper7z
+from .Archive7zLib    import CLASS_Archive7z
 
 __all__ = ["CLASS_EnDeCodeLib", 
            "CLASS_SessionVAR", 
            "CLASS_MailSender",
-           "CLASS_ExtWrapper7z"
+           "CLASS_ExtWrapper7z",
+           "CLASS_Archive7z"
           ]

{utilitylibapi-1.2511.27 → utilitylibapi-1.2511.29/src/UtilityLibAPI.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: UtilityLibAPI
-Version: 1.2511.27
+Version: 1.2511.29
 Summary: UtilityLibAPI Python package
 Author-email: James Lin <tylin123@ms27.hinet.net>
 License: Copyright (c) 2025 James Lin **UtilityLibAPI**
@@ -33,6 +33,19 @@ Dynamic: license-file
 #UtilityLibAPI Classes
 
 ## History of version
+Version 1.2511.29: 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.
+
+Version 1.2511.281: 2025/11/27<BR>
+Modified 7zArchiveLib to Archive7zLib --> 7z Archive tools library
+
+Version 1.2511.28: 2025/11/27<BR>
+Fixed 7zArchiveLib --> 7z Archive tools library
+
 Version 1.2511.27: 2025/11/27<BR>
 Add 7zArchiveLib --> 7z Archive tools library
 

{utilitylibapi-1.2511.27 → utilitylibapi-1.2511.29}/src/UtilityLibAPI.egg-info/SOURCES.txt

@@ -2,7 +2,7 @@ LICENSE
 README.md
 pyproject.toml
 setup.cfg
-src/UtilityLibAPI/7zArchiveLib.py
+src/UtilityLibAPI/Archive7zLib.py
 src/UtilityLibAPI/EnDeCodeLib.py
 src/UtilityLibAPI/ExtWrapper7zLib.py
 src/UtilityLibAPI/MailSenderLib.py

utilitylibapi-1.2511.27/README.md

@@ -1,17 +0,0 @@
-#UtilityLibAPI Classes
-
-## History of version
-Version 1.2511.27: 2025/11/27<BR>
-Add 7zArchiveLib --> 7z Archive tools library
-
-Version 1.2510.22: 2025/10/21<BR>
-Add ExtWrapper7zLib --> 7z Archive tools library
-
-Version 1.2510.22: 2025/10/21<BR>
-Add MailSenderLib --> CLASS_MailSender library
-
-Version 0.1.1: 2025/10/13<BR>
-Fixed export class path<BR>
-
-Version 0.1.0: 2025/10/13<BR>
-Create UtilityLibAPI -- EnDeCodeLib + SessionVARLib<BR>