Dockerfile format and parser, and a modern version of dockfmt. Built on top of the internal buildkit parser.
Binaries are available from the releases page.
A updated version of the dockfmt. Uses the dockerfile parser from moby/buildkit and the shell formatter from mvdan/sh.
Usage:
dockerfmt [Dockerfile] [flags]
dockerfmt [command]
Available Commands:
completion Generate the autocompletion script for the specified shell
help Help about any command
version Print the version number of dockerfmt
Flags:
-c, --check Check if the file(s) are formatted
-h, --help help for dockerfmt
-i, --indent uint Number of spaces to use for indentation (default 4)
-n, --newline End the file with a trailing newline
-w, --write Write the formatted output back to the file(s)
Use "dockerfmt [command] --help" for more information about a command.
- The
RUNparser currently doesn’t support grouping or semicolons in commands - No line wrapping is performed for long JSON commands
- The
# escape=Xdirective is not supported
Contributions are welcome!
RUN <"hello"
echo "world"
EOF
- Support for basic inline comments in run steps:
RUN echo "hello" \
# this is a comment
&& echo "world"
RUN echo "hello" \
# this is a comment
# that spans multiple lines
&& echo "world"
This is surprisingly non-trivial as we want to attach the comments to their position in the formatted output, but they are stripped by the parser beforehand.
The JS bindings are available in the js directory. More information on how to use them can be found in the README file.