GitWakaTime is a mash up between data obtained through "Wakatime" and the data we all create using git. The principal is to capture a baseline of activity for a task and answer the age old question "How much time did I spend on this?" or "What is the minimum amount I can charge for my time".
This implementation varies form Wakatime's commit feature as it compares time spent on each file, vs comparing the time between commits. It tends to be significantly more accurate for those who do per line commits. Read more about it here
Install the gem:
$ gem install gitwakatime
Run the setup command: you will need your wakatime api key
$ gitwakatime init
This creates a .gitwakatime.yml file on the user's home directory ~/.gitwakatime.yml which will contain your api keys and a ~/.gitqakatime.sqlite database to speed things up a bit.
Process the current directory for the past 7 days
$ gitwakatime tally
Process the current directory from a given point (this will still load all heartbeats data to prevent providing incorrect timing at the start point)
$ gitwakatime tally -s 2014-02-01
Process the another directory
$ gitwakatime tally -f ~/some/other/repo
Hard reset of the local cache database, if you are getting odd numbers
$ gitwakatime reset
There a currently a few limitations with this model
- Merges are free, (no time is attributed a merge). This is true for most merges but conflict resolution will be attributed to git parent commit of that file for that merge.
Total Recorded time 1 day 9 hrs 13 mins 32 secs
Total Committed Time 1 day 8 hrs 43 mins 48 secs
2015-02-04 Total 2 hrs 59 mins 38 secs
b1cd1d09c 2015-02-04 00:59:06 -0500 9 mins 4 secs Adding fix and test for the query class.
d8ca53770 2 mins 51 secs lib/gitwakatime/query.rb
d8ca53770 6 mins 13 secs spec/query_spec.rb
8e0f0890e 2015-02-04 00:46:52 -0500 26 mins 4 secs A new implementation of the split tree file issue, I think i need a more complex git log to really validate the idea.
093f9e4d5 26 mins 4 secs lib/gitwakatime/commited_file.rb
d8ca53770 2015-02-04 00:46:17 -0500 54 mins 13 secs Improving testing for UTC. Fixing various bugs related to single day comparisons.
5471c6c80 6 mins 32 secs lib/gitwakatime/query.rb
08c7f7005 5 mins 40 secs lib/gitwakatime/timer.rb
5f3ec243e 27 mins 41 secs spec/commited_file_spec.rb
95e218d72 4 mins 41 secs spec/mapper_spec.rb
4949d899a 4 mins 47 secs spec/query_spec.rb
4949d899a 1 min 49 secs spec/spec_helper.rb
ea23d7dd7 3 mins 3 secs spec/timer_spec.rb
30415f0a3 2015-02-04 11:54:18 -0500 1 hr 30 mins 17 secs Cache Heartbeats locally, in sqlite.
093f9e4d5 4 mins 19 secs lib/gitwakatime.rb
25 secs lib/gitwakatime/heartbeat.rb
caf409884 7 mins 45 secs lib/gitwakatime/heartbeats.rb
331723757 1 min 39 secs lib/gitwakatime/cli.rb
46 mins 2 secs lib/gitwakatime/durations.rb
b1cd1d09c 23 mins 50 secs lib/gitwakatime/query.rb
d8ca53770 3 mins 15 secs lib/gitwakatime/timer.rb
d8ca53770 1 min 20 secs spec/commited_file_spec.rb
b1cd1d09c 45 secs spec/query_spec.rb
d8ca53770 23 secs spec/spec_helper.rb
d8ca53770 34 secs spec/timer_spec.rb
2015-02-03 Total 7 hrs 6 mins 19 secs
5f3ec243e 2015-02-03 23:20:15 -0500 11 mins 55 secs compare times in utc.
34c8f0b99 11 mins 55 secs spec/commited_file_spec.rb
4949d899a 2015-02-03 23:20:02 -0500 24 mins 5 secs Reduce log output in testing.
b07136e26 18 mins 1 sec lib/gitwakatime/log.rb
39863a249 4 mins 35 secs spec/query_spec.rb
- Fork it ( https://github.com/[my-github-username]/gitwakatime/fork )
- Create your feature branch (
git checkout -b my-new-feature) - Commit your changes (
git commit -am 'Add some feature') - Push to the branch (
git push origin my-new-feature) - Create a new Pull Request