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]