.os.* — process environment

Process-environment access. The namespace is deliberately small: two builtins read and write environment variables. Filesystem metadata lives in its own .fs.* namespace.

Restricted under -U

.os.getenv and .os.setenv are RAY_FN_RESTRICTED (environment is process-global state).

Reference

Function	Arity	Flags	Description
.os.getenv	unary	restricted	Read an environment variable as a string.
.os.setenv	binary	restricted	Set an environment variable.

.os.getenv

Signature: (.os.getenv "NAME"). Returns the value as a string, or the empty string if the variable is unset.

Errors: type (arg not a string), domain (empty arg).

(.os.getenv "HOME")
;; => "/Users/anton"

(.os.getenv "NONEXISTENT")
;; => ""

.os.setenv

Signature: (.os.setenv "NAME" "value"). Both args must be strings. Returns value (retained) so the call composes inside larger expressions.

Errors: type (either arg not a string), domain (null pointer).

(.os.setenv "RAY_DEBUG" "1")

See also

• .fs.* — filesystem metadata (size / list).
• .sys.exec — shell out for anything not covered here.