setup-cpp/packages/os-env/README.md

1.8 KiB

os-env

Version License: Apache--2.0

Manage environment variables, PATH, and rc files

Install

npm install --save os-env

Usage

defaultRcPath (variable)

RcOptions (type)

sourceRCInRc (variable)

handles adding conditions to source rc file from .bashrc and .profile

finalizeRC (function)

Parameters:

  • rcOptions (RcOptions)

returns: Promise

escapeString (function)

Escape a string for use in a shell command

Parameters:

  • valGiven (string) - The string to escape
  • shouldEscapeSpace (boolean) - Whether to escape spaces in the string

returns: any

AddEnvOptions (type)

addEnv (function)

Add an environment variable.

This function is cross-platforms and works in all the local or CI systems.

Parameters:

  • name (string)
  • valGiven (string)
  • givenOptions (Partial<AddEnvOptions>)

returns: Promise

addPath (function)

Add a path to the PATH environment variable.

This function is cross-platforms and works in all the local or CI systems.

Parameters:

  • path (string)
  • givenOptions (Partial<AddPathOptions>)

returns: Promise

🤝 Contributing

You can sponsor my work here:

https://github.com/sponsors/aminya

Pull requests, issues and feature requests are welcome. See the Contributing guide.