conf-edit v1.0.7

conf-edit

Quickly and easily change .conf properties file. Mainly created to run in docker files to convert environment variable to .conf files to offer some form of obfuscation in some docker images.

Can be used in console or as node extension.

Usage

Install:

npm install conf-edit

Javascript

There are 4 main functions exposed:

getSettings

Get the current settings from a .conf file. This can also be limited to a specified set of properties.

const { getSettings } = require('conf-edit');

const confFile = 'some/relative/or/absolute/file.conf';
const limits = [
    'PROPERTY1',
    'OTHERPROP',
];

console.log("only file", getSettings(confFile));
console.log("with limits", getSettings(confFile, limits));
console.log("set extend to true", getSettings(confFile, limits, true));
console.log("set extend to false (default)", getSettings(confFile, limits, false));
// with extend set to false, you are limited to limits properties that should not match if not case don't match.
console.log("set ignoreCase to false", getSettings(confFile, limits, false, false));
// with extend set to true, all properties should be displayed, but only matched if case is match
console.log("set ignoreCase to false", getSettings(confFile, limits, true, false));

console.log("set ignoreCase to true (default)", getSettings(confFile, limits, true, true));

// OUTPUT:
//  only file { property1: 'some value',  property2: 'some value2' }
//   - with limits { OTHERPROP: undefined, property1: 'some value' }
//   - set extend to true {
//       OTHERPROP: undefined,
//       property1: 'some value',
//       property2: 'some value2'
//     }
//   - set extend to false (default) { OTHERPROP: undefined, property1: 'some value' }
//   - set ignoreCase to false { PROPERTY1: undefined, OTHERPROP: undefined }
//   - set ignoreCase to false {
//       PROPERTY1: undefined,
//       OTHERPROP: undefined,
//       property1: 'some value',
//       property2: 'some value2'
//     }
//   - set ignoreCase to true (default) {
//       OTHERPROP: undefined,
//       property1: 'some value',
//       property2: 'some value2'
//     }

The .conf file has the following properties:

property1 some value
property2 some value2
# exlcudedProperty exclude value

Function parameters

getSettings ( configFile, defaultProperties, extend, ignoreCase )

setSettings

Returns a new config string based on a config string provieded at a file location and an object with a given properties.

In these examples the same .conf file is used than specified above.

const { setSettings }= require('conf-edit');

const confFile = 'some/relative/or/absolute/file.conf';
const newValues = {
    PROPERTY1: "new prop1", 
    OTHERPROP: 'new', 
    property2: null, 
    exlcudedProperty : "activate"
};

console.log("normal:\n", setSettings(confFile, newValues));
console.log("extended:\n", setSettings(confFile, newValues, true));
console.log("no extend & no ignoreCase:\n", setSettings(confFile, newValues, false, false));
console.log("extended & no ignoreCase:\n", setSettings(confFile, newValues, true, false));

// OUTPUT
//  normal:
//      property1 new prop1
//      # property2 some value2
//      exlcudedProperty activate
//  extended:
//      property1 new prop1
//      # property2 some value2
//      exlcudedProperty activate
//      OTHERPROP new
//  no extend & no ignoreCase:
//      property1 some value
//      # property2 some value2
//      exlcudedProperty activate
//  extended & no ignoreCase:
//      property1 some value
//      # property2 some value2
//      exlcudedProperty activate
//      PROPERTY1 new prop1
//      OTHERPROP new

Function parameters

getSettings ( configFile, defaultProperties, extend, ignoreCase )

parseConfig

The main function that converts a string representation of a .connf file to a object of key value pairs. Refer to output and results under getSettings for more information.

Parameters

getSettings ( confFile, defaultProperties, extend, ignoreCase )

This is similar to getSettings and all parameters are the same except for the first parameter.

confFile is the actual content of the .conf file.

setConfig

The main function that sets new values to an existing configuration string and returns. Refer to output and results under setSettings for more information

Parameters

setConfig ( configFile, propertyValues, extend, ignoreCase = true )

This is similar to setSettings and all parameters are the same except for the first parameter.

confFile is the actual content of the .conf file.

CLI

Only 2 functions are exposed through the cli process, these are getSettings and setSettings.

CLI Usage

conf-edit function -e -i -d dest -p property -p property

OR

conf-edit function -extend true -ignoreCase true --destination dest --property prop

Arguments

NOTE unfortunately I have not yet extended the destination function to automatically create folders when outputting to a file. Therefore destination is limited to exiting folders.

Examples

Given the following .conf file (location ./src/tmp.conf from where console command is run):

Note if the console does not run by calling conf-edit, try prefixing it with npx conf-edit ...

property1 some value
property2 some value2
# exlcudedProperty exclude value

The following are some get examples

GET examples

conf-edit ./bin/cli.js get ./src/tmp.conf 

> output {"property1":"some value","property2":"some value2"}

conf-edit ./bin/cli.js getSettings --property 'PROPERTY1' --property 'nonexist prop' ./src/tmp.conf 

> output {"nonexist":"prop","property1":"some value"}

conf-edit ./bin/cli.js getsEtTiNgS --property 'PROPERTY1' --property 'nonexist prop' ./src/tmp.conf -e

> output {"nonexist":"prop","property1":"some value","property2":"some value2"}

SET examples

conf-edit ./bin/cli.js set -p 'property1 new' -p 'nonexistnig prop' ./src/tmp.conf

> output
    property1 new
    property2 some value2
    # exlcudedProperty exclude value

conf-edit ./bin/cli.js setsettings -p 'property1 new' -p 'nonexistnig prop' ./src/tmp.conf --extend

> output:
    property1 new
    property2 some value2
    # exlcudedProperty exclude value
    nonexistnig prop

conf-edit ./bin/cli.js setSettings -p 'property1 new' --property 'exlcudedProperty go live' ./src/tmp.conf

> output:
    property1 new
    property2 some value2
    exlcudedProperty go live

conf-edit ./bin/cli.js setSettings -p 'property1 new' --property 'exlcudedProperty go live' ./src/tmp.conf -d ./log.txt

> same result as above, but printed to log.txt

Note

Project has not been fully tested and feel free to contribute. Project has been completed quickly in order to proceed with further projects. I would like to extend this project later on to also be able to Parse and Compile .yml files.