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.35.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.35.0-cp312-cp312-macosx_11_0_arm64.whl (807.6 kB view details)

Uploaded CPython 3.12macOS 11.0+ ARM64

assay_it-3.35.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.35.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for assay_it-3.35.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 64a78f382cf7bb10ab61e6ff8248c3d2f64b1538fb00fb7599764781c26a3401
MD5 5aab6cef87adbdbd78e6598b8bfc8c84
BLAKE2b-256 f94c3f55d691cf3bbcb9564ac02c87d5e49d059bd4abcda7a4b86f1ca0520733

See more details on using hashes here.

Provenance

The following attestation bundles were made for assay_it-3.35.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.35.0-cp312-cp312-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for assay_it-3.35.0-cp312-cp312-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 bccf49ebc32e357f1b8201b7a219478b4ad7f2d92a8a57e806b753005619767e
MD5 a32c08bd8124800dabdafccecbaa4017
BLAKE2b-256 2a79acc41807986d8b9105e55b09f828473fe0d1807280b67d19616800a1ac1d

See more details on using hashes here.

Provenance

The following attestation bundles were made for assay_it-3.35.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.35.0-cp312-cp312-macosx_10_12_x86_64.whl.

File metadata

File hashes

Hashes for assay_it-3.35.0-cp312-cp312-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 18a2a779c03cc66c8aa040241c0b206ca5aa2d2eed791543157b03c36a19b82f
MD5 fae9b7ff1b0f16c0c795fbfda299fa1f
BLAKE2b-256 4f614ae9b180334f1e56c6e48d6ba2529c97b6ef29e86efbe3b9a69d92cb9ec2

See more details on using hashes here.

Provenance

The following attestation bundles were made for assay_it-3.35.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