overdrive-db 1.0.1__tar.gz

overdrive_db-1.0.1/MANIFEST.in

@@ -0,0 +1,3 @@
+include README.md
+include LICENSE
+recursive-include overdrive *.py *.dll *.so *.dylib

overdrive_db-1.0.1/PKG-INFO

@@ -0,0 +1,114 @@
+Metadata-Version: 2.4
+Name: overdrive-db
+Version: 1.0.1
+Summary: Embeddable document database — like SQLite for JSON
+Author-email: ALL FOR ONE TECH <admin@afot.in>
+License: MIT OR Apache-2.0
+Project-URL: Homepage, https://github.com/ALL-FOR-ONE-TECH/OverDrive-DB_SDK
+Project-URL: Documentation, https://github.com/ALL-FOR-ONE-TECH/OverDrive-DB_SDK/blob/main/docs/python-guide.md
+Project-URL: Repository, https://github.com/ALL-FOR-ONE-TECH/OverDrive-DB_SDK
+Project-URL: Bug Tracker, https://github.com/ALL-FOR-ONE-TECH/OverDrive-DB_SDK/issues
+Project-URL: Downloads, https://github.com/ALL-FOR-ONE-TECH/OverDrive-DB_SDK/releases
+Keywords: database,document,json,sql,embedded,nosql,sqlite
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Programming Language :: Python :: 3
+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: Topic :: Database
+Classifier: Topic :: Database :: Database Engines/Servers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# OverDrive InCode SDK — Python
+
+**Embeddable document database — like SQLite for JSON.**
+
+Import the package. Open a file. Query your data. *No server needed.*
+
+## Install
+
+```bash
+pip install overdrive-db
+```
+
+After installing, download the native library for your platform from
+[GitHub Releases](https://github.com/ALL-FOR-ONE-TECH/OverDrive-DB_SDK/releases/latest)
+and place it in your project directory or on your system PATH.
+
+| Platform | File |
+|---|---|
+| Windows x64 | `overdrive-windows-x64.dll` → rename to `overdrive.dll` |
+| Linux x64 | `liboverdrive-linux-x64.so` → rename to `liboverdrive.so` |
+| macOS ARM64 | `liboverdrive-macos-arm64.dylib` → rename to `liboverdrive.dylib` |
+
+## Quick Start
+
+```python
+from overdrive import OverDrive
+
+# Context manager for automatic cleanup
+with OverDrive("myapp.odb") as db:
+    db.create_table("users")
+
+    # Insert
+    user_id = db.insert("users", {
+        "name": "Alice",
+        "email": "alice@example.com",
+        "age": 30
+    })
+
+    # SQL Query
+    results = db.query("SELECT * FROM users WHERE age > 25")
+    for row in results:
+        print(f"  {row['name']} — {row['email']}")
+
+    # Full-text search
+    matches = db.search("users", "alice")
+
+    # Batch insert
+    db.insert_many("users", [
+        {"name": "Bob", "age": 25},
+        {"name": "Charlie", "age": 35},
+    ])
+
+    print(f"Total users: {db.count('users')}")
+```
+
+## API
+
+| Method | Description |
+|---|---|
+| `OverDrive(path)` | Open or create a database |
+| `db.close()` | Close the database |
+| `db.create_table(name)` | Create a table |
+| `db.drop_table(name)` | Drop a table |
+| `db.list_tables()` | List all tables |
+| `db.insert(table, doc)` | Insert a document, returns `_id` |
+| `db.insert_many(table, docs)` | Batch insert |
+| `db.get(table, id)` | Get by `_id` |
+| `db.update(table, id, updates)` | Update fields |
+| `db.delete(table, id)` | Delete by `_id` |
+| `db.count(table)` | Count documents |
+| `db.query(sql)` | Execute SQL query |
+| `db.search(table, text)` | Full-text search |
+
+## Links
+
+- [Full Documentation](https://github.com/ALL-FOR-ONE-TECH/OverDrive-DB_SDK/blob/main/docs/python-guide.md)
+- [GitHub](https://github.com/ALL-FOR-ONE-TECH/OverDrive-DB_SDK)
+- [Releases](https://github.com/ALL-FOR-ONE-TECH/OverDrive-DB_SDK/releases)
+
+## License
+
+MIT / Apache-2.0

overdrive_db-1.0.1/README.md

@@ -0,0 +1,82 @@
+# OverDrive InCode SDK — Python
+
+**Embeddable document database — like SQLite for JSON.**
+
+Import the package. Open a file. Query your data. *No server needed.*
+
+## Install
+
+```bash
+pip install overdrive-db
+```
+
+After installing, download the native library for your platform from
+[GitHub Releases](https://github.com/ALL-FOR-ONE-TECH/OverDrive-DB_SDK/releases/latest)
+and place it in your project directory or on your system PATH.
+
+| Platform | File |
+|---|---|
+| Windows x64 | `overdrive-windows-x64.dll` → rename to `overdrive.dll` |
+| Linux x64 | `liboverdrive-linux-x64.so` → rename to `liboverdrive.so` |
+| macOS ARM64 | `liboverdrive-macos-arm64.dylib` → rename to `liboverdrive.dylib` |
+
+## Quick Start
+
+```python
+from overdrive import OverDrive
+
+# Context manager for automatic cleanup
+with OverDrive("myapp.odb") as db:
+    db.create_table("users")
+
+    # Insert
+    user_id = db.insert("users", {
+        "name": "Alice",
+        "email": "alice@example.com",
+        "age": 30
+    })
+
+    # SQL Query
+    results = db.query("SELECT * FROM users WHERE age > 25")
+    for row in results:
+        print(f"  {row['name']} — {row['email']}")
+
+    # Full-text search
+    matches = db.search("users", "alice")
+
+    # Batch insert
+    db.insert_many("users", [
+        {"name": "Bob", "age": 25},
+        {"name": "Charlie", "age": 35},
+    ])
+
+    print(f"Total users: {db.count('users')}")
+```
+
+## API
+
+| Method | Description |
+|---|---|
+| `OverDrive(path)` | Open or create a database |
+| `db.close()` | Close the database |
+| `db.create_table(name)` | Create a table |
+| `db.drop_table(name)` | Drop a table |
+| `db.list_tables()` | List all tables |
+| `db.insert(table, doc)` | Insert a document, returns `_id` |
+| `db.insert_many(table, docs)` | Batch insert |
+| `db.get(table, id)` | Get by `_id` |
+| `db.update(table, id, updates)` | Update fields |
+| `db.delete(table, id)` | Delete by `_id` |
+| `db.count(table)` | Count documents |
+| `db.query(sql)` | Execute SQL query |
+| `db.search(table, text)` | Full-text search |
+
+## Links
+
+- [Full Documentation](https://github.com/ALL-FOR-ONE-TECH/OverDrive-DB_SDK/blob/main/docs/python-guide.md)
+- [GitHub](https://github.com/ALL-FOR-ONE-TECH/OverDrive-DB_SDK)
+- [Releases](https://github.com/ALL-FOR-ONE-TECH/OverDrive-DB_SDK/releases)
+
+## License
+
+MIT / Apache-2.0

overdrive_db-1.0.1/overdrive/__init__.py

@@ -0,0 +1,348 @@
+"""
+OverDrive InCode SDK — Python Wrapper
+Embeddable document database. Like SQLite for JSON.
+
+Usage:
+    from overdrive import OverDrive
+
+    db = OverDrive("myapp.odb")
+    db.create_table("users")
+    db.insert("users", {"name": "Alice", "age": 30})
+    results = db.query("SELECT * FROM users WHERE age > 25")
+    db.close()
+"""
+
+import ctypes
+import json
+import os
+import platform
+import sys
+from pathlib import Path
+from typing import Any, Dict, List, Optional, Union
+
+
+def _find_library() -> str:
+    """Find the overdrive shared library."""
+    system = platform.system()
+    if system == "Windows":
+        lib_name = "overdrive.dll"
+    elif system == "Darwin":
+        lib_name = "liboverdrive.dylib"
+    else:
+        lib_name = "liboverdrive.so"
+
+    # Search paths
+    search_paths = [
+        Path(__file__).parent / lib_name,
+        Path(__file__).parent / "lib" / lib_name,
+        Path(__file__).parent.parent / "target" / "release" / lib_name,
+        Path(__file__).parent.parent.parent / "target" / "release" / lib_name,
+    ]
+
+    for path in search_paths:
+        if path.exists():
+            return str(path)
+
+    # Try system path
+    return lib_name
+
+
+class _Native:
+    """Low-level ctypes bindings to liboverdrive."""
+
+    def __init__(self):
+        lib_path = _find_library()
+        self.lib = ctypes.cdll.LoadLibrary(lib_path)
+
+        # Lifecycle
+        self.lib.overdrive_open.argtypes = [ctypes.c_char_p]
+        self.lib.overdrive_open.restype = ctypes.c_void_p
+
+        self.lib.overdrive_close.argtypes = [ctypes.c_void_p]
+        self.lib.overdrive_close.restype = None
+
+        self.lib.overdrive_sync.argtypes = [ctypes.c_void_p]
+        self.lib.overdrive_sync.restype = None
+
+        # Tables
+        self.lib.overdrive_create_table.argtypes = [ctypes.c_void_p, ctypes.c_char_p]
+        self.lib.overdrive_create_table.restype = ctypes.c_int
+
+        self.lib.overdrive_drop_table.argtypes = [ctypes.c_void_p, ctypes.c_char_p]
+        self.lib.overdrive_drop_table.restype = ctypes.c_int
+
+        self.lib.overdrive_list_tables.argtypes = [ctypes.c_void_p]
+        self.lib.overdrive_list_tables.restype = ctypes.c_void_p
+
+        self.lib.overdrive_table_exists.argtypes = [ctypes.c_void_p, ctypes.c_char_p]
+        self.lib.overdrive_table_exists.restype = ctypes.c_int
+
+        # CRUD
+        self.lib.overdrive_insert.argtypes = [ctypes.c_void_p, ctypes.c_char_p, ctypes.c_char_p]
+        self.lib.overdrive_insert.restype = ctypes.c_void_p
+
+        self.lib.overdrive_get.argtypes = [ctypes.c_void_p, ctypes.c_char_p, ctypes.c_char_p]
+        self.lib.overdrive_get.restype = ctypes.c_void_p
+
+        self.lib.overdrive_update.argtypes = [ctypes.c_void_p, ctypes.c_char_p, ctypes.c_char_p, ctypes.c_char_p]
+        self.lib.overdrive_update.restype = ctypes.c_int
+
+        self.lib.overdrive_delete.argtypes = [ctypes.c_void_p, ctypes.c_char_p, ctypes.c_char_p]
+        self.lib.overdrive_delete.restype = ctypes.c_int
+
+        self.lib.overdrive_count.argtypes = [ctypes.c_void_p, ctypes.c_char_p]
+        self.lib.overdrive_count.restype = ctypes.c_int
+
+        # Query
+        self.lib.overdrive_query.argtypes = [ctypes.c_void_p, ctypes.c_char_p]
+        self.lib.overdrive_query.restype = ctypes.c_void_p
+
+        self.lib.overdrive_search.argtypes = [ctypes.c_void_p, ctypes.c_char_p, ctypes.c_char_p]
+        self.lib.overdrive_search.restype = ctypes.c_void_p
+
+        # Utility
+        self.lib.overdrive_last_error.argtypes = []
+        self.lib.overdrive_last_error.restype = ctypes.c_char_p
+
+        self.lib.overdrive_free_string.argtypes = [ctypes.c_void_p]
+        self.lib.overdrive_free_string.restype = None
+
+        self.lib.overdrive_version.argtypes = []
+        self.lib.overdrive_version.restype = ctypes.c_char_p
+
+
+_native = None
+
+
+def _get_native() -> _Native:
+    global _native
+    if _native is None:
+        _native = _Native()
+    return _native
+
+
+def _check_error(native: _Native):
+    """Check for and raise the last error."""
+    err = native.lib.overdrive_last_error()
+    if err:
+        raise OverDriveError(err.decode("utf-8"))
+
+
+def _read_and_free(native: _Native, ptr) -> Optional[str]:
+    """Read a C string and free it."""
+    if not ptr:
+        return None
+    try:
+        s = ctypes.cast(ptr, ctypes.c_char_p).value
+        return s.decode("utf-8") if s else None
+    finally:
+        native.lib.overdrive_free_string(ptr)
+
+
+class OverDriveError(Exception):
+    """Exception raised by OverDrive operations."""
+    pass
+
+
+class OverDrive:
+    """
+    OverDrive InCode SDK — Embeddable Document Database
+
+    Usage:
+        db = OverDrive("myapp.odb")
+        db.create_table("users")
+        db.insert("users", {"name": "Alice", "age": 30})
+        results = db.query("SELECT * FROM users WHERE age > 25")
+        db.close()
+
+    Context manager:
+        with OverDrive("myapp.odb") as db:
+            db.insert("logs", {"event": "startup"})
+    """
+
+    def __init__(self, path: str):
+        self._native = _get_native()
+        self._handle = self._native.lib.overdrive_open(path.encode("utf-8"))
+        if not self._handle:
+            _check_error(self._native)
+            raise OverDriveError(f"Failed to open database: {path}")
+        self._path = path
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, *args):
+        self.close()
+
+    def __del__(self):
+        try:
+            self.close()
+        except Exception:
+            pass
+
+    # ── Lifecycle ───────────────────────────────
+
+    def close(self):
+        """Close the database and release resources."""
+        if self._handle:
+            self._native.lib.overdrive_close(self._handle)
+            self._handle = None
+
+    def sync(self):
+        """Force sync data to disk."""
+        self._ensure_open()
+        self._native.lib.overdrive_sync(self._handle)
+
+    @property
+    def path(self) -> str:
+        return self._path
+
+    @staticmethod
+    def version() -> str:
+        native = _get_native()
+        v = native.lib.overdrive_version()
+        return v.decode("utf-8") if v else "unknown"
+
+    # ── Tables ──────────────────────────────────
+
+    def create_table(self, name: str):
+        """Create a new table."""
+        self._ensure_open()
+        result = self._native.lib.overdrive_create_table(self._handle, name.encode("utf-8"))
+        if result != 0:
+            _check_error(self._native)
+
+    def drop_table(self, name: str):
+        """Drop a table."""
+        self._ensure_open()
+        result = self._native.lib.overdrive_drop_table(self._handle, name.encode("utf-8"))
+        if result != 0:
+            _check_error(self._native)
+
+    def list_tables(self) -> List[str]:
+        """List all tables."""
+        self._ensure_open()
+        ptr = self._native.lib.overdrive_list_tables(self._handle)
+        if not ptr:
+            _check_error(self._native)
+            return []
+        result = _read_and_free(self._native, ptr)
+        return json.loads(result) if result else []
+
+    def table_exists(self, name: str) -> bool:
+        """Check if a table exists."""
+        self._ensure_open()
+        result = self._native.lib.overdrive_table_exists(self._handle, name.encode("utf-8"))
+        return result == 1
+
+    # ── CRUD ────────────────────────────────────
+
+    def insert(self, table: str, doc: Dict[str, Any]) -> str:
+        """Insert a document. Returns the _id."""
+        self._ensure_open()
+        json_str = json.dumps(doc)
+        ptr = self._native.lib.overdrive_insert(
+            self._handle,
+            table.encode("utf-8"),
+            json_str.encode("utf-8"),
+        )
+        if not ptr:
+            _check_error(self._native)
+            raise OverDriveError("Insert failed")
+        result = _read_and_free(self._native, ptr)
+        return result or ""
+
+    def insert_many(self, table: str, docs: List[Dict[str, Any]]) -> List[str]:
+        """Insert multiple documents. Returns list of _ids."""
+        return [self.insert(table, doc) for doc in docs]
+
+    def get(self, table: str, id: str) -> Optional[Dict[str, Any]]:
+        """Get a document by _id."""
+        self._ensure_open()
+        ptr = self._native.lib.overdrive_get(
+            self._handle,
+            table.encode("utf-8"),
+            id.encode("utf-8"),
+        )
+        if not ptr:
+            return None
+        result = _read_and_free(self._native, ptr)
+        return json.loads(result) if result else None
+
+    def update(self, table: str, id: str, updates: Dict[str, Any]) -> bool:
+        """Update a document by _id."""
+        self._ensure_open()
+        json_str = json.dumps(updates)
+        result = self._native.lib.overdrive_update(
+            self._handle,
+            table.encode("utf-8"),
+            id.encode("utf-8"),
+            json_str.encode("utf-8"),
+        )
+        if result == -1:
+            _check_error(self._native)
+        return result == 1
+
+    def delete(self, table: str, id: str) -> bool:
+        """Delete a document by _id."""
+        self._ensure_open()
+        result = self._native.lib.overdrive_delete(
+            self._handle,
+            table.encode("utf-8"),
+            id.encode("utf-8"),
+        )
+        if result == -1:
+            _check_error(self._native)
+        return result == 1
+
+    def count(self, table: str) -> int:
+        """Count documents in a table."""
+        self._ensure_open()
+        result = self._native.lib.overdrive_count(self._handle, table.encode("utf-8"))
+        if result == -1:
+            _check_error(self._native)
+        return max(0, result)
+
+    # ── Query ───────────────────────────────────
+
+    def query(self, sql: str) -> List[Dict[str, Any]]:
+        """Execute SQL query. Returns list of result rows."""
+        self._ensure_open()
+        ptr = self._native.lib.overdrive_query(self._handle, sql.encode("utf-8"))
+        if not ptr:
+            _check_error(self._native)
+            return []
+        result = _read_and_free(self._native, ptr)
+        if not result:
+            return []
+        parsed = json.loads(result)
+        return parsed.get("rows", [])
+
+    def query_full(self, sql: str) -> Dict[str, Any]:
+        """Execute SQL query. Returns full result with metadata."""
+        self._ensure_open()
+        ptr = self._native.lib.overdrive_query(self._handle, sql.encode("utf-8"))
+        if not ptr:
+            _check_error(self._native)
+            return {"rows": [], "columns": [], "rows_affected": 0}
+        result = _read_and_free(self._native, ptr)
+        return json.loads(result) if result else {}
+
+    def search(self, table: str, text: str) -> List[Dict[str, Any]]:
+        """Full-text search."""
+        self._ensure_open()
+        ptr = self._native.lib.overdrive_search(
+            self._handle,
+            table.encode("utf-8"),
+            text.encode("utf-8"),
+        )
+        if not ptr:
+            return []
+        result = _read_and_free(self._native, ptr)
+        return json.loads(result) if result else []
+
+    # ── Internal ────────────────────────────────
+
+    def _ensure_open(self):
+        if not self._handle:
+            raise OverDriveError("Database is closed")

overdrive_db-1.0.1/overdrive/download.py

@@ -0,0 +1,74 @@
+"""
+Helper to download the OverDrive native binary from GitHub Releases.
+
+Usage:
+    python -m overdrive.download
+
+Or in code:
+    from overdrive.download import ensure_binary
+    ensure_binary()
+"""
+
+import os
+import platform
+import sys
+import urllib.request
+from pathlib import Path
+
+REPO = "ALL-FOR-ONE-TECH/OverDrive-DB_SDK"
+VERSION = "v1.0.1"
+
+
+def get_binary_info():
+    """Get the correct binary name for the current platform."""
+    system = platform.system()
+    if system == "Windows":
+        return "overdrive-windows-x64.dll", "overdrive.dll"
+    elif system == "Darwin":
+        return "liboverdrive-macos-arm64.dylib", "liboverdrive.dylib"
+    else:
+        return "liboverdrive-linux-x64.so", "liboverdrive.so"
+
+
+def ensure_binary(target_dir: str = None) -> str:
+    """
+    Download the native binary if not already present.
+    
+    Args:
+        target_dir: Directory to place the binary. Defaults to package directory.
+    
+    Returns:
+        Path to the binary.
+    """
+    remote_name, local_name = get_binary_info()
+
+    if target_dir is None:
+        target_dir = str(Path(__file__).parent)
+
+    dest = os.path.join(target_dir, local_name)
+
+    if os.path.exists(dest):
+        print(f"✓ overdrive: Binary already present ({local_name})")
+        return dest
+
+    url = f"https://github.com/{REPO}/releases/download/{VERSION}/{remote_name}"
+    print(f"⬇ overdrive: Downloading {remote_name}...")
+
+    try:
+        urllib.request.urlretrieve(url, dest)
+        size_mb = os.path.getsize(dest) / (1024 * 1024)
+        print(f"✓ overdrive: Downloaded {local_name} ({size_mb:.1f} MB)")
+        return dest
+    except Exception as e:
+        print(f"⚠ overdrive: Download failed: {e}")
+        print(f"  Download manually from: https://github.com/{REPO}/releases/tag/{VERSION}")
+        print(f"  Place the binary in: {target_dir}/")
+        return ""
+
+
+if __name__ == "__main__":
+    path = ensure_binary()
+    if path:
+        print(f"\nBinary ready at: {path}")
+    else:
+        sys.exit(1)

overdrive_db-1.0.1/overdrive_db.egg-info/PKG-INFO

@@ -0,0 +1,114 @@
+Metadata-Version: 2.4
+Name: overdrive-db
+Version: 1.0.1
+Summary: Embeddable document database — like SQLite for JSON
+Author-email: ALL FOR ONE TECH <admin@afot.in>
+License: MIT OR Apache-2.0
+Project-URL: Homepage, https://github.com/ALL-FOR-ONE-TECH/OverDrive-DB_SDK
+Project-URL: Documentation, https://github.com/ALL-FOR-ONE-TECH/OverDrive-DB_SDK/blob/main/docs/python-guide.md
+Project-URL: Repository, https://github.com/ALL-FOR-ONE-TECH/OverDrive-DB_SDK
+Project-URL: Bug Tracker, https://github.com/ALL-FOR-ONE-TECH/OverDrive-DB_SDK/issues
+Project-URL: Downloads, https://github.com/ALL-FOR-ONE-TECH/OverDrive-DB_SDK/releases
+Keywords: database,document,json,sql,embedded,nosql,sqlite
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Programming Language :: Python :: 3
+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: Topic :: Database
+Classifier: Topic :: Database :: Database Engines/Servers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# OverDrive InCode SDK — Python
+
+**Embeddable document database — like SQLite for JSON.**
+
+Import the package. Open a file. Query your data. *No server needed.*
+
+## Install
+
+```bash
+pip install overdrive-db
+```
+
+After installing, download the native library for your platform from
+[GitHub Releases](https://github.com/ALL-FOR-ONE-TECH/OverDrive-DB_SDK/releases/latest)
+and place it in your project directory or on your system PATH.
+
+| Platform | File |
+|---|---|
+| Windows x64 | `overdrive-windows-x64.dll` → rename to `overdrive.dll` |
+| Linux x64 | `liboverdrive-linux-x64.so` → rename to `liboverdrive.so` |
+| macOS ARM64 | `liboverdrive-macos-arm64.dylib` → rename to `liboverdrive.dylib` |
+
+## Quick Start
+
+```python
+from overdrive import OverDrive
+
+# Context manager for automatic cleanup
+with OverDrive("myapp.odb") as db:
+    db.create_table("users")
+
+    # Insert
+    user_id = db.insert("users", {
+        "name": "Alice",
+        "email": "alice@example.com",
+        "age": 30
+    })
+
+    # SQL Query
+    results = db.query("SELECT * FROM users WHERE age > 25")
+    for row in results:
+        print(f"  {row['name']} — {row['email']}")
+
+    # Full-text search
+    matches = db.search("users", "alice")
+
+    # Batch insert
+    db.insert_many("users", [
+        {"name": "Bob", "age": 25},
+        {"name": "Charlie", "age": 35},
+    ])
+
+    print(f"Total users: {db.count('users')}")
+```
+
+## API
+
+| Method | Description |
+|---|---|
+| `OverDrive(path)` | Open or create a database |
+| `db.close()` | Close the database |
+| `db.create_table(name)` | Create a table |
+| `db.drop_table(name)` | Drop a table |
+| `db.list_tables()` | List all tables |
+| `db.insert(table, doc)` | Insert a document, returns `_id` |
+| `db.insert_many(table, docs)` | Batch insert |
+| `db.get(table, id)` | Get by `_id` |
+| `db.update(table, id, updates)` | Update fields |
+| `db.delete(table, id)` | Delete by `_id` |
+| `db.count(table)` | Count documents |
+| `db.query(sql)` | Execute SQL query |
+| `db.search(table, text)` | Full-text search |
+
+## Links
+
+- [Full Documentation](https://github.com/ALL-FOR-ONE-TECH/OverDrive-DB_SDK/blob/main/docs/python-guide.md)
+- [GitHub](https://github.com/ALL-FOR-ONE-TECH/OverDrive-DB_SDK)
+- [Releases](https://github.com/ALL-FOR-ONE-TECH/OverDrive-DB_SDK/releases)
+
+## License
+
+MIT / Apache-2.0

overdrive_db-1.0.1/overdrive_db.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+MANIFEST.in
+README.md
+pyproject.toml
+overdrive/__init__.py
+overdrive/download.py
+overdrive_db.egg-info/PKG-INFO
+overdrive_db.egg-info/SOURCES.txt
+overdrive_db.egg-info/dependency_links.txt
+overdrive_db.egg-info/top_level.txt

overdrive_db-1.0.1/overdrive_db.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

overdrive_db-1.0.1/overdrive_db.egg-info/top_level.txt

@@ -0,0 +1 @@
+overdrive

overdrive_db-1.0.1/pyproject.toml

@@ -0,0 +1,47 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "overdrive-db"
+version = "1.0.1"
+description = "Embeddable document database — like SQLite for JSON"
+readme = "README.md"
+license = {text = "MIT OR Apache-2.0"}
+requires-python = ">=3.8"
+authors = [
+    {name = "ALL FOR ONE TECH", email = "admin@afot.in"}
+]
+keywords = ["database", "document", "json", "sql", "embedded", "nosql", "sqlite"]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "License :: OSI Approved :: Apache Software License",
+    "Operating System :: Microsoft :: Windows",
+    "Operating System :: POSIX :: Linux",
+    "Operating System :: MacOS :: MacOS X",
+    "Programming Language :: Python :: 3",
+    "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",
+    "Topic :: Database",
+    "Topic :: Database :: Database Engines/Servers",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+
+[project.urls]
+Homepage = "https://github.com/ALL-FOR-ONE-TECH/OverDrive-DB_SDK"
+Documentation = "https://github.com/ALL-FOR-ONE-TECH/OverDrive-DB_SDK/blob/main/docs/python-guide.md"
+Repository = "https://github.com/ALL-FOR-ONE-TECH/OverDrive-DB_SDK"
+"Bug Tracker" = "https://github.com/ALL-FOR-ONE-TECH/OverDrive-DB_SDK/issues"
+Downloads = "https://github.com/ALL-FOR-ONE-TECH/OverDrive-DB_SDK/releases"
+
+[tool.setuptools.packages.find]
+include = ["overdrive*"]
+
+[tool.setuptools.package-data]
+overdrive = ["*.dll", "*.so", "*.dylib"]

overdrive_db-1.0.1/setup.cfg

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