@zokugun/ini-parse-lite

A high-performance parser that turns INI strings into structured records. It handles sections and key-value pairs while maintaining a simple, clean API for developers.

Features

• Easy Setup: Quick integration with standard configuration files.
• Structured Output: Returns clean objects for easy data access.
• Fast Conversion: Rapidly turns raw text into usable data.
• Safe Parsing: Protects against common prototype pollution attacks.
• Lite Parsing: Handle the most common INI format (defined at EditorConfig). No fancy extra formats.

Installation

npm add @zokugun/ini-parse-lite

Quick Start

import { type IniResult, parseIni } from '@zokugun/ini-parse-lite';

function runSectionExample(): void {
	const iniString = `
timeout=30
log_level=debug

[database]
host=localhost
port=5432

[api]
key=secret_token
url=https://api.example.com
`;

	const config: IniResult = parseIni(iniString);

    const timeout = config.global.timeout;
	const dbHost = config.database.host;
	const apiKey = config.api.key;

    console.log(`Timeout: ${timeout}`);
	console.log(`Database Host: ${dbHost}`);
	console.log(`API Key: ${apiKey}`);
}

Contributions

Contributions are most welcome. Please:

• Open issues and feature requests under the repository discussions.
• Follow the CONTRIBUTING.md.

Donations

Support this project by becoming a financial contributor.

	ko-fi.com/daiyam
	liberapay.com/daiyam/donate
	paypal.me/daiyam99

License

Copyright © 2026-present Baptiste Augrain

Licensed under the MIT license.