irskep / ct

Time tracking tool

ct - Cut Time

ct is a time tracking tool requiring Python 2.7 and python-dateutil. If you are on a Mac, it can update your Adium status with what you are working on.

Workflow

Install with python setup.py install.

When you begin working, type ct clockin [project_name]. When you are done, type ct clockout. To change projects, type ct clockin [new_project]. To sum up all the hours spent on your projects, type ct summary.

You can instruct ct to use a working directory other than ~/.ct by setting $CT_HOME.

Commands

Usage: ct [command]

clockin [project_name]: Begin tracking hours on a project
clockout: Stop tracking hours
summary [project_name]: Count and display hours spent on one or all projects

The clockin and clockout commands both take a --time argument to specify a time other than now. If you have Adium, you can also specify --away to have your status set to Away instead of Available in addition to having your status message updated.

ct's Issues

'ct summary --format=CSV'

There should be a --format option which, when fed CSV, will spit out date, hours rows for use on my Yelp time sheet.

'ct toggle' command

It would check for the most recent project and clock in or out depending on what is appropriate.

So that you can do this:

> ct clockin proj1
(clock into proj1)
> ct toggle
(clock out of proj1)
> ct toggle
(clock into proj1)
> ct clockin proj2
(clock out of proj1 and into proj2)
> ct toggle
(clock out of proj2)
> ct toggle (clock into proj2)
....

'ct summary' should support --days, --months, --all

To make it possible to see how much was done, when.

Bug with time-dependent formatting?

When I perform a:
ct summary --from november1
Everything works as expected

When I perform:
ct summary --from november

I get the following output:

Morgan McClure
Intwine
Traceback (most recent call last):
File "/Users/mcclurem/local/src/ct/bin/ct", line 11, in
main()
File "/opt/local/Library/Frameworks/Python.framework/Versions/2.7/lib/python2.7/site-packages/cuttime/init.py", line 43, in main
args.func(args)
File "/opt/local/Library/Frameworks/Python.framework/Versions/2.7/lib/python2.7/site-packages/cuttime/commands.py", line 212, in execute
format_func(file_path, from_time, to_time, projects)
File "/opt/local/Library/Frameworks/Python.framework/Versions/2.7/lib/python2.7/site-packages/cuttime/commands.py", line 268, in print_file_pretty
self.print_days(months.values()[0], 2)
IndexError: list index out of range

Subprojects

ct summary should do this:

yelp/mrjob: 10 hours
yelp/tron: 2 hours
yelp: 3 hours
all yelp: 15 hours