BCBvcl4pyAPI 0.1.6__tar.gz → 0.1.7__tar.gz

{bcbvcl4pyapi-0.1.6 → bcbvcl4pyapi-0.1.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: BCBvcl4pyAPI
-Version: 0.1.6
+Version: 0.1.7
 Summary: BCBvcl4pyAPI Python package
 Author-email: James Lin <tylin123@ms27.hinet.net>
 License: Copyright (c) 2025 James Lin
@@ -33,11 +33,14 @@ 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.7: 2025/10/09<BR>
+Add the TMemoryStream, TIniFiles class
+
+Version 0.1.6: 2025/10/08<BR>
+Add the AnsiString class 
 
 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 
+Version 0.1.3: 2025/09/19<BR>
+Mainly fixed the issue where Packages could not be found after an update.<BR>

{bcbvcl4pyapi-0.1.6 → bcbvcl4pyapi-0.1.7}/README.md

@@ -1,11 +1,14 @@
 #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.7: 2025/10/09<BR>
+Add the TMemoryStream, TIniFiles class
+
+Version 0.1.6: 2025/10/08<BR>
+Add the AnsiString class 
 
 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 
+Version 0.1.3: 2025/09/19<BR>
+Mainly fixed the issue where Packages could not be found after an update.<BR>

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

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

bcbvcl4pyapi-0.1.7/src/BCBvcl4pyAPI/TIniFileAPI.py

@@ -0,0 +1,107 @@
+import os
+import configparser
+
+class TIniFile:
+    def __init__(self, FileName: str, Encoding: str = "byte"):
+        """
+        Encoding:
+            "byte"    -> Big5 編碼
+            "unicode" -> UTF-8 編碼
+        """
+        self.FileName = FileName
+        self.Encoding = Encoding.lower()
+        self.config = configparser.ConfigParser()
+        self.config.optionxform = str  # 保留大小寫
+
+        self._encoding_name = "big5" if self.Encoding == "byte" else "utf-8"
+
+        if os.path.exists(self.FileName):
+            self.config.read(self.FileName, encoding=self._encoding_name)
+
+    # -----------------------
+    # 讀取方法
+    # -----------------------
+    def ReadString(self, Section: str, Ident: str, Default: str = "") -> str:
+        if self.config.has_section(Section) and self.config.has_option(Section, Ident):
+            return self.config.get(Section, Ident)
+        return Default
+
+    def ReadInteger(self, Section: str, Ident: str, Default: int = 0) -> int:
+        try:
+            return int(self.ReadString(Section, Ident, str(Default)))
+        except ValueError:
+            return Default
+
+    def ReadFloat(self, Section: str, Ident: str, Default: float = 0.0) -> float:
+        try:
+            return float(self.ReadString(Section, Ident, str(Default)))
+        except ValueError:
+            return Default
+
+    def ReadBool(self, Section: str, Ident: str, Default: bool = False) -> bool:
+        val = self.ReadString(Section, Ident, str(Default))
+        return val.lower() in ['1', 'true', 'yes']
+
+    # -----------------------
+    # 寫入方法
+    # -----------------------
+    def WriteString(self, Section: str, Ident: str, Value: str):
+        if not self.config.has_section(Section):
+            self.config.add_section(Section)
+        self.config.set(Section, Ident, Value)
+        self._save()
+
+    def WriteInteger(self, Section: str, Ident: str, Value: int):
+        self.WriteString(Section, Ident, str(Value))
+
+    def WriteFloat(self, Section: str, Ident: str, Value: float):
+        self.WriteString(Section, Ident, str(Value))
+
+    def WriteBool(self, Section: str, Ident: str, Value: bool):
+        self.WriteString(Section, Ident, str(int(Value)))
+
+    # -----------------------
+    # 刪除 / 檢查
+    # -----------------------
+    def DeleteKey(self, Section: str, Ident: str):
+        if self.config.has_section(Section):
+            self.config.remove_option(Section, Ident)
+            self._save()
+
+    def EraseSection(self, Section: str):
+        if self.config.has_section(Section):
+            self.config.remove_section(Section)
+            self._save()
+
+    def ValueExists(self, Section: str, Ident: str) -> bool:
+        return self.config.has_section(Section) and self.config.has_option(Section, Ident)
+
+    # -----------------------
+    # 內部保存
+    # -----------------------
+    def _save(self):
+        with open(self.FileName, 'w', encoding=self._encoding_name) as f:
+            self.config.write(f)
+
+    # -----------------------
+    # 關閉 (可選)
+    # -----------------------
+    def Close(self):
+        self.config = None
+
+
+# ================================================================================
+if(__name__=="__main__"):
+    # 預設 Big5
+    ini = TIniFile("test.ini")
+    # 或者使用 Unicode (UTF-8)
+    # ini = TIniFile("test.ini", Encoding="unicode")
+
+    ini.WriteString("User", "Name", "林大明")
+    ini.WriteInteger("User", "Age", 36)
+
+    name = ini.ReadString("User", "Name", "DefaultName")
+    age = ini.ReadInteger("User", "Age", 0)
+
+    print(name, age)
+    

bcbvcl4pyapi-0.1.7/src/BCBvcl4pyAPI/TMemoryStream.py

@@ -0,0 +1,149 @@
+import io
+import os
+import pickle
+
+class TStream:
+    def __init__(self):
+        self._stream = io.BytesIO()
+
+    # ---- 屬性 ----
+    @property
+    def Position(self) -> int:
+        return self._stream.tell()
+
+    @Position.setter
+    def Position(self, value: int):
+        self._stream.seek(value, io.SEEK_SET)
+
+    @property
+    def Size(self) -> int:
+        current = self._stream.tell()
+        self._stream.seek(0, io.SEEK_END)
+        size = self._stream.tell()
+        self._stream.seek(current, io.SEEK_SET)
+        return size
+
+    # ---- 基本方法 ----
+    def Seek(self, Offset: int, Origin: int = io.SEEK_SET) -> int:
+        """移動資料指標"""
+        return self._stream.seek(Offset, Origin)
+
+    def Read(self, Buffer, Count: int) -> int:
+        """讀取 Count 個位元組到 Buffer"""
+        data = self._stream.read(Count)
+        if isinstance(Buffer, bytearray):
+            Buffer[:len(data)] = data
+        return len(data)
+
+    def Write(self, Buffer, Count: int) -> int:
+        """寫入 Count 個位元組"""
+        if isinstance(Buffer, (bytes, bytearray)):
+            self._stream.write(Buffer[:Count])
+            return Count
+        raise TypeError("Buffer must be bytes or bytearray")
+
+    def ReadBuffer(self, Count: int) -> bytes:
+        """讀取指定長度的 bytes"""
+        return self._stream.read(Count)
+
+    def WriteBuffer(self, Data: bytes):
+        """直接寫入 bytes"""
+        self._stream.write(Data)
+
+    def Clear(self):
+        """清空資料"""
+        self._stream = io.BytesIO()
+
+    def SetSize(self, NewSize: int):
+        """設定串流大小"""
+        current = self._stream.tell()
+        data = self._stream.getvalue()
+        if NewSize < len(data):
+            data = data[:NewSize]
+        else:
+            data += b'\x00' * (NewSize - len(data))
+        self._stream = io.BytesIO(data)
+        self._stream.seek(min(current, NewSize))
+
+    def LoadFromFile(self, FileName: str):
+        """從檔案載入"""
+        if not os.path.exists(FileName):
+            raise FileNotFoundError(FileName)
+        with open(FileName, "rb") as f:
+            self._stream = io.BytesIO(f.read())
+        self._stream.seek(0)
+
+    def SaveToFile(self, FileName: str):
+        """儲存至檔案"""
+        with open(FileName, "wb") as f:
+            current = self._stream.tell()
+            self._stream.seek(0)
+            f.write(self._stream.read())
+            self._stream.seek(current)
+
+    # ---- 擴充：物件序列化 ----
+    def WriteObject(self, obj):
+        """序列化並寫入任意 Python 物件（包含 dataclass）"""
+        data = pickle.dumps(obj)
+        self.Clear()
+        self._stream.write(data)
+        self._stream.seek(0)
+
+    def ReadObject(self):
+        """讀取並還原先前 WriteObject() 寫入的 Python 物件"""
+        self._stream.seek(0)
+        return pickle.loads(self._stream.read())
+
+
+class TMemoryStream(TStream):
+    """模擬 BCB5 的 TMemoryStream"""
+    def __init__(self):
+        super().__init__()
+
+# ================================================================================
+# [使用範例]
+if(__name__=="__main__"):
+    from dataclasses import dataclass
+
+    @dataclass
+    class STRU_Employee:
+        mi_EMPID:    int;
+        ms_EMPNAME:  str;
+        ms_BIRTHDAY: str;
+        ms_Weight:   float;
+
+    obj_MemStream: TMemoryStream;
+    stru_EMP1    : STRU_Employee;
+    stru_EMP2    : STRU_Employee;
+    stru_EMP3    : STRU_Employee;
+    stru_READ    : STRU_Employee;
+    
+    obj_MemStream = TMemoryStream();
+    stru_EMP1     = STRU_Employee(0, "劉備", "1998/01/02", 54.23);
+    stru_EMP2     = STRU_Employee(1, "關羽", "2026/03/26", 74.74);
+    stru_EMP3     = STRU_Employee(2, "張飛", "2028/11/18", 94.39);
+    stru_READ     = STRU_Employee(-1, "", "", 0.0);
+    
+    obj_MemStream.Clear();
+    obj_MemStream.WriteObject(stru_EMP1);
+    obj_MemStream.Position = 0;
+    obj_MemStream.SaveToFile("emp1.bin");
+
+    obj_MemStream.Clear();
+    obj_MemStream.WriteObject(stru_EMP2);
+    obj_MemStream.Position = 0;
+    obj_MemStream.SaveToFile("emp2.bin");
+
+    obj_MemStream.Clear();
+    obj_MemStream.WriteObject(stru_EMP3);
+    obj_MemStream.Position = 0;
+    obj_MemStream.SaveToFile("emp3.bin");
+
+
+    obj_MemStream.LoadFromFile("emp2.bin");
+    stru_READ = obj_MemStream.ReadObject();
+
+    print(stru_READ.mi_EMPID);
+    print(stru_READ.ms_EMPNAME);
+    print(stru_READ.ms_BIRTHDAY);
+    print(stru_READ.ms_Weight);

{bcbvcl4pyapi-0.1.6 → bcbvcl4pyapi-0.1.7}/src/BCBvcl4pyAPI/__init__.py

@@ -2,4 +2,8 @@ from .BCBvcl4pyAPI         import TStringList, TList, DynamicArray
 from .HyperDynamicArrayAPI import HyperDynamicArray
 from .AnsiStringAPI        import AnsiString
 
-__all__ = ["TStringList", "TList", "DynamicArray", "HyperDynamicArray", "AnsiString"]
+__all__ = ["TStringList", "TList", "DynamicArray", 
+           "HyperDynamicArray", 
+           "AnsiString",
+           "TMemoryStream"
+          ]

{bcbvcl4pyapi-0.1.6 → bcbvcl4pyapi-0.1.7}/src/BCBvcl4pyAPI.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: BCBvcl4pyAPI
-Version: 0.1.6
+Version: 0.1.7
 Summary: BCBvcl4pyAPI Python package
 Author-email: James Lin <tylin123@ms27.hinet.net>
 License: Copyright (c) 2025 James Lin
@@ -33,11 +33,14 @@ 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.7: 2025/10/09<BR>
+Add the TMemoryStream, TIniFiles class
+
+Version 0.1.6: 2025/10/08<BR>
+Add the AnsiString class 
 
 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 
+Version 0.1.3: 2025/09/19<BR>
+Mainly fixed the issue where Packages could not be found after an update.<BR>

{bcbvcl4pyapi-0.1.6 → bcbvcl4pyapi-0.1.7}/src/BCBvcl4pyAPI.egg-info/SOURCES.txt

@@ -5,6 +5,8 @@ setup.cfg
 src/BCBvcl4pyAPI/AnsiStringAPI.py
 src/BCBvcl4pyAPI/BCBvcl4pyAPI.py
 src/BCBvcl4pyAPI/HyperDynamicArrayAPI.py
+src/BCBvcl4pyAPI/TIniFileAPI.py
+src/BCBvcl4pyAPI/TMemoryStream.py
 src/BCBvcl4pyAPI/__init__.py
 src/BCBvcl4pyAPI.egg-info/PKG-INFO
 src/BCBvcl4pyAPI.egg-info/SOURCES.txt