Struct Dockerfile 

pub struct Dockerfile {
    pub global_args: Vec<ArgInstruction>,
    pub stages: Vec<Stage>,
}

A parsed Dockerfile

Fields

global_args: Vec<ArgInstruction>

Global ARG instructions that appear before the first FROM

stages: Vec<Stage>

Build stages

Implementations

impl Dockerfile

pub fn resolve_from_args(&mut self, build_args: &HashMap<String, String>)

Expand pre-FROM ARGs in every stage’s FROM target.

Docker semantics: only ARGs declared BEFORE the first FROM participate in FROM-line expansion (FROM ${BASE_IMAGE} / FROM img:${TAG:-latest}), with --build-arg values overriding their defaults. The parser can’t do this (it has no build args), so targets containing $ end up classified as DockerfileFromTarget::Stage — and struct-consuming backends then fail with Stage '${BASE_IMAGE}' not found. Call this with the effective build args before handing the Dockerfile to a backend.

Expanded targets are re-classified: scratch, a previously declared stage name, an OCI image reference, or (still) a stage string. A target that expands to an empty string is left untouched so the eventual error names the unexpanded variable instead of a blank.

pub fn parse(content: &str) -> Result<Self>

Parse a Dockerfile from a string

Errors

Returns an error if the Dockerfile content is malformed or contains invalid instructions.

pub fn from_file(path: impl AsRef<Path>) -> Result<Self>

Parse a Dockerfile from a file

Errors

Returns an error if the file cannot be read or the Dockerfile is malformed.

pub fn get_stage(&self, name_or_index: &str) -> Option<&Stage>

Get a stage by name or index

pub fn final_stage(&self) -> Option<&Stage>

Get the final stage (last one in the Dockerfile)

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

Get all stage names/identifiers

pub fn has_stage(&self, name_or_index: &str) -> bool

Check if a stage exists

pub fn stage_count(&self) -> usize

Returns the number of stages

Trait Implementations

impl Clone for Dockerfile

fn clone(&self) -> Dockerfile

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Dockerfile

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Dockerfile

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Dockerfile

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.