DSL: add dsl
stanza, defining DSL specification version for a Cask
#4870
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
References: #4688
Renamed
dsl
from earlier proposed stanzaspec
.I remain conflicted about adding boilerplate to the Cask language. Simplicity is
what makes Casks amenable to first-time authors, and first-time authors are the
principal drivers of this project.
However, the technical advantage of specifying the DSL version is pretty hard to deny
if we merge #3066 — which is also seeking simplicity, in the form of very straightforward
bookkeeping.
The alternatives to #3066 are: binary serialization (which will break), or creating
a new log format which largely duplicates the info in the Cask DSL — which requires
much more new code. Also, both alternatives would reduce transparency to the
user.