Once it’s launched you don’t have to bother anymore starting/stopping timers or inventing some arbitrary amount of time to fill your fancy time tracker.

How does it work

TimeTap keeps an eye on (tracks) the modification time of the frontmost file and tells you how much time you spent on each project.

If you stop coding for a while while squeezing your brains TimeTap understands. TimeTap will consider “coding time” pauses to up to 30 minutes between to saves in the same project.

Technically it saves a timestamp+path of the frontmost file in TextMate every 30 seconds, then it digests all this information in a nice Sinatra webapp.

The server will respond on http://0.0.0.0:1111/.

Instructions

Run ruby tap.rb or run rake launcher && launchctl load ~/Library/LaunchAgents to add a plist for OSX’s launchd and have it launched automatically at login.

Setting up config file

timetap uses a config file to control where projects are kept, etc. Put this config file in ~/.tap_config.

cp config.yaml ~/.tap_config

Keys Explained

root - where the timetap logs should be saved. Recommended value: ~
code - where all you project live, in a flat hierachy.
nested_project_layers - see below, on nested projects. Default is 1

Nested Projects allows you to keep your projects inside a hierarchy, instead of the original assumption of timetap (which is that all projects are flat).

For example, you could keep your directory structure might look like:

~/Code/
  Clients/
    AcmeCorp/
      website/
        intranet
    BetaCorp/
      skunkworks/
  OpenSource/
    project_one/
    timetap/

A nested_project_layers setting of 2 (in your .tap_config file) would mean we track “AcmeCorp”, “BetaCorp”, and everything under OpenSource, as their own projects

Assumptions

• You code on TextMate.
• You save often (like me), at least every 30 minutes.
• You keep your code organized (I use ~/Code as main code folder).

TODO

• support other text editors, or at least make it easy to do so
• (r)spec it!
• make it more configurable
• gemify (with jeweler)
• flatten encoding quick-fixes with proper solutions (eat and spit only utf8)
• integration with external (online) time tracking tools
• export to csv (?)

cvs_username = gets

to get it working you have to ask input from STDIN:

cvs_username = STDIN.gets

def ask message
print message
STDIN.gets.chomp
end
# ...
cvs_username = ask('Please insert your CVS username')

My Dock with Sticker Icons!

task :mytask do
  # ...
end

namespace :myscope do
  task :mytask => :mytask
end

This will end up with loop dependency error, so how we can call a top level task with the same name of one from our current scope?

The solution is not documented, i found it directly in the rake’s library code.

task :mytask do
  # ...
end

namespace :myscope do
  task :mytask => "rake:mytask"
end

If so, you’ll know you can’t use it to build script without using an absolute path in the shebang line in your custom scripts:

> ./script/runner -h
Usage: ./script/runner [options] ('Some.ruby(code)' or a filename)
You can also use runner as a shebang line for your scripts like this:
#!/usr/bin/env /path/to/your/app/script/runner
...

 So here’s the solution! (here the script is saved in the script dir)

#!/usr/bin/env ruby
unless $0 =~ /runner/
  exec("#{File.dirname(__FILE__)}/runner #{__FILE__}")
  # "exec" exits the current processing, so this comment won't reached (thanks to Arthaey Angosii)
end
# Your great script goes here!

 Alternative:

#!/usr/bin/env ruby
$: << File.dirname(__FILE__)
ARGV[0] = __FILE__
load 'runner'
#your code here

sudo gem install mysql  --include-dependencies -- --with-mysql-config=/usr/bin/mysql_config

UPDATE on other systems the following should work:

sudo gem install mysql  --include-dependencies -- --with-mysql-config=`which mysql_config`

http://www.hugeurl.com/?NDQwNGRlNDRjM2I2ZTMyND
AwMzg3Y2U1MTI1OTI5ODYmMTMmVm0wd2QyUXlVWG
xWV0d4WFlUSm9WMVl3Wkc5V1ZsbDNXa2M1YWxKc1dq
QlVWbHBQVjBaYWMySkVUbGhoTVVwVVZtcEdZV015U2t
WVWJHaG9UV3N3ZUZacVFtRlRNazE1VTJ0V1ZXSkhhRzl
VVm1oRFZWWmFkR1ZHV214U2JHdzFWa2QwYzJGc1Nu
UmhSemxWVmpOT00xcFZXbUZrUjA1R1pFWlNUbFpVV
mtwV2JURXdZVEZrU0ZOclpHcFRSVXBZVkZWYWQxT
kdVbFZTYlVacVZtdGFNRlZ0ZUZOVWJVWTJVbFJHV
jFaRmIzZFdha1poVjBaT2NtSkdTbWxTTW1oWlYxZDR
iMkl3TUhoWGJHUllZbFZhY2xWc1VrZFhiR3QzV2tSU
1ZrMXJjRWxhU0hCSFZqSkZlVlZZWkZwV1JWcHlWV
EJhVDJOc2NFaGpSbEpUVmxoQ1dsWnJXbGRoTVZW
NVZXNU9hbEp0VWxsWmJGWmhZMVpzY2xkdFJteF
diVko1VmpJMWExWXdNVVZTYTFwV1lrWktSRlpxUV
hoa1ZsWjFWMnhhYUdFeGNGbFhhMVpoVkRKT2RGTn
JaRlJpVjNoWVZXcE9iMWRHV25STlNHUnNVakJzTkZVe
WRHdGhWazVHVjJ4U1dtSkhhRlJXTVZwWFkxWktjbVJHV
WxkaVJtOTNWMnhXYjJFeFdYZE5WVlpUWVRGd1dGbHJaR
zlqYkZweFUydGFiRlpzV2xwWGExcHJZVWRGZUdOR2JGaGh
NVnBvVmtSS1QyUkdUbkphUmxKcFZqTm9WVlpHWTNoaU1XU
npWMWhvWVZKR1NuQlVWbHBYVFRGU1ZtRkhPVmROVjFKSl
dWVmFjMWR0UlhsaFJWSmFaV3RhV0ZwRlZYaFdNVkowWlVkc1UySllZM2
hXYTFwaFZURlZlRmR1U2s1V1ZscFVXVlJHZDFZeGJISlhhM1JUVW14d2VGV
ldhRzloTVZwelYycENXbFpXY0ROWmEyUkdaV3hHY21KR1pGZE5NRXBKVm10
U1MxVXhXWGhhU0ZaVllr
WktjRlpxU205bGJHUllaVWM
1YVUxcmJEUldNalZUVkd4a1NGVnN
XbFZXYkhCWVZHdGFhMk5zV25Sa1JtUnBWbGhDTmxaVVNURlVNVnAw
VW01S1QxWnNTbUZVVmxwM1pXeHJlV1ZJWkZOTlZrcDVWR3hhVDJGV1
NuUlBWRTVYWVRGd2FGbHFTa1psVmtweVdr
Wm9hV0Y2Vm5oV1ZFSnZVVEZzVjFWc1dsaGliVkp5V1d0YW
QyVkdWblJrUkVKV1RXdHdTVlpYY0VOWGJGcFhZMFJPV21FeVVrZGF
WV1JQVTBVNVYyRkhhRTVXYmtKMlZteG9kMUl5UlhoYVJXUldZbXR3YUZWd
E1XOWpSbHB4VkcwNVYxWnNjRWhYVkU1dllWVXhXRlZzYUZkTlYya
DJWMVphUzFKc1RuUlBWbFpYVFRGS05sWkhkR0ZXYlZaWVZX
dG9hMUp0VWs5V2FrWkxVMnhrVjFadFJsWk5
WbXcxVld4b2MxWnNXa1pUYkdoWFlXczFkbGxWV
21GalZrcHpXa1pvVjJKclNrbFdWbVEwV1ZaWmVGTnJXbE5XUlZVNQ==