girt 0.16.0

An incremental, idiomatic Rust implementation of Git
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44

//! Run with `cargo run --example loose_commit`; all storage is disposable.
use girt::{
    Commit, CommitFields, EntryMode, LooseObjects, ObjectFormat, Signature, Tree, TreeEntry,
};

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let directory = tempfile::tempdir()?;
    let objects = LooseObjects::new(directory.path().join("objects"), ObjectFormat::Sha1);

    let blob = objects.write_blob(b"Hello from a commit!\n")?;
    let tree = Tree::new(
        girt::ObjectFormat::Sha1,
        vec![TreeEntry {
            mode: EntryMode::Blob,
            name: b"hello.txt".to_vec(),
            id: blob,
        }],
    )?;
    let tree_id = objects.write_tree(&tree)?;

    let author = Signature::now(b"A. Writer", b"writer@example.com")?;
    let commit = Commit::new(CommitFields {
        tree: tree_id,
        parents: vec![],
        author: author.clone(),
        committer: author,
        extra_headers: vec![],
        message: b"Record the first snapshot\n".to_vec(),
    })?;

    let id = objects.write_commit(&commit)?;
    let restored = objects.read_commit(id, 4096)?;
    assert_eq!(restored, commit);

    let restored_tree = objects.read_tree(restored.tree(), 4096)?;
    assert_eq!(
        objects.read_blob(restored_tree.entries()[0].id, 1024)?,
        b"Hello from a commit!\n"
    );

    println!("Stored commit {id} referencing tree {tree_id} and blob {blob}");
    // The temporary directory and every loose object are removed on normal exit.
    Ok(())
}