|
1 | | -Diff Utils library is an OpenSource library for performing the comparison operations between texts: computing diffs, applying patches, generating unified diffs or parsing them, generating diff output for easy future displaying (like side-by-side view) and so on. |
| 1 | +# Java Diff Utils |
2 | 2 |
|
3 | | -Main reason to build this library was the lack of easy-to-use libraries with all the usual stuff you need while working with diff files. Originally it was inspired by JRCS library and it's nice design of diff module. |
| 3 | +java-diff-utils was originally developed at Google Code: <https://code.google.com/archive/p/java-diff-utils/>. |
4 | 4 |
|
5 | | -# Main Features |
| 5 | +The original author created a new repository at <https://github.com/dnaumenko/java-diff-utils>. |
6 | 6 |
|
7 | | -* computing the difference between two texts. |
8 | | -* capable to hand more than plain ASCII. Arrays or List of any type that implements hashCode() and equals() correctly can be subject to differencing using this library |
9 | | -* patch and unpatch the text with the given patch |
10 | | -* parsing the unified diff format |
11 | | -* producing human-readable differences |
12 | | - |
13 | | -# Algorithms |
14 | | - |
15 | | -This library implements Myer's diff algorithm. But it can easily replaced by any other which is better for handing your texts. I have plan to add implementation of some in future. |
16 | | - |
17 | | -# Changelog |
18 | | - |
19 | | -## Version 1.2 |
20 | | -* JDK 1.5 compatibility |
21 | | -* Ant build script |
22 | | -* Generate output in unified diff format (thanks for Bill James) |
23 | | - |
24 | | -# To Install |
25 | | - |
26 | | -Just add the code below to your maven dependencies: |
27 | | - |
28 | | - <dependency> |
29 | | - <groupId>com.googlecode.java-diff-utils</groupId> |
30 | | - <artifactId>diffutils</artifactId> |
31 | | - <version>1.3.0</version> |
32 | | - </dependency> |
33 | | - |
34 | | -And for Ivy: |
35 | | - |
36 | | - <dependency org="com.googlecode.java-diff-utils" name="diffutils" rev="1.3.0"/> |
37 | | - |
38 | | -# Coming eventually |
39 | | - |
40 | | -* support for inline diffs in output |
41 | | -* helpers for showing side-by-side, line-by-line diffs or text with inter-line and intra-line change highlights |
42 | | -* customization of diff algorithm for better experience while computing diffs between strings (ignoring blank lines or spaces, etc) |
43 | | -* generating output in other formats (not only unified). E.g. CVS. |
44 | | - |
45 | | -# Tutorials |
46 | | - |
47 | | -http://www.adictosaltrabajo.com/tutoriales/tutoriales.php?pagina=CompararFicherosJavaDiffUtils (in Spanish). Thanks Miguel |
| 7 | +Meanwhile, other persons created a fork of Google Code: <https://github.com/KengoTODA/java-diff-utils>. |
| 8 | +This repository was forked multiple times. |
| 9 | +The most active fork was maintained by @bkromhout. |
| 10 | +@koppor took over maintaince and moved it to <https://github.com/java-diff-utils/java-diff-utils>. |
| 11 | +Please continue contributing there. |
0 commit comments