23 lines
848 B
Go
23 lines
848 B
Go
// Package userfunc implements a HCL extension that allows user-defined
|
|
// functions in HCL configuration.
|
|
//
|
|
// Using this extension requires some integration effort on the part of the
|
|
// calling application, to pass any declared functions into a HCL evaluation
|
|
// context after processing.
|
|
//
|
|
// The function declaration syntax looks like this:
|
|
//
|
|
// function "foo" {
|
|
// params = ["name"]
|
|
// result = "Hello, ${name}!"
|
|
// }
|
|
//
|
|
// When a user-defined function is called, the expression given for the "result"
|
|
// attribute is evaluated in an isolated evaluation context that defines variables
|
|
// named after the given parameter names.
|
|
//
|
|
// The block name "function" may be overridden by the calling application, if
|
|
// that default name conflicts with an existing block or attribute name in
|
|
// the application.
|
|
package userfunc
|