Struct DockerfileTranslator 

pub struct DockerfileTranslator { /* private fields */ }

Stateful translator from Instruction to BuildahCommand sequences.

Tracks the target OS and the most recent SHELL instruction so that shell-form RUN / CMD / ENTRYPOINT use the correct shell for the target platform:

• Linux, no SHELL override — RUN cmd → buildah run -- /bin/sh -c "cmd"
• Windows, no SHELL override — RUN cmd → buildah run -- cmd.exe /S /C "cmd"
• Any OS with SHELL ["pwsh", "-Command"] — subsequent RUN cmd uses buildah run -- pwsh -Command "cmd"

The translator is stateful because Dockerfile SHELL instructions persist across subsequent RUN/CMD/ENTRYPOINT translations until another SHELL replaces them. Callers that translate a multi-instruction stage should reuse a single translator instance across the full instruction stream.

This translator is designed to be shared between the buildah backend and the Phase L-4 HCS (Windows host compute service) backend, so neither needs to re-implement the shell-form / workdir branching.

Implementations

impl DockerfileTranslator

pub fn new(target_os: ImageOs) -> Self

Create a new translator for a given target OS, with no SHELL override.

pub fn target_os(&self) -> ImageOs

Return the target OS this translator emits commands for.

pub fn active_shell(&self) -> Vec<String>

Return the current shell-form prefix: the SHELL override if one was applied, else the OS default (/bin/sh -c on Linux, cmd.exe /S /C on Windows).

pub fn set_shell_override(&mut self, shell: Vec<String>)

Replace the translator’s SHELL override, matching the effect of a Dockerfile SHELL ["…"] instruction on subsequent RUN/CMD/ENTRYPOINT shell-form commands.

pub fn translate( &mut self, container: &str, instruction: &Instruction, ) -> Vec<BuildahCommand>

Translate a single instruction into zero or more BuildahCommands.

Stateful: SHELL instructions update the translator’s shell override, so subsequent RUN / CMD / ENTRYPOINT shell-form translations pick up the new shell. WORKDIR emits an OS-appropriate pre-mkdir followed by buildah config --workingdir.

Trait Implementations

impl Clone for DockerfileTranslator

fn clone(&self) -> DockerfileTranslator

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for DockerfileTranslator

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.