motedb-python 0.12.6__cp39-abi3-win_amd64.whl

motedb/__init__.py

@@ -0,0 +1,76 @@
+"""MoteDB — AI-native embedded multimodal database.
+
+Rust-native engine (vectors / full-text / spatial / time-series in one ACID
+store) with a Python-first surface. This wrapper adds Arrow/pandas interop
+on top of the native extension.
+"""
+
+from ._native import *  # noqa: F401,F403
+from ._native import Database as _Database
+
+__version__ = __import__("_native_version_hack", fromlist=[""]) if False else None
+
+
+def _native_version():
+    import motedb._native as _n
+
+    return getattr(_n, "__version__", "0.12.0")
+
+
+__version__ = _native_version()
+
+
+def query_arrow(self, sql, params=None):
+    """Run a SELECT and return a pyarrow.Table.
+
+    Columnar columns ride numpy (zero-copy where the engine already built
+    arrays); VECTOR columns become FixedSizeListArray(float32). Requires
+    pyarrow (`pip install pyarrow`).
+    """
+    import pyarrow as pa
+
+    cols, data = self.fetch_arrays(sql, params=params)
+    arrays = []
+    for c in cols:
+        v = data[c]
+        # VECTOR columns: 2D numpy (fast path) or a list of equal-length
+        # lists → FixedSizeListArray(float32), the canonical Arrow vector
+        # representation.
+        try:
+            import numpy as _np
+
+            if isinstance(v, _np.ndarray) and v.ndim == 2:
+                flat = _np.ascontiguousarray(v, dtype=_np.float32).reshape(-1)
+                arrays.append(
+                    pa.FixedSizeListArray.from_arrays(pa.array(flat), v.shape[1])
+                )
+                continue
+        except ImportError:
+            pass
+        if isinstance(v, list) and v and isinstance(v[0], (list, tuple)):
+            dim = len(v[0])
+            if all(len(x) == dim for x in v):
+                flat = [f for row in v for f in row]
+                arrays.append(
+                    pa.FixedSizeListArray.from_arrays(pa.array(flat, type=pa.float32()), dim)
+                )
+                continue
+        arrays.append(pa.array(v))
+    return pa.Table.from_arrays(arrays, names=list(cols))
+
+
+def query_pandas(self, sql, params=None):
+    """Run a SELECT and return a pandas.DataFrame (via Arrow)."""
+    try:
+        import pandas as pd
+    except ImportError as e:  # pragma: no cover
+        raise ImportError("query_pandas requires pandas (`pip install pandas`)") from e
+    return self.query_arrow(sql, params=params).to_pandas()
+
+
+# Attach the interop methods to the pyo3 Database class (heap type — setattr
+# on the class works; verified in test).
+_Database.query_arrow = query_arrow
+_Database.query_pandas = query_pandas
+
+__all__ = [n for n in dir() if not n.startswith("_")]

motedb_python-0.12.6.dist-info/METADATA

@@ -0,0 +1,109 @@
+Metadata-Version: 2.4
+Name: motedb-python
+Version: 0.12.6
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Rust
+Classifier: Programming Language :: Python :: 3
+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: Programming Language :: Python :: Implementation :: CPython
+Classifier: Topic :: Database
+Classifier: Topic :: Database :: Database Engines/Servers
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+License-File: licenses/LICENSE
+Summary: AI-native embedded multimodal database — SQL, vectors, full-text, spatial and time-series in one ACID engine, with edge presets for robots and edge devices.
+Keywords: database,embedded-database,vector-search,full-text-search,spatial,time-series,rag,robotics,edge-ai,sql
+License: MIT
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: Changelog, https://github.com/motedb/motedb/blob/main/CHANGELOG.md
+Project-URL: Documentation, https://github.com/motedb/motedb/tree/main/bindings/python
+Project-URL: Homepage, https://github.com/motedb/motedb
+Project-URL: Issues, https://github.com/motedb/motedb/issues
+Project-URL: Repository, https://github.com/motedb/motedb
+Project-URL: Source, https://github.com/motedb/motedb
+
+# MoteDB Python Bindings
+
+Embedded multimodal database for Python — SQL + vector search + full-text
+search + spatial in one engine, with edge-presets for memory-constrained
+devices.
+
+## Install (from source)
+
+```bash
+pip install maturin
+cd bindings/python
+maturin develop --release
+# no maturin / offline? scripts/build_wheel.sh builds a wheel with cargo+zip
+```
+
+## Quick start
+
+```python
+import motedb
+
+db = motedb.Database("/data/store.mote", preset="edge")   # general|edge|robotics|embodied
+db.execute("CREATE TABLE IF NOT EXISTS docs (id INT PRIMARY KEY AUTO_INCREMENT, text TEXT, emb VECTOR(384))")
+db.execute("INSERT INTO docs (text, emb) VALUES (?, ?)", params=["hello world", [0.1] * 384])
+
+rows = db.execute("SELECT id, text FROM docs WHERE text MATCH AGAINST('hello')")   # list[dict]
+cols, tuples = db.query("SELECT id, text FROM docs")                               # (columns, list[tuple])
+
+# Vector ANN — literal or parameter vectors both order correctly:
+near = db.execute("SELECT id FROM docs ORDER BY emb <-> ? LIMIT 5", params=[[0.1] * 384])
+
+tx = db.begin()
+db.execute("UPDATE docs SET text = ? WHERE id = 1", params=["hi"])
+db.rollback(tx)          # or db.commit(tx)
+
+db.checkpoint()          # durability point
+db.close()
+```
+
+## API
+
+| Method | Notes |
+|---|---|
+| `Database(path, preset=None, create=True)` | create-or-open |
+| `execute(sql, params=None)` | SELECT → `list[dict]`; DML → affected count; DDL → None |
+| `query(sql, params=None)` | SELECT → `(columns, list[tuple])` |
+| `executemany(sql, params)` | one INSERT per parameter set — single WAL fsync per batch |
+| `begin()/commit(tx)/rollback(tx)` | transactions |
+| `doctor()` | self-check → `{"verdict", "checks": [{name,status,detail}]}` |
+| `checkpoint()/vacuum()/close()` | lifecycle |
+
+Parameter types: `None/bool/int/float/str/list[float]` (→ embedding vector),
+and geometry dicts for GEOMETRY columns:
+`{"type": "Point3D", "x": 1.0, "y": -2.0, "z": 0.5}`,
+`{"type": "Point", "x": 1.0, "y": -2.0}`,
+`{"type": "LineString"|"Polygon", "points": [[x, y], ...]}`.
+Result types: `None/bool/int/float/str/list[float]` (vector), timestamp as
+int microseconds, geometry as the same dict shapes (tensor still renders as
+a `<tensor>` tag).
+
+## Benchmark
+
+`bench/bench_edge.py` — reproducible edge-workload comparison vs stdlib
+SQLite (see `bench/README.md` for methodology and reference numbers: point
+2.9×, filter 3.7×, GROUP BY 9.8×, ANN 3.2×, RSS −12%; honest loss on batch
+insert).
+
+## Publishing
+
+Wheels for 4 targets are built by `.github/workflows/python-wheels.yml` on
+tag push; PyPI publishing uses Trusted Publisher (register the repo at
+pypi.org → no token secret needed).
+
+## Known gaps (pre-1.0)
+
+- Tensor/Spatial/TextDoc values pass through as tags, not Python objects.
+

motedb_python-0.12.6.dist-info/RECORD

@@ -0,0 +1,7 @@
+motedb/__init__.py,sha256=RdshS60ZfD_9c96Xp7aFL3sQ1zXJdiPgfFE9oS5iQOc,2665
+motedb/_native.pyd,sha256=7oVUdCCG9THMnUZU6ahNDL6G9pc0i-55gIgpj6Sew7M,9453056
+motedb_python-0.12.6.dist-info/METADATA,sha256=aSVcuuEdEEodA5f2t5fIZpfRzIceF-US52QR4UIYuWo,4601
+motedb_python-0.12.6.dist-info/WHEEL,sha256=xe4_tbg8wYdeh4O7nLbnWckzIQtCR4nODDgwke_TKy8,95
+motedb_python-0.12.6.dist-info/licenses/licenses/LICENSE,sha256=XfL-D6vY6IcKiBSg3yzflH9sPq7bSHrVxwVefuCR-YU,1084
+motedb_python-0.12.6.dist-info/sboms/motedb-python.cyclonedx.json,sha256=-iCR13hwrv_Q3goKpdJno-cNZCkG8sCk-7F5kvZ-xcE,114572
+motedb_python-0.12.6.dist-info/RECORD,,

motedb_python-0.12.6.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: maturin (1.15.0)
+Root-Is-Purelib: false
+Tag: cp39-abi3-win_amd64

motedb_python-0.12.6.dist-info/licenses/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 motedb
+
+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.