dqcsim 0.0.4

DQCsim: Delft Quantum Classical Simulator
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
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77

use crate::common::{error::Error, log::Loglevel, util::friendly_enum_parse};
use named_type::NamedType;
use named_type_derive::*;
use serde::{Deserialize, Serialize};
use std::process::Stdio;
use strum_macros::{Display, EnumIter, EnumString};

/// All loglevel options plus pass and null, used to specify how a
/// stdout/stderr stream should be captured.
#[derive(Display, EnumIter, EnumString, NamedType, Debug, Copy, Clone, PartialEq)]
enum StreamCaptureOption {
    Pass,
    Null,
    Fatal,
    Error,
    Warn,
    Note,
    Info,
    Debug,
    Trace,
}

/// Stream capture mode.
///
/// Specifies how a plugin stdout/stderr stream should be captured.
#[derive(Debug, Clone, PartialEq, Deserialize, Serialize)]
pub enum StreamCaptureMode {
    /// Don't capture the stream. That is, let it pass through to DQCsim's
    /// stdout/stderr stream unchecked.
    Pass,

    /// Disable the stream by piping it to /dev/null (or by emulating this
    /// behavior).
    Null,

    /// Capture the stream to turn each line into a log message with the
    /// specified level.
    Capture(Loglevel),
}

impl ::std::str::FromStr for StreamCaptureMode {
    type Err = Error;
    fn from_str(s: &str) -> Result<Self, Self::Err> {
        let opt: StreamCaptureOption = friendly_enum_parse(s)?;
        Ok(match opt {
            StreamCaptureOption::Pass => StreamCaptureMode::Pass,
            StreamCaptureOption::Null => StreamCaptureMode::Null,
            StreamCaptureOption::Fatal => StreamCaptureMode::Capture(Loglevel::Fatal),
            StreamCaptureOption::Error => StreamCaptureMode::Capture(Loglevel::Error),
            StreamCaptureOption::Warn => StreamCaptureMode::Capture(Loglevel::Warn),
            StreamCaptureOption::Note => StreamCaptureMode::Capture(Loglevel::Note),
            StreamCaptureOption::Info => StreamCaptureMode::Capture(Loglevel::Info),
            StreamCaptureOption::Debug => StreamCaptureMode::Capture(Loglevel::Debug),
            StreamCaptureOption::Trace => StreamCaptureMode::Capture(Loglevel::Trace),
        })
    }
}

impl Into<Stdio> for StreamCaptureMode {
    fn into(self) -> Stdio {
        match self {
            StreamCaptureMode::Null => Stdio::null(),
            StreamCaptureMode::Pass => Stdio::inherit(),
            StreamCaptureMode::Capture(_) => Stdio::piped(),
        }
    }
}

impl Into<Stdio> for &StreamCaptureMode {
    fn into(self) -> Stdio {
        match *self {
            StreamCaptureMode::Null => Stdio::null(),
            StreamCaptureMode::Pass => Stdio::inherit(),
            StreamCaptureMode::Capture(_) => Stdio::piped(),
        }
    }
}