godiff

README

godiff

A File/Directory diff-like comparison tool with HTML output. Enhanced to support CSV files with Primary/Combinational Keys

This program can be use to compare files and directories for differences. When comparing directories, it iterates through all files in both directories and compare files having the same name.

See example output here:

How to use godiff - general all files

godiff file1 file2 > results.html
godiff directory1 directory > results.html

How to use godiff - csv files

* Compare csv files with primary key
godiff -key <CaseSensitive-Column-name> file1 file2
* Compare csv files with combinational keys
 godiff -key <CommaSeperatedCaseSensitive-Column-names> file1 file2
* Output diff files to different name / folder
 godiff -csv <diff-csv-file-name> -html <diff-html-file-name> -diff-dir <output-dir> -key <column-name> file1 file2
* Measure the time taken to generate diff files
 godiff -timeit -key <Column-name> file1 file2

See godiff -h for all the available command line options

Features

• When comparing two directory, place all the differences into a single html file.
• Supports UTF8 file.
• Show differences within a line
• Options for ignore case, white spaces compare, blank lines etc.
• Compare csv files and generate diff csv file
• Compare csv files with single / combinational primary keys
• CSV files Columns / Rows can be any order
• Measure time taken to create diff files
• Diff files can be saved in different folder

Description

I need a program to to compare 2 directories, and report differences in all files. Much like gnudiff, but with a nicer output. And I also like to try out the go programming language, so I created godiff.

The diff algorithm implemented here is based on "An O(ND) Difference Algorithm and its Variations" by Eugene Myers Algorithmica Vol. 1 No. 2, 1986, p 251.

godiff always tries to produce the minimal differences, just like gnudiff with the "-d" option.

Go Language

This program is created in the go programming language. For more information about go, see golang.org

How to Build

On Linux or Darwin OS

go build -o godiff godiff.go godiff_unix.go

On Windows

go build -o godiff.exe  godiff.go godiff_windows.go

Prebuild Binary for Windows

https://github.com/rsrini7/godiff/releases/download/snapshot/godiff3.7z

Documentation

Overview

File/Directory diff tool with HTML output
Copyright (C) 2012   Siu Pin Chao

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.

Description:

This program can be use to compare files and directories for differences.
When comparing directories, it iterates through all files in both directories
and compare files having the same name.

It uses the algorithm from "An O(ND) Difference Algorithm and its Variations"
by Eugene Myers Algorithmica Vol. 1 No. 2, 1986, p 251.

Main Features:

• Supports UTF8 file.
• Show differences within a line
• Options for ignore case, white spaces compare, blank lines etc.

Main aim of the application is to try out the features in the go programming language. (golang.org)

• Slices: Used extensively, and re-slicing too whenever it make sense.

• File I/O: Use Mmap for reading text files

• Function Closure: Use in callbacks functions to handle both file and line compare

• Goroutines: for running multiple file compares concurrently, using channels and mutex too.

  History ------- 2012/09/20 Created