hanifx-db 28.0.0__tar.gz

hanifx_db-28.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Hanif (HanifX)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

hanifx_db-28.0.0/PKG-INFO

@@ -0,0 +1,317 @@
+Metadata-Version: 2.4
+Name: hanifx-db
+Version: 28.0.0
+Summary: HanifX Database Engine — Custom binary database with built-in HanifX security encoding
+Home-page: https://pypi.org/project/hanifx-db
+Author: Hanif
+Author-email: sajim4653@gmail.com
+Project-URL: Source, https://pypi.org/project/hanifx-db
+Project-URL: Tracker, https://pypi.org/project/hanifx-db
+Keywords: database,db,hanifx,security,encoding,encryption,custom-database,binary-format,hxdb,termux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Database
+Classifier: Topic :: Security :: Cryptography
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license-file
+Dynamic: project-url
+Dynamic: requires-python
+Dynamic: summary
+
+# HanifX DB 🗄️
+
+**HanifX Database Engine** — A fully custom binary database built from scratch in pure Python with built-in HanifX security encoding.
+
+[![Version](https://img.shields.io/badge/version-27.0.0-blue)](https://pypi.org/project/hanifx-db)
+[![Python](https://img.shields.io/badge/python-3.6%2B-green)](https://pypi.org/project/hanifx-db)
+[![License](https://img.shields.io/badge/license-MIT-orange)](LICENSE)
+[![Platform](https://img.shields.io/badge/platform-Termux%20%7C%20Linux%20%7C%20Windows%20%7C%20Mac-lightgrey)](https://pypi.org/project/hanifx-db)
+
+---
+
+## ✨ Features
+
+- 🔐 **Built-in HanifX Security** — Irreversible encoding, no external dependency
+- 🗂️ **Multi-Table Support** — Multiple tables in a single `.hxdb` file
+- ⚡ **O(1) Index System** — Custom hash table for fast lookups
+- 🔄 **Transactions + WAL** — Commit, rollback, crash recovery
+- 🗜️ **Custom Compression** — Own RLE + LZ algorithm
+- 🔗 **Relations** — Foreign keys, ONE_TO_ONE, ONE_TO_MANY, MANY_TO_MANY
+- 🔍 **Query Builder** — Fluent query API with 11 operators
+- 💾 **LRU Cache** — Fast repeated reads
+- 📝 **Operation Logging** — Every operation logged to `.hxlog`
+- 📦 **Pure Python** — No external dependencies, works on Termux
+
+---
+
+## 📦 Installation
+
+```bash
+pip install hanifx-db
+```
+
+---
+
+## 🚀 Quick Start
+
+```python
+from hanifxdb import HanifXDB
+
+# Open / Create database
+db = HanifXDB("mydata.hxdb")
+
+# Create table
+db.create_table("users")
+
+# Set plain data
+db.set("users", "name", "Sazzad")
+db.set("users", "age", 20)
+db.set("users", "is_admin", True)
+
+# Set secret data (irreversible HanifX encoding)
+db.set_secret("users", "password", "mypass123")
+
+# Get data
+print(db.get("users", "name"))    # Sazzad
+print(db.get("users", "age"))     # 20
+
+# Verify secret
+if db.verify("users", "password", "mypass123"):
+    print("Login success!")
+
+# Close
+db.close()
+```
+
+---
+
+## 🔐 Security
+
+HanifX DB uses the built-in **HanifX 24.0.0** encoding algorithm:
+
+```python
+# Store secret (irreversible)
+db.set_secret("users", "token", "mytoken123")
+
+# Verify (checksum-based)
+db.verify("users", "token", "mytoken123")   # True
+db.verify("users", "token", "wrongtoken")   # HanifXVerifyError
+
+# Encode file
+db.set_file("users", "photo", "profile.jpg")
+
+# Generate secure token
+token = db.generate_token(32)
+uid   = db.generate_id()
+```
+
+---
+
+## 🗂️ Multi-Table
+
+```python
+db = HanifXDB("shop.hxdb")
+
+db.create_table("users")
+db.create_table("orders")
+db.create_table("products")
+
+db.set("users",    "user_1", {"name": "Sazzad", "age": 20})
+db.set("products", "prod_1", {"name": "Phone",  "price": 500})
+db.set("orders",   "ord_1",  {"user": "user_1", "product": "prod_1"})
+
+print(db.list_tables())   # ['users', 'orders', 'products']
+```
+
+---
+
+## 🔍 Query Builder
+
+```python
+from hanifxdb import OP_GTE, OP_LIKE
+
+# Fluent query
+results = (
+    db.query("users")
+    .where("age", OP_GTE, 18)
+    .where("name", OP_LIKE, "saz")
+    .order_by("age")
+    .limit(10)
+    .execute()
+)
+
+# Shortcuts
+db.find_all("users")
+db.find_one("users", "name", "Sazzad")
+db.find_like("users", "name", "saz")
+db.count("users")
+```
+
+---
+
+## 🔄 Transactions
+
+```python
+db.begin()
+try:
+    db.set("users", "name", "Sazzad")
+    db.set("users", "age", 20)
+    db.set_secret("users", "password", "pass123")
+    db.commit()
+except Exception:
+    db.rollback()
+```
+
+---
+
+## 🔗 Relations
+
+```python
+# Add relation
+db.add_relation(
+    name       = "user_orders",
+    from_table = "orders",
+    from_key   = "user_id",
+    to_table   = "users",
+    to_key     = "id"
+)
+
+# Get related records
+related = db.get_related("user_orders", "user_1")
+
+# Validate foreign key
+db.validate_fk("user_orders", "user_1")
+```
+
+---
+
+## 💾 Backup & Restore
+
+```python
+# Backup
+db.backup("backup.hxbak")
+
+# Restore
+db.restore("backup.hxbak")
+```
+
+---
+
+## 📊 Info & Logs
+
+```python
+# Database info
+print(db.info())
+
+# Cache stats
+print(db.cache_stats())
+
+# Read logs
+logs = db.read_logs()
+for log in logs:
+    print(log)
+```
+
+---
+
+## 🖥️ Context Manager
+
+```python
+with HanifXDB("mydata.hxdb") as db:
+    db.create_table("users")
+    db.set("users", "name", "Sazzad")
+# Auto close on exit
+```
+
+---
+
+## 📁 File Format
+
+HanifX DB uses a custom binary `.hxdb` format:
+
+```
+HANIFXDB          ← Magic header (8 bytes)
+Version           ← DB version (4 bytes)
+Timestamps        ← Created / Modified
+Table sections    ← HX_TBL__ + records
+Records           ← HX_REC__ + key + value + checksum
+HX_END__          ← EOF signature
+```
+
+---
+
+## 📋 Supported Data Types
+
+| Type     | Python        | Example                    |
+|----------|---------------|----------------------------|
+| text     | str           | `"Sazzad"`                 |
+| number   | int / float   | `20`, `3.14`               |
+| bool     | bool          | `True`, `False`            |
+| secret   | str (encoded) | `"password123"` → encoded  |
+| file     | str (path)    | `"photo.jpg"` → encoded    |
+| list     | list          | `[1, 2, 3]`                |
+| dict     | dict          | `{"name": "Sazzad"}`       |
+
+---
+
+## ⚡ Query Operators
+
+| Operator   | Meaning              |
+|------------|----------------------|
+| `OP_EQ`    | Equal                |
+| `OP_NEQ`   | Not equal            |
+| `OP_GT`    | Greater than         |
+| `OP_GTE`   | Greater than or equal|
+| `OP_LT`    | Less than            |
+| `OP_LTE`   | Less than or equal   |
+| `OP_IN`    | Value in list        |
+| `OP_NOT_IN`| Value not in list    |
+| `OP_LIKE`  | String contains      |
+| `OP_STARTS`| String starts with   |
+| `OP_ENDS`  | String ends with     |
+
+---
+
+## 📱 Termux Support
+
+```bash
+# Install on Termux (Android)
+pip install hanifx-db
+
+# Use immediately - no extra setup needed
+python3 -c "from hanifxdb import HanifXDB; print('HanifX DB ready!')"
+```
+
+---
+
+## 👨‍💻 Author
+
+**Hanif (HanifX)**
+- PyPI: [habib_bi](https://pypi.org/user/habib_bi)
+- Email: sajim4653@gmail.com
+- Package: [hanifx-db](https://pypi.org/project/hanifx-db)
+
+---
+
+## 📄 License
+
+MIT License — Free to use, modify, and distribute.

hanifx_db-28.0.0/README.md

@@ -0,0 +1,278 @@
+# HanifX DB 🗄️
+
+**HanifX Database Engine** — A fully custom binary database built from scratch in pure Python with built-in HanifX security encoding.
+
+[![Version](https://img.shields.io/badge/version-27.0.0-blue)](https://pypi.org/project/hanifx-db)
+[![Python](https://img.shields.io/badge/python-3.6%2B-green)](https://pypi.org/project/hanifx-db)
+[![License](https://img.shields.io/badge/license-MIT-orange)](LICENSE)
+[![Platform](https://img.shields.io/badge/platform-Termux%20%7C%20Linux%20%7C%20Windows%20%7C%20Mac-lightgrey)](https://pypi.org/project/hanifx-db)
+
+---
+
+## ✨ Features
+
+- 🔐 **Built-in HanifX Security** — Irreversible encoding, no external dependency
+- 🗂️ **Multi-Table Support** — Multiple tables in a single `.hxdb` file
+- ⚡ **O(1) Index System** — Custom hash table for fast lookups
+- 🔄 **Transactions + WAL** — Commit, rollback, crash recovery
+- 🗜️ **Custom Compression** — Own RLE + LZ algorithm
+- 🔗 **Relations** — Foreign keys, ONE_TO_ONE, ONE_TO_MANY, MANY_TO_MANY
+- 🔍 **Query Builder** — Fluent query API with 11 operators
+- 💾 **LRU Cache** — Fast repeated reads
+- 📝 **Operation Logging** — Every operation logged to `.hxlog`
+- 📦 **Pure Python** — No external dependencies, works on Termux
+
+---
+
+## 📦 Installation
+
+```bash
+pip install hanifx-db
+```
+
+---
+
+## 🚀 Quick Start
+
+```python
+from hanifxdb import HanifXDB
+
+# Open / Create database
+db = HanifXDB("mydata.hxdb")
+
+# Create table
+db.create_table("users")
+
+# Set plain data
+db.set("users", "name", "Sazzad")
+db.set("users", "age", 20)
+db.set("users", "is_admin", True)
+
+# Set secret data (irreversible HanifX encoding)
+db.set_secret("users", "password", "mypass123")
+
+# Get data
+print(db.get("users", "name"))    # Sazzad
+print(db.get("users", "age"))     # 20
+
+# Verify secret
+if db.verify("users", "password", "mypass123"):
+    print("Login success!")
+
+# Close
+db.close()
+```
+
+---
+
+## 🔐 Security
+
+HanifX DB uses the built-in **HanifX 24.0.0** encoding algorithm:
+
+```python
+# Store secret (irreversible)
+db.set_secret("users", "token", "mytoken123")
+
+# Verify (checksum-based)
+db.verify("users", "token", "mytoken123")   # True
+db.verify("users", "token", "wrongtoken")   # HanifXVerifyError
+
+# Encode file
+db.set_file("users", "photo", "profile.jpg")
+
+# Generate secure token
+token = db.generate_token(32)
+uid   = db.generate_id()
+```
+
+---
+
+## 🗂️ Multi-Table
+
+```python
+db = HanifXDB("shop.hxdb")
+
+db.create_table("users")
+db.create_table("orders")
+db.create_table("products")
+
+db.set("users",    "user_1", {"name": "Sazzad", "age": 20})
+db.set("products", "prod_1", {"name": "Phone",  "price": 500})
+db.set("orders",   "ord_1",  {"user": "user_1", "product": "prod_1"})
+
+print(db.list_tables())   # ['users', 'orders', 'products']
+```
+
+---
+
+## 🔍 Query Builder
+
+```python
+from hanifxdb import OP_GTE, OP_LIKE
+
+# Fluent query
+results = (
+    db.query("users")
+    .where("age", OP_GTE, 18)
+    .where("name", OP_LIKE, "saz")
+    .order_by("age")
+    .limit(10)
+    .execute()
+)
+
+# Shortcuts
+db.find_all("users")
+db.find_one("users", "name", "Sazzad")
+db.find_like("users", "name", "saz")
+db.count("users")
+```
+
+---
+
+## 🔄 Transactions
+
+```python
+db.begin()
+try:
+    db.set("users", "name", "Sazzad")
+    db.set("users", "age", 20)
+    db.set_secret("users", "password", "pass123")
+    db.commit()
+except Exception:
+    db.rollback()
+```
+
+---
+
+## 🔗 Relations
+
+```python
+# Add relation
+db.add_relation(
+    name       = "user_orders",
+    from_table = "orders",
+    from_key   = "user_id",
+    to_table   = "users",
+    to_key     = "id"
+)
+
+# Get related records
+related = db.get_related("user_orders", "user_1")
+
+# Validate foreign key
+db.validate_fk("user_orders", "user_1")
+```
+
+---
+
+## 💾 Backup & Restore
+
+```python
+# Backup
+db.backup("backup.hxbak")
+
+# Restore
+db.restore("backup.hxbak")
+```
+
+---
+
+## 📊 Info & Logs
+
+```python
+# Database info
+print(db.info())
+
+# Cache stats
+print(db.cache_stats())
+
+# Read logs
+logs = db.read_logs()
+for log in logs:
+    print(log)
+```
+
+---
+
+## 🖥️ Context Manager
+
+```python
+with HanifXDB("mydata.hxdb") as db:
+    db.create_table("users")
+    db.set("users", "name", "Sazzad")
+# Auto close on exit
+```
+
+---
+
+## 📁 File Format
+
+HanifX DB uses a custom binary `.hxdb` format:
+
+```
+HANIFXDB          ← Magic header (8 bytes)
+Version           ← DB version (4 bytes)
+Timestamps        ← Created / Modified
+Table sections    ← HX_TBL__ + records
+Records           ← HX_REC__ + key + value + checksum
+HX_END__          ← EOF signature
+```
+
+---
+
+## 📋 Supported Data Types
+
+| Type     | Python        | Example                    |
+|----------|---------------|----------------------------|
+| text     | str           | `"Sazzad"`                 |
+| number   | int / float   | `20`, `3.14`               |
+| bool     | bool          | `True`, `False`            |
+| secret   | str (encoded) | `"password123"` → encoded  |
+| file     | str (path)    | `"photo.jpg"` → encoded    |
+| list     | list          | `[1, 2, 3]`                |
+| dict     | dict          | `{"name": "Sazzad"}`       |
+
+---
+
+## ⚡ Query Operators
+
+| Operator   | Meaning              |
+|------------|----------------------|
+| `OP_EQ`    | Equal                |
+| `OP_NEQ`   | Not equal            |
+| `OP_GT`    | Greater than         |
+| `OP_GTE`   | Greater than or equal|
+| `OP_LT`    | Less than            |
+| `OP_LTE`   | Less than or equal   |
+| `OP_IN`    | Value in list        |
+| `OP_NOT_IN`| Value not in list    |
+| `OP_LIKE`  | String contains      |
+| `OP_STARTS`| String starts with   |
+| `OP_ENDS`  | String ends with     |
+
+---
+
+## 📱 Termux Support
+
+```bash
+# Install on Termux (Android)
+pip install hanifx-db
+
+# Use immediately - no extra setup needed
+python3 -c "from hanifxdb import HanifXDB; print('HanifX DB ready!')"
+```
+
+---
+
+## 👨‍💻 Author
+
+**Hanif (HanifX)**
+- PyPI: [habib_bi](https://pypi.org/user/habib_bi)
+- Email: sajim4653@gmail.com
+- Package: [hanifx-db](https://pypi.org/project/hanifx-db)
+
+---
+
+## 📄 License
+
+MIT License — Free to use, modify, and distribute.

hanifx_db-28.0.0/hanifx_db.egg-info/PKG-INFO

@@ -0,0 +1,317 @@
+Metadata-Version: 2.4
+Name: hanifx-db
+Version: 28.0.0
+Summary: HanifX Database Engine — Custom binary database with built-in HanifX security encoding
+Home-page: https://pypi.org/project/hanifx-db
+Author: Hanif
+Author-email: sajim4653@gmail.com
+Project-URL: Source, https://pypi.org/project/hanifx-db
+Project-URL: Tracker, https://pypi.org/project/hanifx-db
+Keywords: database,db,hanifx,security,encoding,encryption,custom-database,binary-format,hxdb,termux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Database
+Classifier: Topic :: Security :: Cryptography
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license-file
+Dynamic: project-url
+Dynamic: requires-python
+Dynamic: summary
+
+# HanifX DB 🗄️
+
+**HanifX Database Engine** — A fully custom binary database built from scratch in pure Python with built-in HanifX security encoding.
+
+[![Version](https://img.shields.io/badge/version-27.0.0-blue)](https://pypi.org/project/hanifx-db)
+[![Python](https://img.shields.io/badge/python-3.6%2B-green)](https://pypi.org/project/hanifx-db)
+[![License](https://img.shields.io/badge/license-MIT-orange)](LICENSE)
+[![Platform](https://img.shields.io/badge/platform-Termux%20%7C%20Linux%20%7C%20Windows%20%7C%20Mac-lightgrey)](https://pypi.org/project/hanifx-db)
+
+---
+
+## ✨ Features
+
+- 🔐 **Built-in HanifX Security** — Irreversible encoding, no external dependency
+- 🗂️ **Multi-Table Support** — Multiple tables in a single `.hxdb` file
+- ⚡ **O(1) Index System** — Custom hash table for fast lookups
+- 🔄 **Transactions + WAL** — Commit, rollback, crash recovery
+- 🗜️ **Custom Compression** — Own RLE + LZ algorithm
+- 🔗 **Relations** — Foreign keys, ONE_TO_ONE, ONE_TO_MANY, MANY_TO_MANY
+- 🔍 **Query Builder** — Fluent query API with 11 operators
+- 💾 **LRU Cache** — Fast repeated reads
+- 📝 **Operation Logging** — Every operation logged to `.hxlog`
+- 📦 **Pure Python** — No external dependencies, works on Termux
+
+---
+
+## 📦 Installation
+
+```bash
+pip install hanifx-db
+```
+
+---
+
+## 🚀 Quick Start
+
+```python
+from hanifxdb import HanifXDB
+
+# Open / Create database
+db = HanifXDB("mydata.hxdb")
+
+# Create table
+db.create_table("users")
+
+# Set plain data
+db.set("users", "name", "Sazzad")
+db.set("users", "age", 20)
+db.set("users", "is_admin", True)
+
+# Set secret data (irreversible HanifX encoding)
+db.set_secret("users", "password", "mypass123")
+
+# Get data
+print(db.get("users", "name"))    # Sazzad
+print(db.get("users", "age"))     # 20
+
+# Verify secret
+if db.verify("users", "password", "mypass123"):
+    print("Login success!")
+
+# Close
+db.close()
+```
+
+---
+
+## 🔐 Security
+
+HanifX DB uses the built-in **HanifX 24.0.0** encoding algorithm:
+
+```python
+# Store secret (irreversible)
+db.set_secret("users", "token", "mytoken123")
+
+# Verify (checksum-based)
+db.verify("users", "token", "mytoken123")   # True
+db.verify("users", "token", "wrongtoken")   # HanifXVerifyError
+
+# Encode file
+db.set_file("users", "photo", "profile.jpg")
+
+# Generate secure token
+token = db.generate_token(32)
+uid   = db.generate_id()
+```
+
+---
+
+## 🗂️ Multi-Table
+
+```python
+db = HanifXDB("shop.hxdb")
+
+db.create_table("users")
+db.create_table("orders")
+db.create_table("products")
+
+db.set("users",    "user_1", {"name": "Sazzad", "age": 20})
+db.set("products", "prod_1", {"name": "Phone",  "price": 500})
+db.set("orders",   "ord_1",  {"user": "user_1", "product": "prod_1"})
+
+print(db.list_tables())   # ['users', 'orders', 'products']
+```
+
+---
+
+## 🔍 Query Builder
+
+```python
+from hanifxdb import OP_GTE, OP_LIKE
+
+# Fluent query
+results = (
+    db.query("users")
+    .where("age", OP_GTE, 18)
+    .where("name", OP_LIKE, "saz")
+    .order_by("age")
+    .limit(10)
+    .execute()
+)
+
+# Shortcuts
+db.find_all("users")
+db.find_one("users", "name", "Sazzad")
+db.find_like("users", "name", "saz")
+db.count("users")
+```
+
+---
+
+## 🔄 Transactions
+
+```python
+db.begin()
+try:
+    db.set("users", "name", "Sazzad")
+    db.set("users", "age", 20)
+    db.set_secret("users", "password", "pass123")
+    db.commit()
+except Exception:
+    db.rollback()
+```
+
+---
+
+## 🔗 Relations
+
+```python
+# Add relation
+db.add_relation(
+    name       = "user_orders",
+    from_table = "orders",
+    from_key   = "user_id",
+    to_table   = "users",
+    to_key     = "id"
+)
+
+# Get related records
+related = db.get_related("user_orders", "user_1")
+
+# Validate foreign key
+db.validate_fk("user_orders", "user_1")
+```
+
+---
+
+## 💾 Backup & Restore
+
+```python
+# Backup
+db.backup("backup.hxbak")
+
+# Restore
+db.restore("backup.hxbak")
+```
+
+---
+
+## 📊 Info & Logs
+
+```python
+# Database info
+print(db.info())
+
+# Cache stats
+print(db.cache_stats())
+
+# Read logs
+logs = db.read_logs()
+for log in logs:
+    print(log)
+```
+
+---
+
+## 🖥️ Context Manager
+
+```python
+with HanifXDB("mydata.hxdb") as db:
+    db.create_table("users")
+    db.set("users", "name", "Sazzad")
+# Auto close on exit
+```
+
+---
+
+## 📁 File Format
+
+HanifX DB uses a custom binary `.hxdb` format:
+
+```
+HANIFXDB          ← Magic header (8 bytes)
+Version           ← DB version (4 bytes)
+Timestamps        ← Created / Modified
+Table sections    ← HX_TBL__ + records
+Records           ← HX_REC__ + key + value + checksum
+HX_END__          ← EOF signature
+```
+
+---
+
+## 📋 Supported Data Types
+
+| Type     | Python        | Example                    |
+|----------|---------------|----------------------------|
+| text     | str           | `"Sazzad"`                 |
+| number   | int / float   | `20`, `3.14`               |
+| bool     | bool          | `True`, `False`            |
+| secret   | str (encoded) | `"password123"` → encoded  |
+| file     | str (path)    | `"photo.jpg"` → encoded    |
+| list     | list          | `[1, 2, 3]`                |
+| dict     | dict          | `{"name": "Sazzad"}`       |
+
+---
+
+## ⚡ Query Operators
+
+| Operator   | Meaning              |
+|------------|----------------------|
+| `OP_EQ`    | Equal                |
+| `OP_NEQ`   | Not equal            |
+| `OP_GT`    | Greater than         |
+| `OP_GTE`   | Greater than or equal|
+| `OP_LT`    | Less than            |
+| `OP_LTE`   | Less than or equal   |
+| `OP_IN`    | Value in list        |
+| `OP_NOT_IN`| Value not in list    |
+| `OP_LIKE`  | String contains      |
+| `OP_STARTS`| String starts with   |
+| `OP_ENDS`  | String ends with     |
+
+---
+
+## 📱 Termux Support
+
+```bash
+# Install on Termux (Android)
+pip install hanifx-db
+
+# Use immediately - no extra setup needed
+python3 -c "from hanifxdb import HanifXDB; print('HanifX DB ready!')"
+```
+
+---
+
+## 👨‍💻 Author
+
+**Hanif (HanifX)**
+- PyPI: [habib_bi](https://pypi.org/user/habib_bi)
+- Email: sajim4653@gmail.com
+- Package: [hanifx-db](https://pypi.org/project/hanifx-db)
+
+---
+
+## 📄 License
+
+MIT License — Free to use, modify, and distribute.

hanifx_db-28.0.0/hanifx_db.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+LICENSE
+README.md
+setup.py
+hanifx_db.egg-info/PKG-INFO
+hanifx_db.egg-info/SOURCES.txt
+hanifx_db.egg-info/dependency_links.txt
+hanifx_db.egg-info/top_level.txt
+tests/__init__.py
+tests/test_all.py

hanifx_db-28.0.0/hanifx_db.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

hanifx_db-28.0.0/hanifx_db.egg-info/top_level.txt

@@ -0,0 +1 @@
+tests

hanifx_db-28.0.0/setup.cfg

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

hanifx_db-28.0.0/setup.py

@@ -0,0 +1,49 @@
+# ============================================================
+#   HanifX DB — setup.py
+#   Author  : Hanif (HanifX)
+#   PyPI    : hanifx-db
+# ============================================================
+
+from setuptools import setup, find_packages
+
+with open("README.md", "r", encoding="utf-8") as f:
+    long_description = f.read()
+
+setup(
+    name             = "hanifx-db",
+    version          = "28.0.0",
+    author           = "Hanif",
+    author_email     = "sajim4653@gmail.com",
+    description      = "HanifX Database Engine — Custom binary database with built-in HanifX security encoding",
+    long_description = long_description,
+    long_description_content_type = "text/markdown",
+    url              = "https://pypi.org/project/hanifx-db",
+    packages         = find_packages(),
+    classifiers      = [
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.6",
+        "Programming Language :: Python :: 3.7",
+        "Programming Language :: Python :: 3.8",
+        "Programming Language :: Python :: 3.9",
+        "Programming Language :: Python :: 3.10",
+        "Programming Language :: Python :: 3.11",
+        "Programming Language :: Python :: 3.12",
+        "Programming Language :: Python :: 3.13",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+        "Topic :: Database",
+        "Topic :: Security :: Cryptography",
+        "Topic :: Software Development :: Libraries :: Python Modules",
+    ],
+    python_requires  = ">=3.6",
+    install_requires = [],   # No external dependencies!
+    keywords         = [
+        "database", "db", "hanifx", "security",
+        "encoding", "encryption", "custom-database",
+        "binary-format", "hxdb", "termux"
+    ],
+    project_urls     = {
+        "Source"   : "https://pypi.org/project/hanifx-db",
+        "Tracker"  : "https://pypi.org/project/hanifx-db",
+    },
+)

hanifx_db-28.0.0/tests/test_all.py

@@ -0,0 +1,340 @@
+# ============================================================
+#   HanifX DB — Full Test Suite
+#   Author  : Hanif (HanifX)
+#   Version : 27.0.0
+# ============================================================
+
+import os
+import sys
+
+sys.path.insert(0, os.path.join(os.path.dirname(__file__), ".."))
+
+from hanifxdb import (
+    HanifXDB,
+    HanifXKeyError,
+    HanifXTableExistsError,
+    HanifXTableNotFoundError,
+    HanifXVerifyError,
+    HanifXTransactionError,
+    OP_EQ, OP_GT, OP_LIKE, OP_IN, OP_GTE,
+    REL_ONE_TO_MANY,
+)
+
+# ── Test Helpers ──────────────────────────────────────────────
+
+PASS  = "✅ PASS"
+FAIL  = "❌ FAIL"
+DB_PATH = "test_hanifx.hxdb"
+
+total  = 0
+passed = 0
+failed = 0
+
+
+def test(name: str, fn):
+    global total, passed, failed
+    total += 1
+    try:
+        fn()
+        print(f"  {PASS} — {name}")
+        passed += 1
+    except Exception as e:
+        print(f"  {FAIL} — {name}")
+        print(f"         Error: {e}")
+        failed += 1
+
+
+def cleanup():
+    for ext in (".hxdb", ".hxwal", ".hxlog", ".hxbak"):
+        path = DB_PATH.replace(".hxdb", ext)
+        if os.path.exists(path):
+            os.remove(path)
+
+
+# ── Tests ─────────────────────────────────────────────────────
+
+def run_tests():
+    global passed, failed, total
+    cleanup()
+    db = HanifXDB(DB_PATH, logging=True)
+
+    print("\n" + "=" * 50)
+    print("  HanifX DB — Test Suite v27.0.0")
+    print("=" * 50)
+
+    # ── 1. Table Tests ────────────────────────────────────────
+    print("\n📋 Table Tests")
+
+    test("Create table", lambda: db.create_table("users"))
+    test("Create second table", lambda: db.create_table("orders"))
+
+    def test_duplicate_table():
+        try:
+            db.create_table("users")
+            assert False, "Should have raised"
+        except HanifXTableExistsError:
+            pass
+
+    test("Duplicate table raises error", test_duplicate_table)
+    test("List tables", lambda: assert_eq(sorted(db.list_tables()), ["orders", "users"]))
+    test("Table exists", lambda: assert_true(db.table_exists("users")))
+    test("Table not exists", lambda: assert_false(db.table_exists("ghost")))
+
+    # ── 2. CRUD Tests ─────────────────────────────────────────
+    print("\n📝 CRUD Tests")
+
+    test("Set string",  lambda: db.set("users", "name", "Sazzad"))
+    test("Set integer", lambda: db.set("users", "age", 20))
+    test("Set float",   lambda: db.set("users", "score", 9.5))
+    test("Set bool",    lambda: db.set("users", "is_admin", True))
+    test("Set list",    lambda: db.set("users", "tags", ["python", "dev"]))
+    test("Set dict",    lambda: db.set("users", "info", {"city": "Chittagong", "country": "BD"}))
+
+    test("Get string",  lambda: assert_eq(db.get("users", "name"), "Sazzad"))
+    test("Get integer", lambda: assert_eq(db.get("users", "age"), 20))
+    test("Get float",   lambda: assert_eq(db.get("users", "score"), 9.5))
+    test("Get bool",    lambda: assert_true(db.get("users", "is_admin")))
+    test("Get list",    lambda: assert_eq(db.get("users", "tags"), ["python", "dev"]))
+    test("Get dict",    lambda: assert_eq(db.get("users", "info")["city"], "Chittagong"))
+
+    def test_key_not_found():
+        try:
+            db.get("users", "ghost_key")
+            assert False, "Should have raised"
+        except HanifXKeyError:
+            pass
+
+    test("Get missing key raises error", test_key_not_found)
+
+    test("Exists true",  lambda: assert_true(db.exists("users", "name")))
+    test("Exists false", lambda: assert_false(db.exists("users", "ghost")))
+
+    test("Update value", lambda: (db.update("users", "age", 21), assert_eq(db.get("users", "age"), 21)))
+
+    test("List keys", lambda: assert_true("name" in db.list_keys("users")))
+
+    test("Delete key", lambda: db.delete("users", "tags"))
+
+    def test_deleted_key():
+        try:
+            db.get("users", "tags")
+            assert False, "Should have raised"
+        except HanifXKeyError:
+            pass
+
+    test("Get deleted key raises error", test_deleted_key)
+
+    # ── 3. Secret Tests ───────────────────────────────────────
+    print("\n🔐 Secret Tests")
+
+    test("Set secret", lambda: db.set_secret("users", "password", "mypass123"))
+    test("Secret stored encoded", lambda: assert_true(
+        isinstance(db.get("users", "password"), dict)
+    ))
+    test("Verify correct password", lambda: assert_true(
+        db.verify("users", "password", "mypass123")
+    ))
+
+    def test_wrong_password():
+        try:
+            db.verify("users", "password", "wrongpass")
+            assert False, "Should have raised"
+        except HanifXVerifyError:
+            pass
+
+    test("Verify wrong password raises error", test_wrong_password)
+    test("List secrets", lambda: assert_true("password" in db.list_secrets("users")))
+
+    # ── 4. Security Utility Tests ─────────────────────────────
+    print("\n🛡️ Security Utility Tests")
+
+    test("Generate token", lambda: assert_true(len(db.generate_token()) == 64))
+    test("Generate ID",    lambda: assert_true(len(db.generate_id()) == 32))
+
+    # ── 5. Query Tests ────────────────────────────────────────
+    print("\n🔍 Query Tests")
+
+    db.set("users", "user2", {"name": "Hanif", "age": 25, "city": "Dhaka"})
+    db.set("users", "user3", {"name": "Samia", "age": 18, "city": "Chittagong"})
+
+    test("Find all", lambda: assert_true(len(db.find_all("users")) > 0))
+
+    test("Query with OP_GT", lambda: assert_true(
+        len(db.query("users").where("age", OP_GT, 18).execute()) > 0
+    ))
+
+    test("Query with OP_LIKE", lambda: assert_true(
+        len(db.query("users").where("name", OP_LIKE, "han").execute()) > 0
+    ))
+
+    test("Query with OP_EQ", lambda: assert_true(
+        len(db.query("users").where("city", OP_EQ, "Dhaka").execute()) > 0
+    ))
+
+    test("Query limit", lambda: assert_true(
+        len(db.query("users").limit(1).execute()) == 1
+    ))
+
+    test("Query count", lambda: assert_true(
+        db.query("users").count() > 0
+    ))
+
+    test("Query first", lambda: assert_true(
+        db.query("users").first() is not None
+    ))
+
+    test("find_one", lambda: assert_true(
+        db.find_one("users", "name", "Sazzad") is not None
+    ))
+
+    test("find_like", lambda: assert_true(
+        len(db.find_like("users", "city", "chit")) > 0
+    ))
+
+    test("count", lambda: assert_true(db.count("users") > 0))
+
+    # ── 6. Transaction Tests ──────────────────────────────────
+    print("\n🔄 Transaction Tests")
+
+    def test_commit():
+        db.begin()
+        db.set("orders", "order_1", {"item": "Phone", "price": 500})
+        db.set("orders", "order_2", {"item": "Laptop", "price": 1000})
+        db.commit()
+        assert db.exists("orders", "order_1")
+        assert db.exists("orders", "order_2")
+
+    test("Transaction commit", test_commit)
+
+    def test_rollback():
+        db.begin()
+        db.set("orders", "order_temp", {"item": "Tablet", "price": 300})
+        db.rollback()
+        assert not db.exists("orders", "order_temp")
+
+    test("Transaction rollback", test_rollback)
+
+    def test_no_tx():
+        try:
+            db.commit()
+            assert False, "Should have raised"
+        except HanifXTransactionError:
+            pass
+
+    test("Commit without begin raises error", test_no_tx)
+
+    # ── 7. Relation Tests ─────────────────────────────────────
+    print("\n🔗 Relation Tests")
+
+    def test_add_relation():
+        db.add_relation(
+            name       = "user_orders",
+            from_table = "orders",
+            from_key   = "user_id",
+            to_table   = "users",
+            to_key     = "id"
+        )
+        assert "user_orders" in db.list_relations()
+
+    test("Add relation", test_add_relation)
+    test("List relations", lambda: assert_true(len(db.list_relations()) > 0))
+
+    # ── 8. Index Tests ────────────────────────────────────────
+    print("\n⚡ Index Tests")
+
+    test("Create index", lambda: db.create_index("users", "name"))
+    test("Drop index",   lambda: db.drop_index("users", "name"))
+
+    # ── 9. Cache Tests ────────────────────────────────────────
+    print("\n💾 Cache Tests")
+
+    test("Cache stats", lambda: assert_true(
+        isinstance(db.cache_stats(), dict)
+    ))
+    test("Clear cache", lambda: db.clear_cache())
+
+    # ── 10. Table Info Tests ──────────────────────────────────
+    print("\n📊 Info Tests")
+
+    test("Table info", lambda: assert_true(
+        isinstance(db.table_info("users"), dict)
+    ))
+    test("DB info", lambda: assert_true(
+        isinstance(db.info(), dict)
+    ))
+    test("DB size", lambda: assert_true(
+        db.info()["size_bytes"] > 0
+    ))
+
+    # ── 11. Backup Tests ──────────────────────────────────────
+    print("\n💿 Backup Tests")
+
+    test("Backup DB", lambda: db.backup("test_backup.hxbak"))
+    test("Backup file exists", lambda: assert_true(
+        os.path.exists("test_backup.hxbak")
+    ))
+
+    # ── 12. Log Tests ─────────────────────────────────────────
+    print("\n📝 Log Tests")
+
+    test("Read logs", lambda: assert_true(
+        isinstance(db.read_logs(), list)
+    ))
+
+    # ── 13. Drop Table Tests ──────────────────────────────────
+    print("\n🗑️ Drop Table Tests")
+
+    db.create_table("temp_table")
+    test("Drop table", lambda: db.drop_table("temp_table"))
+    test("Dropped table not exists", lambda: assert_false(
+        db.table_exists("temp_table")
+    ))
+
+    def test_drop_missing():
+        try:
+            db.drop_table("ghost_table")
+            assert False, "Should have raised"
+        except HanifXTableNotFoundError:
+            pass
+
+    test("Drop missing table raises error", test_drop_missing)
+
+    # ── Close ─────────────────────────────────────────────────
+    db.close()
+    test("Close DB", lambda: assert_true(db._closed))
+
+    # ── Summary ───────────────────────────────────────────────
+    print("\n" + "=" * 50)
+    print(f"  Total  : {total}")
+    print(f"  Passed : {passed} ✅")
+    print(f"  Failed : {failed} ❌")
+    print("=" * 50)
+
+    if failed == 0:
+        print("\n🎉 All tests passed! HanifX DB is ready!")
+    else:
+        print(f"\n⚠️  {failed} test(s) failed. Please check above.")
+
+    # Cleanup
+    cleanup()
+    for f in ("test_backup.hxbak",):
+        if os.path.exists(f):
+            os.remove(f)
+
+
+# ── Assert Helpers ────────────────────────────────────────────
+
+def assert_eq(a, b):
+    assert a == b, f"Expected {b!r}, got {a!r}"
+
+def assert_true(val):
+    assert val, f"Expected True, got {val!r}"
+
+def assert_false(val):
+    assert not val, f"Expected False, got {val!r}"
+
+
+# ── Run ───────────────────────────────────────────────────────
+
+if __name__ == "__main__":
+    run_tests()