|
1 | | -## Difference Calculator |
2 | | -This program takes two files as arguments, compares them, and outputs the differences between them. |
3 | | -### Hexlet tests and linter status: |
| 1 | +# Hexlet tests and linter status: |
4 | 2 | [](https://github.com/ZLOI27/python-project-50/actions) |
5 | 3 | [](https://github.com/ZLOI27/python-project-50/actions/workflows/pyci.yml) |
6 | 4 | [](https://sonarcloud.io/summary/new_code?id=ZLOI27_python-project-50) |
7 | 5 | [](https://sonarcloud.io/summary/new_code?id=ZLOI27_python-project-50) |
8 | 6 |
|
9 | | -### Setup all dependencies |
| 7 | + |
| 8 | +# gendiff configuration file diff tool |
| 9 | + |
| 10 | +gendiff is a tool for easily comparing configuration files and displaying the differences between them in various formats. With gendiff, you can: |
| 11 | + |
| 12 | +- Get diffs in different formats: from the human-readable stylish format to the simple plain format, and even json. |
| 13 | +- Work with different file types, supporting YAML and JSON formats. |
| 14 | +- Easily integrate with other tools and scripts for automatic configuration comparisons. |
| 15 | + |
| 16 | +### Features: |
| 17 | +- Simple command-line interface. |
| 18 | +- Support for extendable output formats. |
| 19 | +- Comparison of nested data structures. |
| 20 | +- Suitable for working with any type of configuration or data files. |
| 21 | + |
| 22 | +### Supported Output Formats: |
| 23 | +- *Stylish*: Beautiful and human-readable output. |
| 24 | +- *Plain*: Simple text-based output. |
| 25 | +- *JSON*: Output in JSON format for integration with other tools. |
| 26 | + |
| 27 | +# Installation Guide for gendiff |
| 28 | + |
| 29 | +Follow the steps below to set up and install the gendiff project on your local machine. |
| 30 | + |
| 31 | +### Clone the Repository |
| 32 | + |
| 33 | +Start by cloning the repository from GitHub: |
| 34 | + |
| 35 | +```bash |
| 36 | +https://github.com/ZLOI27/python-project-50.git |
| 37 | +``` |
| 38 | + |
| 39 | +### Installation |
| 40 | +Navigate into the project directory and install the required dependencies: |
| 41 | + |
| 42 | +```bash |
| 43 | +cd python-project-50 |
| 44 | +``` |
10 | 45 | ```bash |
11 | 46 | make install |
12 | 47 | ``` |
13 | 48 |
|
14 | | -### Install package global |
| 49 | +### Install the package globally |
15 | 50 | ```bash |
16 | 51 | make build |
| 52 | +``` |
| 53 | +``` |
17 | 54 | make package-install |
18 | 55 | ``` |
19 | 56 |
|
20 | | -### Run tests |
| 57 | +### Run the tool |
| 58 | + |
| 59 | +```bash |
| 60 | +gendiff -f <format> <first_file> <second_file> |
| 61 | +``` |
| 62 | + |
| 63 | +Replace `<first_file>`, `<second_file>`, and `<format>` with the appropriate file paths and desired output format (such as `stylish`, `plain`, or `json`). |
| 64 | + |
| 65 | +## Tests |
| 66 | + |
| 67 | +### Run the tests |
21 | 68 | ```bash |
22 | 69 | make test |
23 | 70 | ``` |
24 | 71 |
|
25 | | -### Run tests with coverage, run with test-files and ruff check |
| 72 | +### Run the tests with coverage, run with test-files and ruff check |
26 | 73 | ```bash |
27 | 74 | make full-check |
28 | 75 | ``` |
|
0 commit comments