confbox

Parsing and serialization utils for YAML (js-yaml), TOML (smol-toml), JSONC (jsonc-parser), JSON5 (json5), INI (ini) and JSON.

✨ Zero dependency and tree-shakable

✨ Types exported out of the box

✨ Preserves code style (indentation and whitespace)

[!TIP] Use unjs/c12 for a full featured configuration loader!

Usage

Install package:

1# ✨ Auto-detect
2npx nypm install confbox
3
4# npm
5npm install confbox
6
7# yarn
8yarn add confbox
9
10# pnpm
11pnpm install confbox
12
13# bun
14bun install confbox
15
16# deno
17deno install confbox

Import:

ESM (Node.js, Bun, Deno)

1import {
2  parseJSON5,
3  stringifyJSON5,
4  parseJSONC,
5  stringifyJSONC,
6  parseYAML,
7  stringifyYAML,
8  parseJSON,
9  stringifyJSON,
10  parseTOML,
11  stringifyTOML,
12  parseINI,
13  stringifyINI,
14} from "confbox";

CDN (Deno, Bun and Browsers)

1import {
2  parseJSON5,
3  stringifyJSON5,
4  parseJSONC,
5  stringifyJSONC,
6  parseYAML,
7  stringifyYAML,
8  parseJSON,
9  stringifyJSON,
10  parseTOML,
11  stringifyTOML,
12  parseINI,
13  stringifyINI,
14} from "https://esm.sh/confbox";

parseINI(text, options?)

Converts an INI string into an object.

Note: Style and indentation are not preserved currently.

parseJSON(text, options?)

Converts a JSON string into an object.

Indentation status is auto-detected and preserved when stringifying back using stringifyJSON

parseJSON5(text, options?)

Converts a JSON5 string into an object.

parseJSONC(text, options?)

Converts a JSONC string into an object.

parseTOML(text)

Converts a TOML string into an object.

parseYAML(text, options?)

Converts a YAML string into an object.

stringifyINI(value, options?)

Converts a JavaScript value to an INI string.

Note: Style and indentation are not preserved currently.

stringifyJSON(value, options?)

Converts a JavaScript value to a JSON string.

Indentation status is auto detected and preserved when using value from parseJSON.

stringifyJSON5(value, options?)

Converts a JavaScript value to a JSON5 string.

stringifyJSONC(value, options?)

Converts a JavaScript value to a JSONC string.

stringifyTOML(value)

Converts a JavaScript value to a TOML string.

stringifyYAML(value, options?)

Converts a JavaScript value to a YAML string.

Contribution

Local development

• Clone this repository
• Install the latest LTS version of Node.js
• Enable Corepack using corepack enable
• Install dependencies using pnpm install
• Run tests using pnpm dev or pnpm test

License

Published under the MIT license. Made by @pi0 and community 💛

---

🤖 auto updated with automd