hcl

Overview ¶

Package hcl is an HCL2 front-end for pkgx pantry recipes. A package.hcl is decoded into the SAME pantry.Recipe as a package.yml — via the same schema validation — so a recipe written either way produces an identical build.

Example (equivalent to the curl.se package.yml):

distributable {
  url              = "https://curl.se/download/curl-{{version}}.tar.bz2"
  strip-components = 1
}
dependencies = { "openssl.org" = "^1.1", "zlib.net" = "^1.2.11" }
build {
  script = ["./configure $ARGS", "make --jobs {{ hw.concurrency }} install"]
  env    = { ARGS = ["--prefix={{prefix}}", "--with-openssl"] }
}
provides = ["bin/curl", "bin/curl-config"]

Blocks express nested maps (build, test, distributable); object attributes express maps whose keys aren't HCL identifiers (eg. "openssl.org").