Registry / data / merge-json-cli

merge-json-cli

library1.0.4jsnpmunverified

The `merge-json-cli` package (current stable version 1.0.4) is a lean command-line utility designed for merging multiple JSON files into a single output. It introduces a custom "spread syntax" (`"..."`) directly within JSON objects and arrays, allowing developers to declaratively reference external JSON files or specific paths within them using JSON pointers. This enables dynamic composition of complex configurations from modular JSON fragments. The tool supports both object and array merging, including the use of glob patterns for array-based merges. As a CLI tool, its release cadence is driven by feature enhancements and bug fixes rather than a fixed schedule. Its primary differentiator is the in-JSON spread syntax, providing an intuitive way to manage hierarchical data structures across multiple files. It requires Node.js version 18.3.0 or higher.

data devops

npm install merge-json-cli

github ↗package ↗

INSTALL

IMPORT

SIG · MERGE-JSON-CLI

merge-json-cli

datajavascriptv1.0.4

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Demonstrates how to run the `merge-json-cli` tool directly using `npx` to merge an input JSON file that references another JSON file via its custom spread syntax, outputting the consolidated result.

npx merge-json-cli --in ./input.json --out ./output.json # Example input.json: # { # "configName": "MyApp", # "version": "1.0.0", # "...": "./features.json", # "settings": { # "theme": "dark" # } # } # Example features.json (referenced by input.json): # { # "featureA": true, # "featureB": false # } # The command will merge input.json, incorporating features.json, # and write the result to output.json.

merge-json --version

Debug

Known issues

gotchaThe `merge-json-cli` package requires Node.js version 18.3.0 or higher. Running it with an older version will result in an error.

fix

Ensure your Node.js environment is updated to version 18.3.0 or newer before running the CLI tool.

affects: <18.3.0

gotchaPaths specified in the JSON spread syntax (`"..."`) must be valid file paths or JSON pointers. Incorrectly formatted paths will lead to file not found errors or parsing issues.

fix

Verify that all paths used with `"..."` correctly point to existing JSON files or valid nested keys within those files (e.g., `./my-data.json` or `./config.json#/app/settings`).

affects: *

gotchaReferenced JSON files must exist and be accessible relative to the primary input file or current working directory. If a file cannot be found, the merge operation will fail.

fix

Double-check the existence and permissions of all JSON files referenced within your configurations. Use absolute paths if relative paths cause ambiguity.

affects: *

gotchaCommand line arguments require correct syntax for input (`--in|-i`) and output (`--out|-o`). Misspellings or incorrect formatting will prevent the tool from executing.

fix

Always use `--in <file>` or `-i <file>` for the source JSON, and `--out <file>` or `-o <file>` for the target output file.

affects: *

Errors

Common errors & fixes

Error: ENOENT: no such file or directory, open 'path/to/referenced-file.json'

A JSON file specified in a `"..."` spread operator within your input JSON does not exist at the provided path, or the path is incorrect.

fix

Correct the file path specified in the `"..."` value within your JSON configuration, or ensure the referenced file is present at that location.

SyntaxError: Unexpected token '...'

The input JSON file contains invalid JSON syntax that prevents standard JSON parsing before `merge-json-cli` can process its custom spread operators.

fix

Validate all your input JSON files for correct JSON syntax using a linter or an online JSON validator to fix any parsing errors.

Error: The 'merge-json-cli' package requires Node.js version >=18.3.0. You are running vX.Y.Z.

The Node.js version installed on your system is older than the minimum required by `merge-json-cli`.

fix

Update your Node.js installation to version 18.3.0 or newer using a Node.js version manager like `nvm` or by downloading the latest LTS release from the official Node.js website.

Upgrade

Version history

1.0.4latest on npm

Audit

Dependencies

noderequiredRuntime environment requirement specified in engines field for the CLI tool.

Agent activity

4 hits · last 30 days

node

Resources

githubhttps://github.com/buuhuu/merge-json-cli ↗

packagehttps://www.npmjs.com/package/merge-json-cli ↗