feat: add env::args_os_opt() which takes an argument to determine input unicode-decomposition

This allows for the possibility to respect `core.precomposeUnicode` should one already have that value.

Author: Byron

Cargo.lock

@@ -300,9 +300,6 @@ parking_lot = "0.12.1"
 
 document-features = { version = "0.2.0", optional = true }
 
-[target.'cfg(target_vendor = "apple")'.dependencies]
-unicode-normalization = { version = "0.1.19", default-features = false }
-
 [dev-dependencies]
 gix-testtools = { path = "../tests/tools" }
 is_ci = "1.1.1"

gix/Cargo.toml

@@ -12,21 +12,23 @@ pub fn agent() -> &'static str {
     concat!("oxide-", env!("CARGO_PKG_VERSION"))
 }
 
-/// Equivalent to `std::env::args_os()`, but with precomposed unicode on `MacOS` and other apple platforms.
-#[cfg(not(target_vendor = "apple"))]
-pub fn args_os() -> impl Iterator<Item = OsString> {
-    std::env::args_os()
-}
-
 /// Equivalent to `std::env::args_os()`, but with precomposed unicode on MacOS and other apple platforms.
+/// It does not change the input arguments on any other platform.
 ///
-/// Note that this ignores `core.precomposeUnicode` as git-config isn't available yet. It's default enabled in modern git though.
-#[cfg(target_vendor = "apple")]
+/// Note that this ignores `core.precomposeUnicode` as git-config isn't available yet. It's default enabled in modern git though,
+/// and generally decomposed unicode is nothing one would want in a git repository.
 pub fn args_os() -> impl Iterator<Item = OsString> {
-    use unicode_normalization::UnicodeNormalization;
-    std::env::args_os().map(|arg| match arg.to_str() {
-        Some(arg) => arg.nfc().collect::<String>().into(),
-        None => arg,
+    args_os_opt(cfg!(target_vendor = "apple"))
+}
+
+/// Like [`args_os()`], but with the `precompose_unicode` parameter akin to `core.precomposeUnicode` in the Git configuration.
+pub fn args_os_opt(precompose_unicode: bool) -> impl Iterator<Item = OsString> {
+    std::env::args_os().map(move |arg| {
+        if precompose_unicode {
+            gix_utils::str::precompose_os_string(arg.into()).into_owned()
+        } else {
+            arg
+        }
     })
 }