feat: add git_submodule_clone

libgit2-sys/lib.rs

@@ -2288,6 +2288,11 @@ extern "C" {
     ) -> c_int;
     pub fn git_submodule_add_to_index(submodule: *mut git_submodule, write_index: c_int) -> c_int;
     pub fn git_submodule_branch(submodule: *mut git_submodule) -> *const c_char;
+    pub fn git_submodule_clone(
+        repo: *mut *mut git_repository,
+        submodule: *mut git_submodule,
+        opts: *const git_submodule_update_options,
+    ) -> c_int;
     pub fn git_submodule_foreach(
         repo: *mut git_repository,
         callback: git_submodule_cb,

src/submodule.rs

@@ -33,6 +33,21 @@ impl<'repo> Submodule<'repo> {
         unsafe { crate::opt_bytes(self, raw::git_submodule_branch(self.raw)) }
     }
 
+    /// Perform the clone step for a newly created submodule.
+    ///
+    /// This performs the necessary `git_clone` to setup a newly-created submodule.
+    pub fn clone(&mut self, opts: &mut SubmoduleUpdateOptions<'_>) -> Result<Repository, Error> {
+        unsafe {
+            let mut raw_repo = ptr::null_mut();
+            try_call!(raw::git_submodule_clone(
+                &mut raw_repo,
+                self.raw().as_mut(),
+                &opts.raw() as *const _
+            ));
+            Ok(Binding::from_raw(raw_repo))
+        }
+    }
+
     /// Get the submodule's url.
     ///
     /// Returns `None` if the url is not valid utf-8 or if the URL isn't present
@@ -360,4 +375,18 @@ mod tests {
             t!(submodule.update(init, opts));
         }
     }
+
+    #[test]
+    fn clone_submodule() {
+        // -----------------------------------
+        // Same as `add_a_submodule()`
+        let (_td, repo1) = crate::test::repo_init();
+        let (_td, repo2) = crate::test::repo_init();
+
+        let url = Url::from_file_path(&repo1.workdir().unwrap()).unwrap();
+        let mut s = repo2
+            .submodule(&url.to_string(), Path::new("bar"), true)
+            .unwrap();
+        t!(s.clone(&mut SubmoduleUpdateOptions::default()));
+    }
 }