dmarc 0.1.8

DMARC (RFC7489) implementation
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

use crate::policy;

#[derive(PartialEq)]
enum Value {
    None,
    Neutral,
    Pass,
    Fail,
}

/// Result of applying a DMARC policy
pub struct DMARCResult {
    value: Value,
    policy: Option<policy::Policy>,
}

impl DMARCResult {
    /// Get the result as string (neutral, fail or pass)
    pub fn to_str(&self) -> &'static str {
        match self.value {
            Value::None => "none",
            Value::Neutral => "neutral",
            Value::Pass => "pass",
            Value::Fail => "fail",
        }
    }

    /// Constructs a neutral result
    pub fn neutral(policy: policy::Policy) -> Self {
        Self {
            value: Value::Neutral,
            policy: Some(policy),
        }
    }

    /// Constructs a pass result
    pub fn pass(policy: policy::Policy) -> Self {
        Self {
            value: Value::Pass,
            policy: Some(policy),
        }
    }

    /// Constructs a fail result
    pub fn fail(policy: policy::Policy) -> Self {
        Self {
            value: Value::Fail,
            policy: Some(policy),
        }
    }

    /// Constructs a none result
    pub fn none() -> Self {
        Self {
            value: Value::None,
            policy: None,
        }
    }

    /// Checks if the email is supposed to be reject based on the DMARC policy and
    /// its result
    pub fn should_reject(&self) -> bool {
        if let Some(policy) = &self.policy {
            self.value == Value::Fail && policy.action == policy::ReceiverAction::Reject
        } else {
            false
        }
    }
}