properties-reader

What is properties-reader?

The properties-reader npm package is a utility for reading and manipulating .properties files in Node.js. It allows you to load properties files, access and modify their values, and save changes back to the file.

What are properties-reader's main functionalities?

Load Properties File

This feature allows you to load a .properties file into a PropertiesReader object, making it easy to access and manipulate the properties within the file.

const PropertiesReader = require('properties-reader');
const properties = PropertiesReader('path/to/file.properties');

Get Property Value

This feature allows you to retrieve the value of a specific property key from the loaded properties file.

const value = properties.get('some.property.key');
console.log(value);

Set Property Value

This feature allows you to set or update the value of a specific property key in the loaded properties file.

properties.set('some.property.key', 'new value');

Save Properties File

This feature allows you to save the changes made to the properties back to the file.

properties.save('path/to/file.properties');

Get All Properties

This feature allows you to retrieve all properties as an object, making it easy to work with all the properties at once.

const allProperties = properties.getAllProperties();
console.log(allProperties);

Other packages similar to properties-reader

dotenv

dotenv is a popular package for loading environment variables from a .env file into process.env. While it is primarily used for environment variables, it can also be used to manage configuration properties. Unlike properties-reader, dotenv focuses on environment variables and does not provide methods for manipulating the properties after loading them.

config

config is a configuration management package for Node.js that allows you to define configuration settings for your application in a variety of formats, including .json, .yaml, and .properties files. It provides a more comprehensive solution for managing application configurations compared to properties-reader, which is focused solely on .properties files.

nconf

nconf is a hierarchical configuration manager for Node.js that supports multiple configuration sources such as command-line arguments, environment variables, and files (including .json and .properties). It offers more flexibility and features compared to properties-reader, making it suitable for complex configuration management needs.

README

Properties-Reader

An ini file compatible properties reader for Node.JS

Installation

The easiest installation is through NPM:

npm install properties-reader

Or clone the repo https://github.com/steveukx/properties and include the /src/PropertiesReader.js script.

API

Read properties from a file:

var PropertiesReader = require('properties-reader');
var properties = PropertiesReader('/path/to/properties.file');

The properties are then accessible either by fully qualified name, or if the property names are in dot-delimited notation, they can be access as an object:

// fully qualified name
var property = properties.get('some.property.name');

// by object path
var property = properties.path().some.property.name;

To read more than one file, chain calls to the .read() method:

properties.read('/another.file').read('/yet/another.file');

To set an arbitrary property into the properties object, use .set():

properties.set('property.name', 'Property Value');

When reading a .ini file, sections are created by having a line that contains just a section name in square brackets. The section name is then prefixed to all property names that follow it until another section name is found to replace the current section.

# contents of properties file
[main]
some.thing = foo

[blah]
some.thing = bar

// reading these back from the properties reader
properties.get('main.some.thing') == 'foo';
properties.get('blah.some.thing') == 'bar';

Checking for the current number of properties that have been read into the reader:

var propertiesCount = properties.length;

The length is calculated on request, so if accessing this in a loop an efficiency would be achieved by caching the value.

When duplicate names are found in the properties, the first one read will be replaced with the later one.

Data Types

Properties will automatically be converted to their regular data types when they represent true/false or numeric values. To get the original value without any parsing / type coercion applied, use properties.getRaw('path.to.prop').

Contributions

If you find bugs or want to change functionality, feel free to fork and pull request.