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.38.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.38.0-cp312-cp312-macosx_11_0_arm64.whl (807.9 kB view details)

Uploaded CPython 3.12macOS 11.0+ ARM64

assay_it-3.38.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.38.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for assay_it-3.38.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 19aa9eea1e16da003abb1d6644ee30a563633be115e0a3425d083819d9ff0e46
MD5 0b9653beb244c107b52586a9514713c4
BLAKE2b-256 a4d7805ca6a99e365ff7754a2ae06d0f7ecbaa0364948e18c45e4312eeeaaadf

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for assay_it-3.38.0-cp312-cp312-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 6031e8f0ab96436d3ea468fb7d6d0c2d10211d1b8c363207c798a9fc0cfe8be3
MD5 ec62ebae33d80307c22f8410419e451d
BLAKE2b-256 254783f9c531880a409c0cfc31445762d37e2931c3a283e0a7acf054a6abffb4

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for assay_it-3.38.0-cp312-cp312-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 d9e77309903374fa4bc311cbbc329fdc9318e1dc2e10b7296a6f759d07ae93d0
MD5 19fa1d2a3ff95fc761eebca75200fc97
BLAKE2b-256 dddca7f6ab164d20c0bea849d53bb927a2d7c980668fe435073b7b510bd1f26f

See more details on using hashes here.

Provenance

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