Temper.Env (temper v0.2.0)

Boundary module that gathers run context data from the real world: git, CI environment variables, the system clock and the runtime.

gather/1 returns a plain map suitable for Temper.RunContext.new/1. All side effects live here so the core stays pure; every lookup degrades gracefully (no git, no repository, no CI) to nil values rather than raising.

Summary

Types

option()

Options for gather/1.

Functions

gather(opts \\ [])

Gathers environment data into a plain map for Temper.RunContext.new/1.

Types

option()

@type option() :: {:cd, Path.t()}

Options for gather/1.

Functions

gather(opts \\ [])

@spec gather([option()]) :: map()

Gathers environment data into a plain map for Temper.RunContext.new/1.

The map always contains :run_id (fresh 16-byte random hex), :at (UTC ISO 8601, second precision), :elixir, :otp, :partition (from MIX_TEST_PARTITION), :ci, :sha, :dirty and :branch.

Git data is resolved with the first source that answers:

Manual override — a non-empty TEMPER_SHA switches git context to manual mode: :sha from TEMPER_SHA, :dirty from TEMPER_DIRTY ("true"/"1"/"yes", default false), :branch from TEMPER_BRANCH (default nil). For environments where git is out of reach — a test container without the .git directory, a sandboxed build — pass the values in from outside. Without TEMPER_SHA, the other two TEMPER_* variables are ignored.
CI provider variables (e.g. GITHUB_SHA) — CI checkouts are clean by construction, so no shelling out.
Local git — git rev-parse/git status in opts[:cd] (default: the current directory); nil values outside a repository or without git installed.

The ExUnit :seed is intentionally absent — only the formatter knows it, and merges it into this map itself.