module Hace

Extended Modules

• Hace

Defined in:

completion.cr
hace.cr
makefile.cr

Constant Summary

DEPRECATED_ENV_WARNED = Set(String).new

Environment variable names that already produced a deprecation warning (${NAME} expansion, brace-less $NAME in non-command fields), so each is reported at most once per run.

ENVIRONMENT = {} of String => String

FAIL_FAST_SHELLS = ["sh", "bash", "zsh", "dash", "ash", "ksh", "mksh"] of ::String

Shells that understand POSIX fail-fast (-e). When a task or Hacefile selects one of these shells without explicit arguments, hace runs the commands with "-e -c" so multi-command tasks stop at the first failure, matching the default /bin/sh behavior. Other shells (python, cmd.exe, ...) only get the script passed via -c.

RECIPE_STAMP_DIR = ".hace"

Recipe stamps make the rendered recipe part of the staleness model.

Croupier only considers missing outputs, input file hashes and upstream staleness, so editing a task's commands in the Hacefile would never trigger a rebuild. To fix that, every task gets an extra input: a small file whose content is the SHA1 of its commands, shell and working directory. When the recipe changes, the stamp content changes, and the regular input-hash comparison marks the task stale.

TASKS_WITH_CLI_ARGS = Set(String).new

Track which tasks explicitly use CLI_ARGS (detected before Crinja expansion)

VARIABLES = {} of String => Value

VERSION = {{ (`shards version /srv/crystaldoc.info/github-ralsina-hace-v1.2.3/src`).chomp.stringify }}

Class Method Summary

• .env_namespace : Hash(String, Value)

  Snapshot the merged environment view as template variables, backing the env namespace ({{ env.NAME }}).

• .expand_env_in_value(value : Hace::Value) : Hace::Value

  Expand the deprecated ${ENV_VAR} references inside a value and everything nested in it, leaving non-string values untouched.

• .expand_env_vars(str : String) : String

  Expand the deprecated braced ${ENV_VAR} references from the merged environment view.

• .expand_glob(str : String) : Array(String)
• .expand_string(str : String, variables = Hace::VARIABLES) : String
• .from_yaml_any(any : YAML::Any) : Hace::Value

  Convert a parsed YAML node into the typed Value representation.

• .inject_cli_args(cli_args : Array(String))

  Inject CLI_ARGS and CLI_ARGS_LIST into VARIABLES for template expansion

• .load_dotenv(dotenv_file = nil)
• .recipe_stamp_path(task_name : String) : String
• .reset_state

  Clear the module-level mutable state (VARIABLES, ENVIRONMENT, the CLI_ARGS tracking set and the env-deprecation warning set).

• .stamp_recipe(task_name : String, signature : String) : String

  Record the current recipe signature for task_name and return the stamp path.

• .to_crinja_value(value : Hace::Value) : Crinja::Value
• .to_crinja_variables(hash : Hash(String, Value)) : Crinja::Variables

  Convert a Hash(String, Value) to Crinja::Variables

• .warn_braceless_env_ref(str : String)

  Warn about brace-less $WORD references in non-command fields: hace no longer expands them, so a value like "$HOME" stays literal.

Class Method Detail