Merge branch 'example-new-repo'

Author: Byron

git-repository/examples/init-repo-and-commit.rs

@@ -0,0 +1,38 @@
+// creates a repo with user-specified path (which must not exist)
+// adds initial commit with empty tree
+
+use anyhow::Context;
+use git_repository as git;
+
+fn main() -> anyhow::Result<()> {
+    // Note use of args_os:
+    // paths may not be UTF-8 encoded and thus can't be forced into a String.
+    // gitoxide does not assume encodings that aren't there
+    // to match the way git does it as a bare minimum and be just as flexible.
+    let work_dir = std::env::args_os()
+        .nth(1)
+        .context("First argument needs to be the directory to initialize the repository in")?;
+    let repo = git::init(work_dir)?;
+
+    println!(
+        "Repo: {:?}",
+        repo.work_dir().expect("non-bare repositories have a work-dir")
+    );
+
+    let empty_tree_id = repo.write_object(git::objs::Tree::empty())?;
+    let author = git::actor::SignatureRef {
+        name: "Maria Sanchez".into(),
+        email: "[email protected]".into(),
+        time: git_date::Time::now_local_or_utc(),
+    };
+    let id = repo.commit(
+        "HEAD",
+        author,
+        author,
+        "initial commit",
+        empty_tree_id,
+        git::commit::NO_PARENT_IDS,
+    )?;
+    println!("new commit id with empty tree: {:?}", id);
+    Ok(())
+}