timed 0.4

command-line time tracking

timed
a command-line time tracker.

INTRODUCTION.

1. Timed stays out of your way.
2. Timed is as simple as possible.

INSTALLATION.

Method 1.

$ git clone git://github.com/adeel/timed.git
$ cd timed
# python setup.py install

Method 2.

# pip install timed

USAGE.

$ timed start myproject
starting work on myproject
at 16:35 on 07 Feb 2011

$ timed
working on myproject:
from 16:35 on 07 Feb 2011
to now, 17:00 on 07 Feb 2011
=> 0h25m have elapsed

$ timed stop
worked on myproject
from 16:35 on 07 Feb 2011
to now, 17:40 on 07 Feb 2011
=> 1h5m elapsed

$ timed summary
myproject 1h5m

$ cat ~/.timed
myproject: 16:35 on 07 Feb 2011 - 17:40 on 07 Feb 2011

Remember that ~/.timed is just a text file so the standard UNIX text
processing tools (grep et al.) are available. For example, to see a summary
of your work during the month of January 2011:

$ cat ~/.timed | grep "Jan 2011" | timed parse

COMMANDS.

timed: alias for 'timed status'

timed status:
print current status

timed start <project>:
start tracking for <project>

timed stop:
stop tracking for the active project

timed summary:
show a summary of all projects

timed parse:
parses a stream with text formatted as a Timed logfile and shows a
summary

timed help:
print help

BONUS. Enable tab completion for project names by putting this in your
.bashrc:

shopt -s progcomp
timed_complete() {
local partial
COMPREPLY=()
partial=${COMP_WORDS[COMP_CWORD]}
COMPREPLY=($(compgen -W '$( timed projects )' -- $partial))
return 0
}
complete -F timed_complete -o dirnames timed

CHANGELOG.

0.40: Added tab completion for project names.
0.35: Added `timed parse`.
0.30: Complete refactoring.
0.20: Updated formatting (colors!).
0.13: Stopped using ez_setup for installation.
0.12: YAML turned out to be pretty slow, so it's been dropped.
0.11: Using YAML to store the log.
0.10: First release.

AUTHOR. Adeel Ahmad Khan <[e-mail]>.