Skip to main content

Differentially certified Drools-subset rule engine over Arrow dataframes

Project description

seine-rs

A rules/decisioning engine over Arrow dataframes — a Rust port of a bounded Drools (DRL) subset, differentially certified against real Drools 9.44.0.Final: every supported behavior is pinned by running the same scenarios through both engines, plus multi-seed fuzz campaigns (zero divergences to completion).

import polars as pl
import seine
from seine import Rule, fact

@fact
class Person:
    name: str
    age: int
    score: float

@fact
class Flagged:
    name: str
    score: float

adults = Rule("Adults")
p = adults.when(Person, Person.age >= 18)
adults.then_insert(Flagged, name=p.name, score=p.score)

people = pl.DataFrame({"name": ["ada", "kurt"], "age": [36, 17], "score": [91.5, 99.0]})
res = seine.run([adults], {Person: people, Flagged: []})

pl.DataFrame(res.derived()["Flagged"])   # facts the rules created
pl.DataFrame(res.firings())              # full audit trail
  • Bulk, columnar boundary: Arrow tables in (polars / pyarrow / pandas ≥ 2.2, zero-copy via the PyCapsule interface), Arrow tables out. Row-object lists (@fact instances, dicts, dataclasses, Pydantic models) work too.
  • Rules in Python or DRL: the Python builder compiles to DRL text, so both paths run the identical certified engine. Anything outside the certified grammar is a definition-time CompileError.
  • Full working-memory lifecycle: insert → fire → update/delete by handle → fire, each certified differentially.
  • No Python in the hot path: conditions, aggregates and salience are native; callbacks are observers over immutable results.

Install: pip install seine-rs — the import is import seine.

Source, scenario corpus, and the full decision log (D-001…D-048): https://github.com/sl-agentics/seine

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

seine_rs-0.4.2.tar.gz (244.0 kB view details)

Uploaded Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

seine_rs-0.4.2-cp39-abi3-win_amd64.whl (1.2 MB view details)

Uploaded CPython 3.9+Windows x86-64

seine_rs-0.4.2-cp39-abi3-manylinux_2_34_x86_64.whl (1.6 MB view details)

Uploaded CPython 3.9+manylinux: glibc 2.34+ x86-64

seine_rs-0.4.2-cp39-abi3-macosx_11_0_arm64.whl (1.3 MB view details)

Uploaded CPython 3.9+macOS 11.0+ ARM64

seine_rs-0.4.2-cp39-abi3-macosx_10_12_x86_64.whl (1.3 MB view details)

Uploaded CPython 3.9+macOS 10.12+ x86-64

File details

Details for the file seine_rs-0.4.2.tar.gz.

File metadata

  • Download URL: seine_rs-0.4.2.tar.gz
  • Upload date:
  • Size: 244.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for seine_rs-0.4.2.tar.gz
Algorithm Hash digest
SHA256 8b791a11e1a2447fa0ca5d24fa8a581d63f3280dadef9e831a891994acafd619
MD5 91a597d0353d281b6c215ff19caadbab
BLAKE2b-256 c583938b1582f802461e3a3160bf1ac65a51104570286dcb236d5f5ffff252df

See more details on using hashes here.

Provenance

The following attestation bundles were made for seine_rs-0.4.2.tar.gz:

Publisher: ci.yml on sl-agentics/seine

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file seine_rs-0.4.2-cp39-abi3-win_amd64.whl.

File metadata

  • Download URL: seine_rs-0.4.2-cp39-abi3-win_amd64.whl
  • Upload date:
  • Size: 1.2 MB
  • Tags: CPython 3.9+, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for seine_rs-0.4.2-cp39-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 8922bb899c435a6fdf701ca9d609e9f61269a296a5a2ceb43cad18cc95cfcea3
MD5 07fd62debacbbff481d95fa33106a0ea
BLAKE2b-256 5ef831c399376be9a578d0d06b32e6e626e5c78afd8786aba0af83967516a042

See more details on using hashes here.

Provenance

The following attestation bundles were made for seine_rs-0.4.2-cp39-abi3-win_amd64.whl:

Publisher: ci.yml on sl-agentics/seine

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file seine_rs-0.4.2-cp39-abi3-manylinux_2_34_x86_64.whl.

File metadata

File hashes

Hashes for seine_rs-0.4.2-cp39-abi3-manylinux_2_34_x86_64.whl
Algorithm Hash digest
SHA256 53dd326f5da0474de72a32b5c4085b0fcac151e878456cf670e66fe13858fd1a
MD5 ac1401083554e8c94f6f811120ee79c4
BLAKE2b-256 fce90c88848411b7a88133edeb3e488ed609cff8cdcec0e1be99052b864f7c0b

See more details on using hashes here.

Provenance

The following attestation bundles were made for seine_rs-0.4.2-cp39-abi3-manylinux_2_34_x86_64.whl:

Publisher: ci.yml on sl-agentics/seine

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file seine_rs-0.4.2-cp39-abi3-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for seine_rs-0.4.2-cp39-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 fed641ba16653cbbff6a41b59a88463af4ab1d16c87527ef6475bf9386419949
MD5 f7c1e3830c8c262c8c9eaae7e7037498
BLAKE2b-256 f2222351747a0012faf919f1f5f3f94a03e768836b9e96b04804d24d8c5c641f

See more details on using hashes here.

Provenance

The following attestation bundles were made for seine_rs-0.4.2-cp39-abi3-macosx_11_0_arm64.whl:

Publisher: ci.yml on sl-agentics/seine

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file seine_rs-0.4.2-cp39-abi3-macosx_10_12_x86_64.whl.

File metadata

File hashes

Hashes for seine_rs-0.4.2-cp39-abi3-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 510c0293022a26ed69152a63e8e89dc7398b8c059fba9e7915944f80b28ded1b
MD5 10dc3d7fff2d37fb4e8f883415ff9864
BLAKE2b-256 8a6479631146d13caaa31b4c51853b0ae200f98da19672d9069b1fb6acb1a485

See more details on using hashes here.

Provenance

The following attestation bundles were made for seine_rs-0.4.2-cp39-abi3-macosx_10_12_x86_64.whl:

Publisher: ci.yml on sl-agentics/seine

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page