Read bower.json files with semantics, normalisation, defaults, validation and authentication (via authrc)
npm install bower-json-authRead bower.json files with semantics, normalisation, defaults, validation and authentication (via authrc).
Note that this is a non-standard forked version for personal purposes!
#### .read(file, options, callback)
Reads file and applies normalisation, defaults and validation according to the bower.json spec.
If the passed file does not exist, the callback is called with error.code equal to ENOENT.
If the passed file contents are not valid JSON, the callback is called with error.code equal to EMALFORMED.
If the json does not comply with the bower.json spec, the callback is called with error.code equal to EINVALID.
If file is a directory, find() will be used to search for the json file.
The options argument is optional and can be omitted. These options will be passed to parse method.
``js
var bowerJson = require('bower-json');
// Can also be used by simply calling bowerJson()
bowerJson.read('/path/to/bower.json', function (err, json) {
if (err) {
console.error('There was an error reading the file');
console.error(err.message);
return;
}
console.log('JSON: ', json);
});
`
#### .parse(json, options)
Parses an object. Useful when you want to apply normalisation and validation directly to an object.
If the json does not comply with the bower.json spec, an error is thrown with error.code equal to EINVALID.
The options arguments is optional and can be omitted. Available options:
- validate: Apply validation, defaults to truefalse
- normalize: Apply normalisation, defaults to json
- clone: clone, use and return the passed in object instead of using it directly, defaults to false
`js
var bowerJson = require('bower-json');
var json = {
name: 'my-package',
version: '0.0.1'
};
try {
bowerJson.parse(json);
} catch (err) {
console.error('There was an error parsing the object');
console.error(err.message);
}
`
#### .validate(json)
Validates the passed json object. error.code
Throws an error with equal to EINVALID if it does not comply with the spec.
`js
var bowerJson = require('bower-json');
var json = {
name: 'my-package',
version: '0.0.1'
};
try {
bowerJson.validate(json);
} catch (err) {
console.error('There was an error validating the object');
console.error(err.message);
}
`
#### .normalize(json)
`js
var bowerJson = require('bower-json');
var json = {
name: 'my-package',
version: '0.0.1',
main: 'foo.js,bar.js'
};
bowerJson.nornalize(json);
json.main // ['foo.js', 'bar.js']
`
#### .find(folder, callback)
Finds the json filename inside a folder. bower.json
Checks if a exists, falling back to component.json (deprecated) and .bower.json. error.code
If no file was found, the callback is called with a of ENOENT.
`js
var bowerJson = require('bower-json');
bowerJson.find('/path/to/folder', function (err, filename) {
if (err) {
console.error('There is no json file in the folder');
return;
}
console.log('Filename: ', filename);
// Now that we got the filename, we can read its contents
bowerJson.read(filename, function (err, json) {
if (err) {
console.error('There was an error reading the file');
console.error(err.message);
return;
}
console.log('JSON: ', json);
});
});
``
* Add test cases for authrc
Released under the MIT License.