1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
|
# App-ccdiff
A colored diff that also colors inside changed lines
# Synopsis
```
usage: ccdiff [options] file1 [file2]
ccdiff --help | --man | --info
file1 or file2 can be - (but not both)
```
# Description
All command-line tools that show the difference between two files fall
short in showing minor changes visually usefully. This tool tries to give
the look and feel of `diff --color` or `colordiff`, but extending the
display of colored output from red for deleted lines and green for added
lines to red for deleted characters and green for added characters within
the changed lines.
The tool has options to choose your own favorite color combinations, as
long as they are supported by
[Term::ANSIColor](https://metacpan.org/pod/Term::ANSIColor).
If you want no colors but indicators below the removed/added characters
in the output, which is very useful if you want to email the output, the
option `--no-color` adds those indicators. With the `--fancy` option you
will get Unicode characters.
# Installation
Change the first line of `ccdiff` to start your favorite perl interpreter
and then move the file to a folder in your `$PATH`, or install from CPAN:
```
$ cpan App::ccdiff
```
# Alternatives
## Command line / CLI
* `diff`
* `diff --color`
* [`colordiff`](https://www.colordiff.org/)
* [`klondiff`](https://github.com/pierstitus/klondiff)
* [`diff-so-fancy`](https://github.com/so-fancy/diff-so-fancy)
* `git`
This however requires a long command:
```
$ git -c color.diff.new='bold reverse green' \
-c color.diff.old='bold reverse red' \
diff --no-index -U0 --no-color \
--word-diff=color --word-diff-regex=. \
<file1> <file2>
```
An alternative for integration with git is `diff-so-fancy`
## ASCII
* `vimdiff`
## GUI
Please never use the `xdiff` command (if available at all), because it is
included in many distributions and/or packages and they all work different
or not at all. Some at not intended to be invoked from the command line.
The list is in increasing clarity of the tool being able to show *minor*
changes in lines visually outstanding:
* `mgdiff` (C, X11)
* `diffuse` (Python)
* `bcompare` (C, X11, not freeware/opensource)
* `kompare` (C, X11, KDE)
* `xxdiff` (C, X11)
* `meld` (Python)
* `kdiff3` (C, X11, Qt)
* `tkdiff` (Tcl/Tk)
## Other (not checked yet)
Reasons for not checking include Windows and emacs.
* araxis
* bc
* bc3
* codecompare
* deltaworker
* diffmerge
* ecmerge
* emerge
* examdiff
* guiffy
* gvimdiff2
* gvimdiff3
* opendiff
* p4merge
* winmerge
# Dependencies
This tool will run on recent perl distributions that have
[Algorithm::Diff](https://metacpan.org/pod/Algorithm::Diff)
installed. The modules
[Term::ANSIColor](https://metacpan.org/pod/Term::ANSIColor)
and [Getopt::Long](https://metacpan.org/pod/Getopt::Long)
that are also used are part of the perl CORE distribution
since at least version 5.6.0.
```
suse# zypper in perl-Algorithm-Diff
centos# yum install -y perl-Algorithm-Diff
other# cpan Algorithm::Diff
```
# Git integration
You can use ccdiff to show diffs in git. It may work like this:
```
$ git config --global diff.tool ccdiff
$ git config --global difftool.prompt false
$ git config --global difftool.ccdiff.cmd 'ccdiff --utf-8 -u -r $LOCAL $REMOTE'
$ git difftool SHA~..SHA
$ wget https://github.com/Tux/App-ccdiff/raw/master/Files/git-ccdiff \
-O ~/bin/git-ccdiff
$ perl -pi -e 's{/pro/bin/perl}{/usr/bin/env perl}' ~/bin/git-ccdiff
$ chmod 755 ~/bin/git-ccdiff
$ git ccdiff SHA
```
Of course you can use `curl` instead of `wget` and you can choose your own
(fixed) path to `perl` instead of using `/usr/bin/env`.
## LIMITATIONS
There is no provision (yet) for coping with double-width characters.
Large datasets may consume all available memory, causing the diff to fail.
Not all that can be set from the configuration files can be overruled by
command-line options.
## LICENSE
The Artistic License 2.0
Copyright (c) 2018-2025 H.Merijn Brand
|
