tasktree 0.1.3

Distributed task-tree values: W3C trace-compatible task identities under an application-supplied URN scheme, validated lifecycle transitions, lineage, and progress
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
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108

use std::fmt::{
    Display,
    Formatter,
};
use std::str::FromStr;

use serde::{
    Deserialize,
    Serialize,
};

use super::{
    TaskId,
    TaskIdentityError,
    TaskNodeId,
    TaskTreeId,
};
use crate::scheme::UrnScheme;

macro_rules! impl_string_traits {
    ($type:ty, $parse:path) => {
        impl Display for $type {
            fn fmt(&self, formatter: &mut Formatter<'_>) -> std::fmt::Result {
                formatter.write_str(self.as_str())
            }
        }

        impl FromStr for $type {
            type Err = TaskIdentityError;

            fn from_str(raw: &str) -> Result<Self, Self::Err> {
                $parse(raw)
            }
        }

        impl AsRef<str> for $type {
            fn as_ref(&self) -> &str {
                self.as_str()
            }
        }

        impl Serialize for $type {
            fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
            where
                S: serde::Serializer,
            {
                serializer.serialize_str(self.as_str())
            }
        }

        impl<'de> Deserialize<'de> for $type {
            fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>
            where
                D: serde::Deserializer<'de>,
            {
                let raw = String::deserialize(deserializer)?;
                $parse(&raw).map_err(serde::de::Error::custom)
            }
        }
    };
}

macro_rules! impl_scheme_string_traits {
    ($type:ident, $parse:path) => {
        impl<S: UrnScheme> Display for $type<S> {
            fn fmt(&self, formatter: &mut Formatter<'_>) -> std::fmt::Result {
                formatter.write_str(self.as_str())
            }
        }

        impl<S: UrnScheme> FromStr for $type<S> {
            type Err = TaskIdentityError;

            fn from_str(raw: &str) -> Result<Self, Self::Err> {
                $parse(raw)
            }
        }

        impl<S: UrnScheme> AsRef<str> for $type<S> {
            fn as_ref(&self) -> &str {
                self.as_str()
            }
        }

        impl<S: UrnScheme> Serialize for $type<S> {
            fn serialize<Ser>(&self, serializer: Ser) -> Result<Ser::Ok, Ser::Error>
            where
                Ser: serde::Serializer,
            {
                serializer.serialize_str(self.as_str())
            }
        }

        impl<'de, S: UrnScheme> Deserialize<'de> for $type<S> {
            fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>
            where
                D: serde::Deserializer<'de>,
            {
                let raw = String::deserialize(deserializer)?;
                $parse(&raw).map_err(serde::de::Error::custom)
            }
        }
    };
}

impl_scheme_string_traits!(TaskId, TaskId::parse);
impl_scheme_string_traits!(TaskTreeId, TaskTreeId::new);
impl_string_traits!(TaskNodeId, TaskNodeId::new);