Search…
Environment variables

Environment Variables

DCli provides tools to manage the environment variables within your DCli script and any child process you call from a DCli script.
For complete API documentation refer to: pub.dev
When a DCli script starts, it loads the set of environment variables from its parent process (usually your shell). The full set of environment variables are available via the envs function which returns a map containing key/value pairs for all environment variables.
To access an environment variable called 'COLORTERM':
1
var colorTermValue = env['COLORTERM'];
Copied!
You can also set an environment variable:
1
env['DART_SDK'] = 'somepath';
Copied!
Once you create or modify an environment variable, then any calls to env[] will return the modified value.
If you run a child process via any of the DCli methods then the child process will be passed all of current environment variable.
You CANNOT change the parent shell's environment variables. This is a security restriction imposed by the OS.
DCli also exposes a number of commonly used environment variables as global getters.
  • HOME - your home directory
  • PATH - a list of all the paths that make up your PATH.
  • pwd - the present working directory.
1
// home will contain the path to your HOME directory.
2
var home = HOME;
3
4
/// paths will contain a list of the paths contain in your OS PATH environment variable.
5
List<String> paths = PATH;
6
7
paths.forEach((path) => print(path));
8
9
print('Your working directory is $pwd);
Copied!

envs -> Map<String, String>

Returns a map of all the environment variables inherited from the parent as well as any changes made by calls to `env[]=`.

PATH

DCli provides a list of methods allow you to modify the PATH. Like any environment variables modifying the PATH will only affect child process you call and not the parent shell.
Methods to manipulate the path include:
  • appendToPATH
  • prependToPATH
  • removeFromPATH
  • isOnPATH
  • delimiterForPATH
Last modified 1mo ago