agriql 3.10.1__tar.gz

agriql-3.10.1/LICENSE

@@ -0,0 +1,17 @@
+Apache License
+Version 2.0, January 2004
+http://www.apache.org/licenses/
+
+Copyright 2026 Sbruice Singh, Agricultural Service of Product Farm (ASPF)
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

agriql-3.10.1/PKG-INFO

@@ -0,0 +1,64 @@
+Metadata-Version: 2.4
+Name: agriql
+Version: 3.10.1
+Summary: Client for the AgriQL engine. This package is not a database.
+Author-email: Sbruice Singh <sbruicesingh@haclon.in>
+License-Expression: Apache-2.0
+Project-URL: Homepage, https://github.com/SbruiceS/agriql-python
+Project-URL: Issues, https://github.com/SbruiceS/agriql-python/issues
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: pandas
+Requires-Dist: pandas; extra == "pandas"
+Provides-Extra: polars
+Requires-Dist: polars; extra == "polars"
+Provides-Extra: arrow
+Requires-Dist: pyarrow; extra == "arrow"
+Provides-Extra: geo
+Requires-Dist: geopandas; extra == "geo"
+Provides-Extra: ml
+Requires-Dist: numpy; extra == "ml"
+Provides-Extra: all
+Requires-Dist: pandas; extra == "all"
+Requires-Dist: polars; extra == "all"
+Requires-Dist: pyarrow; extra == "all"
+Requires-Dist: numpy; extra == "all"
+Dynamic: license-file
+
+# agriql
+
+Python client for the AgriQL engine. `import agriql` does not start a second database.
+
+```python
+import agriql
+
+db = agriql.connect("farm.aqdb")
+result = db.query("SELECT plant_id, soil_moisture FROM agriculture.soil")
+result.to_records()
+```
+
+`to_pandas()`, `to_polars()`, and `to_arrow()` import those libraries only when called. Arrow IPC is not produced by the engine. `to_arrow()` builds a `pyarrow` table from the result grid.
+
+## Install
+
+`libagriql_ffi` must already be on the library path. Build it from [AgriQL](https://github.com/SbruiceS/AgriQL):
+
+```bash
+git clone https://github.com/SbruiceS/AgriQL.git
+cd AgriQL
+cargo build -p agriql-ffi --release
+sudo cp target/release/libagriql_ffi.so /usr/local/lib
+sudo ldconfig
+```
+
+Then:
+
+```bash
+pip install git+https://github.com/SbruiceS/agriql-python.git
+pip install "agriql[pandas] @ git+https://github.com/SbruiceS/agriql-python.git"
+```
+
+If the library is not in a default directory, set `AGRIQL_FFI` to the full path of `libagriql_ffi.so`.
+
+`agriql.connect("agriql://127.0.0.1:5471/farm")` uses the server port instead of the library. This package is not published on PyPI.

agriql-3.10.1/README.md

@@ -0,0 +1,36 @@
+# agriql
+
+Python client for the AgriQL engine. `import agriql` does not start a second database.
+
+```python
+import agriql
+
+db = agriql.connect("farm.aqdb")
+result = db.query("SELECT plant_id, soil_moisture FROM agriculture.soil")
+result.to_records()
+```
+
+`to_pandas()`, `to_polars()`, and `to_arrow()` import those libraries only when called. Arrow IPC is not produced by the engine. `to_arrow()` builds a `pyarrow` table from the result grid.
+
+## Install
+
+`libagriql_ffi` must already be on the library path. Build it from [AgriQL](https://github.com/SbruiceS/AgriQL):
+
+```bash
+git clone https://github.com/SbruiceS/AgriQL.git
+cd AgriQL
+cargo build -p agriql-ffi --release
+sudo cp target/release/libagriql_ffi.so /usr/local/lib
+sudo ldconfig
+```
+
+Then:
+
+```bash
+pip install git+https://github.com/SbruiceS/agriql-python.git
+pip install "agriql[pandas] @ git+https://github.com/SbruiceS/agriql-python.git"
+```
+
+If the library is not in a default directory, set `AGRIQL_FFI` to the full path of `libagriql_ffi.so`.
+
+`agriql.connect("agriql://127.0.0.1:5471/farm")` uses the server port instead of the library. This package is not published on PyPI.

agriql-3.10.1/agriql/__init__.py

@@ -0,0 +1,7 @@
+"""AgriQL client. Queries run in the AgriQL engine through its C ABI or its port."""
+
+from agriql.connection import connect
+from agriql.result import Result
+
+__all__ = ["connect", "Result"]
+__version__ = "3.10.1"

agriql-3.10.1/agriql/__main__.py

@@ -0,0 +1,13 @@
+import sys
+
+from agriql import connect
+
+
+def main():
+    target = sys.argv[1] if len(sys.argv) > 1 else ":memory:"
+    sql = sys.argv[2] if len(sys.argv) > 2 else "SHOW VERSION;"
+    print(connect(target).query(sql).text)
+
+
+if __name__ == "__main__":
+    main()

agriql-3.10.1/agriql/_ffi.py

@@ -0,0 +1,52 @@
+"""ctypes bindings for libagriql_ffi. The library owns the engine."""
+
+import ctypes
+import os
+from pathlib import Path
+
+
+def load():
+    requested = os.environ.get("AGRIQL_FFI")
+    names = [
+        requested,
+        "libagriql_ffi.so",
+        "libagriql_ffi.dylib",
+        "agriql_ffi.dll",
+    ]
+    roots = [
+        Path.cwd(),
+        Path(__file__).resolve().parents[3] / "target" / "debug",
+        Path(__file__).resolve().parents[3] / "target" / "release",
+    ]
+    candidates = []
+    for name in names:
+        if not name:
+            continue
+        path = Path(name)
+        if path.is_file():
+            candidates.append(path)
+        for root in roots:
+            found = root / name
+            if found.is_file():
+                candidates.append(found)
+    if not candidates:
+        raise FileNotFoundError(
+            "libagriql_ffi was not found. Build it with `cargo build -p agriql-ffi` "
+            "or set AGRIQL_FFI to the library path."
+        )
+    chosen = max(candidates, key=lambda path: path.stat().st_mtime)
+    lib = ctypes.CDLL(str(chosen))
+    lib.agriql_open.argtypes = [ctypes.c_char_p, ctypes.POINTER(ctypes.c_void_p)]
+    lib.agriql_open.restype = ctypes.c_int
+    lib.agriql_close.argtypes = [ctypes.c_void_p]
+    lib.agriql_close.restype = ctypes.c_int
+    lib.agriql_execute.argtypes = [ctypes.c_void_p, ctypes.c_char_p]
+    lib.agriql_execute.restype = ctypes.c_void_p
+    lib.agriql_result_text.argtypes = [ctypes.c_void_p]
+    lib.agriql_result_text.restype = ctypes.c_char_p
+    lib.agriql_result_status.argtypes = [ctypes.c_void_p]
+    lib.agriql_result_status.restype = ctypes.c_int
+    lib.agriql_free_result.argtypes = [ctypes.c_void_p]
+    lib.agriql_thread_error.argtypes = []
+    lib.agriql_thread_error.restype = ctypes.c_char_p
+    return lib

agriql-3.10.1/agriql/connection.py

@@ -0,0 +1,105 @@
+"""Connections. A file path uses the C ABI. agriql:// uses the server port."""
+
+import socket
+
+from agriql._ffi import load
+from agriql.result import Result
+
+_lib = None
+
+
+def connect(target=":memory:"):
+    if str(target).startswith("agriql://"):
+        return PortConnection(str(target))
+    return EngineConnection(str(target))
+
+
+class EngineConnection:
+    def __init__(self, path):
+        global _lib
+        if _lib is None:
+            _lib = load()
+        self._lib = _lib
+        self._db = ctypes_open(self._lib, path)
+
+    def query(self, sql):
+        result = self._lib.agriql_execute(self._db, sql.encode())
+        if not result:
+            raise RuntimeError(_error(self._lib))
+        status = self._lib.agriql_result_status(result)
+        raw = self._lib.agriql_result_text(result)
+        text = raw.decode() if raw else ""
+        self._lib.agriql_free_result(result)
+        if status != 0:
+            raise RuntimeError(text or _error(self._lib))
+        return Result(text)
+
+    def close(self):
+        if self._db:
+            self._lib.agriql_close(self._db)
+            self._db = None
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, *_args):
+        self.close()
+
+
+class PortConnection:
+    def __init__(self, url):
+        raw = url.replace("agriql://", "", 1)
+        database = None
+        if "/" in raw:
+            raw, database = raw.split("/", 1)
+        host, port = raw.rsplit(":", 1)
+        self.host = host
+        self.port = int(port)
+        self.database = database
+
+    def query(self, sql):
+        sock = socket.create_connection((self.host, self.port), timeout=5)
+        try:
+            payload = ""
+            if self.database:
+                payload += f"USE DATABASE {self.database};\n"
+            payload += sql.strip() + "\n.quit\n"
+            sock.sendall(payload.encode())
+            data = b""
+            while True:
+                chunk = sock.recv(65536)
+                if not chunk:
+                    break
+                data += chunk
+        finally:
+            sock.close()
+        if not data:
+            raise ConnectionError(f"agriql://{self.host}:{self.port} closed without a reply")
+        return Result(data.decode())
+
+    def close(self):
+        return None
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, *_args):
+        return None
+
+
+def ctypes_open(lib, path):
+    import ctypes
+
+    out = ctypes.c_void_p()
+    encoded = None if path in ("", ":memory:") else path.encode()
+    status = lib.agriql_open(encoded, ctypes.byref(out))
+    if status != 0 or not out.value:
+        raise RuntimeError(_error(lib))
+    return out.value
+
+
+def _error(lib):
+    raw = lib.agriql_thread_error()
+    if not raw:
+        return "AGRIQL-2701: the engine returned no message"
+    return raw.decode()

agriql-3.10.1/agriql/result.py

@@ -0,0 +1,37 @@
+"""A query result is a grid from the engine. pandas, Polars, and Arrow are optional views."""
+
+
+class Result:
+    def __init__(self, text):
+        self.text = text
+
+    def to_records(self):
+        lines = [line for line in self.text.splitlines() if line]
+        if len(lines) < 2 or "\t" not in lines[0]:
+            return [{"text": line} for line in lines]
+        header = lines[0].split("\t")
+        return [dict(zip(header, line.split("\t"))) for line in lines[1:]]
+
+    def to_pandas(self):
+        try:
+            import pandas as pd
+        except ImportError as exc:
+            raise ImportError("pandas is not installed. Use pip install 'agriql[pandas]'.") from exc
+        return pd.DataFrame(self.to_records())
+
+    def to_polars(self):
+        try:
+            import polars as pl
+        except ImportError as exc:
+            raise ImportError("polars is not installed. Use pip install 'agriql[polars]'.") from exc
+        return pl.DataFrame(self.to_records())
+
+    def to_arrow(self):
+        try:
+            import pyarrow as pa
+        except ImportError as exc:
+            raise ImportError(
+                "pyarrow is not installed. The engine does not emit Arrow IPC yet. "
+                "Use pip install 'agriql[arrow]' to build a table from the result grid."
+            ) from exc
+        return pa.Table.from_pylist(self.to_records())

agriql-3.10.1/agriql.egg-info/PKG-INFO

@@ -0,0 +1,64 @@
+Metadata-Version: 2.4
+Name: agriql
+Version: 3.10.1
+Summary: Client for the AgriQL engine. This package is not a database.
+Author-email: Sbruice Singh <sbruicesingh@haclon.in>
+License-Expression: Apache-2.0
+Project-URL: Homepage, https://github.com/SbruiceS/agriql-python
+Project-URL: Issues, https://github.com/SbruiceS/agriql-python/issues
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: pandas
+Requires-Dist: pandas; extra == "pandas"
+Provides-Extra: polars
+Requires-Dist: polars; extra == "polars"
+Provides-Extra: arrow
+Requires-Dist: pyarrow; extra == "arrow"
+Provides-Extra: geo
+Requires-Dist: geopandas; extra == "geo"
+Provides-Extra: ml
+Requires-Dist: numpy; extra == "ml"
+Provides-Extra: all
+Requires-Dist: pandas; extra == "all"
+Requires-Dist: polars; extra == "all"
+Requires-Dist: pyarrow; extra == "all"
+Requires-Dist: numpy; extra == "all"
+Dynamic: license-file
+
+# agriql
+
+Python client for the AgriQL engine. `import agriql` does not start a second database.
+
+```python
+import agriql
+
+db = agriql.connect("farm.aqdb")
+result = db.query("SELECT plant_id, soil_moisture FROM agriculture.soil")
+result.to_records()
+```
+
+`to_pandas()`, `to_polars()`, and `to_arrow()` import those libraries only when called. Arrow IPC is not produced by the engine. `to_arrow()` builds a `pyarrow` table from the result grid.
+
+## Install
+
+`libagriql_ffi` must already be on the library path. Build it from [AgriQL](https://github.com/SbruiceS/AgriQL):
+
+```bash
+git clone https://github.com/SbruiceS/AgriQL.git
+cd AgriQL
+cargo build -p agriql-ffi --release
+sudo cp target/release/libagriql_ffi.so /usr/local/lib
+sudo ldconfig
+```
+
+Then:
+
+```bash
+pip install git+https://github.com/SbruiceS/agriql-python.git
+pip install "agriql[pandas] @ git+https://github.com/SbruiceS/agriql-python.git"
+```
+
+If the library is not in a default directory, set `AGRIQL_FFI` to the full path of `libagriql_ffi.so`.
+
+`agriql.connect("agriql://127.0.0.1:5471/farm")` uses the server port instead of the library. This package is not published on PyPI.

agriql-3.10.1/agriql.egg-info/SOURCES.txt

@@ -0,0 +1,15 @@
+LICENSE
+README.md
+pyproject.toml
+agriql/__init__.py
+agriql/__main__.py
+agriql/_ffi.py
+agriql/connection.py
+agriql/result.py
+agriql.egg-info/PKG-INFO
+agriql.egg-info/SOURCES.txt
+agriql.egg-info/dependency_links.txt
+agriql.egg-info/entry_points.txt
+agriql.egg-info/requires.txt
+agriql.egg-info/top_level.txt
+tests/test_client.py

agriql-3.10.1/agriql.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

agriql-3.10.1/agriql.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+agriql = agriql.__main__:main

agriql-3.10.1/agriql.egg-info/requires.txt

@@ -0,0 +1,21 @@
+
+[all]
+pandas
+polars
+pyarrow
+numpy
+
+[arrow]
+pyarrow
+
+[geo]
+geopandas
+
+[ml]
+numpy
+
+[pandas]
+pandas
+
+[polars]
+polars

agriql-3.10.1/agriql.egg-info/top_level.txt

@@ -0,0 +1 @@
+agriql

agriql-3.10.1/pyproject.toml

@@ -0,0 +1,32 @@
+[project]
+name = "agriql"
+version = "3.10.1"
+description = "Client for the AgriQL engine. This package is not a database."
+readme = "README.md"
+requires-python = ">=3.9"
+license = "Apache-2.0"
+authors = [{ name = "Sbruice Singh", email = "sbruicesingh@haclon.in" }]
+dependencies = []
+
+[project.urls]
+Homepage = "https://github.com/SbruiceS/agriql-python"
+Issues = "https://github.com/SbruiceS/agriql-python/issues"
+
+[project.optional-dependencies]
+pandas = ["pandas"]
+polars = ["polars"]
+arrow = ["pyarrow"]
+geo = ["geopandas"]
+ml = ["numpy"]
+all = ["pandas", "polars", "pyarrow", "numpy"]
+
+[project.scripts]
+agriql = "agriql.__main__:main"
+
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["agriql*"]

agriql-3.10.1/setup.cfg

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

agriql-3.10.1/tests/test_client.py

@@ -0,0 +1,44 @@
+import os
+import tempfile
+import unittest
+from pathlib import Path
+
+from agriql import connect
+from agriql.result import Result
+
+
+class ClientTest(unittest.TestCase):
+    def test_memory_query_uses_the_engine(self):
+        db = connect(":memory:")
+        text = db.query("SHOW VERSION;").text
+        self.assertIn("engine=3.10.1", text)
+        db.close()
+
+    def test_aqdb_file_round_trip(self):
+        with tempfile.TemporaryDirectory() as tmp:
+            os.environ["AGRIQL_DATA_DIR"] = tmp
+            created = connect(":memory:")
+            created.query("CREATE DATABASE farm;")
+            created.close()
+            path = Path(tmp) / "databases" / "farm.aqdb"
+            self.assertTrue(path.is_file(), path)
+            db = connect(str(path))
+            db.query("CREATE SCHEMA fields;")
+            db.close()
+            again = connect(str(path))
+            self.assertIn("fields", again.query("SHOW SCHEMAS;").text)
+            again.close()
+
+    def test_records_and_missing_optional_libraries(self):
+        result = Result("plant_id\tsoil_moisture\na\t10\n")
+        self.assertEqual(result.to_records(), [{"plant_id": "a", "soil_moisture": "10"}])
+        with self.assertRaises(ImportError):
+            result.to_pandas()
+        with self.assertRaises(ImportError):
+            result.to_polars()
+        with self.assertRaises(ImportError):
+            result.to_arrow()
+
+
+if __name__ == "__main__":
+    unittest.main()