devela/work/process/
ext.rs

1// devela::work::process::ext
2//
3//! Defines the [`ExtProcess`] trait.
4//
5
6use crate::Process;
7use std::process::{abort, exit, id};
8
9/// Marker trait to prevent downstream implementations of the [`ExtThread`] trait.
10trait Sealed {}
11impl Sealed for Process {}
12
13#[doc = crate::TAG_NAMESPACE!()]
14/// Extension trait providing additional methods for [`Process`]es.
15///
16/// It offers the standalone functions in `std::process` as associated methods.
17#[rustfmt::skip]
18#[cfg_attr(feature = "nightly_doc", doc(notable_trait))]
19#[expect(private_bounds, reason = "Sealed")]
20pub trait ExtProcess: Sealed {
21    /// Terminates the current process in an abnormal fashion.
22    ///
23    /// See `std::process::`[abort].
24    #[rustfmt::skip]
25    fn abort() -> ! { abort() }
26
27    /// Terminates the current process with the specified exit code.
28    ///
29    /// See `std::process::`[exit].
30    #[rustfmt::skip]
31    fn exit(code: i32) -> ! { exit(code) }
32
33
34    /// Returns the OS-assigned process identifier associated with this process.
35    ///
36    /// See `std::process::`[id].
37    #[must_use] #[rustfmt::skip]
38    fn id() -> u32 { id() }
39}
40impl ExtProcess for Process {}