Concatenate JSON file(s) or standard input to standard output.
pip install json-cat
Usage: jsoncat [OPTIONS] [JSONFILES]...
Concatenate JSON FILE(s), or standard input, format standard output.
Options:
-c, --compact Compact JSON.
--version Show the version and exit.
--help Show this message and exit.JSON can be output as pretty JSON (nicely indented with sorted keys) for readability, or as compacted JSON for efficient machine use.
| Stdin | File Name(s) | Defined Behavior |
|---|---|---|
| No Data | No Filename | Print command usage message |
| Data | No Filename | Read JSON data from STDIN |
| Data | Dash char. (-) | Read JSON data from STDIN |
| No Data | Dash char. (-) | Accept user input until EOF |
| N/A | Filename | Read JSON data from file |
| N/A | File1, File2, ... | Concatenate JSON data in array |
| Compact | Description |
|---|---|
| True | No newlines, no indent and no spaces after punctuation. |
| False | Indent-level 2 w/ sorted keys |
- JSON Decoder: Read JSON data from standard input and/or one or more paths/filenames.
- JSON Concatenation: If multiple JSON files/input-streams are provided then concatenate the JSON data into a JSON array in the sequence the files were specified.
- JSON Formatting: JSON can be output as pretty JSON (nicely indented with sorted keys) for readability, or as compacted JSON for efficient machine use.
- Keyboard Interrupt Handling: When writing data to standard output or standard error if a SIGINT ("program interrupt") signal is sent the KeyboardInterrupError message and stack trace will be suppressed; this makes a nice clean break when the user types the INTR character; normally Ctrl-c.
- Command-line Interface Tool: For interactive usage.
- Reusable JSON I/O Functions: Off-loads I/O handling allowing the individual JSON command-line programs to focus on their core functions.
JSON Cat was originally designed for use with the JSON Translations project, but it was split out as a separate Python micro-package since it may be useful with other applications that read and/or write JSON. The command-line interface is also a handy tool for testing & proto-typing.
output_text(text, color=None, err=False)
output_lines(text, color=None, err=Fase)json_load_file(filename)
json_dump(data, compact=False)