Context

module crystallize.utils.context

---

class FrozenMetrics

Immutable mapping of metric lists with safe append.

method FrozenMetrics.__init__

__init__() → None

---

method FrozenMetrics.add

add(key: str, value: Any) → None

---

method FrozenMetrics.as_dict

as_dict() → Mapping[str, Tuple[Any, ...]]

---

class FrozenContext

Immutable execution context shared between pipeline steps.

Once a key is set its value cannot be modified. Attempting to do so raises :class:ContextMutationError. This immutability guarantees deterministic provenance during pipeline execution.

Attributes:

 - <b>`metrics`</b>:  :class:`FrozenMetrics` used to accumulate lists of metric values. artifacts: :class:`ArtifactLog` collecting binary artifacts to be saved
 - <b>`by `</b>: class:`~crystallize.plugins.plugins.ArtifactPlugin`. logger: :class:`logging.Logger` used for debug and info messages.

method FrozenContext.__init__

__init__(
    initial: Mapping[str, Any],
    logger: Optional[logging.Logger] = None
) → None

---

method FrozenContext.add

add(key: str, value: Any) → None

Alias for __setitem__ providing a clearer API.

---

method FrozenContext.as_dict

as_dict() → Mapping[str, Any]

---

method FrozenContext.get

get(key: str, default: Optional[Any] = None) → Any

Return the value for key if present else default.

---

class LoggingContext

A FrozenContext proxy that records every key read and emits DEBUG lines.

Parameters ---------- ctx: The original, immutable context created by the Experiment runner. logger: The logger to use for DEBUG instrumentation.

method LoggingContext.__init__

__init__(
    ctx: crystallize.utils.context.FrozenContext,
    logger: Optional[logging.Logger] = None
)

---

method LoggingContext.add

add(key: str, value: Any) → None

---

method LoggingContext.as_dict

as_dict() → Mapping[str, Any]

---

method LoggingContext.get

get(key: str, default: Optional[Any] = None) → Any