UtilityLibAPI 1.2511.291__py3-none-any.whl

UtilityLibAPI/Archive7zLib.py

@@ -0,0 +1,335 @@
+import os
+import sys
+import shutil
+import subprocess
+import re
+import glob
+
+class CLASS_Archive7z:
+    def __init__(self):
+        self.on_progress = None
+        self.seven_zip_path = self._find_7z_exe()
+
+    # -------------------------------------------------------------
+    # 自動搜尋 7z.exe
+    # -------------------------------------------------------------
+    def _find_7z_exe(self):
+        candidate_paths = [
+            r"C:\Program Files\7-Zip\7z.exe",
+            r"C:\Program Files (x86)\7-Zip\7z.exe"
+        ]
+        # 1. 先找常用路徑
+        for p in candidate_paths:
+            if os.path.exists(p):
+                return p
+        # 2. 從 PATH 搜尋
+        p = shutil.which("7z")
+        if p:
+            return p
+
+        # 3. 找不到 → 拋錯
+        raise FileNotFoundError("找不到 7z.exe，請確認是否已安裝 7-Zip")
+
+
+    # -------------------------------------------------------------
+    # 設定進度事件
+    # -------------------------------------------------------------
+    def CUF_SET_ProgressEvent(self, func_progress):
+        self.on_progress = func_progress
+
+
+    def _find_7z_exe(self):
+        """
+        依照優先順序尋找 7za.exe → 7z.exe
+        並支援掃描所有磁碟（C, D, E, F...）
+        """
+        # ---------------------------
+        # 1. PATH 中找 7za / 7z
+        # ---------------------------
+        p = shutil.which("7za")
+        if p:
+            return p
+        p = shutil.which("7z")
+        if p:
+            return p
+        # ---------------------------
+        # 2. 常見安裝路徑
+        # ---------------------------
+        common_paths = [
+            r"C:\Program Files\7-Zip\7za.exe",
+            r"C:\Program Files (x86)\7-Zip\7za.exe",
+            r"C:\Program Files\7-Zip\7z.exe",
+            r"C:\Program Files (x86)\7-Zip\7z.exe",
+        ]
+        for p in common_paths:
+            if os.path.exists(p):
+                return p
+        # ---------------------------
+        # 3. 掃描所有磁碟（C, D, E, F...)
+        #    搜尋特定資料夾名稱避免太慢
+        # ---------------------------
+        search_dirs = [
+            "7-Zip",
+            "7Zip",
+            "7zip",
+            "7zip\\bin",
+            "Program Files\\7-Zip",
+            "Program Files (x86)\\7-Zip",
+        ]
+        drives = []
+        for letter in "CDEFGHIJKLMNOPQRSTUVWXYZ":
+            d = f"{letter}:\\"
+            if os.path.exists(d):
+                drives.append(d)
+
+        for drive in drives:
+            for folder in search_dirs:
+                base = os.path.join(drive, folder)
+
+                # 若資料夾不存在跳過
+                if not os.path.isdir(base):
+                    continue
+
+                # 檢查底下是否有 7za.exe 或 7z.exe
+                exe_7za = os.path.join(base, "7za.exe")
+                exe_7z = os.path.join(base, "7z.exe")
+
+                if os.path.exists(exe_7za):
+                    return exe_7za
+                if os.path.exists(exe_7z):
+                    return exe_7z
+
+                # 若還沒找到 → 試著遞迴搜尋
+                try:
+                    for root, dirs, files in os.walk(base):
+                        if "7za.exe" in files:
+                            return os.path.join(root, "7za.exe")
+                        if "7z.exe" in files:
+                            return os.path.join(root, "7z.exe")
+                except PermissionError:
+                    pass  # 跳過無權限的資料夾
+
+        # ---------------------------
+        # 全部找不到 → 拋錯
+        # ---------------------------
+        raise FileNotFoundError("找不到 7za.exe 或 7z.exe，請確認是否已安裝 7-Zip")
+
+    # -------------------------------------------------------------
+    # 封裝執行 7z.exe，並解析 stdout 進度 (%)
+    # -------------------------------------------------------------
+    def _run_7z(self, args_list):
+        """
+        同時支援：
+        ✔ 有 % → 觸發 int 進度
+        ✔ 沒 % → 逐行觸發文字行
+        """
+        cmd = [self.seven_zip_path] + args_list
+
+        process = subprocess.Popen(
+            cmd,
+            stdout=subprocess.PIPE,
+            stderr=subprocess.STDOUT,
+            universal_newlines=True,
+            encoding="utf-8",
+            errors="ignore"
+        )
+
+        progress_pattern = re.compile(r"(\d+)%")
+
+        for line in process.stdout:
+            line = line.strip()
+
+            # 嘗試找百分比
+            match = progress_pattern.search(line)
+            if match:
+                pct = int(match.group(1))
+                if self.on_progress:
+                    try:
+                        self.on_progress(pct)
+                    except:
+                        pass
+            else:
+                # 沒有百分比 → 仍然要回報文字行（使用者可自訂怎麼處理）
+                if self.on_progress and line:
+                    try:
+                        self.on_progress(line)   # 回傳文字行
+                    except:
+                        pass
+        process.wait()
+
+
+    # -------------------------------------------------------------
+    # 壓縮資料夾
+    # -------------------------------------------------------------
+    def CUF_CompressFolder(self, Pms_FolderName:str, Pms_File7z:str, 
+                           Pms_Password:str=None, 
+                           Pmi_SplitSize_K:int=-1):
+
+        if not os.path.exists(Pms_FolderName):
+            raise ValueError("Pms_FolderName 必須是資料夾")
+
+        # -------------------------------------------------------
+        # 取出 Pms_File7z 的路徑並建立
+        # -------------------------------------------------------
+        out_dir = os.path.dirname(Pms_File7z)
+        if out_dir.strip() == "":
+            out_dir = os.getcwd()
+
+        os.makedirs(out_dir, exist_ok=True)
+
+        file_name_only = os.path.basename(Pms_File7z)   # Orange.7z
+
+        # -------------------------------------------------------
+        # 組合 7z 參數
+        # -------------------------------------------------------
+        args = ["a"]
+
+        if Pms_Password:
+            args.append(f"-p{Pms_Password}")
+
+        if Pmi_SplitSize_K != -1:
+            args.append(f"-v{Pmi_SplitSize_K}k")
+
+        # 7z 輸出檔名（不能帶路徑）
+        args.append(file_name_only)
+
+        # 加入來源資料夾
+        args.append(Pms_FolderName)
+
+        # -------------------------------------------------------
+        # 執行壓縮 (7z 產生在目前工作目錄)
+        # -------------------------------------------------------
+        self._run_7z(args)
+
+        # -------------------------------------------------------
+        # ▒▒▒ 壓縮後 → 將檔案移到 Pms_File7z 指定路徑 ▒▒▒
+        # -------------------------------------------------------
+        self._move_output_files(file_name_only, out_dir)
+
+
+    # -------------------------------------------------------------
+    # 壓縮檔案（支援萬用字元 *.txt, apple*.*）
+    # -------------------------------------------------------------
+    def CUF_CompressFile(self, Pms_FileSource:str, Pms_File7z:str, 
+                         Pms_Password:str=None, 
+                         Pmi_SplitSize_K:int=-1):
+        file_list = glob.glob(Pms_FileSource)
+        if not file_list:
+            raise FileNotFoundError(f"找不到符合的檔案: {Pms_FileSource}")
+
+        # -------------------------------------------------------
+        # 取出 Pms_File7z 的路徑並建立
+        # -------------------------------------------------------
+        out_dir = os.path.dirname(Pms_File7z)
+        if out_dir.strip() == "":
+            out_dir = os.getcwd()
+
+        os.makedirs(out_dir, exist_ok=True)
+
+        file_name_only = os.path.basename(Pms_File7z)
+
+        # -------------------------------------------------------
+        # 組合 7z 參數
+        # -------------------------------------------------------
+        args = ["a"]
+
+        if Pms_Password:
+            args.append(f"-p{Pms_Password}")
+
+        if Pmi_SplitSize_K not in (None, -1):
+            args.append(f"-v{Pmi_SplitSize_K}k")
+
+        args.append(file_name_only)
+
+        for f in file_list:
+            args.append(f)
+
+        # -------------------------------------------------------
+        # 執行壓縮
+        # -------------------------------------------------------
+        self._run_7z(args)
+
+        # -------------------------------------------------------
+        # ▒▒▒ 壓縮後 → 移動所有分割檔 / 單一檔 ▒▒▒
+        # -------------------------------------------------------
+        self._move_output_files(file_name_only, out_dir)
+
+
+    # -------------------------------------------------------------
+    # 共用：移動壓縮結果到指定目錄
+    # -------------------------------------------------------------
+    def _move_output_files(self, base_file_name:str, out_dir:str):
+        """
+        base_file_name = "Orange.7z"
+        最後尋找：
+            Orange.7z
+            Orange.7z.001
+            Orange.7z.002
+            ...
+        """
+        for f in os.listdir("."):
+            if f == base_file_name or f.startswith(base_file_name + "."):
+                shutil.move(f, os.path.join(out_dir, f))
+
+
+    def CUF_Decompress(self, Pms_ArchiveFile, Pms_OutputDir, Pms_Password=None):
+        """
+        解壓縮通用函式（最終穩定版本）
+        -------------------------------------
+        Pms_ArchiveFile : 壓縮檔完整路徑
+        Pms_OutputDir   : 要解壓到哪裡
+        Pms_Password    : 解壓密碼（可省略）
+        -------------------------------------
+        支援格式：
+        7z, zip, rar, tar, tar.gz, tar.bz2, tar.xz
+        """
+        # ---------- 路徑檢查 ----------
+        if not os.path.exists(Pms_ArchiveFile):
+            return False, f"Compress file not found: {Pms_ArchiveFile}"
+
+        os.makedirs(Pms_OutputDir, exist_ok=True)
+
+        Pms_7zExe = self.seven_zip_path
+
+        args = ["x"]
+
+        if Pms_Password:
+            args.append(f"-p{Pms_Password}")
+
+        args.append(Pms_ArchiveFile)
+        args.append(f"-o{Pms_OutputDir}")
+        args.append("-y")
+
+        # ★★★ 使用會有進度事件的版本 ★★★
+        try:
+            self._run_7z(args)
+            return True, "Decompress successful."
+        except Exception as e:
+            return False, f"Decompress failure:\n{str(e)}"
+        
+
+# ================================================================================
+# [使用範例]
+def GE_ProgressEvent(Pmf_Percent):
+    print(str(Pmf_Percent));
+
+if(__name__=="__main__"):
+    ms_Path_7z: str;
+    
+    obj_7z = CLASS_Archive7z();
+
+    obj_7z.CUF_SET_ProgressEvent(GE_ProgressEvent);
+
+    obj_7z.CUF_CompressFolder(Pms_FolderName="X:\\TEMP\\BOOK\\MUSIC", 
+                              Pms_File7z="X:\\temp\\book\\PPPK\\GOOD_FILE", 
+                              Pms_Password="Gotech123",
+                              Pmi_SplitSize_K=640);
+
+    obj_7z.CUF_CompressFile(Pms_FileSource="X:\\temp\\book\\*.png",
+                            Pms_File7z="X:\\temp\\book\\abcde\\pqrst\\PPPK-2\\我的PNG圖檔",
+                            Pms_Password="OKOKGOOD",
+                            Pmi_SplitSize_K=100);
+
+    obj_7z.CUF_Decompress(Pms_ArchiveFile="X:\\TEMP\\BOOK\\abcde\\pqrst\\PPPK-2\\我的PNG圖檔.7z.001",
+                          Pms_OutputDir="X:\\temp\\OK了", 
+                          Pms_Password="OKOKGOOD")

UtilityLibAPI/EnDeCodeLib.py

@@ -0,0 +1,198 @@
+# ============================================================================
+#                           通用 加密/解密 (跨平台)
+# ============================================================================
+import base64
+
+# ================================================================================
+class CLASS_EnDeCodeLib:
+    def __init__(self):
+        # 設定預設的 CROSS 加密金鑰
+        self.CVmba_CROSS_KEY = [];
+        self.CVmba_CROSS_KEY.append(0x3f);
+        self.CVmba_CROSS_KEY.append(0x6b);
+        self.CVmba_CROSS_KEY.append(0x59);
+        self.CVmba_CROSS_KEY.append(0x48);
+        # ------------------------------------------------------------------
+        self.CVms_CROSS_ASC = \
+             "AaBbFfGg 125~!@#$)HhIiLlMm_+`-=CcD34dEe:[]JjKk\\\'"\
+             "NnOoSsTt670%UuXxYyZz^&*Pp89QqRr(<>?VvWw,./;{}|\"";
+        self.CVms_CROSS_MAP = \
+             "~!@#$%^& ()_+QWERbnmTOP{}|ASghjkDFL:\"ZXiopCV<>?`" \
+             "125-=*qwert67890yuBNM[]\\asd34fGHJKl;\'zxYUIcv,./";
+        # ------------------------------------------------------------------
+        
+        
+    # ================================================================================
+    #                                   PRIVATE
+    # ================================================================================
+    # ----------------------------------------------------------------------------
+    # 功能: CROSS 金鑰加密 (針對不可視字元: 使用金鑰加密)
+    # 傳入:
+    # 傳回:
+    # ----------------------------------------------------------------------------
+    def CVF_CROSS_XOR(self, Pmc_SRC_CH):
+        mia_SRCCH = [];
+        ms_ENCODE = "";
+        mi_ENCODE = 0;
+        mi_c      = 0;
+
+        mia_SRCCH = Pmc_SRC_CH.encode('big5');
+        # ------------------------------------------------------------
+        for mi_c in range(0, len(mia_SRCCH)):
+            mi_ENCODE = mia_SRCCH[mi_c];
+            # ------------------------------------------------------------
+            for mi_d in range(0, len(self.CVmba_CROSS_KEY)):
+                mi_ENCODE ^= self.CVmba_CROSS_KEY[mi_d];
+            # ------------------------------------------------------------
+            ms_ENCODE += chr(mi_ENCODE);
+        # ------------------------------------------------------------
+        return(ms_ENCODE);
+    
+    
+    # ================================================================================
+    #                                   PUBLIC
+    # ================================================================================
+    # ----------------------------------------------------------------------------
+    # 功能: 設定 CROSS 加密金鑰
+    # 傳入:
+    # 傳回:
+    # ----------------------------------------------------------------------------
+    def CUF_CROSS_SetKey(self, Rmca_KeyCode):
+        if(len(Rmca_KeyCode) <= 0):
+            return;
+        # ------------------------------------------------------------
+        self.CVmba_CROSS_KEY.clear();
+        # ------------------------------------------------------------
+        for mi_c in range(0, len(Rmca_KeyCode)):
+            self.CVmba_CROSS_KEY = Rmca_KeyCode[mi_c];
+    
+    # ----------------------------------------------------------------------------
+    # 功能: 回傳 CROSS 加密金鑰
+    # 傳入:
+    # 傳回:
+    # ----------------------------------------------------------------------------
+    def CUF_CROSS_GetKey(self):
+        return(self.CVmba_CROSS_KEY);
+    
+    
+    # ----------------------------------------------------------------------------
+    # 功能: CROSS 加密程序
+    # 傳入:
+    # 傳回:
+    # ----------------------------------------------------------------------------
+    def CUF_CROSS_EnCode(self, Pms_SRC_Text):
+        ms_RET_STR = "";
+        mB_Found   = False;
+        mi_c       = 0;
+        mi_d       = 0;
+        # ------------------------------------------------------------
+        if(type(Pms_SRC_Text) is bytes):
+            Pms_SRC_Text = str(Pms_SRC_Text);
+        # ------------------------------------------------------------
+        # (1) 判斷是否為 ASCII 可視字元,若是則搜尋對應的 CVms_CROSS_MAP[?] 字元
+        for mi_c in range(0, len(Pms_SRC_Text)):
+            mB_Found = False;
+            # --------------------------------------------
+            for mi_d in range(0, len(self.CVms_CROSS_ASC)):
+                if(Pms_SRC_Text[mi_c] == self.CVms_CROSS_ASC[mi_d]):
+                    mB_Found = True;
+                    break;
+            # --------------------------------------------
+            if(mB_Found):
+                # (1-1) 可視字元  : 找到可視字元對應的加密表字元
+                ms_RET_STR += self.CVms_CROSS_MAP[mi_d];
+            else:
+                # (1-2) 不可視字元: 使用金鑰加密
+                ms_RET_STR += self.CVF_CROSS_XOR(Pms_SRC_Text[mi_c]);
+        # ------------------------------------------------------------
+        return(ms_RET_STR);
+    
+    
+    # ----------------------------------------------------------------------------
+    # 功能: CROSS 解密程序
+    # 傳入:
+    # 傳回:
+    # ----------------------------------------------------------------------------
+    def CUF_CROSS_DeCode(self, Pms_ENC_Text):
+        ms_RET_STR = "";
+        mB_Found   = False;
+        mi_c       = 0;
+        mi_d       = 0;
+        # ------------------------------------------------------------
+        # (1) 判斷是否為 ASCII 可視字元,若是則搜尋對應的 CVms_CROSS_MAP[?] 字元
+        for mi_c in range(0, len(Pms_ENC_Text)):
+            mB_Found = False;
+            # --------------------------------------------
+            for mi_d in range(0, len(self.CVms_CROSS_MAP)):
+                if(Pms_ENC_Text[mi_c] == self.CVms_CROSS_MAP[mi_d]):
+                    mB_Found = True;
+                    break;
+            # --------------------------------------------
+            if(mB_Found):
+                # (1-1) 可視字元  : 找到可視字元對應的解密表字元
+                ms_RET_STR += self.CVms_CROSS_ASC[mi_d];
+            else:
+                # (1-2) 不可視字元: 使用金鑰加密
+                ms_RET_STR += self.CVF_CROSS_XOR(Pms_ENC_Text[mi_c]);
+        # ------------------------------------------------------------
+        return(ms_RET_STR);
+
+
+    # ----------------------------------------------------------------------------
+    # 功能: CROSS 加密程序 (Base64 版本)
+    # 傳入:
+    # 傳回:
+    # ----------------------------------------------------------------------------
+    def CUF_CROSS_EnCodeBase64(self, Pms_SRC_Text):
+        ms_EnCode  = "";
+        ms_BuffSTR = "";
+
+        ms_BuffSTR = Pms_SRC_Text.encode('big5');
+        # ------------------------------------------------------------
+        for mi_c in range(0, len(ms_BuffSTR)):
+            ms_EnCode += chr(ms_BuffSTR[mi_c]);
+        # ------------------------------------------------------------
+        # (1) Base64 轉碼
+        ms_EnCode = base64.b64encode(ms_EnCode.encode('utf-8'));
+        # ------------------------------------------------------------
+        # (2) 明文加密
+        ms_EnCode = self.CUF_CROSS_EnCode(ms_EnCode);
+        # ------------------------------------------------------------
+        ms_EnCode = ms_EnCode.encode("utf-8");
+        # ---------e---------------------------------------------------
+        return(ms_EnCode);
+
+
+    # ----------------------------------------------------------------------------
+    # 功能: CROSS 解密程序 (Base64 版本)
+    # 傳入:
+    # 傳回:
+    # ----------------------------------------------------------------------------
+    def CUF_CROSS_DeCodeBase64(self, Pms_ENC_Text):
+        ms_DeCode = "";
+
+        ms_EnCode = Pms_ENC_Text.encode('big5');
+        # ------------------------------------------------------------
+        # (1) Base64 解碼
+        ms_DeCode = base64.b64decode(ms_EnCode);
+        # ------------------------------------------------------------
+        # (2) 解密 
+        ms_DeCode = self.CUF_CROSS_DeCode(ms_DeCode);
+        # ------------------------------------------------------------
+        ms_DeCode = ms_DeCode.encode("utf-8");
+        # ------------------------------------------------------------
+        return(ms_DeCode);     
+    
+
+# ================================================================================
+#                                   EXAMPLE
+# ================================================================================
+if(__name__=="__main__"):
+    Gobj_EnDeCode = CLASS_EnDeCodeLib();
+    
+    ms_TEXT1 = "abcd,123 4567";
+    ms_TEXT2 = "abc真正好123,Good 太棒了 ";
+    # ------------------------------------------------------------
+    print(Gobj_EnDeCode.CUF_CROSS_EnCode(ms_TEXT1));
+    print(Gobj_EnDeCode.CUF_CROSS_EnCode(ms_TEXT2.encode('big5')));
+    print(Gobj_EnDeCode.CUF_CROSS_EnCodeBase64(ms_TEXT2));

UtilityLibAPI/ExtWrapper7zLib.py

@@ -0,0 +1,166 @@
+import os
+import threading
+import subprocess
+import time
+from typing import Callable, Dict, Optional
+
+class CLASS_ExtWrapper7z:
+    def __init__(self, Pms_7z_path: Optional[str] = None):
+        self.Pms_7z_path = Pms_7z_path or self.CUF_Find7zPath()
+        self.tasks: Dict[int, Dict] = {}
+        self.task_counter = 0
+        self.lock = threading.Lock()
+
+    # 🔍 自動搜尋 7z.exe
+    def CUF_Find7zPath(self) -> Optional[str]:
+        common_paths = [
+            r"C:\\Program Files\\7-Zip\\7z.exe",
+            r"C:\\Program Files (x86)\\7-Zip\\7z.exe",
+        ]
+        for path in common_paths:
+            if os.path.exists(path):
+                return path
+
+        for root, dirs, files in os.walk("C:\\"):
+            if "7z.exe" in files:
+                return os.path.join(root, "7z.exe")
+        return None
+
+    # 📦 建立壓縮或解壓縮任務
+    def CUF_AddTask(
+        self,
+        Pms_Mode: str,  # "compress" 或 "extract"
+        Pms_InputPath: str,
+        Pms_OutputPath: str,
+        Pmi_VolumeSizeMB: int = 0,
+        Pms_Password: str = "",
+        Pmf_Callback: Optional[Callable[[int, float, str], None]] = None,
+    ) -> int:
+        with self.lock:
+            self.task_counter += 1
+            mi_TaskID = self.task_counter
+            self.tasks[mi_TaskID] = {
+                "thread": None,
+                "progress": 0.0,
+                "status": "queued",
+                "cancel": False,
+                "mode": Pms_Mode,
+                "input": Pms_InputPath,
+                "output": Pms_OutputPath,
+                "callback": Pmf_Callback,
+            }
+
+        thread = threading.Thread(
+            target=self._CUF_RunTask,
+            args=(mi_TaskID, Pms_Mode, Pms_InputPath, Pms_OutputPath, Pmi_VolumeSizeMB, Pms_Password),
+            daemon=True,
+        )
+        self.tasks[mi_TaskID]["thread"] = thread
+        thread.start()
+        return mi_TaskID
+
+    # 🧩 執行壓縮/解壓縮
+    def _CUF_RunTask(self, TaskID, Mode, InputPath, OutputPath, VolumeSizeMB, Password):
+        task = self.tasks[TaskID]
+        task["status"] = "running"
+        Pms_7z_path = self.Pms_7z_path
+        if not Pms_7z_path or not os.path.exists(Pms_7z_path):
+            task["status"] = "error"
+            if task["callback"]:
+                task["callback"](TaskID, 0, "7z.exe not found")
+            return
+
+        if Mode == "compress":
+            cmd = [Pms_7z_path, "a", OutputPath, "-y"]
+            # 🔹 支援多個檔案/資料夾；以 ; 分隔
+            paths = [p.strip() for p in InputPath.split(";") if p.strip()]
+            cmd.extend(paths)
+            if Password:
+                cmd.append(f"-p{Password}")
+            if VolumeSizeMB > 0:
+                cmd.append(f"-v{VolumeSizeMB}m")
+
+        elif Mode == "extract":
+            cmd = [Pms_7z_path, "x", InputPath, f"-o{OutputPath}", "-y"]
+            if Password:
+                cmd.append(f"-p{Password}")
+        else:
+            task["status"] = "error"
+            if task["callback"]:
+                task["callback"](TaskID, 0, "Invalid mode")
+            return
+
+        proc = subprocess.Popen(
+            cmd, stdout=subprocess.PIPE, stderr=subprocess.STDOUT, text=True
+        )
+
+        for line in proc.stdout:
+            if task["cancel"]:
+                proc.terminate()
+                task["status"] = "cancelled"
+                if task["callback"]:
+                    task["callback"](TaskID, task["progress"], "Cancelled")
+                return
+
+            if "%" in line:
+                try:
+                    percent = float(line.strip().split("%")[0].split()[-1])
+                    task["progress"] = percent
+                    if task["callback"]:
+                        task["callback"](TaskID, percent, "running")
+                except:
+                    pass
+
+        proc.wait()
+        if proc.returncode == 0 and not task["cancel"]:
+            task["status"] = "done"
+            task["progress"] = 100.0
+            if task["callback"]:
+                task["callback"](TaskID, 100.0, "done")
+        elif not task["cancel"]:
+            task["status"] = "error"
+            if task["callback"]:
+                task["callback"](TaskID, task["progress"], "error")
+
+    # ❌ 取消任務
+    def CUF_CancelTask(self, Pmi_TaskID: int):
+        if Pmi_TaskID in self.tasks:
+            self.tasks[Pmi_TaskID]["cancel"] = True
+
+    # 📊 查詢所有任務總進度
+    def CUF_GetTotalProgress(self) -> float:
+        with self.lock:
+            if not self.tasks:
+                return 0.0
+            total = sum(task["progress"] for task in self.tasks.values())
+            return total / len(self.tasks)
+
+    # 🔍 查詢任務狀態
+    def CUF_GetTaskStatus(self, Pmi_TaskID: int) -> str:
+        return self.tasks.get(Pmi_TaskID, {}).get("status", "unknown")
+
+
+
+
+# ================================================================================
+# === 測試範例 ===
+if(__name__ == "__main__"):
+    def my_callback(TaskID, progress, status):
+        print(f"[Task {TaskID}] {status} - {progress:.1f}%")
+
+    wrapper = CLASS_ExtWrapper7z()
+    print("7z 路徑:", wrapper.Pms_7z_path)
+
+    # 壓縮多個檔案 (同時支援萬用字元與多個資料夾)
+    task1 = wrapper.CUF_AddTask(
+        "compress",
+        Pms_InputPath=r"C:\\Temp\\Rubber\b1*.bmp;C:\\boost\\more",
+        Pms_OutputPath=r"C:\\TEMP\\OKOKO_GOOD.7z",
+        Pmi_VolumeSizeMB=50,
+        Pmf_Callback=my_callback,
+    )
+
+    while True:
+        total_progress = wrapper.CUF_GetTotalProgress()
+        print(f"總進度: {total_progress:.2f}%")
+        time.sleep(2)

UtilityLibAPI/MailSenderLib.py

@@ -0,0 +1,206 @@
+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
+
+class CLASS_MailSender:
+    def __init__(self,
+                 Pms_SMTP_Server: str,
+                 Pmi_Port: int,
+                 Pms_Account: str,
+                 Pms_Password: str,
+                 Pmb_UseSSL: bool = True):
+        """
+        初始化郵件寄送物件
+        :param Pms_SMTP_Server: 郵件伺服器主機 (ex: smtp.gmail.com)
+        :param Pmi_Port: 通訊埠 (SSL=465, TLS=587)
+        :param Pms_Account: 登入帳號
+        :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
+
+    #------------------------------------------------------------
+    def CUF_CreateMessage(self,
+                          Pms_Subject: str,
+                          Pms_BodyText: str,
+                          Pms_BodyHTML: Optional[str] = None,
+                          Pms_From: Optional[str] = None,
+                          Pobj_To: Optional[List[str]] = None,
+                          Pobj_Cc: Optional[List[str]] = None,
+                          Pobj_Bcc: Optional[List[str]] = None,
+                          Pobj_Attachments: Optional[List[str]] = None) -> MIMEMultipart:
+        """
+        建立郵件內容（支援 HTML / 附件 / 顯示別名）
+        """
+        msg = MIMEMultipart("alternative")
+
+        # 設定寄件者別名
+        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)
+        msg["Subject"] = Pms_Subject
+
+        # 純文字版本
+        msg.attach(MIMEText(Pms_BodyText or "", "plain", "utf-8"))
+
+        # HTML 版本
+        if Pms_BodyHTML:
+            msg.attach(MIMEText(Pms_BodyHTML, "html", "utf-8"))
+
+        # 附件（支援中文檔名 & Outlook）
+        if Pobj_Attachments:
+            for ms_path in Pobj_Attachments:
+                try:
+                    if not os.path.isfile(ms_path):
+                        print(f"⚠️ Attachements not exists: {ms_path}")
+                        continue
+
+                    ctype, encoding = mimetypes.guess_type(ms_path)
+                    if ctype is None or encoding is not None:
+                        ctype = "application/octet-stream"
+                    maintype, subtype = ctype.split("/", 1)
+
+                    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",
+                            "attachement",
+                            filename=filename_header
+                        )
+                        msg.attach(part)
+                except Exception as e:
+                    print(f"⚠️ Can not add attachment: {ms_path} ({e})")
+        return msg
+
+    #------------------------------------------------------------
+    def CUF_SendMail(self,
+                     Pms_Subject: str,
+                     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,
+            Pobj_Attachments=Pobj_Attachments,
+        )
+
+        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(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(from_addr, all_recipients, msg.as_string())
+
+            print("✅ Send Success!")
+            return True
+        except Exception as e:
+            print("❌ Failure:", e)
+            return False
+
+# ================================================================================
+# [範例]
+# 匯入剛才寫好的 CLASS_MailSender
+#from MailSender import CLASS_MailSender  # 假設你把上面的 class 儲存為 MailSender.py
+if __name__ == "__main__":
+    # === 初始化郵件傳送物件 ===
+    mailer = CLASS_MailSender(
+        Pms_SMTP_Server="msr.hinet.net",
+        Pmi_Port=465,
+        Pms_Account="gxxxx.xz@msa.hinet.net",
+        Pms_Password="xxxxx",
+        Pmb_UseSSL=True
+    )
+
+    # === 郵件收件者設定 ===
+    ml_To  = ["xxxx4@xxxxxh.xxz", "xxxxxx23@xxx7.hxxxx.net"]
+    ml_Cc  = ["exxxxx03@hotmail.com.tw"]
+    ml_Bcc = ["xxxxxxy.lin@msa.hxxxx.net"]  # 密件副本，不會顯示在郵件中
+
+    # === 郵件主題與內容 ===
+    ms_Subject = "團隊週報通知 wahaha 123*()F"
+
+    ms_BodyText = """
+這是一封自動寄出的團隊週報通知。
+請參閱附加的 PDF 檔或 HTML 內文。
+    """
+
+    ms_BodyHTML = """
+    <html>
+      <body style="font-family: Microsoft JhengHei;">
+        <h2 style="color: green;">🌟 團隊週報</h2>
+        <p>各位同仁您好：</p>
+        <p>以下為本週重點摘要：</p>
+        <ul>
+          <li>完成模組 A 測試</li>
+          <li>修正 ERP 匯出問題</li>
+          <li>新增客戶報表功能</li>
+        </ul>
+        <p>詳細報表請參閱附件。</p>
+        <p style="color: gray;">系統自動寄出，請勿回覆。</p>
+      </body>
+    </html>
+    """
+
+    # === 附件路徑 ===
+    ml_Attachments = [
+        "X:\\TEMP\\112年縣檸檬幼申報收入.jpg"
+    ]
+
+    # === 寄送 ===
+    mb_OK = mailer.CUF_SendMail(
+        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,
+        Pobj_Attachments=ml_Attachments
+    )
+
+    if mb_OK:
+        print("✅ 多人郵件已成功寄出！")
+    else:
+        print("❌ 寄送失敗，請檢查設定。")

UtilityLibAPI/SessionVARLib.py

@@ -0,0 +1,143 @@
+import pymysql
+import pickle
+import time
+import uuid
+
+class CLASS_SessionVAR:
+    def __init__(self):
+        self.conn = None
+        self.cursor = None
+        self.table_name = "_session_table"
+
+    # ----------------------------
+    # 建立 SessionID
+    # ----------------------------
+    def CUF_New_SessionID(self):
+        return(str(uuid.uuid4()))
+
+    # ----------------------------
+    # 建立連線與表
+    # ----------------------------
+    def CUF_Create(self, Pms_host:str, Pmi_port:int, Pms_user:str, Pms_password:str, Pms_db:str, 
+                   Pms_SessionID:str=None,
+                   Pms_table_name:str="_session_table"):
+        self.conn = pymysql.connect(
+            host=Pms_host,
+            port=Pmi_port,
+            user=Pms_user,
+            password=Pms_password,
+            database=Pms_db,
+            charset='utf8mb4',
+            autocommit=True
+        )
+        self.cursor = self.conn.cursor()
+        self.table_name = Pms_table_name
+
+        # 建立表格，如果不存在
+        create_sql = f"""
+        CREATE TABLE IF NOT EXISTS `{self.table_name}` (
+            `SessionID` VARCHAR(36) NOT NULL,
+            `VarName` VARCHAR(255) NOT NULL,
+            `VarValue` LONGBLOB,
+            `UpdateTime` BIGINT NOT NULL,
+            PRIMARY KEY (`SessionID`, `VarName`)
+        ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+        """
+        self.cursor.execute(create_sql)
+
+        # 回傳 SessionID
+        if(Pms_SessionID == ""):
+            session_id = self.CUF_New_SessionID();
+        else:
+            session_id = Pms_SessionID;
+        return(session_id);
+
+    # ----------------------------
+    # 儲存變數
+    # ----------------------------
+    def CUF_SET(self, Pms_SessionID, Pms_VarName, Pms_VarValue):
+        blob_data = pickle.dumps(Pms_VarValue)
+        update_time = int(time.time())
+        sql = f"""
+        INSERT INTO `{self.table_name}` (SessionID, VarName, VarValue, UpdateTime)
+        VALUES (%s, %s, %s, %s)
+        ON DUPLICATE KEY UPDATE
+            VarValue = VALUES(VarValue),
+            UpdateTime = VALUES(UpdateTime)
+        """
+        self.cursor.execute(sql, (Pms_SessionID, Pms_VarName, blob_data, update_time))
+
+    # ----------------------------
+    # 取得變數
+    # ----------------------------
+    def CUF_GET(self, Pms_SessionID, Pms_VarName):
+        sql = f"SELECT VarValue FROM `{self.table_name}` WHERE SessionID=%s AND VarName=%s"
+        self.cursor.execute(sql, (Pms_SessionID, Pms_VarName))
+        result = self.cursor.fetchone()
+        if result:
+            return pickle.loads(result[0])
+        return None
+
+    # ----------------------------
+    # 釋放 Session
+    # ----------------------------
+    # 依 SessionID 刪除，或依秒數刪除舊資料
+    def CUF_Release(self, Pms_param):
+        if isinstance(Pms_param, str):
+            sql = f"DELETE FROM `{self.table_name}` WHERE SessionID=%s"
+            self.cursor.execute(sql, (Pms_param,))
+        elif isinstance(Pms_param, (int, float)):
+            threshold = int(time.time()) - int(Pms_param)
+            sql = f"DELETE FROM `{self.table_name}` WHERE UpdateTime < %s"
+            self.cursor.execute(sql, (threshold,))
+
+    # ----------------------------
+    # 關閉資源
+    # ----------------------------
+    def CUF_Close(self):
+        if self.cursor:
+            self.cursor.close()
+            self.cursor = None
+        if self.conn:
+            self.conn.close()
+            self.conn = None
+
+# =============================
+# 範例用法
+# =============================
+if(__name__ == "__main__"):
+    objSession = CLASS_SessionVAR()
+    session_id = objSession.CUF_Create(Pms_host="mis.gotech.biz", 
+                                       Pmi_port=3300, Pms_db="df8000", 
+                                       Pms_user="root",
+                                       Pms_password="gotechdf8000sys",
+                                       Pms_SessionID="xx-202510131127");
+
+    # 儲存資料
+    objSession.CUF_SET(session_id, "mylist", [1,2,3])
+    objSession.CUF_SET(session_id, "mydict", {"a":1, "b":2})
+    
+    # 取得資料
+    mylist = objSession.CUF_GET(session_id, "mylist")
+    mydict = objSession.CUF_GET(session_id, "mydict")
+    print(mylist, mydict)
+
+    # 釋放單一 session
+    # objSession.CUF_Release(session_id)
+
+    # 釋放超過 600 秒的資料
+    # objSession.CUF_Release(600)
+
+    
+    mylist = [5,6,7,8,9];
+    objSession.CUF_SET(session_id, "mylist", mylist);
+
+    mylist = [0];
+    print(mylist);
+
+    mylist = objSession.CUF_GET(session_id, "mylist");
+    print(mylist);
+
+    objSession.CUF_SET(session_id, "")
+
+    objSession.CUF_Close()

UtilityLibAPI/__init__.py

@@ -0,0 +1,12 @@
+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_Archive7z"
+          ]

utilitylibapi-1.2511.291.dist-info/METADATA

@@ -0,0 +1,62 @@
+Metadata-Version: 2.4
+Name: UtilityLibAPI
+Version: 1.2511.291
+Summary: UtilityLibAPI Python package
+Author-email: James Lin <tylin123@ms27.hinet.net>
+License: Copyright (c) 2025 James Lin **UtilityLibAPI**
+        
+        All rights reserved.
+        
+        Permission is granted for **personal, educational, or non-commercial use only**.
+        You **may NOT**:
+        
+        1. Sell or otherwise commercially exploit this software or any part of it.
+        2. Reproduce, distribute, or sublicense this software for commercial purposes.
+        3. Modify or create derivative works for commercial purposes without explicit written permission from the copyright holder.
+        
+        You **may**:
+        
+        - Use the software for personal learning, research, or internal company evaluation (non-commercial).
+        - Share the software with attribution to the original author, as long as it is not for commercial gain.
+        
+        **Disclaimer:**
+        This software is provided "AS IS", without any warranty of any kind, either expressed or implied,
+        including but not limited to the warranties of merchantability, fitness for a particular purpose, or non-infringement.
+        In no event shall the author be liable for any claim, damages, or other liability arising from, out of, or in connection with the software or its use.
+        
+Project-URL: Homepage, https://mis.gotech.biz
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pymysql
+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.
+
+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.291.dist-info/RECORD

@@ -0,0 +1,11 @@
+UtilityLibAPI/Archive7zLib.py,sha256=aZWS3cLA_YdWaoBzBYS7jWIzWxJa8Eg6rFCVOX_u0t4,11949
+UtilityLibAPI/EnDeCodeLib.py,sha256=YPaqzZJXl5f0xwPv4V4zMRWaH6-6K5MNlKMsyUcQ95U,9189
+UtilityLibAPI/ExtWrapper7zLib.py,sha256=ZD1jEzCNh6F_wsZ70O-Tw2KgUNZ7b58siHZNIlZ3n7o,5815
+UtilityLibAPI/MailSenderLib.py,sha256=OZ1ANXJpwPM6Y7Ez1fAW7pSxfL44tzKgrCqaBnLeR1Q,7888
+UtilityLibAPI/SessionVARLib.py,sha256=WGzozRfENQrjNuI5vuRC8CXbz9jSKvE5d612e5WB2q8,4821
+UtilityLibAPI/__init__.py,sha256=FMcTZBeOoejbxU-pIzkpNgUZVMNXtSWNmFXX5USUyTg,413
+utilitylibapi-1.2511.291.dist-info/licenses/LICENSE,sha256=fpKsUxampChuMsbZd_ww_SEJqK88RFiYAvqzAsklgFI,1072
+utilitylibapi-1.2511.291.dist-info/METADATA,sha256=Bw077sxaEkK9rn3ynw2rARlaRf1Xe7z14Fdh1ag5HZQ,2463
+utilitylibapi-1.2511.291.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+utilitylibapi-1.2511.291.dist-info/top_level.txt,sha256=keGrZAwheJUvsOa8IUlwa3fYR7OzUbjFMQUczJC99Tg,14
+utilitylibapi-1.2511.291.dist-info/RECORD,,

utilitylibapi-1.2511.291.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

utilitylibapi-1.2511.291.dist-info/licenses/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2025 James Lin **UtilityLibAPI**
+
+All rights reserved.
+
+Permission is granted for **personal, educational, or non-commercial use only**.
+You **may NOT**:
+
+1. Sell or otherwise commercially exploit this software or any part of it.
+2. Reproduce, distribute, or sublicense this software for commercial purposes.
+3. Modify or create derivative works for commercial purposes without explicit written permission from the copyright holder.
+
+You **may**:
+
+- Use the software for personal learning, research, or internal company evaluation (non-commercial).
+- Share the software with attribution to the original author, as long as it is not for commercial gain.
+
+**Disclaimer:**
+This software is provided "AS IS", without any warranty of any kind, either expressed or implied,
+including but not limited to the warranties of merchantability, fitness for a particular purpose, or non-infringement.
+In no event shall the author be liable for any claim, damages, or other liability arising from, out of, or in connection with the software or its use.

utilitylibapi-1.2511.291.dist-info/top_level.txt

@@ -0,0 +1 @@
+UtilityLibAPI