read-pkg

Read a package.json file

Why

Gracefully handles filesystem issues
Strips UTF-8 BOM
Throws more helpful JSON errors
Normalizes the data

Install

$ npm install --save read-pkg

Usage

var readPkg = require('read-pkg');

readPkg().then(function (pkg) {
	console.log(pkg);
	//=> {name: 'read-pkg', ...}
});

readPkg(__dirname).then(function (pkg) {
	console.log(pkg);
	//=> {name: 'read-pkg', ...}
});

readPkg(path.join('unicorn', 'package.json')).then(function (pkg) {
	console.log(pkg);
	//=> {name: 'read-pkg', ...}
});

API

readPkg([path], [options])

Returns a promise that resolves to the parsed JSON.

readPkg.sync([path], [options])

Returns the parsed JSON.

path

Type: string
Default: .

Path to a package.json file or its directory.

options

normalize

Type: boolean
Default: true

Normalize the package data.

read-pkg-up - Read the closest package.json file
write-pkg - Write a package.json file
load-json-file - Read and parse a JSON file