metta-sqlite 0.9.2__py3-none-any.whl

metta_sqlite-0.9.2.dist-info/METADATA

@@ -0,0 +1,31 @@
+Metadata-Version: 2.4
+Name: metta-sqlite
+Version: 0.9.2
+Summary: sqlite3 as a SQL engine a MeTTa head can be registered into
+License-Expression: MIT
+Classifier: Development Status :: 3 - Alpha
+Classifier: Programming Language :: Python :: 3
+Classifier: Intended Audience :: Science/Research
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+Requires-Dist: pymetta==0.9.2
+
+# metta-sqlite
+
+sqlite3 as a SQL engine a MeTTa head can be registered into.
+
+`pymetta` names no third-party library. This package is one row against the `sql` point, and the seat
+finds it exactly as it finds a package written by somebody else: through the
+`metta.extensions` entry point, loaded at the first dispatch that has no answer
+without it, or through `import metta_sqlite`, whose module body registers the same
+rows.
+
+```sh
+pip install metta-sqlite          # or: pip install 'pymetta[sql]'
+```
+
+Its tests are in `tests/`, and they run in the workspace suite:
+
+```sh
+sh extensions/python/test.sh ext/metta-sqlite
+```

metta_sqlite-0.9.2.dist-info/RECORD

@@ -0,0 +1,6 @@
+metta_sqlite.py,sha256=N2VEFaN1OKD17hMCeJW4Qapn17ElrGMkqpRKrviafkk,1956
+metta_sqlite-0.9.2.dist-info/METADATA,sha256=7c1_FcFXCVo1YV96IHlRzkZ86UqeJQ9T-63IzNwnBvg,1012
+metta_sqlite-0.9.2.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+metta_sqlite-0.9.2.dist-info/entry_points.txt,sha256=0FeD5iKGz16J-9gpaQgY-Of2W-k6uFQw9jxgZQen6zA,47
+metta_sqlite-0.9.2.dist-info/top_level.txt,sha256=nSAMq0u3kWXg1SwJJRJ4JEAZZFSiejR0TTVSrFbQqsY,13
+metta_sqlite-0.9.2.dist-info/RECORD,,

metta_sqlite-0.9.2.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

metta_sqlite-0.9.2.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[metta.extensions]
+metta-sqlite = metta_sqlite

metta_sqlite-0.9.2.dist-info/top_level.txt

@@ -0,0 +1 @@
+metta_sqlite

metta_sqlite.py

@@ -0,0 +1,52 @@
+"""Purpose: sqlite3 as a SQL engine of the MeTTa Python seat, in one row.
+
+A MeTTa head registered into a sqlite3 connection becomes a scalar SQL
+function, so a query can call a definition the space holds. One row against
+the seat's `sql` point; pymetta names no engine.
+
+sqlite3 is the standard library, so this distribution depends on nothing but
+pymetta. It is still a distribution and not a shipped row, because "in the
+standard library" is not a reason for the core to know a SQL engine: the second
+engine of the class has to reach the same door the first did, and a row that
+lived in the core would be the branch a fork starts from.
+
+Assumes:
+  - sqlite3 wants an ARITY and no types, which is why an undeclared head
+    registers here where DuckDB refuses one
+Guarantees:
+  - a head with no declared arrow still registers, taking its argument count
+    from the signature [tested: tests/test_sqlite.py; commit=94057a0f073c0fab0a35c42beff2c324d8a0addd]
+  - a connection of any other engine is declined, so the next row is consulted
+    [tested: tests/test_sqlite.py::test_a_foreign_connection_is_declined;
+    commit=94057a0f073c0fab0a35c42beff2c324d8a0addd]
+Open Obligations:
+  To Do: None
+  Hacks: None
+  Future Enhancements: None
+"""
+
+from __future__ import annotations
+
+import sqlite3
+from typing import Any
+
+from metta import seam
+
+
+def _claims(connection: Any) -> Any:
+    """sqlite3's own connection type, which is in the standard library."""
+    return connection if isinstance(connection, sqlite3.Connection) else None
+
+
+def _define(connection: Any, name: str, call: Any, head: Any, signature: Any) -> None:
+    """sqlite3 wants the arity and no types, so an undeclared head registers."""
+    del head
+    connection.create_function(name, seam.sql_arity(signature), call)
+
+
+def register() -> None:
+    """This package's one row, against the seat's `sql` point."""
+    seam.sql.register("sqlite3", claims=_claims, define=_define)
+
+
+register()