#git-repository #branch #typed #explorer #git2 #rustic #repo

bin+lib supergit

A strongly typed, read-only representation of a git repository

3 unstable releases

0.2.1 Jan 8, 2021
0.2.0 Jan 8, 2021
0.1.0 Nov 9, 2020

#10 in #rustic

GPL-3.0-or-later

80KB
885 lines

supergit

Strongly typed git repository explorer This library provides a more Rustic interface for git repositories, built on the git2 bindings. If you want more low-level access to your repository, consider using that library instead.

supergit aims to make queries into a git repo as typed and easy as possible. Start by creating a Repository, and enumerating or fetching Branches that you are interested in.

use supergit::Repository;

let r = Repository::open("/path/to/repo").unwrap();
println!("{:?}", r.branches());

let branch = r.branch("main").unwrap();
let head = branch.head();
println!("{}: {}", head.id(), head.summary().unwrap_or("".into()));

Library structure

The main abstraction layer for a repository is a set of iterators, over branches, commits, and files in commit trees. Some functions implemented in supergit are quite computationally intensive; they are marked as such with their runtime cost! It's recommended to include supergit::prelude to get started with development.

Dependencies

~11MB
~249K SLoC