INI-Parser

INI-Parser is a simplistic ini file format parser written in typescript for node.js.
I wrote this in my downtime at work to fend off boredom.
To use it, simply import it in your typescript files.

Example

$3

``ini
;Demo.ini
[details]
firstname=John
lastname=Doe
id=0123456789
alive=yes

[activity]
name=Reticulating splines
since=2023-08-02T14:54:11.840Z
`

$3

`typescript
//Demo.ts
import {INIParser} from "@ranchonyx/ini-parser"

const parser = INIParser.GetParser("./Demo.ini");

///Get the value of a key in a section as an INI entity.
parser.get("details", "firstname").asString();
///>>> John

///Get all keys for a section
parser.getKeysForSection("details");
///>>> [ 'firstname', 'lastname', 'id', 'alive' ]

///Get sections
parser.getSections();
///>>> [ 'details', 'activity' ]

///Convert to JSON
parser.asJSON();
/*>>>
{
details: { firstname: 'john', lastname: 'doe', id: 123456789, alive: true },
activity: { name: 'reticulating splines', since: 2023-08-02T14:54:11.840Z }
}
*/
`

Documentation

$3

`typescript
type nativeType = string | number | boolean | Date;
type maybe = undefined | T;

type INIEntity = {
getKey: () => string;
asNumber: () => maybe;
asString: () => maybe;
asBoolean: () => maybe;
asDate: () => maybe;
asGuessedNative: () => nativeType;
}

type INIBlock = Record & { __ini_section_name__: string };

type INIParseResult = Record;
`

$3

`typescript
public static INIParser.GetParser(INIContentOrFilePath: string): INIParser;
public INIParser.get(sectionKey: string, key: string): INIEntity;
public INIParser.getKeysForSection(sectionKey: string): string[];
public INIParser.getSections(): string[];
public INIParser.asJSON(): any;
`

Notes

$3

Please not that INIEntity describes a wrapper around the raw string-like value read from the ini.
You may interpret the raw value as
- string
- number
- boolean
- Date

by calling their respective as-methods.
A way of implicitly getting a javascript native type is to calle the
asGuessedNative()-method, which will, with decent accuracy, convert the raw type to a javascript native type.

$3

Calling JSON.stringify() with an INIParser as argument, it will return the same data as INIParser.asJSON()`.