Socket
Socket
Sign inDemoInstall

pkg-conf

Package Overview
Dependencies
2
Maintainers
1
Versions
12
Alerts
File Explorer

Advanced tools

Install Socket

Detect and block malicious and high-risk dependencies

Install

pkg-conf

Get namespaced config from the closest package.json


Version published
Maintainers
1
Weekly downloads
2,125,024
decreased by-5.92%

Weekly downloads

Readme

Source

pkg-conf

Get namespaced config from the closest package.json

Having tool specific config in package.json reduces the amount of metafiles in your repo (there are usually a lot!) and makes the config obvious compared to hidden dotfiles like .eslintrc, which can end up causing confusion. XO, for example, uses the xo namespace in package.json, and ESLint uses eslintConfig. Many more tools supports this, like AVA, Babel, nyc, etc.

Install

npm install pkg-conf

Usage

{
	"name": "some-package",
	"version": "1.0.0",
	"unicorn": {
		"rainbow": true
	}
}
import {packageConfig} from 'pkg-conf';

const config = await packageConfig('unicorn');

console.log(config.rainbow);
//=> true

API

It walks up parent directories until a package.json can be found, reads it, and returns the user specified namespace or an empty object if not found.

packageConfig(namespace, options?)

Returns a Promise for the config.

packageConfigSync(namespace, options?)

Returns the config.

namespace

Type: string

The package.json namespace you want.

options

Type: object

cwd

Type: string
Default: process.cwd()

The directory to start looking up for a package.json file.

defaults

Type: object

The default config.

skipOnFalse

Type: boolean
Default: false

Skip package.json files that have the namespaced config explicitly set to false.

Continues searching upwards until the next package.json file is reached. This can be useful when you need to support the ability for users to have nested package.json files, but only read from the root one, like in the case of electron-builder where you have one package.json file for the app and one top-level for development.

Example usage for the user:

{
	"name": "some-package",
	"version": "1.0.0",
	"unicorn": false
}

packageJsonPath(config)

Pass in the config returned from any of the above methods.

Returns the file path to the package.json file or undefined if not found.

  • read-pkg-up - Read the closest package.json file
  • read-pkg - Read a package.json file
  • find-up - Find a file by walking up parent directories

Keywords

FAQs

Last updated on 04 Nov 2023

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc