Variable Replacer

Easily inject environment variables or provided variables to compose richer strings.

Install

1npm install @universal-packages/variable-replacer

Global methods

replaceEnv(input: string, [enclosures: [string, string]])

Replace matches in the string with node env variables.

1import { replaceEnv } from '@universal-packages/variable-replacer'
2
3const string = 'NODE_ENV: {{NODE_ENV}}, TS_JEST: {{TS_JEST}}, JEST_WORKER_ID: {{ JEST_WORKER_ID }}'
4const finalString = replaceEnv(string)
5
6console.log(finalString)
7
8// > 'NODE_ENV: test, TS_JEST: 1, JEST_WORKER_ID: 1'

Enclosures

You can provide your own enclosure characters to match for replacements.

1import { replaceEnv } from '@universal-packages/variable-replacer'
2
3const string = 'NODE_ENV: <<NODE_ENV>>, TS_JEST: <<TS_JEST>>, JEST_WORKER_ID: {{ JEST_WORKER_ID }}'
4const finalString = replaceEnv(string, ['<<', '>>'])
5
6console.log(finalString)
7
8// > 'NODE_ENV: test, TS_JEST: 1, JEST_WORKER_ID: {{ JEST_WORKER_ID }}'

replaceVars(input: string, variables: Object, [enclosures: [string, string]])

Replace matches in the string with values provided in an object form.

1import { replaceVars } from '@universal-packages/variable-replacer'
2
3const string = 'key: {{ key }}, another: {{another}}'
4const finalString = replaceVars(string, { key: 'key', another: 'value' })
5
6console.log(finalString)
7
8// > 'key: key, another: value'

Enclosures

Same as with env you can provide your own enclosure characters to match for replacements.

1import { replaceVars } from '@universal-packages/variable-replacer'
2
3const string = 'key: # key #, another: #another#'
4const finalString = replaceVars(string, { key: 'key', another: 'value' }, ['#', '#'])
5
6console.log(finalString)
7
8// > 'key: key, another: value'

evaluateAndReplace(input: string, [options: Object])

Captures what is between the enclosures and evaluates it as a JS expression. The result is then used to replace the match in the string.

1import { evaluateAndReplace } from '@universal-packages/variable-replacer'
2
3const string = 'key: <% 1 + 1 %>, another: <% 2 + 2 %>'
4const finalString = evaluateAndReplace(string)
5
6console.log(finalString)
7
8// > 'key: 2, another: 4'

Options

• scope Object You can provide your own scope to use in your expression.

  1import { evaluateAndReplace } from '@universal-packages/variable-replacer'
  2
  3const string = 'key: <% cpusCount / 2 %>, another: <% mem / 2 %>'
  4const finalString = evaluateAndReplace(string, { cpusCount: 4, mem: 16 })
  5
  6console.log(finalString)
  7
  8// > 'key: 2, another: 8'

• enclosures [string, string] You can provide your own enclosure characters to match for replacements.

  1import { evaluateAndReplace } from '@universal-packages/variable-replacer'
  2
  3const string = 'key: ${ 1 + 1 }$ , another: ${2+2}$'
  4const finalString = evaluateAndReplace(string, ['${', '}$'])
  5
  6console.log(finalString)
  7
  8// > 'key: 2, another: 4'

evaluate(input: string, [scope: Object])

Evaluates the whole string as a JS expression and returns the actual JS result.

1import { evaluate } from '@universal-packages/variable-replacer'
2
3const string = 'a + b'
4const result = evaluate(string, { a: 1, b: 2 })
5
6console.log(result)
7
8// > 3

Combine replacements

You can pass your string through both function to get a final string

1import { replaceEnv, replaceVars } from '@universal-packages/variable-replacer'
2
3const string = 'NODE_ENV: <<NODE_ENV>>, TS_JEST: <<TS_JEST>>, key: {{ key }}'
4let finalString = replaceEnv(string, ['<<', '>>'])
5
6console.log(finalString)
7
8// > 'NODE_ENV: test, TS_JEST: 1, key: {{ key }}'
9
10finalString = replaceVars(string, { key: 'value' })
11
12console.log(finalString)
13
14// > 'NODE_ENV: test, TS_JEST: 1, key: value'

cleanOrphanReplaceable(input: string, [enclosures: [string, string]])

Cleans the string from orphan replaceable enclosures. Useful in case the variables are not provided and you don;t want the value {{ value}} as teh actual value and instead an empty value is more suitable.

1import { cleanOrphanReplaceable } from '@universal-packages/variable-replacer'
2
3const string = 'key: {{ key }}, another: {{another}}'
4const finalString = cleanOrphanReplaceable(string)
5
6console.log(finalString)
7
8// > 'key: , another: '

Enclosures

You can provide your own enclosure characters to match for replacements.

1import { replaceVars } from '@universal-packages/variable-replacer'
2
3const string = 'key: # key #, another: #another#'
4const finalString = replaceVars(string, { key: 'key', another: 'value' }, ['#', '#'])
5
6console.log(finalString)
7
8// > 'key: "", another: ""'

Typescript

This library is developed in TypeScript and shipped fully typed.

Contributing

The development of this library happens in the open on GitHub, and we are grateful to the community for contributing bugfixes and improvements. Read below to learn how you can take part in improving this library.

• Code of Conduct
• Contributing Guide

License

MIT licensed.