cache

Classes

`EvaluationRequest`
`EvaluationResult`
`EvaluationCache`	Durable JSON result cache keyed by `EvaluationRequest` identity.

class EvaluationCache

Bases: object

Durable JSON result cache keyed by EvaluationRequest identity.

The cache stores one JSON file per request identity under results/ and updates an index.json sidecar under the same file lock. The per-result files are the source of truth; the index exists only for cheap inspection.

__init__(root)

Parameters:: root (str | Path)

get(request)

Parameters:: request (EvaluationRequest)
Return type:: EvaluationResult | None

path_for(request_id)

Parameters:: request_id (str)
Return type:: Path

put(result, request=None)

Parameters:

result (EvaluationResult)
request (EvaluationRequest | None)

Return type:

None

class EvaluationRequest

Bases: object

__init__(*, handler, payload, settings=<factory>)

Parameters:

handler (str)
payload (dict[str, Any])
settings (dict[str, Any])

Return type:

None

classmethod from_dict(data)

Parameters:: data (dict[str, Any])
Return type:: EvaluationRequest

handler: str

property identity: str

payload: dict[str, Any]

settings: dict[str, Any]

to_dict()

Return type:: dict[str, Any]

with_settings(**updates)

Parameters:: updates (Any)
Return type:: EvaluationRequest

class EvaluationResult

Bases: object

__init__(*, request_id, metrics, artifacts=<factory>, metadata=<factory>)

Parameters:

request_id (str)
metrics (dict[str, Any])
artifacts (dict[str, Any])
metadata (dict[str, Any])

Return type:

None

artifacts: dict[str, Any]

classmethod from_dict(data)

Parameters:: data (dict[str, Any])
Return type:: EvaluationResult

metadata: dict[str, Any]

metrics: dict[str, Any]

request_id: str

to_dict()

Return type:: dict[str, Any]