asanaclient 0.1.1

Rust SDK for the Asana API
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
109
110
111
112
113
114
115
116
117

//! Project types for the Asana API.

use serde::{Deserialize, Serialize};

use super::common::{Gid, ResourceRef, StatusColor, UserRef};
use super::custom_field::CustomFieldSetting;
use super::status_update::StatusUpdateRef;

/// An Asana project.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct Project {
    /// The unique identifier for the project.
    pub gid: Gid,
    /// The name of the project.
    pub name: String,
    /// The project's color (for display).
    pub color: Option<String>,
    /// Whether the project is archived.
    #[serde(default)]
    pub archived: bool,
    /// Whether the project is public to the organization.
    #[serde(default)]
    pub public: bool,
    /// The project owner.
    pub owner: Option<UserRef>,
    /// The team the project belongs to.
    pub team: Option<ResourceRef>,
    /// The workspace the project belongs to.
    pub workspace: Option<ResourceRef>,
    /// The current status update.
    pub current_status_update: Option<StatusUpdateRef>,
    /// The current status (deprecated, use current_status_update).
    pub current_status: Option<StatusUpdateRef>,
    /// Notes/description for the project.
    pub notes: Option<String>,
    /// HTML notes for the project.
    pub html_notes: Option<String>,
    /// When the project was created.
    pub created_at: Option<String>,
    /// When the project was last modified.
    pub modified_at: Option<String>,
    /// The due date of the project.
    pub due_date: Option<String>,
    /// The due date/time of the project.
    pub due_on: Option<String>,
    /// The start date of the project.
    pub start_on: Option<String>,
    /// The default view for the project (list, board, calendar, timeline).
    pub default_view: Option<String>,
    /// Whether the project is a template.
    #[serde(default)]
    pub is_template: bool,
    /// Permalink URL for the project.
    pub permalink_url: Option<String>,
    /// Icon for the project.
    pub icon: Option<String>,
    /// Custom field settings for this project.
    #[serde(default)]
    pub custom_field_settings: Vec<CustomFieldSetting>,
}

impl Project {
    /// Get the effective status color from either current_status_update or current_status.
    pub fn status_color(&self) -> StatusColor {
        self.current_status_update
            .as_ref()
            .or(self.current_status.as_ref())
            .and_then(|s| s.status_type)
            .unwrap_or_default()
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_deserialize_project() {
        let json = r#"{
            "gid": "123",
            "name": "My Project",
            "archived": false,
            "public": true,
            "notes": "Project description"
        }"#;
        let project: Project = serde_json::from_str(json).unwrap();
        assert_eq!(project.gid, "123");
        assert_eq!(project.name, "My Project");
        assert!(!project.archived);
        assert!(project.public);
    }

    #[test]
    fn test_project_status_color() {
        let json = r#"{
            "gid": "123",
            "name": "My Project",
            "current_status_update": {
                "gid": "456",
                "title": "On Track",
                "status_type": "green"
            }
        }"#;
        let project: Project = serde_json::from_str(json).unwrap();
        assert_eq!(project.status_color(), StatusColor::Green);
    }

    #[test]
    fn test_project_status_color_default() {
        let json = r#"{
            "gid": "123",
            "name": "My Project"
        }"#;
        let project: Project = serde_json::from_str(json).unwrap();
        assert_eq!(project.status_color(), StatusColor::None);
    }
}