Command line JSONX to JSON format file converter
npm install @spaceboy.cz/jsonx---
---
Comments begin with # or //; anything after one of those tags is treated as a comment and ignored.
(Of course not when the tag is part of a quotation mark (") bordered key or value.)
Trailing commas allow you to add/remove the last item of a list without changing other lines. It makes smaller differences in version control; your code is syntactically more stable against changes.
Let's look at example.jsonx file:
`` __ __ ____ _
| \/ |_ _ / ___| _ _ ___| |_ ___ _ __ ___
| |\/| | | | | \___ \| | | / __| __/ _ \ '_
# "key2" is list of [something very important]:
"key2": [
"value2.1", // Disable when ... /
// "value2.2", // Enable when ... //
"value2.3", # Trailing comma allows adding/deleting another value
# with only one line change in version control diff
],
"key3#": ["foo", "bar", #Some comment
"baz",
// Misformated source can be
// repaired using --reformat option.
],# <- note the trailing comma
}
``
Note the big title (generated with TAAG). Not only does it look cool, but it also makes it easier for developers to keep track of which configuration they're actually editing when working on multiple projects at the same time.
Also notice how badly the file is formatted. Its because of reasons (which you will get to understand later in this text).
utility by command line:
`
$ npm install -g @spaceboy.cz/jsonx
Since then, should be globally available on your computer.
$3
- ### --inputfile (-i)
Input (source) JSONX file.
- ### --outputfile (-o)
Output (target) JSON file. When not specified, output file name is created automatically (by adding .json as extension to input file name). Eg.
test.jsonx to test.json.- ### --overwite (-w)
Allows overwriting existing
output file.- ### --reformat (-r)
Reformats input JSONX (by parsing JSON and stringyfying it again). Output is indeted with four spaces.
Recommended argument.
- ### --reformat2
Reformats input JSONX (by parsing JSON and stringyfying it again). Output is indeted with two spaces.
- ### --reformat-tab
Reformats input JSONX (by parsing JSON and stringyfying it again). Output is indeted with tab.
- ### --crlf
CRLF [
\r\n] sequence is used for line endings in output file. (Default is LF [\n].)- ### --lfcr
LFCR [
\n\r] sequence is used for line endings in output file. (Default is LF [\n].)- ### --blank (-b)
Adds blank line to end of document (required by some systems).
$3
| Code | Description |
|---|---|
| 1 | JSON parsing error |
| 2 | Filesystem error (input file unreachable, output file already exists and overwrite is not allowed etc.) |
3. JSONX command line utility example
Let's try to convert example JSONX file from paragraph 1.In command line, type
`
$ jsonx -i example.jsonx
File
should appear with content looking like this:
`
{
"key1": "value1",
"key2": [
"value2.1",
"value2.3"
],
"key3#": ["foo", "bar",
"baz"
]
}
Well, the result is still not very nice (remember the bad formatting of the source file?).Fortunately, we can fix the formatting. Enter the same command again, this time with the
--reformat (or -r) option. On the second try, you should get an error message:`
$ jsonx -i example.jsonx -r
Output file already exists (example.json). Run command again with overwrite enabled.
Convert file again with
(or -w) option. Now the command should be executed successfully:
`
$ jsonx -i example.jsonx -r -w
Converting example.jsonx to example.json.
Done.
This time,
should look like this:
`
{
"key1": "value1",
"key2": [
"value2.1",
"value2.3"
],
"key3#": [
"foo",
"bar",
"baz"
]
}
It is very inconvenient to generate a new JSON file after every change to the source JSONX file by running the command from the command line. That's why we try to automate this process as much as possible.
If you can help us create plugins for Grunt, please contact us!
If you can help us create plugins for Gulp, please contact us!
If you can help us create plugins for VS Code, please contact us!
If you can help us create plugins for PHP Storm, please contact us!