Skip to main content

File bindings

<name> is defined by file "<filepath>"

Associates a name with the contents of a file. The value is resolved every time the name is referenced.

Where

  • <name> is the name to associated the file contents
  • <filepath> the path to the file (can be in DocString position)

Optionally accepts the @Eager or @Lazy annotations.

  • @Eager immediately evaluates the <expression> and binds the result to <name>
  • @Lazy evaluates the <expression> and binds the result to <name> when it is first referenced
  • In the absence of either annotation, <expression> is evaluated every time <name> is referenced

Example

  Given the content is defined by file "path/to/file.txt"
<name> is defined by <encoding> file "<filepath>"

Associates a name with the contents of a file using a given character encoding. The value is resolved every time the name is referenced.

Where

  • <name> is the name to associated the file contents
  • <encoding> is the encoding to use when reading the file
  • <filepath> the path to the file (can be in DocString position)

Optionally accepts the @Eager or @Lazy annotations.

  • @Eager immediately evaluates the <expression> and binds the result to <name>
  • @Lazy evaluates the <expression> and binds the result to <name> when it is first referenced
  • In the absence of either annotation, <expression> is evaluated every time <name> is referenced

Example

  Given the content is defined by UTF-8 file "path/to/file.txt"