Skip to main content

Assay Python Bindings

assay-it is the Python package for the assay import namespace.

It currently provides a small, bounded surface on top of Assay core:

  • AssayClient for writing JSONL trace records from Python
  • Coverage for policy coverage analysis against trace/tool-call inputs
  • Explainer for rule-by-rule explanation of a single trace
  • a pytest fixture plugin exposed as assay_client

Install

pip install assay-it

Import path:

from assay import AssayClient, Coverage, Explainer, validate

What It Is

This package is for Python-side trace capture and lightweight policy-analysis helpers. It is useful when you want to:

  • append structured trace events to a JSONL file from Python
  • analyze tool-call traces against an Assay policy
  • explain why a given trace matched or violated policy rules
  • use a simple pytest fixture around the Python client

What It Is Not

This package is not the full Assay CLI or the full trust-compiler surface. It does not replace:

  • assay mcp wrap and runtime MCP enforcement
  • evidence bundle generation and verification workflows
  • Trust Basis / Trust Card generation
  • the GitHub Action or release-binary install path

Those outward-facing product surfaces live in the main Assay CLI and repository docs.

Example

from assay import AssayClient, Coverage, Explainer

client = AssayClient("traces.jsonl")
client.record_trace({"tool": "ToolA", "args": {"q": "weather"}})

coverage = Coverage("assay.yaml")
report = coverage.analyze([[{"tool": "ToolA", "args": {"q": "weather"}}]])

explainer = Explainer("assay.yaml")
details = explainer.explain([{"tool": "ToolA", "args": {"q": "weather"}}])

Repository

Download files

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

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

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

assay_it-3.34.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (1.2 MB view details)

Uploaded CPython 3.12manylinux: glibc 2.17+ x86-64

assay_it-3.34.0-cp312-cp312-macosx_11_0_arm64.whl (806.0 kB view details)

Uploaded CPython 3.12macOS 11.0+ ARM64

assay_it-3.34.0-cp312-cp312-macosx_10_12_x86_64.whl (1.6 MB view details)

Uploaded CPython 3.12macOS 10.12+ x86-64

File details

Details for the file assay_it-3.34.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for assay_it-3.34.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 3ee2fafdde1045c91c7cd95c4beb80aaaf6a639942d1070d8bd3c7fe11e8c040
MD5 7d388cfadaa770d6c2e61a2a9bca745a
BLAKE2b-256 fcb33db5b1ee007e64b52713452902408f8c0f1a41044116e8184fc171dd1b4a

See more details on using hashes here.

Provenance

The following attestation bundles were made for assay_it-3.34.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:

Publisher: release.yml on Rul1an/assay

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

File details

Details for the file assay_it-3.34.0-cp312-cp312-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for assay_it-3.34.0-cp312-cp312-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 bd98c7965c6828dc4927d3553393f2c99c3a7e21245d5e2869c794b55d7c79b3
MD5 20f8344fa85a08970b67072bedc1d8db
BLAKE2b-256 94fa84aa2a2939cdcea986574d56175d86229d36a576fe6722ebb911e1c955a3

See more details on using hashes here.

Provenance

The following attestation bundles were made for assay_it-3.34.0-cp312-cp312-macosx_11_0_arm64.whl:

Publisher: release.yml on Rul1an/assay

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

File details

Details for the file assay_it-3.34.0-cp312-cp312-macosx_10_12_x86_64.whl.

File metadata

File hashes

Hashes for assay_it-3.34.0-cp312-cp312-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 760883380bd54a11e78c90a0c212f541eb628cf48a84ae3f2378faa13f58ea46
MD5 6014d05db3a9d7b5d446053d9bae8f9c
BLAKE2b-256 fed069e4723d02d15672ce7e82db6efd24b73468009bd0ee2d0f4c4f49fa6fc2

See more details on using hashes here.

Provenance

The following attestation bundles were made for assay_it-3.34.0-cp312-cp312-macosx_10_12_x86_64.whl:

Publisher: release.yml on Rul1an/assay

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

Release history Release notifications | RSS feed

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