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.37.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.37.0-cp312-cp312-macosx_11_0_arm64.whl (807.7 kB view details)

Uploaded CPython 3.12macOS 11.0+ ARM64

assay_it-3.37.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.37.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for assay_it-3.37.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 168d3815cfaa13300e1ff778d737958be576972f2258ed4b1cf003ac8f9de4ec
MD5 8d32069b2b13e815e24892b09ac43cb8
BLAKE2b-256 1bfd65e8c6a0bf5e5717368c910616598fe0b598642225bd82836ed946a3c9ea

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for assay_it-3.37.0-cp312-cp312-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 5db12cdc6ec04c66ff3c0bfdca4808d662a33b1e14386dd972fae7845085af15
MD5 7a1980fe0739c6f3e305bbbdaf21f24c
BLAKE2b-256 7ca1f6ebb29a94f604fdf1e385a0f386faf1a54e931d14e02c5a2364c0c1c346

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for assay_it-3.37.0-cp312-cp312-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 379a9ad38af609cc670b55993157ea6c4641f98052edccb7d76c888b0b4d9233
MD5 5d8dc42791a040aa15ed23bc1f0a1810
BLAKE2b-256 f7909b2a82d8169ed2295ed70f0e7d11e457cc8cf09bffcd9b1a8cac16dba03d

See more details on using hashes here.

Provenance

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