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
|
Timetasker CLI
==============
Provides a nice command line interface to submit time sheets using [Time
Task][1]. This command will submit a single time entry.
The project vastly improves upon a [Chrome extension][2] that auto-fills the
time sheet form on the website.
## Usage
This will submit a time entry for the "example" project on the current day with
a duration of 7 hours and an empty description:
$ timetasker --project example
Here we set a custom time of 4.5 hours:
$ timetasker --project example --time 4.5
Now we specify a date and add a description:
$ timetasker --project example \
> --date 2017-05-31 \
> --description "Worked on Timetasker"
And because it's a shell command, we can combine it with other commands. Let's
create a week's worth of time entries starting on Monday May 29th, 2017:
$ for d in $(ruby -e "require 'date'
> d = Date.new(2017, 5, 29)
> (0..4).each { |i| puts (d + i).strftime('%Y-%m-%d') }");
> do timetasker --project example --date $d;
> done
## Configuration
Timetasker relies on a configuration file in order to work properly.
If this is your first time running Timetasker, use this command to generate a
skeleton config:
$ timetasker --write-config
This will generate a `$HOME/.config/timetasker/config.toml` file that looks like
this:
[auth]
username = ""
password_cmd = ""
[profile]
person_id = # ADD PERSON ID
[projects.example]
client = # ADD CLIENT ID
project = # ADD PROJECT ID
module = # ADD MODULE ID
task = 0
work_type = # ADD WORK TYPE ID
billable = true
Fill in the `username` with your TimeTask username. The `password_cmd` should be
a shell command that will output your TimeTask password to STDOUT.
Notice the `[projects.example]` line? That's a project alias. If we, for
instance, changed it to `[projects.my-cool-project]`, we could post a time entry
to that project like this:
$ timetasker --project my-cool-project
You say you have more than one project? No problem, just copy-paste an
additional `[projects.example]` section and give it a new name.
To fill in the other configuration options, we're going to have to take a trip
to the TimeTask website (relax, we won't be using it much after this).
1. Visit `https://*.timetask.com/time/add/`
2. Fill in a single entry, but don't submit it yet
3. Open the Network console in your browser's developer tools
4. Submit your time entry
5. View the POST request to `https://*.timetask.com/index.php`
6. Take a look at the form data of the request
You should see something like this:
module:time
action:submitmultipletime
f_entryIndexes:0
f_personID0:111111
f_clientID0:22222
f_projectID0:333333
f_moduleID0:444444
f_taskID0:0
f_worktypeID0:555555
f_date0:04/06/17
f_time0:7
f_billable0:t
f_description0:
Copy the numbers into their corresponding fields in your `config.toml` file.
Once you have a complete config file, you should be all set to start posting
time entries!
Eventually, you'll have to update the `module` value in your configuration file
to align with the current sprint. Instead of visiting the website to get the new
ID of the `module`, the modules of a project can be listed from the program:
$ timetasker --project example --list-modules
This produces the following output:
ID Module
77777 Sprint 1
222222 Sprint 2
The correct sprint ID can then be easily copied from this list into
`config.toml`.
## Install
Visit the [releases][3] page, download the version corresponding to your
platform, and put the resulting `timetasker` binary on your PATH.
To install from source, use:
$ go install github.com/teddywing/timetasker
Bash completion is available for project aliases. To take advantage of it,
source the completion file in your Bash profile:
$ source ~/path/to/timetasker.bash-completion
## License
Copyright © 2017 Teddy Wing. Licensed under the GNU GPLv3+ (see the included
COPYING file).
[1]: https://timetask.com
[2]: https://github.com/teddywing/chrome-timetasker
[3]: https://github.com/teddywing/timetasker/releases
|
