tasg 0.1.2

Manage your tasks with tasg!
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

//! Command-line interface (CLI)
use clap::{Parser, Subcommand};

/// Command-line interface for the Tasg application.
///
/// The `Cli` struct defines the main entry point for the CLI, using the `clap` crate to parse
/// command-line arguments. It includes the primary command and its associated subcommands.
///
/// The CLI supports various operations such as adding tasks, listing tasks, completing tasks,
/// deleting tasks, and editing tasks.
#[derive(Parser, Debug)]
#[command(name = "tasg", about, version, author)]
pub struct Cli {
    /// The command to execute, specified as a subcommand.
    ///
    /// This field holds the parsed subcommand, which can be one of the variants in the `Commands` enum.
    #[command(subcommand)]
    pub command: Commands,
}

/// Enum representing the available commands in the Tasg CLI.
///
/// The `Commands` enum defines the subcommands supported by the Tasg application. Each variant
/// corresponds to a specific action that the user can perform, such as adding, listing,
/// completing, deleting, or editing tasks.
///
/// # Variants
///
/// - `Add` - Adds a new task with the specified description.
/// - `List` - Lists tasks, with an option to show all tasks, including completed ones.
/// - `Complete` - Marks a task as complete by its ID.
/// - `Delete` - Deletes a task by its ID.
/// - `Edit` - Edits the description of an existing task by its ID.
#[derive(Subcommand, Debug)]
pub enum Commands {
    /// Add a new task to the task list.
    ///
    /// This subcommand adds a new task with the provided description.
    ///
    /// # Arguments
    ///
    /// - `description` - A string representing the description of the new task.
    ///
    Add {
        /// The description of the task to add.
        ///
        /// This argument specifies the text description for the new task.
        #[arg()]
        description: String,
    },

    /// List tasks from the task list.
    ///
    /// This subcommand lists tasks with an option to show all tasks, including those that are completed.
    ///
    /// # Arguments
    ///
    /// - `all` - A flag indicating whether to show all tasks. If set, completed tasks will also be listed.
    ///
    List {
        /// Show all tasks, including completed ones.
        #[arg(short, long)]
        all: bool,
    },

    /// Mark a task as complete.
    ///
    /// This subcommand updates the status of the specified task to complete based on its ID.
    ///
    /// # Arguments
    ///
    /// - `id` - The ID of the task to mark as complete. Must be a positive integer.
    Complete {
        /// The ID of the task to complete.
        ///
        /// This argument specifies the ID of the task that should be marked as completed.
        #[arg(value_parser = clap::value_parser!(u32).range(1..))]
        id: u32,
    },

    /// Delete a task from the task list.
    ///
    /// This subcommand removes the task with the specified ID from the task list.
    ///
    /// # Arguments
    ///
    /// - `id` - The ID of the task to delete. Must be a positive integer.
    Delete {
        /// The ID of the task to delete.
        ///
        /// This argument specifies the ID of the task that should be removed from the list.
        #[arg(value_parser = clap::value_parser!(u32).range(1..))]
        id: u32,
    },

    /// Edit an existing task's description.
    ///
    /// This subcommand allows you to modify the description or mark the task as completed.
    ///
    /// # Arguments
    ///
    /// - `id` - The ID of the task to edit. Must be a positive integer.
    /// - `description` - The new description of the task.
    Edit {
        /// The ID of the task to edit.
        ///
        /// This argument specifies the ID of the task that should be edited.
        #[arg(value_parser = clap::value_parser!(u32).range(1..))]
        id: u32,

        /// The new description of the task.
        ///
        /// This argument allows the user to provide a new text description for the task.
        /// If not provided, the description will remain unchanged.
        #[arg(short, long)]
        description: Option<String>,
    },

    /// Nuke all of the tasks.
    ///
    /// This subcommand will delete all your tasks - use with caution!
    Nuke,
}