craft_parts.state_manager.stage_state module

State definitions for the stage step.

class craft_parts.state_manager.stage_state.StageState(**data)

Bases: StepState

Context information for the stage step.

Parameters:

data (Any)

model_config: ClassVar[ConfigDict] = {'alias_generator': <function StepState.<lambda>>, 'extra': 'ignore', 'frozen': True, 'populate_by_name': True, 'validate_assignment': True}

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

overlay_hash: Annotated[str | None]

project_options_of_interest(project_options)

Return relevant project options concerning this step.

Parameters:

project_options (dict[str, Any]) – A dictionary containing all project options.

Return type:

dict[str, Any]

Returns:

A dictionary containing project options of interest.

properties_of_interest(part_properties, *, extra_properties=None)

Return relevant properties concerning this step.

Parameters:

• part_properties (dict[str, Any]) – A dictionary containing all part properties.

• extra_properties (Optional[list[str]]) – Additional relevant properties to be returned.

Return type:

dict[str, Any]

Returns:

A dictionary containing properties of interest.

classmethod unmarshal(data)

Create and populate a new StageState object from dictionary data.

The unmarshal method validates entries in the input dictionary, populating the corresponding fields in the state object.

Parameters:

data (dict[str, Any]) – The dictionary data to unmarshal.

Return type:

StageState

Returns:

The newly created object.

Raises:

TypeError – If data is not a dictionary.