Movatterモバイル変換

[0]ホーム
URL:

Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

 Sign up
Appearance settings

Update README.md#221

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to ourterms of service andprivacy statement. We’ll occasionally send you account related emails.

Already on GitHub?Sign in to your account

Merged
wumpz merged 1 commit intojava-diff-utils:masterfrommb720:patch-1
Oct 5, 2025
Merged
Changes fromall commits
Commits
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
42 changes: 21 additions & 21 deletionsREADME.md
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -4,38 +4,38 @@

[![Build Status](https://travis-ci.org/java-diff-utils/java-diff-utils.svg?branch=master)](https://travis-ci.org/java-diff-utils/java-diff-utils)

[![Build Status usingGithub Actions](https://github.com/java-diff-utils/java-diff-utils/workflows/Java%20CI%20with%20Maven/badge.svg)](https://github.com/java-diff-utils/java-diff-utils/actions?query=workflow%3A%22Java+CI+with+Maven%22)
[![Build Status usingGitHub Actions](https://github.com/java-diff-utils/java-diff-utils/workflows/Java%20CI%20with%20Maven/badge.svg)](https://github.com/java-diff-utils/java-diff-utils/actions?query=workflow%3A%22Java+CI+with+Maven%22)

[![Codacy Badge](https://app.codacy.com/project/badge/Grade/002c53aa0c924f71ac80a2f65446dfdd)](https://www.codacy.com/gh/java-diff-utils/java-diff-utils/dashboard?utm_source=github.com&utm_medium=referral&utm_content=java-diff-utils/java-diff-utils&utm_campaign=Badge_Grade)

[![Maven Central](https://maven-badges.herokuapp.com/maven-central/io.github.java-diff-utils/java-diff-utils/badge.svg)](http://maven-badges.herokuapp.com/maven-central/io.github.java-diff-utils/java-diff-utils)

## Intro

Diff Utils library is anOpenSourcelibrary 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.
Diff Utils library is anopen sourcelibrary for performing 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.

Mainreason 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 andit's nice design of diff module.
The mainreason 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 andits nice design of diff module.

**This is originally a fork of java-diff-utils from Google Code Archive.**

## GPG Signature Validation

The gpg singing key in [KEYS] is used for thisprojects artifacts.
The gpg singing key in [KEYS] is used for thisproject's artifacts.

## API

Javadocs of the actual release version: [JavaDocs java-diff-utils](https://java-diff-utils.github.io/java-diff-utils/4.10/docs/apidocs/)
Javadocs of the actual release version: [Javadocs java-diff-utils](https://java-diff-utils.github.io/java-diff-utils/4.10/docs/apidocs/)

## Examples

Look [here](https://github.com/java-diff-utils/java-diff-utils/wiki) to find more helpfulinformations and examples.
Look [here](https://github.com/java-diff-utils/java-diff-utils/wiki) to find more helpfulinformation and examples.

These two outputs are generated usingthisjava-diff-utils. The source code can also be found at the *Examples* page:
These two outputs are generated using java-diff-utils. The source code can also be found at the *Examples* page:

**Producing a one liner including all difference information.**

```Java
//create a configured DiffRowGenerator
// Create a configured DiffRowGenerator
DiffRowGenerator generator = DiffRowGenerator.create()
.showInlineDiffs(true)
.mergeOriginalRevised(true)
Expand All@@ -44,15 +44,15 @@ DiffRowGenerator generator = DiffRowGenerator.create()
.newTag(f -> "**") //introduce markdown style for bold
.build();

//computethe differences for two test texts.
// Computethe differences for two test texts
List<DiffRow> rows = generator.generateDiffRows(
Arrays.asList("This is a testsenctence."),
Arrays.asList("This is a testsentence."),
Arrays.asList("This is a test for diffutils."));

System.out.println(rows.get(0).getOldLine());
```

This is a test ~senctence~**for diffutils**.
This is a test ~sentence~**for diffutils**.

**Producing a side by side view of computed differences.**

Expand All@@ -64,9 +64,9 @@ DiffRowGenerator generator = DiffRowGenerator.create()
.newTag(f -> "**")
.build();
List<DiffRow> rows = generator.generateDiffRows(
Arrays.asList("This is a testsenctence.", "This is the second line.", "And here is the finish."),
Arrays.asList("This is a testsentence.", "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) {
Expand All@@ -76,14 +76,14 @@ for (DiffRow row : rows) {

|original|new|
|--------|---|
|This is a test ~senctence~.|This is a test **for diffutils**.|
|This is a test ~sentence~.|This is a test **for diffutils**.|
|This is the second line.|This is the second line.|
|~And here is the finish.~||

## Main Features

*computing the difference between two texts.
*capable tohand more than plainascii. Arrays or List of any type that implements hashCode() and equals() correctly can be subject to differencing using this library
*Computing the difference between two texts.
*Capable tohandle more than plainASCII. Arrays or List of any type that implements hashCode() and equals() correctly can be subject to differencing using this library
* patch and unpatch the text with the given patch
* parsing the unified diff format
* producing human-readable differences
Expand All@@ -95,10 +95,10 @@ for (DiffRow row : rows) {

### Algorithms

*Myer's diff
*Myers diff
* HistogramDiff

But it can easily replaced by any other which is better forhanding your texts. I have plan to add implementation of some in future.
But it can easilybereplaced by any other which is better forhandling your texts. I haveaplan to addtheimplementation of some in the future.

## Source Code conventions

Expand All@@ -123,7 +123,7 @@ This is a valid piece of source code:

### To Install

Just add the code below to yourmaven dependencies:
Just add the code below to yourMaven dependencies:

```xml
<dependency>
Expand All@@ -133,7 +133,7 @@ Just add the code below to your maven dependencies:
</dependency>
```

or usinggradle:
or usingGradle:

```groovy
// https://mvnrepository.com/artifact/io.github.java-diff-utils/java-diff-utils
Expand Down
[8]ページ先頭
©2009-2025 Movatter.jp