Validate Yaml files and enforce a given structure
Yaml files are parsed via js-yaml
and the structure defined in the configuration options is enforced with
check-type
.
Please note that this library requires the minimum Node.js
version to be 6.9.5
, which is the Long Term Support (LTS) version.
Installation:
npm install yaml-validator --save-dev
Usage:
const YamlValidator = require('yaml-validator');
// Default options
const options = this.options({
log: false,
structure: false,
yaml: false,
writeJson: false
});
const files = [];
const validator = new YamlValidator(options);
validator.validate(files);
validator.report();
All options are false
by default which disables their use.
Type: string
Default value: false
In case the value is not false
, the given string will be used as log file where all the
task output is written.
Type: object
Default value: false
The most complex style of checking validity.
Type: function
Default value: null
One of the options passed to safeload
method of js-yaml
.
Please note that the onWarning
callback is being used by this library and any method written for it,
will be run after the one implemented in this library.
The callback get called with two parameters, of which the first is the error in question,
while the second is the file path of the given Yaml file.
Type: boolean
Default: false
Write the given Yaml file as pretty printed JSON in the same path, just by changing the file extension to json
.
Please note that any existing JSON files will be cruelly overwritten.
In case an array is found, all its members are assumed to have the given structure.
This can be seen in the classRooms
property, which according to the configuration below,
should be an array, for which all items are objects, which all should have a name
and id
properties, with the given types.
The teachers
array is made of strings, thus all items in that array must be a string.
const options = {
structure: {
school: {
'description?': 'string', //Optional, won't show in invalid array
code: 'number',
principal: {
name: 'string'
},
classRooms: [
{
name: 'string',
id: 'number',
'location?':{
floor: "string",
building: "string",
}
}
],
teachers: [
'string'
]
}
}
};
Using the options.onWarning
callback, the possible parsing errors can be retrieved.
const options = {
onWarning: function (error, filepath) {
console.log(filepath + ' has error: ' + error);
}
};
It is possible to use the options.writeJson
to have all the files processed,
to be saved in JSON format, in the same file path as the original Yaml files.
const options = {
writeJson: true
};
"A Beginner's Guide to Open Source: The Best Advice for Making your First Contribution".
Also there is a blog post about "45 Github Issues Dos and Don’ts".
Linting is done with ESLint and can be executed with npm run lint
.
There should be no errors appearing after any JavaScript file changes.
Please note that any features or changed will not be merged without working unit tests.
Unit tests are written with tape
and can be executed with npm test
.
Code coverage is inspected with nyc
and
can be executed with npm run coverage
after running npm test
.
Please make sure it is over 90% at all times.
v0.4.0
(2017-06-28)- Provide file name, error message and line number when failing #7
- Keep dependencies up to date and test against Node.js major version
8
- Minimum supported Node.js version lifted from
4.2.0
to6.9.5
v0.3.0
(2016-10-10)- Proper unit tests #6
options.yaml.onWarning
is nowoptions.onWarning
v0.2.1
(2016-08-25)- Define the minimum Node.js version in
package.json
, as4.2.0
- Define the minimum Node.js version in
v0.2.0
(2016-07-06)- Using shared ESLint configuration #2
- Possible JSON file written now replaces extension properly
v0.1.0
(2016-02-22)- Initial release to the World with code originating from
grunt-yaml-validator
version0.8.0
- Initial release to the World with code originating from
Copyright (c) Juga Paazmaya paazmaya@yahoo.com
Licensed under the MIT license.