Skip to content

Latest commit

 

History

History
116 lines (83 loc) · 3.25 KB

cask_language_deltas.md

File metadata and controls

116 lines (83 loc) · 3.25 KB

Cask Language Deltas

This document summarizes revisions to the Cask Domain-Specific Language (DSL).

Cask DSL 1.0

These are deltas from the pre-existing (unversioned) conventions to the Cask DSL 1.0 specification.

This Document Is Incomplete

This document still being written. It is not yet a complete reference. This notice will be removed for the final form.

Removals (1.0)

Stub!

Additions (1.0)

  • appcast
  • artifact
  • depends_on :cask
    • stub - not yet functional
  • depends_on :macos
    • stub - not yet functional
  • depends_on :arch
    • stub - not yet functional
  • depends_on :x11
    • stub - not yet functional
  • depends_on :java
    • stub - not yet functional
  • conflicts_with
    • stub - not yet functional
  • gpg
  • installer :script
  • license
  • suite
  • stage_only
  • tags
  • uninstall :rmdir
  • uninstall :trash
    • stub - currently just a synonym for uninstall :delete
  • zap

Renames (1.0)

old form new form
after_install postflight
after_uninstall uninstall_postflight
before_install preflight
before_uninstall uninstall_preflight
container_type container :type
depends_on_formula depends_on :formula
install pkg
link app (or sometimes suite or artifact)
nested_container container :nested =>
uninstall :files uninstall :delete
version 'latest' version :latest
manual_installer(path) (within caveats) installer :manual
destination_path staged_path

All Supported Stanzas (1.0)

Stub!

Header Line (1.0)

The header line was changed from the form

class MyApp < Cask

to

cask :v1 => 'my-app' do

Legacy rules for mapping Cask filenames to header class names are no longer needed. The name 'my-app' in the header corresponds directly to the filename my-app.rb.

The term :v1 identifies the DSL version (currently 1.0), and defines the features which are available for the current Cask.

References

<3 THANK YOU TO ALL CONTRIBUTORS! <3