/git_diff

A simple implementation for taking the output from 'git diff' and transforming it into Elixir structs.

Primary LanguageElixirMIT LicenseMIT

GitDiff

A simple implementation for taking the output from 'git diff' and transforming it into Elixir structs.

Documentation

API documentation is available at https://hexdocs.pm/git_diff

Installation

The package can be installed by adding git_diff to your list of dependencies in mix.exs:

def deps do
  [
    {:git_diff, "~> 0.6.4"}
  ]
end

Example

Output:

[
  %GitDiff.Patch{
    chunks: [
      %GitDiff.Chunk{
        from_num_lines: "42",
        from_start_line: "42",
        header: "@@ -481,23 +483,24 @@ class Cursor extends Model {"
        context: "class Cursor extends Model {", # will be "" if there is no context
        lines: [
          %GitDiff.Line{
            from_line_number: "481",
            text: "   {",
            to_line_number: "483",
            type: :context # will be one of :context, :add, :remove
          },
          ...
        ],
        to_num_lines: "42",
        to_start_line: "42"
      }
    ],
  from: "src/cursor.js",
  headers: %{"index" => {"10bdef8", "181eeb9", "100644"}},
  to: "src/cursor.js"},
]

The above output is heavily truncated for illustration, but it should give enough of an idea of what to expect. The code, while naive, is less than 100 lines of actual code and all takes place in the GitDiff module. Emulate the tests in an interactive shell for quick viewing of the output.

Benchmarks

Haven't done much benchmarking, but up to around a 5k (I just stopped trying there) line diff the performance was linear and took a whopping 35ms per call on the test VM. For a more reasonably sized ~150 line diff it clocked in at around 340 microseconds.