Populate JSON files with properties from other JSON files.
npm install grunt-json2json~0.4.5
shell
npm install grunt-json2json --save-dev
`
Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:
`js
grunt.loadNpmTasks('grunt-json2json');
`
The "json2json" task
$3
In your project's Gruntfile, add a section named json2json to the data object passed into grunt.initConfig().
`js
grunt.initConfig({
json2json: {
// Task specific options
options: {
indent: ' ' // Destination files will be indented with two white spaces
},
// Target specific options
example_target: {
src: ['source1.json', 'source2.json'], // Source JSON files to read properties from.
dest: ['destination1.json', 'destination2.json'] // Destination JSON files to be updated or created with properties from sources.
options: {
updateOnly: true, // Only existing properties in destinations will be populated from sources. No properties will be added.
pointers: [ // Only properties in the sources pointed by these JSON pointers will populate destinations.
'/foo',
'/bar/baz'
]
map: { // Map properties in the sources to other properties in the destinations.
'/foo': '/remapped_foo',
'/bar/baz': '/remapped_barbaz'
}
}
},
},
});
`
$3
#### options.updateOnly
Type: Boolean
Default value: false
If true, only properties already existing in the destination files will be populated with values from the source files. Note that if a specified destination doesn't exist, an empty JSON file will be created.
If false, properties that don't exist yet in the destination files will be added.
#### options.pointers
Type: Array
Default value: []
An Array of JSON pointers that define the properties in the sources that will populate the destinations.
Example:
`js
json2json: {
options {
pointers: [
'/foo',
'/bar'
]
}
}
`
with source
`JSON
{
"foo": "some value",
"bar": "some other value",
"baz": "yet another value"
}
`
will output
`JSON
{
"foo": "some value",
"bar": "some other value"
}
`
If options.pointers is not defined or empty, by default all the properties from the source files will populate the destination files.
#### options.map
Type: Object
Default value: {}
An Object that defines how JSON pointers in the source files are mapped in the destination files.
Example:
`js
json2json: {
options {
map: {
'/foo': '/remapped_foo',
'/bar/baz': '/remapped_barbaz'
}
}
}
`
with source file
`JSON
{
"foo": "some value",
"bar": {
"baz": "some other value"
}
}
`
will output
`JSON
{
"remapped_foo": "some value",
"remapped_barbaz": "some other value"
}
`
#### options.indent
Type: String|Number
Default value: \t
The String or number of white spaces used for indentation in the destination files (see JSON.stringify).
$3
#### Populating bower.json and component.json from package.json
If your project uses Bower and/or Component to manage your front-end packages, you might want to keep in synch data from the different configuration files (package.json, bower.json and component.json). If you decide that package.json is the master file where you edit the common data, you can synch bower.json and/or component.json using json2json:
##### Simple update
This simply synchs all properties with the same name from package.json to bower.json and component.json.
`js
grunt.initConfig({
json2json: {
synchConfigs: {
src: 'package.json',
dest: ['bower.json', component.json],
options: {
updateOnly: true // This assumes that bower.json and component.json are already set up with the needed properties.
}
}
}
});
`
##### Targeted update, add missing properties in destinations
`js
grunt.initConfig({
json2json: {
synchConfigs: {
src: 'package.json',
dest: ['bower.json', component.json],
options: {
pointers: [ // This ensures that only those properties will be updated if found in package.json.
'/name', // Because updateOnly defaults to false, they will be added to bower.json and component.json if missing.
'/description',
'/version',
'/license',
'/keywords',
'/repository'
'/private'
]
}
}
}
});
`
##### Targeted update with remapping
This uses two targets to handle the differences in data models between package.json, bower.json and component.json.
`js
grunt.initConfig({
json2json: {
options: {
src: 'package.json'
pointers: [
'/name',
'/description',
'/version',
'/license',
'/keywords',
'/repository'
'/private'
]
},
bower: {
dest: 'bower.json',
options: {
pointers: <%= json2json.options.pointers %>.concat([
'/author',
'/contributors',
'/homepage'
]),
map {
'/author': '/authors/-',
'/contributors': '/authors/-'
}
}
},
component: {
dest: 'component.json'
}
}
});
``