Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (rc9) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

RC9

Read/Write RC files couldn't be easier!

Install

Install using npm or yarn:

npm i rc9
# or
yarn add rc9

Import into your Node.js project:

// CommonJS
const { read, write } = require('rc9')

// ESM
import { read, write } from 'rc9'

Usage

.conf:

db.username=db username
db.password=db pass
db.enabled=true

Read/Write config:

const config = read() // or read('.conf')

// config = {
//   db: {
//     username: 'db username',
//     password: 'db pass',
//     enabled: true
//   }
// }

config.enabled = false
write(config) // or write(config, '.conf')

Update config:

update({ 'db.enabled': false })

User Config

It is common to globally read/write config from/to user home directory, you can use readUser/writeuser shortcuts to quickly do this:

writeUser({ token: 123 }, '.zoorc')

const conf = readUser('.zoorc') // { token: 123 }

Unflatten

RC uses flat to automatically flat/unflat when writing and reading rcfile.

It means that you can use . for keys to define objects. Some examples:

hello.world = true <=> { hello: { world: true }
test.0 = A <=> tags: [ 'A' ]

Note: If you use keys that can override like x= and x.y=, you can disable this feature by passing flat: true option.

Native Values

RC uses destr to convert values into native javascript values.

So reading count=123 results { count: 123 } (instead of { count: "123" }) if you want to preserve strings as is, can use count="123".

Exports

const defaults: RCOptions;
function parse(contents: string, flat: boolean): RC;
function parseFile(path: string, flat: boolean): RC;
function read(options?: RCOptions | string): RC;
function readUser(options?: RCOptions | string): RC;
function serialize(config: RC): string;
function write(config: RC, options?: RCOptions | string): void;
function writeUser(config: RC, options?: RCOptions | string): void;
function update(config: RC, options?: RCOptions | string): RC;
function updateUser(config: RC, options?: RCOptions | string): Record<string, any>;

Defaults:

{
  name: '.conf',
  dir: process.cwd(),
  flat: false
}

Why RC9?

Be the first one to guess 🐇

License

MIT. Made with 💖