Universal.Git 1.0.0

Universal.Git

Universal.Git provides Git repository APIs on Universal.VersionControl.

using Universal.Git;
using Universal.VersionControl;

using GitRepository repository = await GitRepository.InitializeAsync("repository");
ObjectId blob = await repository.WriteBlobAsync("content\n"u8.ToArray());
ObjectId tree = await repository.WriteTreeAsync([
    new GitTreeEntry { Mode = "100644", Name = "file.txt", ObjectId = blob },
]);
GitSignature signature = new()
{
    Name = "A. User",
    Email = "a@example.com",
    When = DateTimeOffset.UtcNow,
};
GitVersionInfo commit = await repository.CommitAsync(
    new GitCommitState
    {
        Tree = tree,
        Author = signature,
        Committer = signature,
        Message = "Initial commit\n",
    },
    new VersionCreationOptions(),
    new VersionReferenceName("refs/heads/main"),
    expectedTarget: null);

Repository data

• SHA-1 and SHA-256 objects, packs, pack indexes, alternates, bundles, commit graphs, and multi-pack indexes.
• Direct, symbolic, packed, replacement, shallow, reflog, branch, tag, note, worktree, and submodule state.
• Index versions 2 through 4, attributes, ignore rules, sparse checkout, status, staging, checkout, restore, reset, clean, move, and remove.
• Object, tree, revision, history, diff, patch, blame, grep, describe, inspection, and integrity APIs.

History operations

• Commit, merge, merge-base, pull, rebase, stash, cherry-pick, revert, rerere, bisect, and pruning.
• Text and binary patches, patch IDs, range diffs, format-patch, mailbox parsing, and am sessions.
• Archives, fast import/export, reference transactions, signing providers, credential helpers, and hooks.

Transport

• Local paths and file: URLs.
• Smart and dumb HTTP and HTTPS.
• SSH and SCP-style SSH URLs.
• OpenSSH, PuTTY Plink/Pageant, TortoisePlink, and simple SSH command variants. SSH remotes honor GIT_SSH_COMMAND, GIT_SSH, GIT_SSH_VARIANT, core.sshCommand, and ssh.variant.
• Git protocol versions 0, 1, and 2 over git: transport.
• Clone, fetch, push, upload-pack, and receive-pack operations.

Network, object, pack, graph, patch, mailbox, helper, and hook operations expose resource limits and cancellation. Mutable metadata uses lock files or atomic replacement where the repository format permits it.

The package targets .NET Standard 2.0.