joycon
Load config with ease.
Last updated 10 months ago by egoist .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install joycon 
SYNC missed versions from official npm registry.

joycon

NPM version NPM downloads install size CircleCI donate chat

Differences with cosmiconfig?

JoyCon is zero-dependency but feature-complete.

Install

yarn add joycon

Usage

const JoyCon = require('joycon')

const joycon = new JoyCon()

joycon.load(['package-lock.json', 'yarn.lock'])
.then(result => {
  // result is {} when files do not exist
  // otherwise { path, data }
})

By default only .js and .json file are parsed, otherwise raw data will be returned, so you can add custom loader to parse them:

const joycon = new JoyCon()

joycon.addLoader({
  test: /\.toml$/,
  load(filepath) {
    return require('toml').parse(filepath)
  }
})

joycon.load(['cargo.toml'])

API

constructor([options])

options

files
  • Type: string[]

The files to search.

cwd

The directory to search files.

stopDir

The directory to stop searching.

packageKey

You can load config from certain property in a package.json file. For example, when you set packageKey: 'babel', it will load the babel property in package.json instead of the entire data.

parseJSON
  • Type: (str: string) => any
  • Default: JSON.parse

The function used to parse JSON string.

resolve([files], [cwd], [stopDir])

resolve([options])

files defaults to options.files.

cwd defaults to options.cwd.

stopDir defaults to options.stopDir then path.parse(cwd).root.

If using a single object options, it will be the same as constructor options.

Search files and resolve the path of the file we found.

There's also .resolveSync method.

load(...args)

The signature is the same as resolve.

Search files and resolve { path, data } of the file we found.

There's also .loadSync method.

addLoader(Loader)

interface Loader {
  name?: string
  test: RegExp
  load(filepath: string)?: Promise<any>
  loadSync(filepath: string)?: any
}

At least one of load and loadSync is required, depending on whether you're calling the synchonous methods or not.

removeLoader(name)

Remove loaders by loader name.

clearCache()

Each JoyCon instance uses its own cache.

Contributing

  1. Fork it!
  2. Create your feature branch: git checkout -b my-new-feature
  3. Commit your changes: git commit -am 'Add some feature'
  4. Push to the branch: git push origin my-new-feature
  5. Submit a pull request :D

Author

joycon © egoist, Released under the MIT License.
Authored and maintained by egoist with help from contributors (list).

github.com/egoist · GitHub @egoist · Twitter @_egoistlily

Current Tags

  • 2.2.5                                ...           latest (10 months ago)

20 Versions

  • 2.2.5                                ...           10 months ago
  • 2.2.4                                ...           a year ago
  • 2.2.3                                ...           a year ago
  • 2.2.2                                ...           a year ago
  • 2.2.1                                ...           a year ago
  • 2.2.0                                ...           a year ago
  • 2.1.2                                ...           a year ago
  • 2.1.1                                ...           a year ago
  • 2.1.0                                ...           a year ago
  • 2.0.0                                ...           a year ago
  • 1.1.1                                ...           2 years ago
  • 1.1.0                                ...           2 years ago
  • 1.0.4                                ...           2 years ago
  • 1.0.3                                ...           2 years ago
  • 1.0.2                                ...           2 years ago
  • 1.0.1                                ...           2 years ago
  • 1.0.0                                ...           2 years ago
  • 0.3.0                                ...           2 years ago
  • 0.2.0                                ...           2 years ago
  • 0.1.0                                ...           2 years ago

Copyright 2014 - 2016 © taobao.org |