The std/envvars module implements environment variable handling.
Types
ReadEnvEffect = object of ReadIOEffect
- Effect that denotes a read from an environment variable. Source Edit
WriteEnvEffect = object of WriteIOEffect
- Effect that denotes a write to an environment variable. Source Edit
Procs
proc getEnv(key: string; default = ""): string {....tags: [ReadEnvEffect], raises: [], forbids: [].}
-
Returns the value of the environment variable named key.
If the variable does not exist, "" is returned. To distinguish whether a variable exists or it's value is just "", call existsEnv(key) proc.
See also:
Example:
assert getEnv("unknownEnv") == "" assert getEnv("unknownEnv", "doesn't exist") == "doesn't exist"
Source Edit
Iterators
iterator envPairs(): tuple[key, value: string] {....tags: [ReadEnvEffect], raises: [], forbids: [].}
-
Iterate over all environments variables.
In the first component of the tuple is the name of the current variable stored, in the second its value.
Works in native backends, nodejs and vm, like the following APIs:
Source Edit