Skip to content

Commit 6f8bfb4

Browse files
committed
Adding basic readme
Signed-off-by: Raj Babu Das <mail.rajdas@gmail.com>
1 parent b5e5ee2 commit 6f8bfb4

File tree

1 file changed

+77
-1
lines changed

1 file changed

+77
-1
lines changed

README.md

Lines changed: 77 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1,77 @@
1-
# diffr
1+
# Diffr - Compare Directory Content Differences with Ease
2+
3+
4+
Diffr is an open-source web-based tool designed to make comparing content differences between two directories a simple and intuitive process. Whether you're a developer comparing source code, a designer comparing image assets, or anyone dealing with files, Diffr provides a user-friendly interface to quickly identify changes and similarities between directories.
5+
6+
Visit the project on GitHub: [https://github.com/imrajdas/diffr](https://github.com/imrajdas/diffr)
7+
8+
## Table of Contents
9+
10+
- [Installation](#installation)
11+
- [Usage](#usage)
12+
- [Commands](#commands)
13+
- [Flags](#flags)
14+
- [Examples](#examples)
15+
- [Contributing](#contributing)
16+
- [License](#license)
17+
18+
## Installation
19+
20+
To use Diffr, you need to have [Go](https://golang.org/) installed on your system. Once you have Go set up, you can install Diffr using the following command:
21+
22+
```bash
23+
go get -u github.com/imrajdas/diffr
24+
```
25+
26+
## Usage
27+
28+
Diffr simplifies the process of comparing content differences between two directories. The basic usage is as follows:
29+
30+
```bash
31+
diffr [dir1] [dir2] [flags]
32+
```
33+
34+
You can also use the command to access specific features:
35+
36+
```bash
37+
diffr [command]
38+
```
39+
40+
## Commands
41+
42+
Diffr supports the following commands:
43+
44+
- `help`: Displays help information about any command.
45+
- `version`: Displays the version of Diffr.
46+
47+
## Flags
48+
49+
Diffr provides the following flags to customize its behavior:
50+
51+
- `-a, --address string`: Set the address for the web server to listen on. The default is `http://localhost`.
52+
- `-h, --help`: Display help information about Diffr.
53+
- `-p, --port int`: Set the port for the web server to listen on. The default is `8080`.
54+
55+
## Examples
56+
57+
Here are some examples of how to use Diffr:
58+
59+
```bash
60+
# Compare contents of two directories
61+
diffr /path/to/dir1 /path/to/dir2
62+
63+
# Compare contents with custom server address and port
64+
diffr /path/to/dir1 /path/to/dir2 -a http://127.0.0.1 -p 9000
65+
```
66+
67+
## Contributing
68+
69+
Contributions to Diffr are welcomed and encouraged! If you find a bug or have a feature request, please open an issue on the [GitHub repository](https://github.com/imrajdas/diffr). If you'd like to contribute code, feel free to fork the repository and submit a pull request.
70+
71+
## License
72+
73+
Diffr is released under the [Apache](LICENSE). You are free to use, modify, and distribute this software in accordance with the terms of the license.
74+
75+
---
76+
77+
Diffr makes directory content comparison hassle-free, allowing you to focus on identifying differences rather than dealing with complex tools. Give it a try, and make directory comparison a breeze!

0 commit comments

Comments
 (0)