BCBvcl4pyAPI 0.1.5__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.5 → bcbvcl4pyapi-0.1.6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "BCBvcl4pyAPI"
-version = "0.1.5"
+version = "0.1.6"
 description = "BCBvcl4pyAPI Python package"
 authors = [
   { name="James Lin", email="tylin123@ms27.hinet.net" }
@@ -17,3 +17,6 @@ dependencies = [
 
 [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/__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.5 → 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.5/BCBvcl4pyAPI/__init__.py

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

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

@@ -1,13 +0,0 @@
-Metadata-Version: 2.4
-Name: BCBvcl4pyAPI
-Version: 0.1.5
-Summary: BCBvcl4pyAPI Python package
-Author-email: James Lin <tylin123@ms27.hinet.net>
-Project-URL: Homepage, https://mis.gotech.biz
-Description-Content-Type: text/markdown
-Requires-Dist: pymysql
-
-Version 0.1.3: 2025/09/19
-Mainly fixed the issue where Packages could not be found after an update.
-Version 0.1.5: 2025/09/20
-Add the HyperDynamicArray class to provide large memory access functionality.

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

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

bcbvcl4pyapi-0.1.5/PKG-INFO

@@ -1,13 +0,0 @@
-Metadata-Version: 2.4
-Name: BCBvcl4pyAPI
-Version: 0.1.5
-Summary: BCBvcl4pyAPI Python package
-Author-email: James Lin <tylin123@ms27.hinet.net>
-Project-URL: Homepage, https://mis.gotech.biz
-Description-Content-Type: text/markdown
-Requires-Dist: pymysql
-
-Version 0.1.3: 2025/09/19
-Mainly fixed the issue where Packages could not be found after an update.
-Version 0.1.5: 2025/09/20
-Add the HyperDynamicArray class to provide large memory access functionality.

bcbvcl4pyapi-0.1.5/README.md

@@ -1,4 +0,0 @@
-Version 0.1.3: 2025/09/19
-Mainly fixed the issue where Packages could not be found after an update.
-Version 0.1.5: 2025/09/20
-Add the HyperDynamicArray class to provide large memory access functionality.