pytest-session-trace
Pytest plugin that turns a recorded agent session (Claude Code JSONL, henhouse tools.v1 JSON, or legacy call list) into deterministic tool-call assertions. No LLM in CI. No network. No MCP SDK.
Install
Python 3.10+. Requires henhouse:
pip install henhouse pytest-session-trace
Or install tagged releases from GitHub:
pip install git+https://github.com/gmhoward9289-ops/henhouse@v0.1.1
pip install git+https://github.com/gmhoward9289-ops/pytest-session-trace@v0.1.1
Develop from sibling clones under dev/:
pip install -e ../henhouse
pip install -e .
pytest tests -v --session-trace tests/fixtures/one_write.jsonl
Example
from session_trace.assert_tools import assert_tool_called, assert_tool_order
def test_wrote(session_trace):
assert_tool_called(session_trace, "Write")
assert_tool_order(session_trace, ["Write"])
Point the fixture at a transcript or henhouse envelope:
pytest --session-trace path/to/session.jsonl
pytest --session-trace path/to/calls.json
# or
set SESSION_TRACE=path/to/session.jsonl
If neither --session-trace nor SESSION_TRACE is set, tests that request the session_trace fixture are skipped so this plugin can be installed globally without breaking unrelated suites.
Recorders
roost and leghorn record and display live Claude Code sessions. This plugin only asserts against a saved JSONL or python -m henhouse output.
Parsing is delegated to henhouse (load_tool_calls, ToolCall).
Optional extra [anchor] uses trust_but_anchor.locate to fail closed when a quoted argument is not in a source file:
pip install -e ".[anchor]"
Starter test from a transcript
python -m session_trace path/to/session.jsonl > test_session.py
That file is a copy-pasteable starting point, not a required CI step for this package.
Have a recorded session and a pytest file that pins it? Post the workflow in Show and tell.
License
Apache-2.0
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file pytest_session_trace-0.1.1.tar.gz.
File metadata
- Download URL: pytest_session_trace-0.1.1.tar.gz
- Upload date:
- Size: 11.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2d9a230cd9a1bf6e6c107fc00c37ebc942bafe8e5e90abc810e2d7911733831c
|
|
| MD5 |
877599109bdc80ed2d876647bd28e895
|
|
| BLAKE2b-256 |
813c29d7f33a9f7b76500c8e4d26942a7ce3d0391330d62e7f25513824c3eabf
|
Provenance
The following attestation bundles were made for pytest_session_trace-0.1.1.tar.gz:
Publisher:
release.yml on gmhoward9289-ops/pytest-session-trace
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
pytest_session_trace-0.1.1.tar.gz -
Subject digest:
2d9a230cd9a1bf6e6c107fc00c37ebc942bafe8e5e90abc810e2d7911733831c - Sigstore transparency entry: 2530844562
- Sigstore integration time:
-
Permalink:
gmhoward9289-ops/pytest-session-trace@0a46fd8a3c71419d28cdc1d7af64f57a9b21081e -
Branch / Tag:
refs/heads/main - Owner: https://github.com/gmhoward9289-ops
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@0a46fd8a3c71419d28cdc1d7af64f57a9b21081e -
Trigger Event:
workflow_dispatch
-
Statement type:
File details
Details for the file pytest_session_trace-0.1.1-py3-none-any.whl.
File metadata
- Download URL: pytest_session_trace-0.1.1-py3-none-any.whl
- Upload date:
- Size: 13.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f517b5ea273c0f3e6758e3ccd37c5afe90353752b987628d1bbd2d5dbdb46ff2
|
|
| MD5 |
f62c2abf5274af8b404ca9cdcf3aa53c
|
|
| BLAKE2b-256 |
ad1bf3e6eb73d8b42a0228188e0feace323b6c080e2b7f1d7f2bc4d9a631f45a
|
Provenance
The following attestation bundles were made for pytest_session_trace-0.1.1-py3-none-any.whl:
Publisher:
release.yml on gmhoward9289-ops/pytest-session-trace
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
pytest_session_trace-0.1.1-py3-none-any.whl -
Subject digest:
f517b5ea273c0f3e6758e3ccd37c5afe90353752b987628d1bbd2d5dbdb46ff2 - Sigstore transparency entry: 2530844609
- Sigstore integration time:
-
Permalink:
gmhoward9289-ops/pytest-session-trace@0a46fd8a3c71419d28cdc1d7af64f57a9b21081e -
Branch / Tag:
refs/heads/main - Owner: https://github.com/gmhoward9289-ops
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@0a46fd8a3c71419d28cdc1d7af64f57a9b21081e -
Trigger Event:
workflow_dispatch
-
Statement type:
