tigrbl_engine_numpy 0.1.1

NumPy engine plugin for tigrbl with array-to-table helpers.

tigrbl_engine_numpy

A tigrbl engine plugin that registers kind="numpy" where each array/matrix is a single-table database-like object.

Features

• Registers a numpy engine through the tigrbl.engine entry-point group.
• Treats one NumPy array/matrix as one table.
• Provides a first-class NumpySession (subclass of TigrblSessionBase) without pandas dependencies.
• Supports loading .npy/.npz via np.load(...), memory-mapped arrays via np.memmap(...), and persistence via np.save(...).

Installation

uv

uv add tigrbl_engine_numpy

pip

pip install tigrbl_engine_numpy

Usage

import numpy as np
from tigrbl.engine import EngineSpec

spec = EngineSpec(kind="numpy", mapping={"array": np.array([[1, 2], [3, 4]]), "columns": ["id", "value"], "table": "matrix", "pk": "id"})
provider = spec.provider()
engine, session_factory = provider.build()

session = session_factory()
print(session.array())
print(session.to_records())
session.close()