Juntai Query Engine

juntai-query-engine is a synchronous, in-process Python library that validates an authorized Juntai logical query, translates it to Meridian's public structured Catalog, and returns a stable Juntai query page. It is not an HTTP service, a storage Engine, an Adapter registry, or an IAM policy evaluator.

The 2.0.0 contract deliberately has three public operations:

  • JuntaiQueryEngine.query(plan, context) validates and executes one logical query.
  • JuntaiQueryEngine.catalog(context) exposes only the authorized logical query surface.
  • JuntaiQueryEngine.translate(text, context) optionally produces an unexecuted plan through an injected translator.

Composition

The application supplies four in-process objects:

  1. an immutable SnapshotStore containing exact schema-policy snapshots;
  2. a Meridian runtime implementing the IAM operation-context hook, catalog(), and execute();
  3. the exact snapshot digest selected for the request;
  4. optionally, a domain-owned natural-language translator.
from juntai_query_engine import JuntaiQueryEngine

engine = JuntaiQueryEngine(
    runtime=meridian_runtime,
    snapshots=snapshot_store,
    snapshot_digest="sha256:...",
)
page = engine.query(plan, authorized_operation_context)

Plans use formatVersion: juntai.logical-query.v1. They contain a logical resource, filter, projection, sort, and page only. Tenant, principal, physical storage names, Bindings, credentials, Adapters, and native cursors are forbidden. Meridian owns the opaque cursor returned by execution.

The engine validates the exact snapshot, trusted IAM context, field authorization, operators, limits, deterministic ordering, and result envelope before it touches the runtime. It then enters IAM's verified operation scope, creates one public Meridian expression, and calls runtime.execute(expression) exactly once.

Development

python -m pip install -e '.[test]'
ruff check .
pytest
python -m build

Python 3.12 and 3.13 are supported. Runtime dependencies are intentionally pinned to IAM 2.0.0 and the Meridian 1.0.0 public contracts.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for vanzeph from gravatar.com vanzeph

Credits

Author: Juntai Team

License

Proprietary

Requires

Python >=3.12

Provides Extra

test

Report project as malware

Download files

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

Source Distribution

juntai_query_engine-2.0.0.tar.gz (12.8 kB view details)

Uploaded Source

Built Distribution

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

juntai_query_engine-2.0.0-py3-none-any.whl (13.5 kB view details)

Uploaded Python 3

File details

Details for the file juntai_query_engine-2.0.0.tar.gz.

File metadata

  • Download URL: juntai_query_engine-2.0.0.tar.gz
  • Upload date:
  • Size: 12.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for juntai_query_engine-2.0.0.tar.gz
Algorithm Hash digest
SHA256 889e870a3532fe6bcd4e40642d6ff70e3131d16e0d61b484f90e9ed36bf43145
MD5 4916a3c46847f413f9784aa53eecf920
BLAKE2b-256 ea1d93dee37da73fe22918d85879e9dcb733a63fab7d267a82687fb39996ac5c

See more details on using hashes here.

Provenance

The following attestation bundles were made for juntai_query_engine-2.0.0.tar.gz:

Publisher: publish.yml on zephytiju/JuntaiQueryEngine

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

File details

Details for the file juntai_query_engine-2.0.0-py3-none-any.whl.

File metadata

File hashes

Hashes for juntai_query_engine-2.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 2866d1d837e53e40bd4a0757690f0160693775ce81d77d7a26ea6fdb5c319f54
MD5 b914bf621ed6ee9b3bccf035211b48c9
BLAKE2b-256 30eb302c57449cdf4d62ede677c378a730325e5bf081b8b3971113295f0b12bb

See more details on using hashes here.

Provenance

The following attestation bundles were made for juntai_query_engine-2.0.0-py3-none-any.whl:

Publisher: publish.yml on zephytiju/JuntaiQueryEngine

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

Release history Release notifications | RSS feed

This release

2.0.0 This release

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page