Skip to content

Commit 041373e

Browse files
authored
Update README.md
1 parent 59473c6 commit 041373e

File tree

1 file changed

+54
-7
lines changed

1 file changed

+54
-7
lines changed

README.md

Lines changed: 54 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,28 +1,75 @@
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:
42
[![Actions Status](https://github.com/ZLOI27/python-project-50/actions/workflows/hexlet-check.yml/badge.svg)](https://github.com/ZLOI27/python-project-50/actions)
53
[![Python CI](https://github.com/ZLOI27/python-project-50/actions/workflows/pyci.yml/badge.svg)](https://github.com/ZLOI27/python-project-50/actions/workflows/pyci.yml)
64
[![Maintainability Rating](https://sonarcloud.io/api/project_badges/measure?project=ZLOI27_python-project-50&metric=sqale_rating)](https://sonarcloud.io/summary/new_code?id=ZLOI27_python-project-50)
75
[![Coverage](https://sonarcloud.io/api/project_badges/measure?project=ZLOI27_python-project-50&metric=coverage)](https://sonarcloud.io/summary/new_code?id=ZLOI27_python-project-50)
86

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+
```
1045
```bash
1146
make install
1247
```
1348

14-
### Install package global
49+
### Install the package globally
1550
```bash
1651
make build
52+
```
53+
```
1754
make package-install
1855
```
1956

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
2168
```bash
2269
make test
2370
```
2471

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
2673
```bash
2774
make full-check
2875
```

0 commit comments

Comments
 (0)