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
|
Timetasker CLI
==============
Provides a nice command line interface to submit time sheets using [Time
Task](https://timetask.com). This command will submit a single time entry.
The project improves upon a [Chrome
extension](https://github.com/teddywing/chrome-timetasker) 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"
## 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 the entire
`[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. Open 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!
## 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
## License
Copyright © 2017 Teddy Wing. Licensed under the GNU GPLv3+ (see the included
COPYING file).
[3]: https://github.com/teddywing/timetasker/releases
|
