UtilityLibAPI 0.1.0__tar.gz

utilitylibapi-0.1.0/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-0.1.0/PKG-INFO

@@ -0,0 +1,37 @@
+Metadata-Version: 2.4
+Name: UtilityLibAPI
+Version: 0.1.0
+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 0.1.0: 2025/10/13<BR>
+Create UtilityLibAPI -- EnDeCodeLib + SessionVARLib<BR>

utilitylibapi-0.1.0/README.md

@@ -0,0 +1,5 @@
+#UtilityLibAPI Classes
+
+## History of version
+Version 0.1.0: 2025/10/13<BR>
+Create UtilityLibAPI -- EnDeCodeLib + SessionVARLib<BR>

utilitylibapi-0.1.0/pyproject.toml

@@ -0,0 +1,22 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "UtilityLibAPI"
+version = "0.1.0"
+description = "UtilityLibAPI Python package"
+authors = [
+  { name="James Lin", email="tylin123@ms27.hinet.net" }
+]
+readme = "README.md"
+license = { file = "LICENSE" }
+dependencies = [
+  "pymysql",  
+]
+
+[project.urls]
+Homepage = "https://mis.gotech.biz"
+
+[tools.setuptools.packages.find]
+where = ["src"]

utilitylibapi-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

utilitylibapi-0.1.0/src/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-0.1.0/src/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-0.1.0/src/UtilityLibAPI.egg-info/PKG-INFO

@@ -0,0 +1,37 @@
+Metadata-Version: 2.4
+Name: UtilityLibAPI
+Version: 0.1.0
+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 0.1.0: 2025/10/13<BR>
+Create UtilityLibAPI -- EnDeCodeLib + SessionVARLib<BR>

utilitylibapi-0.1.0/src/UtilityLibAPI.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+LICENSE
+README.md
+pyproject.toml
+setup.cfg
+src/EnDeCodeLib.py
+src/SessionVARLib.py
+src/__init__.py
+src/UtilityLibAPI.egg-info/PKG-INFO
+src/UtilityLibAPI.egg-info/SOURCES.txt
+src/UtilityLibAPI.egg-info/dependency_links.txt
+src/UtilityLibAPI.egg-info/requires.txt
+src/UtilityLibAPI.egg-info/top_level.txt

utilitylibapi-0.1.0/src/UtilityLibAPI.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

utilitylibapi-0.1.0/src/UtilityLibAPI.egg-info/requires.txt

@@ -0,0 +1 @@
+pymysql

utilitylibapi-0.1.0/src/UtilityLibAPI.egg-info/top_level.txt

@@ -0,0 +1,3 @@
+EnDeCodeLib
+SessionVARLib
+__init__

utilitylibapi-0.1.0/src/__init__.py

@@ -0,0 +1,6 @@
+from .EnDeCodeLib   import CLASS_EnDeCodeLib
+from .SessionVARLib import TIniFile
+
+__all__ = ["CLASS_EnDeCodeLib", 
+           "CLASS_SessionVAR"
+          ]