simple-task-timer 0.3.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.

## Installation


1. Go to [releases page](https://github.com/zambrinf/simple-task-timer/releases) and find the latest release.
2. Download the zip file corresponding to your operating system.
3. Unzip the file to extract the executable.
4. Place the executable in a folder where it can create a file to store the tasks (make sure you have write permissions for this folder).
5. Add this folder to your PATH.
6. Open a new terminal and run `timer --help`.

You should see the message below:
```
Usage: timer [OPTIONS] [COMMAND]

Commands:
  list     List saved total time of current running tasks added to time elapsed from when it started running
  create   Create a new task
  delete   Delete a task
  delname  Delete a task by name
  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 task type
  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


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': 45:30:00
#[2] 'code-review-pr-x': 00:20:02


Total: 45:50:02
```

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
```

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.
```

## Build from source


```
// Linux
cargo build --release x86_64-unknown-linux-gnu

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