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 with_empty_src_dir(self, dir: PathBuf) -> Self

Point WORKDIR translation at an empty host directory used as the source for buildah copy, which materializes the workdir in the container rootfs without executing a process inside the container.

Without this, WORKDIR falls back to buildah run -- mkdir -p <dir>, which fails on distroless / scratch images that lack a shell. Production callers (the BuildahBackend’s build loop) should create a TempDir for the lifetime of the build and pass its path here. The translator does NOT own the directory’s lifecycle — callers must keep it alive (and empty) until every translated WORKDIR buildah copy command has finished executing.

pub fn with_host_network(self, on: bool) -> Self

Force every translated RUN instruction to use host networking.

When on is true, the translator overrides any per-instruction network value (including None) with RunNetwork::Host before emitting the buildah command. This mirrors the effect of Docker’s docker build --network=host flag and bypasses buildah’s CNI / netavark plumbing entirely. When on is false (the default), per-instruction network values are passed through unchanged.

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.