todoscope 0.1.0

A simple CLI todo list manager
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
133
134
135
136
137
138
139
140
141
142
143
144
145
146

use crate::{priority::Priority, recurrence::Recurrence, sortby::SortBy, status::Status};
use clap::{Parser, Subcommand, ValueEnum};

#[derive(Parser)]
#[command(
    name = "todo",
    about = "A simple todo program with CLI or menu mode",
    long_about = "Manage your tasks via a command-line interface or interactive menu"
)]

pub struct Cli {
    #[arg(long, help = "Run in interactive menu mode")]
    pub menu: bool,

    #[command(subcommand)]
    pub command: Option<Commands>,
}

#[derive(Subcommand)]
pub enum Commands {
    Add {
        #[arg(short = 't', long, help = "Short title for your task")]
        title: String,
        #[arg(short = 'd', long, help = "Optional longer description")]
        description: Option<String>,

        #[arg(
            short = 'p',
            long,
            default_value = "medium",
            value_enum,
            help = "Set task priority"
        )]
        priority: Priority,
        #[arg(
            short = 's',
            long,
            default_value = "pending",
            value_enum,
            help = "Set initial status of the task"
        )]
        status: Status,
        #[arg(short = 'D', long, help = "Optional due date (format: YYY-MM-DD)")]
        due_date: Option<String>,
        #[arg(short = 'r', long, value_enum, help = "Optional recurrence")]
        recurrence: Option<Recurrence>,
        #[arg(
            short = 'g',
            long,
            value_delimiter = ',',
            help = "Tags for the task (comma-separated)"
        )]
        tags: Option<Vec<String>>,
        #[arg(short = 'P', long, help = "Parent task UUID (for the subtasks)")]
        parent_id: Option<String>,
        #[arg(
            short = 'u',
            long,
            value_delimiter = ',',
            help = "Subtasks for this task (comma-separated)"
        )]
        subtasks: Option<Vec<String>>,
    },
    List {
        #[arg(
            short = 's',
            long,
            default_value = "created",
            value_enum,
            help = "Choose how to sort tasks"
        )]
        sort_by: SortBy,
    },
    Search {
        #[arg(short = 'i', long, help = "Find task by its unique ID")]
        id: Option<String>,
        #[arg(
            short = 't',
            long,
            help = "Find tasks by title (partial match allowed)"
        )]
        title: Option<String>,
        #[arg(short = 'p', long, value_enum, help = "Find tasks by priority")]
        priority: Option<Priority>,
        #[arg(short = 's', long, value_enum, help = "Find tasks by status")]
        status: Option<Status>,
        #[arg(short = 'D', long, help = "Find tasks by due date (format: YYY-MM-DD)")]
        due_date: Option<String>,
        #[arg(short = 'r', long, help = "Find tasks by recurrence")]
        recurrence: Option<Recurrence>,
        #[arg(short = 'g', long, value_delimiter = ',', help = "FInd tasks by tags")]
        tags: Option<Vec<String>>,
        #[arg(short = 'P', long, help = "Find tasks by parent task UUID")]
        parent_task_id: Option<String>,
    },

    Update {
        #[arg(short = 'i', long, help = "UUID of the task you want to modify")]
        id: String,
        #[arg(short = 't', long, help = "Update the task title")]
        title: Option<String>,
        #[arg(short = 'd', long, help = "Update the task description")]
        description: Option<String>,
        #[arg(short = 'p', long, value_enum, help = "Update the task priority")]
        priority: Option<Priority>,
        #[arg(short = 's', long, value_enum, help = "Update the task status")]
        status: Option<Status>,
        #[arg(short = 'D', long, help = "Find tasks by due date (format: YYY-MM-DD")]
        due_date: Option<String>,
        #[arg(short = 'r', long, value_enum, help = "Update the recurrence")]
        recurrence: Option<Recurrence>,
        #[arg(short = 'g', long, value_delimiter = ',', help = "Update tags")]
        tags: Option<Vec<String>>,
        #[arg(short = 'P', long, help = "Update parent task UUID")]
        parent_task_id: Option<String>,
        #[arg(
            short = 'u',
            long,
            value_delimiter = ',',
            help = "Update subtasks for this task (comma-separated)"
        )]
        subtasks: Option<Vec<String>>,
    },
    Delete {
        #[arg(short = 'i', long, help = "UUID of the task to remove")]
        id: String,
    },
    Completions {
        #[arg(
            short = 's',
            long,
            value_enum,
            help = "Choose the shell to generate completions for"
        )]
        shell: Shell,
    },
    Notify,
}

#[derive(Copy, Clone, PartialEq, Eq, PartialOrd, Ord, ValueEnum)]
pub enum Shell {
    Bash,
    Zsh,
    Fish,
    Powershell,
}