#docker #dockerfile #dockerfile-generator

dockerfile_builder

Flexible Dockerfile builder with type-safe features

6 releases

0.1.5 Mar 11, 2025
0.1.4 Jul 18, 2023

#226 in Unix APIs

Download history 1/week @ 2024-12-04 1/week @ 2024-12-11 93/week @ 2025-03-05 42/week @ 2025-03-12 10/week @ 2025-03-19

145 downloads per month

MIT/Apache

52KB
960 lines

Documentation Crates.io Crates.io

This library provides a convenient way to programmatically generate Dockerfiles using Rust.

Dockerfiles instructions can be generated using structured and type-safe interfaces, or they can be added flexibly in raw form.

Quickstart

[dependencies]
dockerfile_builder = "0.1.4"
use dockerfile_builder::Dockerfile;
use dockerfile_builder::instruction::{RUN, EXPOSE};

fn main() {
    let dockerfile = Dockerfile::default()
        .push(RUN::from("echo $HOME"))
        .push(EXPOSE::from("80/tcp"))
        .push_any("# Just adding a comment");
    
    let expected = r#"RUN echo $HOME
EXPOSE 80/tcp
# Just adding a comment"#;

    assert_eq!(
        dockerfile.to_string(),
        expected
    );
}

Type-safe support

Dockerfile instructions can be created from a string or with instruction builders. Instruction builders provide structured and type-safe interfaces to build instructions.

use dockerfile_builder::Dockerfile;
use dockerfile_builder::instruction::EXPOSE;
use dockerfile_builder::instruction_builder::ExposeBuilder;

fn main() -> eyre::Result<()> {
    let expose = EXPOSE::from("80/tcp");
    
    let expose_from_builder = ExposeBuilder::builder()
        .port(80)
        .protocol("tcp")
        .build()?;
    
    assert_eq!(expose, expose_from_builder);
    
    let dockerfile = Dockerfile::default()
        .push(expose_from_builder);
      
    assert_eq!(
        dockerfile.to_string(), 
        "EXPOSE 80/tcp"
    );

    Ok(())
}

Dependencies

~0.3–0.8MB
~17K SLoC