python.GeneratorSettingsSemantics.GeneratorSettingsValue Class Reference

Collaboration diagram for python.GeneratorSettingsSemantics.GeneratorSettingsValue:

Public Member Functions
	__init__ (self, layers=None)
	data (self)
	resolve (self, report_context=None, emit_report=False)
	__str__ (self)

Public Attributes
list	layers = []

Protected Member Functions
	_resolve (self)

Protected Attributes
	_reported_contexts = set()

Detailed Description

Stored property value used by GeneratorSettingsSemantics.

It keeps the unresolved layers rather than a pre-merged list so that
CA merges remain associative: base.merge(user) and user.merge(base) 
yield the same result.

Definition at line 101 of file GeneratorSettingsSemantics.py.

Constructor & Destructor Documentation

__init__()

python.GeneratorSettingsSemantics.GeneratorSettingsValue.__init__	(		self,
			layers = None )

Definition at line 109 of file GeneratorSettingsSemantics.py.

    def __init__(self, layers=None):
        self.layers = []
        self._reported_contexts = set()
        seen = set()
 
        for layer in layers or ():
            if not isinstance(layer, GeneratorSettingsLayer):
                layer_type = type(layer).__name__
                raise TypeError(
                    f"GeneratorSettingsValue layers must be "
                    f"GeneratorSettingsLayer instances, got {layer_type}"
                )
 
            # Deduplicate identical layers explicitly instead of relying on
            # object identity. This is what makes repeated symmetric CA merges
            # yield the same result.
            key = (
                layer.source,
                layer.values,
                layer.precedence,
                layer.separators,
                layer.keep,
                layer.report_context,
            )
            if key not in seen:
                self.layers.append(layer)
                seen.add(key)
 

Member Function Documentation

__str__()

python.GeneratorSettingsSemantics.GeneratorSettingsValue.__str__

(

self

)

Return the resolved list as a string.
ComponentAccumulator.gatherProps() converts stored property values
to strings before handing them to Gaudi.

Definition at line 162 of file GeneratorSettingsSemantics.py.

    def __str__(self):
        """
        Return the resolved list as a string.
        ComponentAccumulator.gatherProps() converts stored property values
        to strings before handing them to Gaudi.
        """
        return str(self.resolve(emit_report=True))
 

_resolve()

python.GeneratorSettingsSemantics.GeneratorSettingsValue._resolve ( self )

protected

Return the final command list plus the duplicate/conflict report.

Definition at line 170 of file GeneratorSettingsSemantics.py.

    def _resolve(self):
        """Return the final command list plus the duplicate/conflict report."""
        layers = _ordered_layers(self.layers)
        separators = layers[0].separators if layers else ("=",)
        keep = layers[0].keep if layers else GeneratorSettingsKeep.LAST
        precedences_seen = {}
        for layer in layers:
            if (
                layer.separators == separators
                and layer.keep == keep
            ):
                if layer.precedence in precedences_seen:
                    previous_layer = precedences_seen[layer.precedence]
                    raise ValueError(
                        f"cannot merge generator settings with duplicate "
                        f"precedence {layer.precedence.name}: "
                        f"{previous_layer.source} and {layer.source}"
                    )
                precedences_seen[layer.precedence] = layer
                continue
 
            summary = ", ".join(
                f"{entry.source}: separators={entry.separators}, "
                f"keep={entry.keep.value}"
                for entry in layers
            )
            raise ValueError(
                f"cannot merge generator settings with different parsing "
                f"settings: "
                f"{summary}"
            )
 
        records = _build_records(layers, separators)
        kept_records, removed_records = _deduplicate_records(records, keep)
        return (
            [record["original_setting"] for record in kept_records],
            _build_report(records, kept_records, removed_records),
        )
 
 

data()

python.GeneratorSettingsSemantics.GeneratorSettingsValue.data

(

self

)

Definition at line 138 of file GeneratorSettingsSemantics.py.

    def data(self):
        return self.resolve()
 

resolve()

python.GeneratorSettingsSemantics.GeneratorSettingsValue.resolve	(		self,
			report_context = None,
			emit_report = False )

Resolve all layers to the final settings list.

If emit_report is True, print duplicate/conflict warnings once using
report_context (or a layer-provided report_context if available).

Definition at line 141 of file GeneratorSettingsSemantics.py.

    def resolve(self, report_context=None, emit_report=False):
        """
        Resolve all layers to the final settings list.
 
        If emit_report is True, print duplicate/conflict warnings once using
        report_context (or a layer-provided report_context if available).
        """
        settings, report = self._resolve()
 
        if emit_report:
            for settings_layer in _ordered_layers(self.layers):
                if settings_layer.report_context:
                    report_context = settings_layer.report_context
                    break
 
            if report_context and report_context not in self._reported_contexts:
                _log_report(report_context, report)
                self._reported_contexts.add(report_context)
 
        return settings
 

Member Data Documentation

_reported_contexts

python.GeneratorSettingsSemantics.GeneratorSettingsValue._reported_contexts = set()

protected

Definition at line 111 of file GeneratorSettingsSemantics.py.

layers

python.GeneratorSettingsSemantics.GeneratorSettingsValue.layers = []

Definition at line 110 of file GeneratorSettingsSemantics.py.

---

The documentation for this class was generated from the following file:

• GeneratorSettingsSemantics.py