Usage

; This comment is being ignoredscope = global[database]user = dbuserpassword = dbpassworddatabase = use_this_database[paths.default]datadir = /var/lib/dataarray[] = first valuearray[] = second valuearray[] = third value

import{writeFile,readFile}from'node:fs/promises'import{stringify,parse}from'ini'//  Read INI file as textlettext=awaitreadFile(`./Original.ini`,{encoding :'utf-8'})//  Parse text data to objectconstconfig=parse(text)//  Modify data objectconfig.scope='local'config.database.database='use_another_database'config.paths.default.tmpdir='/tmp'deleteconfig.paths.default.datadirconfig.paths.default.array.push('fourth value')//  Stringify data objecttext=stringify(config,{section :'section'})//  Write INI file as textawaitwriteFile(`./Modified.ini`,text)

[section]scope=local[section.database]user=dbuserpassword=dbpassworddatabase=use_another_database[section.paths.default]tmpdir=/tmparray[]=first valuearray[]=second valuearray[]=third valuearray[]=fourth value

API

Parse

// You can also use `decode`constobject=parse(`<INI Text>`)

Stringify

// You can also use `encode`stringify(object,{/**     *  Whether to insert spaces before & after `=`     *     *  Disabled by default to have better     *  compatibility with old picky parsers.     */whitespace :false,/**     *  Whether to align the `=` character for each section.     *  -> Also enables the `whitespace` option     */align :false,/**     *  Identifier to use for global items     *  and to prepend to all other sections.     */    section,/**     *  Whether to sort all sections & their keys alphabetically.     */sort :false,/**     *  Whether to insert a newline after each section header.     *     *  The TOSHIBA & FlashAir parser require this format.     */newline :false,/**     *  Which platforms line-endings should be used.     *     *  win32 -> CR+LF     *  other -> LF     *     *  Default is the current platform     */    platform,/**     *  Whether to append `[]` to array keys.     *     *  Some parsers treat duplicate names by themselves as arrays     */bracketedArray :true})

stringify(object,'section')

Un / Escape

safe(`"unsafe string"`)// -> \"unsafe string\"

unsafe(`\\"safe string\\"`)// -> "safe string"