BCBvcl4pyAPI 0.1.3__tar.gz → 0.1.6__tar.gz

bcbvcl4pyapi-0.1.6/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2025 James Lin
+
+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.

bcbvcl4pyapi-0.1.6/PKG-INFO

@@ -0,0 +1,43 @@
+Metadata-Version: 2.4
+Name: BCBvcl4pyAPI
+Version: 0.1.6
+Summary: BCBvcl4pyAPI Python package
+Author-email: James Lin <tylin123@ms27.hinet.net>
+License: Copyright (c) 2025 James Lin
+        
+        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
+
+#BCBvcl4pyAPI
+
+## History of version
+Version 0.1.3: 2025/09/19<BR>
+Mainly fixed the issue where Packages could not be found after an update.<BR>
+
+Version 0.1.5: 2025/09/20<BR>
+Add the HyperDynamicArray class to provide large memory access functionality.<BR>
+
+Version 0.1.6: 2025/10/08<BR>
+Add the AnsiString class 

bcbvcl4pyapi-0.1.6/README.md

@@ -0,0 +1,11 @@
+#BCBvcl4pyAPI
+
+## History of version
+Version 0.1.3: 2025/09/19<BR>
+Mainly fixed the issue where Packages could not be found after an update.<BR>
+
+Version 0.1.5: 2025/09/20<BR>
+Add the HyperDynamicArray class to provide large memory access functionality.<BR>
+
+Version 0.1.6: 2025/10/08<BR>
+Add the AnsiString class 

{bcbvcl4pyapi-0.1.3 → bcbvcl4pyapi-0.1.6}/pyproject.toml

@@ -4,13 +4,19 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "BCBvcl4pyAPI"
-version = "0.1.3"
+version = "0.1.6"
 description = "BCBvcl4pyAPI 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"]

bcbvcl4pyapi-0.1.6/src/BCBvcl4pyAPI/AnsiStringAPI.py

@@ -0,0 +1,174 @@
+class AnsiString:
+    def __init__(self, Pms_str: str = '', encoding: str = 'byte'):
+        """
+        encoding:
+            'byte' -> BCB5 byte模式（中文佔兩個byte）
+            'unicode' -> Unicode 字元模式
+        """
+        self.encoding = encoding
+        self.set(Pms_str)
+
+    # ---------------------------------------------
+    # 改變內容
+    # ---------------------------------------------
+    def set(self, Pms_str: str):
+        if self.encoding == 'byte':
+            self._data = Pms_str.encode('big5', errors='replace')
+        else:
+            self._data = Pms_str.encode('utf-8')
+        return self  # 支援連鎖呼叫
+
+    # ---------------------------------------------
+    # 轉成 Python str
+    # ---------------------------------------------
+    def str(self):
+        if self.encoding == 'byte':
+            return self._data.decode('big5', errors='replace')
+        else:
+            return self._data.decode('utf-8')
+
+    def __str__(self):
+        return self.str()
+
+    # ---------------------------------------------
+    # 取 C 字串 bytes
+    # ---------------------------------------------
+    def c_str(self):
+        return self._data
+
+    # ---------------------------------------------
+    # 支援索引取單 byte
+    # ---------------------------------------------
+    def __getitem__(self, index):
+        return self._data[index]
+
+    # ---------------------------------------------
+    # SubString
+    # mode='byte' / 'unicode'
+    # ---------------------------------------------
+    def SubString(self, start: int, length: int = None, mode: str = None):
+        mode = mode or self.encoding
+        if mode == 'unicode':
+            s = self.str()
+            start -= 1
+            if length is None:
+                return AnsiString(s[start:], encoding=self.encoding)
+            else:
+                return AnsiString(s[start:start+length], encoding=self.encoding)
+        elif mode == 'byte':
+            start -= 1
+            if length is None:
+                return AnsiString(self._data[start:].decode('big5', errors='replace'), encoding=self.encoding)
+            else:
+                return AnsiString(self._data[start:start+length].decode('big5', errors='replace'), encoding=self.encoding)
+        else:
+            raise ValueError("mode must be 'byte' or 'unicode'")
+
+    # ---------------------------------------------
+    # 長度
+    # ---------------------------------------------
+    def Length(self, mode: str = None):
+        mode = mode or self.encoding
+        if mode == 'unicode':
+            return len(self.str())
+        elif mode == 'byte':
+            return len(self._data)
+        else:
+            raise ValueError("mode must be 'byte' or 'unicode'")
+
+    @staticmethod
+    def strlen(Pms_str: str, encoding: str = 'byte'):
+        if encoding == 'unicode':
+            return len(Pms_str)
+        elif encoding == 'byte':
+            return len(Pms_str.encode('big5', errors='replace'))
+        else:
+            raise ValueError("encoding must be 'byte' or 'unicode'")
+
+    # ---------------------------------------------
+    # 常用方法
+    # ---------------------------------------------
+    def Trim(self):
+        return AnsiString(self.str().strip(), encoding=self.encoding)
+
+    def UpperCase(self):
+        return AnsiString(self.str().upper(), encoding=self.encoding)
+
+    def LowerCase(self):
+        return AnsiString(self.str().lower(), encoding=self.encoding)
+
+    def Pos(self, sub: str):
+        idx = self.str().find(sub)
+        return idx + 1 if idx >= 0 else 0
+
+    @staticmethod
+    def StringOfChar(char: str, count: int, encoding='byte'):
+        return AnsiString(char * count, encoding=encoding)
+
+    @staticmethod
+    def sprintf(fmt: str, *args, encoding='byte'):
+        return AnsiString(fmt % args, encoding=encoding)
+
+    # ---------------------------------------------
+    # + 運算子
+    # ---------------------------------------------
+    def __add__(self, other):
+        if isinstance(other, AnsiString):
+            combined_str = self.str() + other.str()
+        elif isinstance(other, str):
+            combined_str = self.str() + other
+        else:
+            raise TypeError("Can only add AnsiString or str")
+        return AnsiString(combined_str, encoding=self.encoding)
+
+    # ---------------------------------------------
+    # += 原地累加
+    # ---------------------------------------------
+    def __iadd__(self, other):
+        if isinstance(other, AnsiString):
+            new_str = self.str() + other.str()
+        elif isinstance(other, str):
+            new_str = self.str() + other
+        else:
+            raise TypeError("Can only add AnsiString or str")
+        if self.encoding == 'byte':
+            self._data = new_str.encode('big5', errors='replace')
+        else:
+            self._data = new_str.encode('utf-8')
+        return self
+
+# ================================================================================
+if(__name__=="__main__"):
+    s = AnsiString("  test--測試1234  ")
+
+    # 連鎖呼叫
+    result = s.Trim().UpperCase().SubString(3,5)
+    print(str(result))  # 結果: "ST--測試1"
+
+    # 改變內容也可以連鎖
+    s.set("abc 中文").UpperCase().Trim()
+    print(str(s))       # "ABC 中文"
+
+    # 取長度
+    print(s.Length())           # byte 長度
+    print(s.Length(mode='unicode'))  # 字元長度
+
+    # 靜態 strlen
+    ms_MyStr = "test--測試1234"
+    mi_Len = AnsiString.strlen(ms_MyStr, encoding="unicode")
+    print("mi_Len unicode:", mi_Len)
+    mi_Len_byte = AnsiString.strlen(ms_MyStr, encoding="byte")
+    print("mi_Len byte:", mi_Len_byte)
+
+    # SubString byte/unicode
+    print(str(s.SubString(2,3)))                 # byte模式
+    print(str(s.SubString(2,3, mode='unicode'))) # unicode模式
+
+
+    s.set(str(ms_MyStr))
+    print(s.str())       # "新的字串" -> 大寫 "新的字串"
+    print(s.Pos("測"))
+    
+    print(f"[{s}] ----> len1={s.Length()}");
+    s+="-->增加字";
+    print(f"[{s}] ----> len2={s.Length()}");

bcbvcl4pyapi-0.1.6/src/BCBvcl4pyAPI/HyperDynamicArrayAPI.py

@@ -0,0 +1,137 @@
+import os
+import pickle
+from typing import Generic, TypeVar, Optional
+import pymysql
+from dataclasses import is_dataclass
+
+T = TypeVar("T")
+
+class HyperDynamicArray(Generic[T]):
+    def __init__(
+        self,
+        mysql_host: str,
+        mysql_port: int,
+        mysql_user: str,
+        mysql_password: str,
+        mysql_db: str,
+        table_name: str = "dynamic_array_table",
+        pickle_file: Optional[str] = None,
+        table_type: str = "standard",  # "standard" = InnoDB, "memory" = MEMORY
+        sample_element: Optional[T] = None  # 用來檢測元素型別
+    ):
+        self.mysql_host = mysql_host
+        self.mysql_port = mysql_port
+        self.mysql_user = mysql_user
+        self.mysql_password = mysql_password
+        self.mysql_db = mysql_db
+        self.table_name = table_name
+        self._count = 0
+
+        # 初始化 table_type
+        self.table_type = table_type.lower()
+        if self.table_type not in ("standard", "memory"):
+            raise ValueError("table_type must be 'standard' or 'memory'")
+
+        # 自動切換 MEMORY / InnoDB
+        if self.table_type == "memory":
+            if sample_element is None:
+                # 無法判斷元素型別，安全起見改標準 table
+                print("⚠ Cannot determine element type, using standard table (InnoDB)")
+                self.table_type = "standard"
+            else:
+                if is_dataclass(sample_element) or not isinstance(sample_element, (int, float, str)):
+                    # dataclass 或任意 Python 物件 → 改 InnoDB
+                    print("⚠ Dataclass / Python object not supported in MEMORY Table, switching to standard table (InnoDB)")
+                    self.table_type = "standard"
+                elif isinstance(sample_element, str):
+                    # 字串超長也改 InnoDB
+                    if len(sample_element.encode("utf-8")) > 65532:
+                        print("⚠ String exceeds MEMORY Table maximum length, switching to standard table (InnoDB)")
+                        self.table_type = "standard"
+
+        # 建立 pymysql 連線
+        self._conn = pymysql.connect(
+            host=mysql_host,
+            port=mysql_port,
+            user=mysql_user,
+            password=mysql_password,
+            database=mysql_db,
+            autocommit=True,
+            charset='utf8mb4',
+            cursorclass=pymysql.cursors.Cursor
+        )
+        self._cursor = self._conn.cursor()
+
+        # 建立 table
+        self._create_table()
+
+        # 如果有 pickle_file，轉入 MySQL
+        if pickle_file and os.path.exists(pickle_file):
+            self._load_pickle_to_mysql(pickle_file)
+
+        # 計算元素總數
+        self._cursor.execute(f"SELECT COUNT(*) FROM {self.table_name}")
+        self._count = self._cursor.fetchone()[0]
+
+    def _create_table(self):
+        engine = "InnoDB" if self.table_type == "standard" else "MEMORY"
+        # MEMORY Table 只能用 VARBINARY(65532)
+        column_def = "LONGBLOB" if engine == "InnoDB" else "VARBINARY(65532)"
+        create_sql = f"""
+        CREATE TABLE IF NOT EXISTS {self.table_name} (
+            id BIGINT PRIMARY KEY AUTO_INCREMENT,
+            data {column_def}
+        ) ENGINE={engine};
+        """
+        self._cursor.execute(create_sql)
+
+    def _load_pickle_to_mysql(self, pickle_file: str):
+        with open(pickle_file, "rb") as f:
+            try:
+                while True:
+                    item = pickle.load(f)
+                    self.Add(item)
+            except EOFError:
+                pass
+
+    def Add(self, value: T) -> int:
+        data_blob = pickle.dumps(value)
+        sql = f"INSERT INTO {self.table_name} (data) VALUES (%s)"
+        self._cursor.execute(sql, (data_blob,))
+        self._count += 1
+        return self._count - 1
+
+    def Count(self) -> int:
+        return self._count
+
+    def __getitem__(self, index: int) -> T:
+        if index < 0 or index >= self._count:
+            raise IndexError("HyperDynamicArray index out of range")
+        sql = f"SELECT data FROM {self.table_name} WHERE id = %s"
+        self._cursor.execute(sql, (index + 1,))
+        row = self._cursor.fetchone()
+        if row:
+            return pickle.loads(row[0])
+        else:
+            raise IndexError("HyperDynamicArray index not found")
+
+    def __setitem__(self, index: int, value: T):
+        if index < 0 or index >= self._count:
+            raise IndexError("HyperDynamicArray index out of range")
+        data_blob = pickle.dumps(value)
+        sql = f"UPDATE {self.table_name} SET data = %s WHERE id = %s"
+        self._cursor.execute(sql, (data_blob, index + 1))
+
+    def __iter__(self):
+        for i in range(self._count):
+            yield self[i]
+
+    def Clear(self):
+        """清空 table"""
+        sql = f"TRUNCATE TABLE {self.table_name}"
+        self._cursor.execute(sql)
+        self._count = 0
+
+    def Close(self):
+        self._cursor.close()
+        self._conn.close()

bcbvcl4pyapi-0.1.6/src/BCBvcl4pyAPI/__init__.py

@@ -0,0 +1,5 @@
+from .BCBvcl4pyAPI         import TStringList, TList, DynamicArray
+from .HyperDynamicArrayAPI import HyperDynamicArray
+from .AnsiStringAPI        import AnsiString
+
+__all__ = ["TStringList", "TList", "DynamicArray", "HyperDynamicArray", "AnsiString"]

bcbvcl4pyapi-0.1.6/src/BCBvcl4pyAPI.egg-info/PKG-INFO

@@ -0,0 +1,43 @@
+Metadata-Version: 2.4
+Name: BCBvcl4pyAPI
+Version: 0.1.6
+Summary: BCBvcl4pyAPI Python package
+Author-email: James Lin <tylin123@ms27.hinet.net>
+License: Copyright (c) 2025 James Lin
+        
+        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
+
+#BCBvcl4pyAPI
+
+## History of version
+Version 0.1.3: 2025/09/19<BR>
+Mainly fixed the issue where Packages could not be found after an update.<BR>
+
+Version 0.1.5: 2025/09/20<BR>
+Add the HyperDynamicArray class to provide large memory access functionality.<BR>
+
+Version 0.1.6: 2025/10/08<BR>
+Add the AnsiString class 

bcbvcl4pyapi-0.1.6/src/BCBvcl4pyAPI.egg-info/SOURCES.txt

@@ -0,0 +1,16 @@
+LICENSE
+README.md
+pyproject.toml
+setup.cfg
+src/BCBvcl4pyAPI/AnsiStringAPI.py
+src/BCBvcl4pyAPI/BCBvcl4pyAPI.py
+src/BCBvcl4pyAPI/HyperDynamicArrayAPI.py
+src/BCBvcl4pyAPI/__init__.py
+src/BCBvcl4pyAPI.egg-info/PKG-INFO
+src/BCBvcl4pyAPI.egg-info/SOURCES.txt
+src/BCBvcl4pyAPI.egg-info/dependency_links.txt
+src/BCBvcl4pyAPI.egg-info/requires.txt
+src/BCBvcl4pyAPI.egg-info/top_level.txt
+src/Example/PyListTest.py
+src/Example/PyListTest2.py
+src/Example/TestHyperList.py

bcbvcl4pyapi-0.1.6/src/BCBvcl4pyAPI.egg-info/requires.txt

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

{bcbvcl4pyapi-0.1.3 → bcbvcl4pyapi-0.1.6/src}/BCBvcl4pyAPI.egg-info/top_level.txt

@@ -1 +1,2 @@
 BCBvcl4pyAPI
+Example

bcbvcl4pyapi-0.1.6/src/Example/PyListTest.py

@@ -0,0 +1,25 @@
+from BCBvcl4pyAPI import TStringList
+from BCBvcl4pyAPI import DynamicArray
+
+mi_c : int = 0;
+
+obj_StrList = TStringList();
+
+obj_StrList.Add("Str--1");
+obj_StrList.Add("Str--2");
+
+print();
+for mi_c in range(0, obj_StrList.Count()):
+    print(f"data {mi_c}: {obj_StrList[mi_c]}");
+
+
+mda_Values = DynamicArray[float]();
+
+mda_Values.Add(1.2);
+mda_Values.Add(2.2);
+mda_Values.Add(3.2);
+mda_Values.Add(4.2);
+mda_Values.Add(5.2);
+
+for mi_c in range(0, mda_Values.Length()):
+    print(f"data_float = {mda_Values[mi_c]}");

bcbvcl4pyapi-0.1.6/src/Example/PyListTest2.py

@@ -0,0 +1,19 @@
+from BCBvcl4pyAPI import TStringList
+from BCBvcl4pyAPI import DynamicArray
+
+obj_MyList   : TStringList;
+mda_MyValues : DynamicArray;
+mi_c         : int = 0;
+
+mda_MyValues = DynamicArray();
+
+mda_MyValues.Add(0.319);
+mda_MyValues.Add(4.123);
+mda_MyValues.Add(3.621);
+
+for mi_c in range(0, mda_MyValues.Length()):
+    print(mda_MyValues[mi_c]);
+
+
+obj_MyList = TStringList();
+obj_MyList.Add("OKOK");

bcbvcl4pyapi-0.1.6/src/Example/TestHyperList.py

@@ -0,0 +1,38 @@
+from BCBvcl4pyAPI import HyperDynamicArray
+from dataclasses import dataclass
+
+@dataclass
+class TPerson:
+    name: str
+    age: int
+
+# 建立記憶體 table 模式
+arr = HyperDynamicArray[TPerson](
+    mysql_host="mis.gotech.biz",
+    mysql_port= 3300,
+    mysql_user="root",
+    mysql_password="gotechdf8000sys",
+    mysql_db="df8000",
+    table_name="_mem_dataset",
+    table_type="memory"
+)
+
+arr.Clear();
+
+# 加入元素
+for i in range(500):
+    arr.Add(TPerson(f"Person{i}", 20+i))
+
+print("元素總數:", arr.Count())
+
+# 讀取
+for i in range(arr.Count()):
+    print(arr[i])
+
+print(arr[106].name);
+
+# 清空 table
+#arr.Clear()
+#print("清空後元素總數:", arr.Count())
+
+arr.Close()

bcbvcl4pyapi-0.1.3/BCBvcl4pyAPI/__init__.py

@@ -1,3 +0,0 @@
-from .BCBvcl4pyAPI import TStringList, TList, DynamicArray
-
-__all__ = ["TStringList", "TList", "DynamicArray"]

bcbvcl4pyapi-0.1.3/BCBvcl4pyAPI.egg-info/PKG-INFO

@@ -1,11 +0,0 @@
-Metadata-Version: 2.4
-Name: BCBvcl4pyAPI
-Version: 0.1.3
-Summary: BCBvcl4pyAPI Python package
-Author-email: James Lin <tylin123@ms27.hinet.net>
-Project-URL: Homepage, https://mis.gotech.biz
-Description-Content-Type: text/markdown
-
-Version 0.1.3: 2025/09/19
---------------
-Mainly fixed the issue where Packages could not be found after an update.

bcbvcl4pyapi-0.1.3/BCBvcl4pyAPI.egg-info/SOURCES.txt

@@ -1,9 +0,0 @@
-README.md
-pyproject.toml
-setup.cfg
-BCBvcl4pyAPI/BCBvcl4pyAPI.py
-BCBvcl4pyAPI/__init__.py
-BCBvcl4pyAPI.egg-info/PKG-INFO
-BCBvcl4pyAPI.egg-info/SOURCES.txt
-BCBvcl4pyAPI.egg-info/dependency_links.txt
-BCBvcl4pyAPI.egg-info/top_level.txt

bcbvcl4pyapi-0.1.3/PKG-INFO

@@ -1,11 +0,0 @@
-Metadata-Version: 2.4
-Name: BCBvcl4pyAPI
-Version: 0.1.3
-Summary: BCBvcl4pyAPI Python package
-Author-email: James Lin <tylin123@ms27.hinet.net>
-Project-URL: Homepage, https://mis.gotech.biz
-Description-Content-Type: text/markdown
-
-Version 0.1.3: 2025/09/19
---------------
-Mainly fixed the issue where Packages could not be found after an update.

bcbvcl4pyapi-0.1.3/README.md

@@ -1,3 +0,0 @@
-Version 0.1.3: 2025/09/19
---------------
-Mainly fixed the issue where Packages could not be found after an update.