process-wrap 10.0.0

Wrap a Command, to spawn processes in a group or session or job etc
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43

use std::io::Result;

use tokio::process::Command;
use windows::Win32::System::Threading::PROCESS_CREATION_FLAGS;

use super::{CommandWrap, CommandWrapper};

#[cfg(feature = "job-object")]
use super::JobObject;
#[cfg(feature = "job-object")]
use crate::windows::job_creation_flags;

/// Shim wrapper which sets Windows process creation flags.
///
/// This wrapper is only available on Windows.
///
/// It exists to be able to set creation flags on a `Command` and also store them in the wrapper, so
/// that they're no overwritten by other wrappers. Notably this is the only way to use creation
/// flags and the `JobObject` wrapper together.
///
/// When both `CreationFlags` and `JobObject` are used, process-wrap preserves these flags while
/// temporarily adding `CREATE_SUSPENDED`; registration order does not matter.
#[derive(Clone, Copy, Debug)]
pub struct CreationFlags(pub PROCESS_CREATION_FLAGS);

impl CommandWrapper for CreationFlags {
	fn pre_spawn(&mut self, command: &mut Command, core: &CommandWrap) -> Result<()> {
		#[cfg(feature = "job-object")]
		let flags = if core.has_wrap::<JobObject>() {
			job_creation_flags(self.0).flags
		} else {
			self.0
		};
		#[cfg(not(feature = "job-object"))]
		let flags = {
			let _ = core;
			self.0
		};

		command.creation_flags(flags.0);
		Ok(())
	}
}