Git-hours is a command that calculates working time using the git log data.
Download & Run
You can download Git-hours from links down below.
Put the downloaded file into the bin folder, which is set in the $PATH environment variable. Then it will be recognized as a subcommand of git. Because if a command starts with ‘git-‘, git automatically recognizes it as a subcommand of git.
Install using Golang
$ go get -u github.com/lazypic/git-hours
How to use
- Open the terminal
- Move to your git repository
- Type as shown below
$ git hours From "2019-03-01 00:00:00 +0900" to "2019-03-31 23:59:59 +0900" : 13h20m9s
- The value of timezone offset is automatically set depending on your region.
- By default, the start date is set as the first day of last month and the end date is set as the last day of last month.
$ git hours -help -author string author name -before string before date (default "2020-03-31 23:59:59 +0900") -debug debug mode -duration string git log duration (default "1h") -help print help -since string since(after) date (default "2020-03-01 00:00:00 +0900")
You can set the start date and the end date with this options. If you don’t enter any value, the start date and the end date will be set as the first and last date of last month by default.
$ git hours -since 2019-02-01 -before today
If you want to set timezone value, put timezone value at the end of the command as shown below.
$ git hours -since "2019-03-29 13:55:33 +0800"
If you want to customize every value, enter the date, time, and timezone offset value as shown below.
$ git hours -since "2019-03-01 00:00:00 +0900" -before "2019-03-31 23:59:59 +0900"
If you want to know data of particular user, use the
-author option as shown below.
$ git hours -author name
Also, You can set more than one user as shown below.
$ git hours -author name1,name2
Git-hours calculates working time based on duration. If interval between git commits is less than duration value, Git-hours considers working time was continued. With
-duration option, you can set duration as you want.
By default, duration is set to 1 hour.
If you want to set duration to 30min, type as shown below.
$ git hours -duration 0.5h
-debug option, You can see the details.
You can see information as following:
- interval between git commits
- commit message
$ git hours -debug
2019-03-31 23:28:40 +0900 kim hanwoong edit go fmt 2m26s > 2019-03-31 23:31:06 +0900 kim hanwoong 설명을 추가함. 6m34s > 2019-03-31 23:37:40 +0900 kim hanwoong edit comment 1m46s > 2019-03-31 23:39:26 +0900 hanwoong kim Update README.md 38s > 2019-03-31 23:40:04 +0900 hanwoong kim Update README.md 1m12s > 2019-03-31 23:41:16 +0900 hanwoong kim Update README.md From 2019-02-01 to 2019-03-31 : 13h1m48s
Why did I make it?
I want to work regardless of when and where. So, I needed to calculate my working time.
My first try was toggle-style program. I felt that it is demanding tool. because users have to click button every time the work starts or ends.
And the next try was kimmobrunfeldt's git-hours. Mechanism of kimmobrunfeldt's git-hours looked reasonable to me. However, When I tried to install via https://github.com/kimmobrunfeldt/git-hours it didn't work well on my computer because of the node.js dependency.
So, I revised kimmobrunfeldt's git-hours with Go language. Also, while I was revising it, I added some features that help to create an estimate sheet. Git-hours opens to everyone to download and run. Hope it helps those in need.