const isWindows = require('./is-windows')
|
|
const pathLikeEnvVarWhitelist = new Set(['PATH', 'NODE_PATH'])
|
|
module.exports = varValueConvert
|
|
/**
|
* This will transform UNIX-style list values to Windows-style.
|
* For example, the value of the $PATH variable "/usr/bin:/usr/local/bin:."
|
* will become "/usr/bin;/usr/local/bin;." on Windows.
|
* @param {String} varValue Original value of the env variable
|
* @param {String} varName Original name of the env variable
|
* @returns {String} Converted value
|
*/
|
function replaceListDelimiters(varValue, varName = '') {
|
const targetSeparator = isWindows() ? ';' : ':'
|
if (!pathLikeEnvVarWhitelist.has(varName)) {
|
return varValue
|
}
|
|
return varValue.replace(/(\\*):/g, (match, backslashes) => {
|
if (backslashes.length % 2) {
|
// Odd number of backslashes preceding it means it's escaped,
|
// remove 1 backslash and return the rest as-is
|
return match.substr(1)
|
}
|
return backslashes + targetSeparator
|
})
|
}
|
|
/**
|
* This will attempt to resolve the value of any env variables that are inside
|
* this string. For example, it will transform this:
|
* cross-env FOO=$NODE_ENV BAR=\\$NODE_ENV echo $FOO $BAR
|
* Into this:
|
* FOO=development BAR=$NODE_ENV echo $FOO
|
* (Or whatever value the variable NODE_ENV has)
|
* Note that this function is only called with the right-side portion of the
|
* env var assignment, so in that example, this function would transform
|
* the string "$NODE_ENV" into "development"
|
* @param {String} varValue Original value of the env variable
|
* @returns {String} Converted value
|
*/
|
function resolveEnvVars(varValue) {
|
const envUnixRegex = /(\\*)(\$(\w+)|\${(\w+)})/g // $my_var or ${my_var} or \$my_var
|
return varValue.replace(
|
envUnixRegex,
|
(_, escapeChars, varNameWithDollarSign, varName, altVarName) => {
|
// do not replace things preceded by a odd number of \
|
if (escapeChars.length % 2 === 1) {
|
return varNameWithDollarSign
|
}
|
return (
|
escapeChars.substr(0, escapeChars.length / 2) +
|
(process.env[varName || altVarName] || '')
|
)
|
},
|
)
|
}
|
|
/**
|
* Converts an environment variable value to be appropriate for the current OS.
|
* @param {String} originalValue Original value of the env variable
|
* @param {String} originalName Original name of the env variable
|
* @returns {String} Converted value
|
*/
|
function varValueConvert(originalValue, originalName) {
|
return resolveEnvVars(replaceListDelimiters(originalValue, originalName))
|
}
|
