craft_parts.executor.step_handler module

Handle the execution of built-in or user specified step commands.

class craft_parts.executor.step_handler.StepContents(files=<factory>, dirs=<factory>)[source]

Bases: object

Files and directories to be added to the step’s state.

Parameters:

  • files (Set[str]) –

  • dirs (Set[str]) –

dirs: Set[str]
files: Set[str]
class craft_parts.executor.step_handler.StepHandler(part, *, step_info, plugin, source_handler, env, stdout=None, stderr=None)[source]

Bases: object

Executes built-in or user-specified step commands.

The step handler takes care of the execution of a step, using either a built-in set of actions to be taken, or executing a user-defined script defined in the part specification User-defined scripts may also call the built-in handler for a step by invoking a control utility. This class implements the built-in handlers and a FIFO-based mechanism and API to be used by the external control utility to communicate with the running instance.

Parameters:

  • part (Part) –

  • step_info (StepInfo) –

  • plugin (Plugin) –

  • source_handler (Optional[SourceHandler]) –

  • env (str) –

  • stdout (Union[TextIO, int, None]) –

  • stderr (Union[TextIO, int, None]) –

run_builtin()[source]

Run the built-in commands for the current step.

Return type:

StepContents

run_scriptlet(scriptlet, *, scriptlet_name, step, work_dir)[source]

Execute a scriptlet.

Parameters:

  • scriptlet (str) – the scriptlet to run.

  • work_dir (Path) – the directory where the script will be executed.

  • scriptlet_name (str) –

  • step (Step) –

Return type:

None