gulp-json-sort
v1.0.0
Published
Gulp plugin for deterministic sorting of JSON files
Downloads
4,814
Readme
gulp-json-sort
Gulp plugin for deterministic sorting of JSON files. Supports deep structures, custom compare functions, replacers, and formatting options.
Thin wrapper over substack's json-stable-stringify, which does all the hard work.
Usage
This plugin is authored in ES6, so until Node picks up ES6 module support you'll need to pluck the default property from the require'd import.
var gulp = require('gulp');
var sortJSON = require('gulp-json-sort').default;
gulp.task('sort-json', function() {
return gulp.src('./**/*.json')
.pipe(sortJSON({ space: 2 }))
.pipe(gulp.dest('./'));
});
By default (with no compare function provided), sorting happens alphabetically by key.
If a file contains invalid JSON, a parse error will be emitted on the stream.
Newlines in the output are always LF. Pipe the results through gulp-eol as needed.
API
sortJSON(options?: {
cmp?: (left: { key: string, value: any }, right: { key: string, value: any }) => number,
cycles?: boolean,
replacer?: (key: string, value: any) => any,
space?: number | string
});
See json-stable-stringify for details and behavior for each option; the params are passed straight through.
License
MIT License (Expat)