@std/ini@0.215.0

import * as ini from "@std/ini";
const iniFile = `# Example configuration file
Global Key=Some data here

[Section #1]
Section Value=42
Section Date=1977-05-25
`;
const parsed = ini.parse(iniFile, {
  reviver: (key, value, section) => {
    if (section === "Section #1") {
      if (key === "Section Value") return Number(value);
      if (key === "Section Date") return new Date(value);
    }
    return value;
  },
});
console.log(parsed);

// =>
// {
//   "Global Key": "Some data here",
//   "Section #1": { "Section Value": 42, "Section Date": 1977-05-25T00:00:00.000Z }
// }

const text = ini.stringify(parsed, {
  replacer: (key, value, section) => {
    if (section === "Section #1" && key === "Section Date") {
      return (value as Date).toISOString().split("T")[0];
    }
    return value;
  },
});
console.log(text);

// =>
// Global Key=Some data here
// [Section #1]
// Section Value=42
// Section Date=1977-05-25

Optionally, IniMap may be used for finer INI handling. Using this class will permit preserving comments, accessing values like a map, iterating over key/value/section entries, and more.

import { IniMap } from "@std/ini";
const ini = new IniMap();
ini.set("section1", "keyA", 100)
console.log(ini.toString())

// =>
// [section1]
// keyA=100

ini.set('keyA', 25)
console.log(ini.toObject())

// =>
// {
//   keyA: 25,
//   section1: {
//     keyA: 100
//   }
// }

The reviver and replacer APIs can be used to extend the behavior of IniMap, such as adding support for duplicate keys as if they were arrays of values.

import { IniMap } from "@std/ini";
const iniFile = `# Example of key/value arrays
[section1]
key1=This key
key1=is non-standard
key1=but can be captured!
`;
const ini = new IniMap({ assignment: "=", deduplicate: true });
ini.parse(iniFile, (key, value, section) => {
  if (section) {
    if (ini.has(section, key)) {
      const exists = ini.get(section, key);
      if (Array.isArray(exists)) {
        exists.push(value);
        return exists;
      } else {
        return [exists, value];
      }
    }
  }
  return value;
});
console.log(ini.get("section1", "key1"));

// => [ "This key", "is non-standard", "but can be captured!" ]

const result = ini.toString((key, value) => {
  if (Array.isArray(value)) {
    return value.join(
      `${ini.formatting.lineBreak}${key}${ini.formatting.assignment}`,
    );
  }
  return value;
});
console.log(result === iniFile);

// => true