java diff utils

java-diff-utils

状態

イントロ

Diff Utils ライブラリは、テキスト間の比較操作を実行するためのオープンソース ライブラリです。つまり、差分の計算、パッチの適用、統合された差分の生成または解析、将来の表示 (並べて表示など) を容易にするための差分出力の生成などです。

このライブラリを構築する主な理由は、diff ファイルを操作するときに必要な通常のものをすべて備えた使いやすいライブラリが不足していたことでした。元々は JRCS ライブラリからインスピレーションを得たもので、diff モジュールのデザインが素晴らしいです。

これは元々、Google Code Archive からの java-diff-utils のフォークです。

API

実際のリリース バージョンの Javadoc: JavaDocs java-diff-utils

例

さらに役立つ情報と例については、ここを参照してください。

これら 2 つの出力は、この java-diff-utils を使用して生成されます。ソース コードは、サンプルページにもあります。

すべての相違点情報を含むワンライナーを作成します。

 //create a configured DiffRowGenerator
DiffRowGenerator generator = DiffRowGenerator . create ()
                . showInlineDiffs ( true )
                . mergeOriginalRevised ( true )
                . inlineDiffByWord ( true )
                . oldTag ( f -> "~" )      //introduce markdown style for strikethrough
                . newTag ( f -> "**" )     //introduce markdown style for bold
                . build ();

//compute the differences for two test texts.
List < DiffRow > rows = generator . generateDiffRows (
                Arrays . asList ( "This is a test senctence." ),
                Arrays . asList ( "This is a test for diffutils." ));
        
System . out . println ( rows . get ( 0 ). getOldLine ());

これはテストです文diffutils 用。

計算された差分を並べて表示します。

 DiffRowGenerator generator = DiffRowGenerator . create ()
                . showInlineDiffs ( true )
                . inlineDiffByWord ( true )
                . oldTag ( f -> "~" )
                . newTag ( f -> "**" )
                . build ();
List < DiffRow > rows = generator . generateDiffRows (
                Arrays . asList ( "This is a test senctence." , "This is the second line." , "And here is the finish." ),
                Arrays . asList ( "This is a test for diffutils." , "This is the second line." ));
        
System . out . println ( "|original|new|" );
System . out . println ( "|--------|---|" );
for ( DiffRow row : rows ) {
    System . out . println ( "|" + row . getOldLine () + "|" + row . getNewLine () + "|" );
}

オリジナル	新しい
これはテストです文。	これはdiffutils のテストです。
これは 2 行目です。	これは 2 行目です。
そして、これが仕上がりです。

主な特長

• 2 つのテキストの差を計算します。
• 単純な ASCII よりも多くの処理が可能です。 hashCode() とquals() を正しく実装する任意の型の配列またはリストは、このライブラリを使用して差分処理の対象にすることができます。
• 指定されたパッチを使用してテキストにパッチを適用したりパッチを解除したりする
• 統合された diff 形式を解析する
• 人間が判読できる差異を生み出す
• インライン差分構築
• アルゴリズム:
  • マイヤーズ標準アルゴリズム
  • マイヤーズによる線形空間の改善
  • JGit ライブラリを使用した HistogramDiff

アルゴリズム

• マイヤーの差分
• ヒストグラム差分

ただし、テキストを渡すのに適した他のものに簡単に置き換えることができます。将来的にはいくつかの実装を追加する予定です。

ソースコードの規約

最近、checkstyle プロセスがビルド プロセスに統合されました。 java-diff-utils は、Sun Java 形式の規則に従います。 TAB は使用できません。スペースを使用します。

 public static < T > Patch < T > diff ( List < T > original , List < T > revised ,
    BiPredicate < T , T > equalizer ) throws DiffException {
    if ( equalizer != null ) {
        return DiffUtils . diff ( original , revised ,
        new MyersDiff <>( equalizer ));
    }
    return DiffUtils . diff ( original , revised , new MyersDiff <>());
}

これは有効なソース コードです。

• 中括弧のないブロックは許可されません
• 制御ステートメント (if、while、for) の後には空白が必要です
• 左中括弧は制御ステートメントと同じ行にある必要があります

インストールするには

以下のコードを Maven の依存関係に追加するだけです。

< dependency >
    < groupId >io.github.java-diff-utils</ groupId >
    < artifactId >java-diff-utils</ artifactId >
    < version >4.15</ version >
</ dependency >

またはgradleを使用して:

 // https://mvnrepository.com/artifact/io.github.java-diff-utils/java-diff-utils
implementation " io.github.java-diff-utils:java-diff-utils:4.12 "