francois-tt 0.0.1

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2007 François Beausoleil
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README

@@ -0,0 +1,24 @@
+TT - Time Tracker
+================
+
+Track your time locally, offline.
+
+Usage
+=====
+
+$ pi # punch in, stores current working directory, date, time (UTC)
+$ po # punch out: stops current task
+$ cd my-project
+$ pi
+$ # code furiously
+$ cd ../my-other-project
+$ pi talking about stuff # stops first instance, records new CWD, and comment
+$ po did this and that # stops tracking time, appends comment to time entry
+$ tt list # lists your time entries in a nice format
+$ tt drop # drops your last time entry
+$ tt clear # DESTROYS all time entries, no turning back, nor is there any confirmation
+
+Data
+====
+
+The time tracker database is stored as ~/.tt/entries.csv

data/Rakefile

@@ -0,0 +1,24 @@
+require 'rubygems'
+require 'rake/gempackagetask'
+load File.dirname(__FILE__) + "/clitt.gemspec"
+
+Rake::GemPackageTask.new($spec) do |pkg|
+  pkg.gem_spec = $spec
+end
+
+task :install => [:package] do
+  sh %{sudo gem install --no-rdoc --no-ri pkg/#{GEM}-#{VERSION}}
+end
+
+begin
+  require "spec/rake/spectask"
+rescue LoadError
+  raise "rspec ~> 1.1.3 required to spec this gem, but it is not available."
+end
+
+Spec::Rake::SpecTask.new do |t|
+  t.spec_opts = ["--format", "progress", "--color"]
+  t.warning = false
+end
+
+task :default => :spec

data/TODO

@@ -0,0 +1 @@
+TODO:

data/lib/tt.rb

@@ -0,0 +1,118 @@
+require "fastercsv"
+require "pathname"
+require "time"
+
+module Tt
+  FORMAT = "%Y-%m-%dT%H:%MZ"
+  SCREEN_FORMAT = "%Y-%m-%d %H:%M"
+
+  def self.tt_dir
+    Pathname.new(ENV["HOME"]) + ".tt"
+  end
+
+  def self.tt_path
+    tt_dir + "entries.csv"
+  end
+
+  def self.punch_in(cwd, comment=nil)
+    tt_dir.mkdir unless tt_dir.directory?
+    FasterCSV.open(tt_path, "ab") do |io|
+      io << ["in", cwd, Time.now.utc.strftime(FORMAT), comment]
+    end
+  end
+  
+  def self.punch_out(cwd, comment=nil)
+    tt_dir.mkdir unless tt_dir.directory?
+    FasterCSV.open(tt_path, "ab") do |io|
+      io << ["out", cwd, Time.now.utc.strftime(FORMAT), comment]
+    end
+  end
+
+  def self.report_line(dir, intime, outtime, comment)
+    ltime = Time.now
+    intime = intime + ltime.utc_offset if intime
+    outtime = outtime + ltime.utc_offset if outtime
+
+    if outtime then
+      duration_in_seconds = outtime - intime
+      duration_in_minutes = duration_in_seconds / 60
+      duration_as_human_string = "%02d:%02d" % [duration_in_minutes / 60, duration_in_minutes % 60]
+
+      print "%-40s %16s %16s %5s" % [dir, intime.strftime(SCREEN_FORMAT), outtime.strftime(SCREEN_FORMAT), duration_as_human_string]
+      print " - %s" % comment if comment && !comment.empty?
+      puts
+    else
+      print "%-40s %16s %16s %5s" % [dir, intime.strftime(SCREEN_FORMAT), "", ""]
+      print " - %s" % comment if comment && !comment.empty?
+      puts
+    end
+  end
+
+  def self.report
+    tt_dir.mkdir unless tt_dir.directory?
+    line, state, dir, intime, outtime, comment = 0, :out, nil, nil, nil, nil
+
+    FasterCSV.foreach(tt_path) do |row|
+      line += 1
+
+      case row[0]
+      when "in"
+        case state
+        when :out # punch in
+          dir = row[1]
+          intime = Time.parse(row[2])
+          outtime = nil
+          comment = row[3]
+          state = :in
+        when :in # switch task
+          outtime = Time.parse(row[2])
+          report_line(dir, intime, outtime, [comment, row[3]].compact.join("; "))
+
+          dir = row[1]
+          intime = Time.parse(row[2])
+          outtime = nil
+          comment = nil
+        else
+          raise ArgumentError, "Unknown processing state: #{state}, expected one of in/out"
+        end
+      when "out"
+        case state
+        when :in # punch out
+          outtime = Time.parse(row[2])
+          report_line(dir, intime, outtime, [comment, row[3]].compact.join("; "))
+
+          dir, intime, outtime, comment = nil
+          state = :out
+        when :out
+          $stderr.puts "WARNING: out when already out on line #{line}"
+        else
+          raise ArgumentError, "Unknown processing state: #{state}, expected one of in/out"
+        end
+      else
+        raise SyntaxError, "Error on line \##{line} of #{tt_path}: unknown reference in column 0: #{row[0]}"
+      end
+    end if tt_path.file?
+
+    case state
+    when :in
+      report_line(dir, intime, nil, comment)
+    end
+  end
+
+  def self.drop
+    FasterCSV.open(tt_path.to_s + ".new", "wb") do |io|
+      lastrow = nil
+      FasterCSV.foreach(tt_path, "rb") do |row|
+        io << lastrow if lastrow
+        lastrow = row
+      end
+    end
+
+    tt_path.unlink
+    File.rename(tt_path.to_s + ".new", tt_path)
+  end
+
+  def self.clear
+    tt_path.unlink
+  end
+end

metadata

@@ -0,0 +1,67 @@
+--- !ruby/object:Gem::Specification 
+name: francois-tt
+version: !ruby/object:Gem::Version 
+  version: 0.0.1
+platform: ruby
+authors: 
+- "Fran\xC3\xA7ois Beausoleil"
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-05-14 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: fastercsv
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 1.2.3
+    version: 
+description: Track your time locally, offline, using this simple tool.
+email: francois@teksol.info
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README
+- LICENSE
+- TODO
+files: 
+- LICENSE
+- README
+- Rakefile
+- TODO
+- lib/tt.rb
+has_rdoc: true
+homepage: http://github.com/francois/tt
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.0.1
+signing_key: 
+specification_version: 2
+summary: Track your time locally, offline, using this simple tool.
+test_files: []
+