gouqi 0.20.0

Rust interface for Jira
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

//! Interfaces for accessing and managing transition

// Ours
use crate::{Error, Jira, Result, TransitionOption, TransitionOptions, TransitionTriggerOptions};

/// Issue transition interface
#[derive(Debug)]
pub struct Transitions {
    jira: Jira,
    key: String,
}

impl Transitions {
    pub fn new<K>(jira: &Jira, key: K) -> Transitions
    where
        K: Into<String>,
    {
        Transitions {
            jira: jira.clone(),
            key: key.into(),
        }
    }

    /// Return list of transitions options for this issue
    pub fn list(&self) -> Result<Vec<TransitionOption>> {
        self.jira
            .get::<TransitionOptions>(
                "api",
                &format!("/issue/{}/transitions?expand=transitions.fields", self.key),
            )
            .map(|wrapper| wrapper.transitions)
    }

    /// Trigger a issue transition to transition with a resolution
    /// use TransitionTrigger::builder(id).resolution(name)
    pub fn trigger(&self, trans: TransitionTriggerOptions) -> Result<()> {
        self.jira
            .post::<(), TransitionTriggerOptions>(
                "api",
                &format!("/issue/{}/transitions", self.key),
                trans,
            )
            .or_else(|e| match e {
                Error::Serde(_) => Ok(()),
                e => Err(e),
            })
    }
}

#[cfg(feature = "async")]
use crate::r#async::Jira as AsyncJira;

#[cfg(feature = "async")]
#[derive(Debug)]
pub struct AsyncTransitions {
    jira: AsyncJira,
    key: String,
}

#[cfg(feature = "async")]
impl AsyncTransitions {
    pub fn new<K>(jira: &AsyncJira, key: K) -> AsyncTransitions
    where
        K: Into<String>,
    {
        AsyncTransitions {
            jira: jira.clone(),
            key: key.into(),
        }
    }

    /// Return list of transitions options for this issue
    pub async fn list(&self) -> Result<Vec<TransitionOption>> {
        self.jira
            .get::<TransitionOptions>(
                "api",
                &format!("/issue/{}/transitions?expand=transitions.fields", self.key),
            )
            .await
            .map(|wrapper| wrapper.transitions)
    }

    /// Trigger a issue transition to transition with a resolution
    /// use TransitionTrigger::builder(id).resolution(name)
    pub async fn trigger(&self, trans: TransitionTriggerOptions) -> Result<()> {
        self.jira
            .post::<(), TransitionTriggerOptions>(
                "api",
                &format!("/issue/{}/transitions", self.key),
                trans,
            )
            .await
            .or_else(|e| match e {
                Error::Serde(_) => Ok(()),
                e => Err(e),
            })
    }
}