Struct Stages

pub struct Stages<'a> {
    pub stages: Vec<Stage<'a>>,
}

A collection of stages in a [multi-stage build].

Example

use dockerfile_parser::Dockerfile;

let dockerfile = Dockerfile::parse(r#"
  FROM alpine:3.12 as build
  RUN echo "hello world" > /foo

  FROM ubuntu:18.04
  COPY --from=0 /foo /foo
"#).unwrap();

for stage in dockerfile.stages() {
  println!("stage #{}, name: {:?}", stage.index, stage.name)
}

Fields

stages: Vec<Stage<'a>>

Implementations

impl<'a> Stages<'a>

pub fn new(dockerfile: &'a Dockerfile) -> Stages<'a>

pub fn get_by_name(&'a self, name: &str) -> Option<&'a Stage<'a>>

Attempts to fetch a stage by its name (FROM alias).

pub fn get(&'a self, s: &str) -> Option<&'a Stage<'a>>

Attempts to fetch a stage by its string representation.

Stages with a valid integer value are retrieved by index, otherwise by name.

pub fn iter(&self) -> Iter<'_, Stage<'a>>

Returns an iterator over stages, wrapping the underlying Vec::iter().

Trait Implementations

impl<'a> Debug for Stages<'a>

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

Formats the value using the given formatter.

impl<'a> Index<usize> for Stages<'a>

type Output = Stage<'a>

The returned type after indexing.

fn index(&self, index: usize) -> &Self::Output

Performs the indexing (container[index]) operation.

impl<'a> IntoIterator for Stages<'a>

type Item = Stage<'a>

The type of the elements being iterated over.

type IntoIter = IntoIter<Stage<'a>>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.