ratado 0.2.0

A fast, keyboard-driven terminal task manager built with Rust and Ratatui
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
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132

//! Project model for organizing tasks.
//!
//! Projects provide a way to group related tasks together. Each project
//! has a name, color, and icon for visual identification in the UI.

use chrono::{DateTime, Utc};
use serde::{Deserialize, Serialize};
use uuid::Uuid;

/// A project for organizing tasks.
///
/// Projects allow users to group related tasks together. Each project
/// has a customizable color and icon that are displayed in the UI.
///
/// # Examples
///
/// ```
/// use ratado::models::Project;
///
/// // Create a basic project
/// let project = Project::new("Work");
/// assert_eq!(project.name, "Work");
///
/// // Create a styled project
/// let project = Project::with_style("Personal", "#e74c3c", "🏠");
/// assert_eq!(project.color, "#e74c3c");
/// ```
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct Project {
    /// Unique identifier (UUID v7 string - time-ordered)
    pub id: String,
    /// Project name displayed in the UI
    pub name: String,
    /// Hex color code for the project (e.g., "#3498db")
    pub color: String,
    /// Emoji or icon representing the project
    pub icon: String,
    /// When the project was created (UTC)
    pub created_at: DateTime<Utc>,
}

impl Project {
    /// Creates a new project with the given name.
    ///
    /// Uses default styling (blue color, folder icon).
    ///
    /// # Arguments
    ///
    /// * `name` - The name for the project
    ///
    /// # Returns
    ///
    /// A new `Project` with default color (#3498db) and icon (📁)
    ///
    /// # Examples
    ///
    /// ```
    /// use ratado::models::Project;
    ///
    /// let project = Project::new("Work");
    /// assert_eq!(project.name, "Work");
    /// assert_eq!(project.color, "#3498db");
    /// ```
    pub fn new(name: &str) -> Self {
        Self {
            id: Uuid::now_v7().to_string(),
            name: name.to_string(),
            color: "#3498db".to_string(),
            icon: "📁".to_string(),
            created_at: Utc::now(),
        }
    }

    /// Creates a new project with custom color and icon.
    ///
    /// # Arguments
    ///
    /// * `name` - The name for the project
    /// * `color` - Hex color code (e.g., "#e74c3c")
    /// * `icon` - Emoji or icon character
    ///
    /// # Returns
    ///
    /// A new `Project` with the specified styling
    ///
    /// # Examples
    ///
    /// ```
    /// use ratado::models::Project;
    ///
    /// let project = Project::with_style("Personal", "#e74c3c", "🏠");
    /// assert_eq!(project.name, "Personal");
    /// assert_eq!(project.color, "#e74c3c");
    /// assert_eq!(project.icon, "🏠");
    /// ```
    pub fn with_style(name: &str, color: &str, icon: &str) -> Self {
        Self {
            id: Uuid::now_v7().to_string(),
            name: name.to_string(),
            color: color.to_string(),
            icon: icon.to_string(),
            created_at: Utc::now(),
        }
    }
}

impl Default for Project {
    fn default() -> Self {
        Self::new("Inbox")
    }
}

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

    #[test]
    fn test_project_new() {
        let project = Project::new("Work");
        assert_eq!(project.name, "Work");
        assert_eq!(project.color, "#3498db");
        assert!(!project.id.is_empty());
    }

    #[test]
    fn test_project_with_style() {
        let project = Project::with_style("Personal", "#e74c3c", "🏠");
        assert_eq!(project.name, "Personal");
        assert_eq!(project.color, "#e74c3c");
        assert_eq!(project.icon, "🏠");
    }
}