graph LR
glom_core_glom["glom.core.glom"]
glom_core__glom["glom.core._glom"]
glom_core__t_eval["glom.core._t_eval"]
glom_core_ScopeVars["glom.core.ScopeVars"]
glom_core_TargetRegistry["glom.core.TargetRegistry"]
glom_core_register_op["glom.core.register_op"]
glom_core_glom -- "delegates to" --> glom_core__glom
glom_core_glom -- "sets up" --> glom_core_ScopeVars
glom_core__glom -- "delegates to" --> glom_core__t_eval
glom_core__glom -- "utilizes" --> glom_core_ScopeVars
glom_core__t_eval -- "queries" --> glom_core_TargetRegistry
glom_core__t_eval -- "relies on" --> glom_core_ScopeVars
glom_core_register_op -- "modifies" --> glom_core_TargetRegistry
The Core Transformation Engine subsystem in glom is primarily defined by the glom.core module, specifically encompassing the core transformation logic. Its boundaries are marked by the public glom.core.glom function, the internal recursive glom.core._glom engine, the glom.core._t_eval evaluation mechanism, and the supporting infrastructure for context management (glom.core.ScopeVars) and operation dispatch (glom.core.TargetRegistry, glom.core.register_op).
The primary public API entry point for initiating data transformations. It acts as the orchestrator, setting up the initial execution context, including ScopeVars, and delegating the core transformation process to _glom.
Related Classes/Methods:
The internal, recursive transformation engine. It interprets the overall transformation specification (spec) and iteratively applies it to the data, delegating individual transformation steps to _t_eval. This component is central to the pipeline's execution.
Related Classes/Methods:
The core evaluation engine responsible for processing individual transformation nodes (instances of TType). It dispatches operations to the correct handlers based on the TargetRegistry, effectively executing the specific transformation logic.
Related Classes/Methods:
Manages the dynamic scope and contextual variables during a transformation's execution. It provides crucial runtime context, such as the current data target and root data, enabling flexible and context-aware transformations within the DSL.
Related Classes/Methods:
A central registry that maps data types and operations to their corresponding transformation handlers. It is fundamental for enabling polymorphic behavior and allowing _t_eval to correctly dispatch operations based on the current data and specification.
Related Classes/Methods:
A utility function that provides extensibility to the glom engine. It allows users to register custom transformation operations or override built-in ones by modifying the TargetRegistry, thereby extending the library's capabilities.
Related Classes/Methods: