Dockerfile Model 1.2.0

What's Changed

Features

• Do not require comma delimiters for exec form by @mthalman in #117

Dependency Updates

• Pin dependencies by @renovate in #105
• Update actions/setup-dotnet action to v1.9.1 by @renovate in #106
• Update dependency Microsoft.NET.Test.Sdk to 17.11.1 by @renovate in #110
• Update actions/upload-artifact action to v2.3.1 by @renovate in #109
• Update xunit-dotnet monorepo by @renovate in #111
• Update actions/checkout action to v4 by @renovate in #112
• Update actions/setup-dotnet action to v4 by @renovate in #113
• Update dependency coverlet.collector to v6 by @renovate in #114

Infrastructure

• Configure global.json by @mthalman in #108
• Fix test step in workflow by @mthalman in #118

Full Changelog: v1.1.1...v1.2.0

Dockerfile Model v1.1.1

What's Changed

• Upgrade System.Text.RegularExpressions by @mthalman in #104

Full Changelog: v1.1.0...v1.1.1

Download the NuGet package: Valleysoft.DockerfileModel

Dockerfile Model 1.1.0

What's Changed

• Add features to readme by @mthalman in #95
• Allow port to be parsed in image name by @mthalman in #96
• Update workflows to .NET 6 SDK by @mthalman in #97
• Upgrade to C# 10 by @mthalman in #98
• Fix ENV instruction parsing by @mthalman in #99
• Project updates by @mthalman in #100

Download the NuGet package: Valleysoft.DockerfileModel

Dockerfile Model 1.0.0

This .NET library provides a structured model of the Dockerfile syntax for the purposes of parsing and generating Dockerfiles.

This initial pre-release provides the ability to parse any Dockerfile with structured types for all constructs (instructions, comments, and parser directives).

Key Features

• A high-level model for interacting with Dockerfile constructs.
• Access to the underlying tokens that make up the higher-level model.
• Full fidelity for input and output: the model's output is identical to the Dockerfile input.
• Resolve ARG values that are referenced throughout a Dockerfile.
• Ability to further organize a Dockerfile model in terms of its stages.

Download the NuGet package: Valleysoft.DockerfileModel

DockerfileModel 0.5.0

This .NET library provides a structured model of the Dockerfile syntax for the purposes of parsing and generating Dockerfiles. This release is feature complete and considered a release candidate. It provides parsed models of all Dockerfile instructions and their underlying syntax.

New features

• Support for from flag in COPY instruction
• Add support for LABEL instruction
• Add support for MAINTAINER instruction
• Add support for ONBUILD instruction
• Add support for SHELL instruction
• Add support for STOPSIGNAL instruction
• Add support for USER instruction
• Add support for VOLUME instruction
• Add support for WORKDIR instruction

Design changes

• Redesign identifier token
• Support line continuations on input to KeywordToken
• Redesign command-related APIs
• Add support for the chmod flag
• Support multiple declarations in a single ARG instruction
• Support env option for secret mounts
• Rename ChangeOwner to UserAccount
• Expose IList of exec-form command value tokens
• Rename class for CMD instruction

Bug fixes

• Fix ENV inst parsing with newline
• Fix parsing of empty line continuations for commands
• Flow escape character
• Fix command parsing for RUN instruction
• Fix parsing of spaces for ENV instruction
• Fix variable character parsing
• Fix parsing of literals containing multiple quote pairs
• Allow non-uppercase instructions
• Fix variable resolution of aggregate tokens

Download

Download the NuGet package: DockerfileModel

DockerfileModel 0.4.0

This .NET library provides a structured model of the Dockerfile syntax for the purposes of parsing and generating Dockerfiles.

New features in this release:

• LiteralToken supports tokenizing of line continuation and variable refs from input string: #63

Download the NuGet package: DockerfileModel

DockerfileModel 0.3.0

This .NET library provides a structured model of the Dockerfile syntax for the purposes of parsing and generating Dockerfiles.

New features in this release:

• Support for secret mounts in RUN instruction: #34
• Construct Dockerfiles with a fluent API: #47, #49
• Support for CMD instruction: #51
• Support for ADD and COPY instructions: #53
• Support for ENTRYPOINT instruction: #54
• Support for EXPOSE instruction: #55
• Support for ENV instruction: #57
• Support for HEALTHCHECK instruction: #60

Download the NuGet package: DockerfileModel

DockerfileModel 0.2.0

This .NET library provides a structured model of the Dockerfile syntax for the purposes of parsing and generating Dockerfiles.

New features in this release:

• Improved argument referencing parsing with full syntax support: #26
• Intra-token line continuation support: #28
• Access to underlying semantic tokens of model items: #30
• RUN instruction parsing supporting both shell form and exec form syntax: #31

Download the NuGet package: DockerfileModel

DockerfileModel 0.1.0

This .NET library provides a structured model of the Dockerfile syntax for the purposes of parsing and generating Dockerfiles.

This initial pre-release provides the ability to parse any Dockerfile with structured types for the following constructs:

• ARG instruction
• FROM instruction
• Comments
• Parser directives

All other instructions besides ARG and FROM and parsed into a basic, generalized instruction type that parses the instruction's args into a single string. Specialized support for more instruction types are in development.

One of the key features in this release is the ability to resolve ARG values that are referenced throughout a Dockerfile.

Download the NuGet package: DockerfileModel