GitDotNet is a .NET library designed to read Git repositories in a fully native .NET environment. It is optimized for minimal memory footprint and efficient data retrieval from repositories.

It also supports writing, but it doesn't write itself: it uses git fast-import to write objects and refs to the repository. This guarantees best writing performance, safe git data writing, and avoid having to reinvent the wheel (object compression...).

• Supports .NET 8 and 9. Note that .NET 9 is highly recommended because it uses zlib-ng which is much faster.
• Reade and parses Git objects (commits, trees, blobs, tags, index...) natively in .NET, using memory-mapped files or in-memory data for high performance.
• In-memory data uses IMemoryCache and can use max size & prioritization to control memory footprint.
• Writes in pack files when committing large number of changes.
• Asynchronous methods for efficient data retrieval.
• Minimal memory footprint with lazy loading of data and usage of data streaming.
• Comparison of git commits and trees, along with renaming detection and git patch creation.

To install GitDotNet, add the GitDotNet or GitDotNet.Microsoft.Extensions.DependencyInjection NuGet package to your project.

1. Add GitDotNet dependencies to your IServiceCollection using the AddGitDotNet extension method. This will inject ConnectionProvider and other required services.
2. Use the Objects.GetAsync method to retrieve Git objects by their hash.
3. Use the provided methods to parse and display the content of commits, trees, blobs, and tags.

using Microsoft.Extensions.DependencyInjection;
using GitDotNet;

var services = new ServiceCollection()
    .AddMemoryCache(o => o.SizeLimit = 10_000_000) // Each entry size is always 1
    .AddGitDotNet();
var provider = services.BuildServiceProvider().GetRequiredService<GitConnectionProvider>();

using var connection = await provider("path/to/repo");
var commit = await connection.Branches["main"].Tip;
Console.WriteLine($"Commit Message: {commit.Message}");

var tree = await commit.GetTreeAsync();

Contributions are welcome! Please open an issue or submit a pull request on GitHub.

This project is licensed under the MIT License.