feat(opts): get/set/reset search path

Author: weihanglo

src/opts.rs

@@ -1,6 +1,65 @@
 //! Bindings to libgit2's git_libgit2_opts function.
 
-use crate::raw;
+use crate::util::Binding;
+use crate::{call, raw, Buf, ConfigLevel, Error, IntoCString};
+
+/// Set the search path for a level of config data. The search path applied to
+/// shared attributes and ignore files, too.
+///
+/// `level` must be one of [`ConfigLevel::System`], [`ConfigLevel::Global`],
+/// [`ConfigLevel::XDG`], [`ConfigLevel::ProgramData`].
+///
+/// `path` lists directories delimited by `GIT_PATH_LIST_SEPARATOR`.
+/// Use magic path `$PATH` to include the old value of the path
+/// (if you want to prepend or append, for instance).
+pub fn set_search_path<P>(level: ConfigLevel, path: P) -> Result<(), Error>
+where
+    P: IntoCString,
+{
+    crate::init();
+    let path = path.into_c_string()?;
+    unsafe {
+        call::c_try(raw::git_libgit2_opts(
+            raw::GIT_OPT_SET_SEARCH_PATH as libc::c_int,
+            level as libc::c_int,
+            path,
+        ))?;
+    }
+    Ok(())
+}
+
+/// Reset the search path for a given level of config data to the default
+/// (generally based on environment variables).
+///
+/// `level` must be one of [`ConfigLevel::System`], [`ConfigLevel::Global`],
+/// [`ConfigLevel::XDG`], [`ConfigLevel::ProgramData`].
+pub fn reset_search_path(level: ConfigLevel) -> Result<(), Error> {
+    crate::init();
+    unsafe {
+        call::c_try(raw::git_libgit2_opts(
+            raw::GIT_OPT_SET_SEARCH_PATH as libc::c_int,
+            level as libc::c_int,
+            core::ptr::null::<u8>(),
+        ))?;
+    }
+    Ok(())
+}
+
+/// Get the search path for a given level of config data.
+///
+/// `level` must be one of [`ConfigLevel::System`], [`ConfigLevel::Global`],
+/// [`ConfigLevel::XDG`], [`ConfigLevel::ProgramData`].
+pub fn get_search_path(level: ConfigLevel) -> Result<String, Error> {
+    let buf = Buf::new();
+    unsafe {
+        call::c_try(raw::git_libgit2_opts(
+            raw::GIT_OPT_GET_SEARCH_PATH as libc::c_int,
+            level as libc::c_int,
+            buf.raw(),
+        ))?;
+    }
+    Ok(buf.as_str().unwrap().to_string())
+}
 
 /// Controls whether or not libgit2 will verify when writing an object that all
 /// objects it references are valid. Enabled by default, but disabling this can