go-gitdiff#

A Go library for parsing and applying patches generated by git diff, git show, and git format-patch. It can also parse and apply unified diffs generated by the standard diff tool.

It supports both standard line-oriented / text patches and Git binary patches.

Status#

In development, most functionality is currently missing, incomplete, or broken.

Why another git/unified diff parser?#

Several packages with similar functionality exist, so why did I write another?

1. No other packages I found support binary diffs, as generated with the --binary flag. This is the main reason for writing a new packages, as the format is pretty different from line-oriented diffs and is unique to Git.

2. Most other packages only parse patches, so you need another package to apply them (and if they do support applies, it is only for text files.)

3. This package aims to accept anything that git apply accepts, and closely follows the logic in apply.c.

4. It seemed like a fun thing to write and a good way to learn more about Git.

Known Issues and Differences From Git#

1. Certain types of invalid input that I believe are accepted by git apply generate errors in this library. These include:

   • Numbers immediately followed by non-numeric characters
   • Trailing characters on a line after valid or expected content

2. The translation from C to Go may have introduced inconsistencies in the way Unicode file names are handled; these are bugs, so please report any issues of this type.

3. When reading headers, this library does not validate that OIDs present on an index line are shorter than or equal to the maximum hash length, as this requires knowing if the repository used SHA1 or SHA256 hashes.