mirror of https://github.com/aminya/setup-cpp
88 lines
1.8 KiB
Markdown
88 lines
1.8 KiB
Markdown
<h1 align="center">os-env</h1>
|
|
<p>
|
|
<img alt="Version" src="https://img.shields.io/badge/version-1.0.0-blue.svg?cacheSeconds=2592000" />
|
|
<img src="https://img.shields.io/badge/node-%3E%3D12-blue.svg" />
|
|
<a href="#" target="_blank">
|
|
<img alt="License: Apache--2.0" src="https://img.shields.io/badge/License-Apache--2.0-yellow.svg" />
|
|
</a>
|
|
</p>
|
|
|
|
> Manage environment variables, PATH, and rc files
|
|
|
|
## Install
|
|
|
|
```sh
|
|
npm install --save os-env
|
|
```
|
|
|
|
## Usage
|
|
|
|
<!-- INSERT GENERATED DOCS START -->
|
|
|
|
### `defaultRcPath` (variable)
|
|
|
|
### `RcOptions` (type)
|
|
|
|
### `sourceRCInRc` (variable)
|
|
|
|
handles adding conditions to source rc file from .bashrc and .profile
|
|
|
|
### `finalizeRC` (function)
|
|
|
|
**Parameters:**
|
|
|
|
- rcOptions (`RcOptions`)
|
|
|
|
**returns:** Promise<void>
|
|
|
|
### `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<void>
|
|
|
|
### `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<void>
|
|
|
|
<!-- INSERT GENERATED DOCS END -->
|
|
|
|
## 🤝 Contributing
|
|
|
|
You can sponsor my work here:
|
|
|
|
https://github.com/sponsors/aminya
|
|
|
|
Pull requests, issues and feature requests are welcome.
|
|
See the [Contributing guide](https://github.com/aminya/setup-cpp/blob/master/CONTRIBUTING.md).
|