Evaluators / Effects

BlockingEffectEvaluationPolicy

class teksi_hooks.evaluators.effects.BlockingEffectEvaluationPolicy[source]

Conservatively block every unsatisfied desired-state effect.

This policy is suitable when no model-specific persistence guarantees are available.

unsatisfied_status(*, effect, current_object)[source]

Return a blocked result for one unsatisfied effect.

Parameters:

Return type:

EffectEvaluationResult

class teksi_hooks.evaluators.effects.EffectDocumentValidator[source]

Validates EffectDocument instances.

The validator performs structural and semantic checks before effects are persisted or transformed into snapshots.

class teksi_hooks.evaluators.effects.EffectEvaluator(object_lookup, policy)[source]

Evaluate desired-state effects against current canonical state.

The evaluator determines whether each effect is already satisfied. An injected policy classifies unsatisfied effects as remediable or blocked.

The evaluator does not mutate canonical state.

Parameters:

evaluate(document)[source]

Evaluate every effect in document order.

Returns exactly one evaluation result per effect.

evaluate_effect(*, effect, effect_index)[source]

Evaluate one desired-state effect.

Parameters:

Return type:

EffectEvaluationResult