simple-task-timer 0.2.0

A simple timer for keeping track of your tasks without leaving the terminal
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

# Simple Task Timer

A simple timer for keeping track of your tasks without leaving the terminal.

```
$ timer list -a
[1] 'working-on-my-app': 45:30:00
#[2] 'code-review-pr-x': 00:20:02

Total: 45:50:02
```

```
Usage: timer [OPTIONS] [COMMAND]

Commands:
  list     List running tasks
  create   Create a new task
  delete   Delete a task
  start    Start running a task timer
  stop     Stop running a task timer
  rename   Rename a task
  add      Add time to a task
  sub      Subtract time from a task
  set      Set the total duration time for a task
  archive  Move a task to archive file
  clear    Clear all tasks of the selected tasktype
  help     Print this message or the help of the given subcommand(s)

Options:
  -t, --tasktype <VALUE>  Type of tasks you want to work on (current, archive) [default: current]
  -h, --help              Print help
  -V, --version           Print version
```

## Examples

Create a task and start running its timer

```
$ timer create -s working-on-my-app
Task working-on-my-app created with id 1
```

Start a task timer

```
$ timer start 1
Task 1 started
```

Stop a task timer

```
$ timer stop 1
Task 1 stopped
```

Add time to a task

```
$ timer add 1 5m
Added 5m to task with id 1, new timer: 23:35:02
```

List running tasks:

```
$ timer list
#[1] 'working-on-my-app': 23:35:02

Total: 23:35:02
```

List all tasks using `-a` option, currently running tasks are marked with `#`
and they are updated to add the time from when it started running

```
$ timer list -a
#[1] 'working-on-my-app': 23:35:39
[2] 'code-review-pr-x': 00:20:00

Total: 23:55:39
```

Set a new time for a task

```
$ timer set 1 45h30m
New time 45h30m set for task 1


$ timer list -a
[1] 'working-on-my-app': 45:30:00
[2] 'code-review-pr-x': 00:20:00

Total: 45:50:00
```

Archive task moves it to archived file which can be accesed using `-t archive`
option

```
$ timer archive 2
Task 2 archived with archive id 1


$ timer list -a
[1] 'working-on-my-app': 45:30:00

Total: 45:30:00


$ timer -t archive list -a
[1] 'code-review-pr-x': 00:20:00

Total: 00:20:00
```

Delete all tasks from archive.

```
$ timer -t archive clear
Do you want to proceed clearing all archive tasks? (Y/N)
y
Tasks cleared.


$ timer -t archive list -a
There are no tasks.
```

## Installation

Run the build command and copy the executable to wherever you want to store the
files. Don't forget to add to path.

```
// Linux
cargo build --release

// Windows
cargo build --release --target x86_64-pc-windows-gnu
```