From 6f8bfb4d487691b760668106fb2795d665c88599 Mon Sep 17 00:00:00 2001 From: Raj Babu Das Date: Sat, 26 Aug 2023 21:15:50 +0530 Subject: [PATCH] Adding basic readme Signed-off-by: Raj Babu Das --- README.md | 78 ++++++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 77 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 8c28a39..264e81e 100644 --- a/README.md +++ b/README.md @@ -1 +1,77 @@ -# diffr \ No newline at end of file +# Diffr - Compare Directory Content Differences with Ease + + +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. + +Visit the project on GitHub: [https://github.com/imrajdas/diffr](https://github.com/imrajdas/diffr) + +## Table of Contents + +- [Installation](#installation) +- [Usage](#usage) +- [Commands](#commands) +- [Flags](#flags) +- [Examples](#examples) +- [Contributing](#contributing) +- [License](#license) + +## Installation + +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: + +```bash +go get -u github.com/imrajdas/diffr +``` + +## Usage + +Diffr simplifies the process of comparing content differences between two directories. The basic usage is as follows: + +```bash +diffr [dir1] [dir2] [flags] +``` + +You can also use the command to access specific features: + +```bash +diffr [command] +``` + +## Commands + +Diffr supports the following commands: + +- `help`: Displays help information about any command. +- `version`: Displays the version of Diffr. + +## Flags + +Diffr provides the following flags to customize its behavior: + +- `-a, --address string`: Set the address for the web server to listen on. The default is `http://localhost`. +- `-h, --help`: Display help information about Diffr. +- `-p, --port int`: Set the port for the web server to listen on. The default is `8080`. + +## Examples + +Here are some examples of how to use Diffr: + +```bash +# Compare contents of two directories +diffr /path/to/dir1 /path/to/dir2 + +# Compare contents with custom server address and port +diffr /path/to/dir1 /path/to/dir2 -a http://127.0.0.1 -p 9000 +``` + +## Contributing + +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. + +## License + +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. + +--- + +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! \ No newline at end of file