Add windows::CommandExt::raw_arg on Rust 1.62+

Author: taiki-e

build.rs

@@ -10,6 +10,9 @@ fn main() {
         }
     };
 
+    if !cfg.probe_rustc_version(1, 62) {
+        autocfg::emit("async_process_no_windows_raw_arg");
+    }
     if !cfg.probe_rustc_version(1, 63) {
         autocfg::emit("async_process_no_io_safety");
     }

src/lib.rs

@@ -520,13 +520,15 @@ impl AsRawFd for ChildStdin {
     }
 }
 
+/// **Note:** This implementation is only available on Rust 1.63+.
 #[cfg(all(not(async_process_no_io_safety), unix))]
 impl AsFd for ChildStdin {
     fn as_fd(&self) -> BorrowedFd<'_> {
         self.0.as_fd()
     }
 }
 
+/// **Note:** This implementation is only available on Rust 1.63+.
 #[cfg(all(not(async_process_no_io_safety), unix))]
 impl TryFrom<ChildStdin> for OwnedFd {
     type Error = io::Error;
@@ -604,13 +606,15 @@ impl AsRawFd for ChildStdout {
     }
 }
 
+/// **Note:** This implementation is only available on Rust 1.63+.
 #[cfg(all(not(async_process_no_io_safety), unix))]
 impl AsFd for ChildStdout {
     fn as_fd(&self) -> BorrowedFd<'_> {
         self.0.as_fd()
     }
 }
 
+/// **Note:** This implementation is only available on Rust 1.63+.
 #[cfg(all(not(async_process_no_io_safety), unix))]
 impl TryFrom<ChildStdout> for OwnedFd {
     type Error = io::Error;
@@ -677,13 +681,15 @@ impl AsRawFd for ChildStderr {
     }
 }
 
+/// **Note:** This implementation is only available on Rust 1.63+.
 #[cfg(all(not(async_process_no_io_safety), unix))]
 impl AsFd for ChildStderr {
     fn as_fd(&self) -> BorrowedFd<'_> {
         self.0.as_fd()
     }
 }
 
+/// **Note:** This implementation is only available on Rust 1.63+.
 #[cfg(all(not(async_process_no_io_safety), unix))]
 impl TryFrom<ChildStderr> for OwnedFd {
     type Error = io::Error;

src/windows.rs

@@ -1,5 +1,7 @@
 //! Windows-specific extensions.
 
+#[cfg(not(async_process_no_windows_raw_arg))]
+use std::ffi::OsStr;
 use std::os::windows::io::{AsRawHandle, RawHandle};
 use std::os::windows::process::CommandExt as _;
 
@@ -16,6 +18,15 @@ pub trait CommandExt: crate::sealed::Sealed {
     ///
     /// [1]: https://docs.microsoft.com/en-us/windows/win32/procthread/process-creation-flags
     fn creation_flags(&mut self, flags: u32) -> &mut Command;
+
+    /// Append literal text to the command line without any quoting or escaping.
+    ///
+    /// This is useful for passing arguments to `cmd.exe /c`, which doesn't follow
+    /// `CommandLineToArgvW` escaping rules.
+    ///
+    /// **Note:** This method is only available on Rust 1.62+.
+    #[cfg(not(async_process_no_windows_raw_arg))]
+    fn raw_arg<S: AsRef<OsStr>>(&mut self, text_to_append_as_is: S) -> &mut Command;
 }
 
 impl crate::sealed::Sealed for Command {}
@@ -24,6 +35,12 @@ impl CommandExt for Command {
         self.inner.creation_flags(flags);
         self
     }
+
+    #[cfg(not(async_process_no_windows_raw_arg))]
+    fn raw_arg<S: AsRef<OsStr>>(&mut self, text_to_append_as_is: S) -> &mut Command {
+        self.inner.raw_arg(text_to_append_as_is);
+        self
+    }
 }
 
 impl AsRawHandle for Child {