Metadata-Version: 2.4
Name: agentforge-testing
Version: 0.2.2
Summary: Richer test helpers for AgentForge (golden-set runner, snapshot, recording analysis)
Project-URL: Homepage, https://github.com/Scaffoldic/agentforge-py
Project-URL: Repository, https://github.com/Scaffoldic/agentforge-py
Project-URL: Documentation, https://github.com/Scaffoldic/agentforge-py
Project-URL: Changelog, https://github.com/Scaffoldic/agentforge-py/blob/main/CHANGELOG.md
Project-URL: Issues, https://github.com/Scaffoldic/agentforge-py/issues
Author: The AgentForge Authors
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: agent,ai,framework,golden,snapshot,testing
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Software Development :: Testing
Classifier: Typing :: Typed
Requires-Python: >=3.13
Requires-Dist: agentforge-core~=0.2.2
Requires-Dist: agentforge-py~=0.2.2
Description-Content-Type: text/markdown

# agentforge-testing

Richer test helpers for AgentForge agents. Pip-installable
separately so the dependency doesn't land in production.

The lighter built-in surface — `MockLLMClient`, `FakeTool`,
`agent_factory`, conformance harnesses, `record_llm` /
`MockLLMClient.from_recording` — ships inside the `agentforge`
runtime package at `agentforge.testing`. Install **this** package
when you want, additionally:

- `GoldenSetRunner` — load JSONL fixtures, run an agent, compare
  output via structural diff with allow-listed wildcards.
- `assert_snapshot(actual, path)` — Approval-style snapshot file
  helper with `UPDATE_SNAPSHOTS=1` re-record.
- `analyze_recording(path)` — stats about a captured cassette
  (call count, token totals, distinct tool calls, per-step
  latency distribution).

```bash
uv add --dev agentforge-testing
```
