dockerfile-parser 0.2.0-rc1

a Rust library for parsing, validating, and modifying Dockerfiles
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40

// (C) Copyright 2019 Hewlett Packard Enterprise Development LP

use std::convert::TryFrom;

use pest::Parser;
use snafu::ResultExt;

use crate::dockerfile::Instruction;
use crate::error::*;
use crate::parser::{DockerfileParser, Pair, Rule};

pub fn strings(strs: &[&str]) -> Vec<String> {
  strs.iter().map(|s| String::from(*s)).collect()
}

/// Parses a string into a single instruction using a particular syntax rule.
///
/// This is technically over-constrained as we could just parse any single
/// instruction using `Rule::step`, however doing so isn't ideal for
/// per-instruction unit tests.
pub fn parse_single(input: &str, rule: Rule) -> Result<Instruction> {
  let record = DockerfileParser::parse(rule, input)
    .context(ParseError)?
    .next()
    .ok_or(Error::UnknownParseError)?;

  Instruction::try_from(record)
}

pub fn parse_direct<T, F>(input: &str, rule: Rule, func: F) -> Result<T>
where
  F: Fn(Pair) -> Result<T>
{
  let pair = DockerfileParser::parse(rule, input)
    .context(ParseError)?
    .next()
    .ok_or(Error::UnknownParseError)?;

  func(pair)
}