/FileComparison

A robust command-line utility engineered to detect differences between two configuration files.

Primary LanguageJavaScript

Actions Status Node CI Maintainability Test Coverage

File Comparison

File Comparison is a robust command-line utility engineered to detect differences between two configuration files. Developed using JavaScript and Node.js, the application supports both JSON and YAML file formats, making it versatile and applicable to a variety of use cases.

Description

FileComparison analyzes two configuration files and generates a detailed report outlining the differences. This utility leverages the power of the Commander npm package to facilitate the handling of command-line inputs.

The solution employs a set of purpose-built functions to deliver this functionality: The output is customizable, allowing users to select from three distinct report formats: stylish, plain, and json. The stylish format is the default, presenting data like a JSON object with nested fields represented through indentation. The plain format delivers the results in straightforward sentences, while the json format presents the difference report as a JSON object.

Usage

Use the following command format to execute the utility:

gendiff [options] <filepath1> <filepath2>

Options:

  • -V, --version: Output the version number
  • -f, --format [type]: Specify the output format (options: "stylish", "plain", "json"; default: "stylish")
  • -h, --help: Display command help

stylish:

npm run bin/gendiff.js -f stylish file1.json file2.json

plain:

npm run bin/gendiff.js -f plain file1.json file2.json

json:

npm run bin/gendiff.js -f json file1.json file2.json

Technologies Used

FileComparison is built with a stack of powerful technologies:

  • JavaScript and Node.js: The backbone of the application, providing the runtime environment.
  • Commander.js: Handles command-line inputs.
  • Lodash: Offers a comprehensive set of utility functions to streamline code.
  • js-yaml: Parses YAML files.

On the development side, the project utilizes:

  • Jest: Facilitates testing of the application.
  • ESLint: Ensures adherence to code quality standards.
  • eslint-config-airbnb-base, eslint-plugin-fp, eslint-plugin-import, eslint-plugin-jest: Provides additional eslint rules.

License

FileComparison is licensed under the ISC license.