HansPeterGit 0.1.8

HansPeterGit

GIT interface for .NET

This repository contains a cross-platform interface to the git CLI (aka git.exe/git).

The project aim is to get rid of the stale library libgit2sharp and provide an easy interface to interact with the git cli.

Dependencies

An installed version of git should be accessible via path or can be defined via the GitOptions.PathToGit property.

Install

Add the NuGet package HansPeterGit to any project supporting .NET Standard 2.0 or higher.

> dotnet add package HansPeterGit

Usage

Clone a repository

GitRepository.Clone() can download a remote repository to the local file system, same as the git clone command.

GitRepository.Clone("https://github.com/twenzel/HansPeterGit.git", @"D:\TestSample");

Create a local repository

The GitRepository.Init() method can create a new Git repository in the specified path, equivalent to the git init command.

var repos = new GitRepository(@"D:\TestSample");
repos.Init();

Get status

Using the GetStatus() method to retrieve the repositories current status.

var repos = new GitRepository(@"D:\TestSample");
var status = repos.GetStatus();

Console.WriteLine($"Current branch: {status.Branch}");
Console.WriteLine($"Current commit: {status.Commit}");

if (status.IsDirty)
{
    var newfile = status.Added.First();
}

var fileInfo = status["src/newFile.json"];

Staging/Restore

To stage the current work tree use any of the Stage/Add/Restore methods.

repos.StageAll();

// Stage file
repos.Add("src/newFile.json");

// Discard changes in working directory
repos.Restore("src/newFile.json");

// Unstage file
repos.Unstage("src/newFile.json");

Commit changes

The Commit() method can be used to commit the current changes.

var commit = repos.Commit("Fix calculation bug");

// with dedicated author
repos.Commit("Fix calculation bug", new Author("Some name", "bugfixer@test.com"));

Push changes

To push changes from the local repository please use the Push() methods.

repos.Push();

// with dedicated remove name
repos.Push("origin", "main");

// with setting an upstream
repos.PushWithUpstream("origin", "main");

Others

There are already some other methods but not all commands are wrapped/implemented yet. Please feel free to create an issue or contribute.

Authentication

Sometimes the remote repository requires an authentication (e.g. GitHub, Azure DevOps). In order to clone or push the repository you can define an authentication.

var options = new GitOptions(workingDirectory);
options.Authentication = new BasicAuthentication("pat", "myuserpat"); 

var repository = GitRepository.Clone("https://dev.azure.com/yourOrgName/yourProject/_git/yourRepository", options);

Beside BasicAuthentication an BearerAuthentication is also already build-in. You can implement your own authentication by implementing the IAuthentication interface. The build-in authentication implementation uses the '-c http.extraheader' argument of the git cli to provide the credentials.