fileset

fileset(path, pattern) returns a set of file paths matching pattern within path. The paths are relative to path. The set is unordered; use sort when order matters.

Signature

fileset(path string, pattern string) set(string)

pattern supports * (any characters except /), ** (any path components), and ? (any single character).

Example

Discover all SQL migration files and run them in alphabetical order:

computed "migrations" {
  description = "All SQL migration files"
  expression  = fileset(".", "migrations/*.sql")
}

task "migrate" {
  description = "Apply all pending migrations"
  commands = [
    "for f in ${join(" ", sort(computed.migrations))}; do psql -f $f && echo \"Applied $f\"; done",
  ]
}

All .sql files under migrations/ are discovered and applied in alphabetical order, which corresponds to their numeric prefix order (e.g., 001_init.sql, 002_users.sql).

Notes

The returned paths are relative to path, not to the playbook directory.
Use sort when you need a deterministic traversal order.
Hidden files (starting with .) are not included unless the pattern explicitly matches them.
Only files are returned, not directories.

Overview

String

Number

Collection

Encoding

Crypto

Filesystem

Datetime

Regex

UUID

Conversion

Environment

Runtime

Signature

Example

Notes

​Signature

​Example

​Notes

Signature

Example

Notes