Docker file parser
Parses a dockerfile contents string and returns the array of commands, keeping
the original file order.Usage
var parser = require('docker-file-parser');
var options = { includeComments: false };
var contents = 'FROM ubuntu:latest\n'
+ 'ADD . /root\n'
+ 'RUN echo done\n';
var commands = parser.parse(contents, options);
commands.every(function (cmd) { console.log(cmd); });Options
includeComments Whether to include comment commands in the returned array.A comment will have the command name as 'COMMENT'.Command entries
Each returned command entry is an object with these properties:name The capitalized name of the command, e.g. 'FROM'.
args Arguments for the command (can be array, string or map).
lineno Line number from the contents string.
error Only if there was an error parsing command.Example:
{
name: 'ADD',
args: [ '.', '/srv/app' ],
lineno: 5
}Notes
There are other docker file parse modules for JavaScript, like
dockerfile-parse and dockerfile-parser, this module differs in the follow
aspects:- keeps the ordering of the commands (as they occur in the dockerfile)
- written from a translation of the docker parser.go
- properly handles character escaping and quoting, e.g. ENV myName="John Doe" myDog=Rex\ The\ Dog
- handles multi-line commands (i.e. have a line continuance '\' at the end)
- can optionally include the comments
