clitt 0.1.0

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/TODO

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

data/bin/clitt

@@ -0,0 +1,24 @@
+#!/usr/bin/env ruby
+require "rubygems"
+$: << File.dirname(__FILE__) + "/../lib"
+require "tt"
+
+case command = ARGV.shift
+when "list", "ls"
+  Tt.report
+when "clear"
+  Tt.clear
+when "drop"
+  Tt.drop
+else
+  puts <<EOF
+WARNING: No command given
+
+tt - Time Tracker
+
+  list: lists the time entries
+  clear: deletes all time entries
+  drop: drops the last time entry from the file
+EOF
+  exit 1
+end

data/bin/pi

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+require "rubygems"
+$: << File.dirname(__FILE__) + "/../lib"
+require "tt"
+
+Tt.punch_in(Dir.pwd, ARGV.empty? ? nil : ARGV.join(" "))

data/bin/po

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+require "rubygems"
+$: << File.dirname(__FILE__) + "/../lib"
+require "tt"
+
+Tt.punch_out(Dir.pwd, ARGV.empty? ? nil : ARGV.join(" "))

data/lib/tt.rb

@@ -0,0 +1,132 @@
+require "pathname"
+require "time"
+
+module Tt
+  FORMAT = "%Y-%m-%dT%H:%MZ"
+  SCREEN_FORMAT = "%Y-%m-%d %H:%M"
+
+  def self.csv_engine
+    if RUBY_VERSION =~ /^1\.8/ then
+      require "fastercsv"
+      FasterCSV
+    else
+      require "csv"
+      CSV
+    end
+  end
+
+  def self.root
+    @root ||= ENV["CLITT_ROOT"].to_s.empty? ? ENV["HOME"] : ENV["CLITT_ROOT"]
+  end
+
+  def self.tt_dir
+    Pathname.new(root) + ".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?
+    csv_engine.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?
+    csv_engine.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, stream=STDOUT)
+    ltime = Time.now
+    intime = intime + ltime.utc_offset
+    endtime = (outtime.nil? ? Time.now.utc : outtime) + ltime.utc_offset
+    outtime = outtime + ltime.utc_offset if outtime
+
+    duration_in_seconds = endtime - intime
+    duration_in_minutes = duration_in_seconds / 60
+    duration_as_human_string = "%02d:%02d" % [duration_in_minutes / 60, duration_in_minutes % 60]
+
+    stream.print "%-40s %16s %16s %5s" % [dir, intime.strftime(SCREEN_FORMAT), outtime ? outtime.strftime(SCREEN_FORMAT) : "", duration_as_human_string]
+    stream.print " - %s" % comment if comment && !comment.empty?
+    stream.puts
+  end
+
+  def self.each_line
+    tt_dir.mkdir unless tt_dir.directory?
+    line, state, dir, intime, outtime, comment = 0, :out, nil, nil, nil, nil
+
+    csv_engine.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])
+          yield(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])
+          yield(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
+      yield(dir, intime, nil, comment)
+    end
+  end
+
+  def self.report(stream=STDOUT)
+    each_line do |dir, intime, outtime, comment|
+      report_line(dir, intime, outtime, comment, stream)
+    end
+  end
+
+  def self.drop
+    csv_engine.open(tt_path.to_s + ".new", "wb") do |io|
+      lastrow = nil
+      csv_engine.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

data/lib/tt/smrty.rb

@@ -0,0 +1,4 @@
+module Tt
+  class Smrty
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,2 @@
+$TESTING=true
+$:.push File.join(File.dirname(__FILE__), '..', 'lib')

metadata

@@ -0,0 +1,105 @@
+--- !ruby/object:Gem::Specification 
+name: clitt
+version: !ruby/object:Gem::Version 
+  version: 0.1.0
+platform: ruby
+authors: 
+- Francois Beausoleil
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-11-30 00:00:00 -05:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: fastercsv
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: "1"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: active_support
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: timecop
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+description: Track your time locally, offline, using this simple tool.
+email: francois@teksol.info
+executables: 
+- clitt
+- pi
+- po
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README
+- TODO
+files: 
+- bin/clitt
+- bin/pi
+- bin/po
+- lib/tt.rb
+- lib/tt/smrty.rb
+- LICENSE
+- README
+- TODO
+has_rdoc: false
+homepage: http://francois.github.com/tt
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+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.3.5
+signing_key: 
+specification_version: 3
+summary: Track your time locally, offline, using this simple tool.
+test_files: 
+- spec/spec_helper.rb