load-ini

load-ini

Read and parse a .ini file

Documentation • Change Log

• load-ini
  • Installation
  • Usage
    • Nodejs require
    • ES6 module
  • API Reference
    • loadIni
    • loadIniSync
    • parseIni
    • stringifyIni
  • Support & Issues
  • License

Installing

# use pnpm
$ pnpm install load-ini

# use npm
$ npm install load-ini --save

Usage

1. Nodejs require

const { loadIni, loadIniSync } = require('load-ini')

loadIni('/path/of/ini_file').then(data => {})
loadIniSync('/path/of/ini_file')

2. ES6 module

import { loadIni, loadIniSync } from 'load-ini'

API Reference

loadIni

Read and parse a .ini file

• Since: 1.0.0

• Arguments:

Parameters	Description	Type	Optional	Required	Default
path	path of ini file	string	-	true	-

• Returns: object | array

• Example:

loadIni('/path/of/ini_file').then(data => {
  console.log(data)
  // { "name": "saqqdy" }
})

• Types:

declare function loadIni(path: string): Promise<Record<string, unknown> | unknown[]>

loadIniSync

Read and parse a .ini file sync mode

• Since: 1.0.0

• Arguments:

Parameters	Description	Type	Optional	Required	Default
path	path of ini file	string	-	true	-

• Returns: object | array

• Example:

loadIniSync('/path/of/ini_file')
// { "name": "saqqdy" }

• Types:

declare function loadIniSync(path: string): Record<string, unknown> | unknown[]

parseIni

Parse ini string into object

• Since: 1.0.0

• Arguments:

Parameters	Description	Type	Optional	Required	Default
data	ini string	string	-	true	-

• Returns: object | array

• Example:

parseIni(`
[user]
    name = saqqdy
    age = 18
`)
// { "name": "saqqdy", age: 18 }

• Types:

declare function parseIni(data: string): Record<string, unknown> | unknown[]

stringifyIni

Convert objects to ini strings

• Since: 1.0.0

• Arguments:

Parameters	Description	Type	Optional	Required	Default
data	object data	object array	-	true	-

• Returns: string

• Example:

stringifyIni({ name: 'saqqdy', age: 18 })
// [user]
//     name = saqqdy
//     age = 18

• Types:

declare function stringifyIni<T>(data: T, options?: EncodeOptions): string

Support & Issues

Please open an issue here.

License

MIT

Changelog

2023.08.16 v1.1.0

1. fix types
2. add support for array
3. auto covert arrayLike object into array