feat: add commands function

src/haiku.rs

@@ -5,13 +5,21 @@ use crate::{CommandExt, IntoResult};
 pub fn that<T: AsRef<OsStr>>(path: T) -> io::Result<()> {
     Command::new("/bin/open")
         .arg(path.as_ref())
-        .status_without_output()
+        .without_io()
+        .status()
         .into_result()
 }
 
 pub fn with<T: AsRef<OsStr>>(path: T, app: impl Into<String>) -> io::Result<()> {
     Command::new(app.into())
         .arg(path.as_ref())
-        .status_without_output()
+        .without_io()
+        .status()
         .into_result()
 }
+
+pub fn commands<T: AsRef<OsStr>>(path: T) -> impl Iterator<Item = Command> {
+    let mut cmd = Command::new("/bin/open");
+    cmd.arg(path.as_ref());
+    Some(cmd).into_iter()
+}

src/ios.rs

@@ -6,7 +6,8 @@ pub fn that<T: AsRef<OsStr>>(path: T) -> io::Result<()> {
     Command::new("uiopen")
         .arg("--url")
         .arg(path.as_ref())
-        .status_without_output()
+        .without_io()
+        .status()
         .into_result()
 }
 
@@ -16,6 +17,13 @@ pub fn with<T: AsRef<OsStr>>(path: T, app: impl Into<String>) -> io::Result<()>
         .arg(path.as_ref())
         .arg("--bundleid")
         .arg(app.into())
-        .status_without_output()
+        .without_io()
+        .status()
         .into_result()
 }
+
+pub fn commands<T: AsRef<OsStr>>(path: T) -> impl Iterator<Item = Command> {
+    let mut cmd = Command::new("uiopen");
+    cmd.arg("--url").arg(path.as_ref());
+    Some(cmd).into_iter()
+}

src/lib.rs

@@ -14,6 +14,12 @@
 //! open::with("http://rust-lang.org", "firefox").unwrap();
 //! ```
 //!
+//! Or obtain commands for opening the URL without running them.
+//!
+//! ```no_run
+//! let cmds = open::commands("http://rust-lang.org");
+//! ```
+//!
 //! # Notes
 //!
 //! ## Nonblocking operation
@@ -131,6 +137,21 @@ pub fn with<T: AsRef<OsStr>>(path: T, app: impl Into<String>) -> io::Result<()>
     os::with(path, app)
 }
 
+/// Get iterator over commands that open path with the default application.
+/// Iterator over Commands is returned as for certain platforms there are
+/// multiple command options.
+/// It is the responsibility of the callee to try all commands.
+///
+/// # Examples
+///
+/// ```no_run
+/// let path = "http://rust-lang.org";
+/// let cmds = open::commands(path);
+/// ```
+pub fn commands<T: AsRef<OsStr>>(path: T) -> impl Iterator<Item = Command> {
+    os::commands(path)
+}
+
 /// Open path with the default application in a new thread.
 ///
 /// See documentation of [`that()`] for more details.
@@ -182,17 +203,19 @@ impl IntoResult<io::Result<()>> for std::os::raw::c_int {
 }
 
 trait CommandExt {
-    fn status_without_output(&mut self) -> io::Result<std::process::ExitStatus>;
+    fn without_io(&mut self) -> &mut Self;
+    fn status(&mut self) -> io::Result<std::process::ExitStatus>;
 }
 
 impl CommandExt for Command {
-    fn status_without_output(&mut self) -> io::Result<std::process::ExitStatus> {
-        let mut process = self
-            .stdin(Stdio::null())
+    fn without_io(&mut self) -> &mut Self {
+        self.stdin(Stdio::null())
             .stdout(Stdio::null())
             .stderr(Stdio::null())
-            .spawn()?;
+    }
 
+    fn status(&mut self) -> io::Result<std::process::ExitStatus> {
+        let mut process = self.spawn()?;
         process.wait()
     }
 }

src/macos.rs

@@ -5,7 +5,8 @@ use crate::{CommandExt, IntoResult};
 pub fn that<T: AsRef<OsStr>>(path: T) -> io::Result<()> {
     Command::new("/usr/bin/open")
         .arg(path.as_ref())
-        .status_without_output()
+        .without_io()
+        .status()
         .into_result()
 }
 
@@ -14,6 +15,13 @@ pub fn with<T: AsRef<OsStr>>(path: T, app: impl Into<String>) -> io::Result<()>
         .arg(path.as_ref())
         .arg("-a")
         .arg(app.into())
-        .status_without_output()
+        .without_io()
+        .status()
         .into_result()
 }
+
+pub fn commands<T: AsRef<OsStr>>(path: T) -> impl Iterator<Item = Command> {
+    let mut cmd = Command::new("/usr/bin/open");
+    cmd.arg(path.as_ref());
+    Some(cmd).into_iter()
+}

src/unix.rs

@@ -8,7 +8,7 @@ use std::{
 
 use crate::{CommandExt, IntoResult};
 
-pub fn that<T: AsRef<OsStr>>(path: T) -> io::Result<()> {
+pub fn commands<T: AsRef<OsStr>>(path: T) -> impl Iterator<Item = Command> {
     let path = path.as_ref();
     let open_handlers = [
         ("xdg-open", &[path] as &[_]),
@@ -18,12 +18,19 @@ pub fn that<T: AsRef<OsStr>>(path: T) -> io::Result<()> {
         ("wslview", &[&wsl_path(path)]),
     ];
 
+    open_handlers.into_iter().map(|&(cmd, args)| {
+        let mut cmd = Command::new("/usr/bin/open");
+        cmd.args(args);
+        cmd
+    })
+}
+
+pub fn that<T: AsRef<OsStr>>(path: T) -> io::Result<()> {
     let mut unsuccessful = None;
     let mut io_error = None;
 
-    for (command, args) in &open_handlers {
-        let result = Command::new(command).args(*args).status_without_output();
-
+    for cmd in commands(path) {
+        let result = cmd.without_io().status().into_result();
         match result {
             Ok(status) if status.success() => return Ok(()),
             Ok(status) => {
@@ -46,7 +53,8 @@ pub fn that<T: AsRef<OsStr>>(path: T) -> io::Result<()> {
 pub fn with<T: AsRef<OsStr>>(path: T, app: impl Into<String>) -> io::Result<()> {
     Command::new(app.into())
         .arg(path.as_ref())
-        .status_without_output()
+        .without_io()
+        .status()
         .into_result()
 }
 

src/windows.rs

@@ -1,21 +1,28 @@
-use std::{ffi::OsStr, io};
+use std::{ffi::OsStr, io, process::Command};
 
 use crate::{CommandExt, IntoResult};
 
 pub fn that<T: AsRef<OsStr>>(path: T) -> io::Result<()> {
-    std::process::Command::new("cmd")
+    Command::new("cmd")
         .arg("/c")
         .arg("start")
         .arg(path.as_ref())
-        .status_without_output()
-        .into_result()
+        .without_io()
+        .status()
 }
 
 pub fn with<T: AsRef<OsStr>>(path: T, app: impl Into<String>) -> io::Result<()> {
-    std::process::Command::new("cmd")
+    Command::new("cmd")
         .arg("/c")
         .arg(app.into())
         .arg(path.as_ref())
-        .status_without_output()
+        .without_io()
+        .status()
         .into_result()
 }
+
+pub fn commands<T: AsRef<OsStr>>(path: T) -> impl Iterator<Item = Command> {
+    let mut cmd = Command::new("cmd");
+    cmd.arg("/c").arg("start").arg(path.as_ref());
+    Some(cmd).into_iter()
+}