hcl 0.2.3

data/.document

@@ -0,0 +1 @@
+--files CHANGELOG

data/.gitignore

@@ -0,0 +1,5 @@
+*.sw[nop]
+pkg
+tags
+doc
+.yardoc

data/CHANGELOG

@@ -0,0 +1,41 @@
+= Recent Changes in HCl
+
+== v0.2.3 Sun Aug 23 21:39:34 2009 -0700
+
+* Allow decimal time offset without a dot, closes #29.
+* Reverted and re-fixed: Adding note fails when task is started without notes, #26.
+* Reinstate the --version option
+
+== v0.2.2 Sun Aug 9 11:16:34 2009 -0700
+
+* Support installation via rip, closes #27.
+* Fixed: Adding note fails when task is started without notes, closes #26.
+* Avoid stack trace on missing XML root node, closes #25.
+
+== v0.2.1 Thu Jul 30 14:02:23 2009 -0700
+
+* Fixed: Creating timers without starting them.
+
+== v0.2.0 Thu Jul 30 11:40:33 2009 -0700
+
+* Allow an initial time to be specified when starting a timer, closes #9.
+* Always display hours as HH:MM, closes #22.
+* Do not write empty task cache, closes #23.
+
+== v0.1.3 Tue Jul 28 09:19:53 2009 -0700
+
+* Add a note about ruby-dev for debian/ubuntu users, closes #20.
+* Friendlier error message on unrecognized task, closes #18, #21.
+
+== v0.1.2 Mon Jul 27 11:46:50 2009 -0700
+
+* Automatically include rubygems in bin/hcl.
+
+== v0.1.1 Fri Jul 24 19:32:32 2009 -0700
+
+* Mention gem in README, read version from file.
+    
+== v0.1.0 Fri Jul 24 19:09:23 2009 -0700
+
+* Initial public release
+

data/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2009 Zack Hobson <zack@opensourcery.com>, OpenSourcery LLC
+
+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.markdown

@@ -0,0 +1,101 @@
+# HCl
+
+HCl is a command-line tool for interacting with Harvest time sheets using the
+[Harvest time tracking API][htt].
+
+[htt]: http://www.getharvest.com/api/time_tracking
+
+## Quick Start
+
+    $ gem install zenhob-hcl --source=http://gems.github.com
+    $ hcl show [date]
+
+### Prerequisites
+
+ * Ruby (tested with 1.8.7)
+ * Ruby OpenSSL support (in debian/ubuntu: apt-get install libopenssl-ruby)
+ * Ruby extension building support (in debian/ubuntu: apt-get install ruby-dev)
+ * RubyGems
+ * Trollop option-parsing library (gem install trollop)
+ * Chronic date-parsing library (gem install chronic)
+ * HighLine console input library (gem install highline)
+ * Jeweler packaging tool (needed to build the gem)
+
+## Usage
+
+    hcl show [date]
+    hcl tasks
+    hcl set <key> <value ...>
+    hcl unset <key>
+    hcl start (<task_alias> | <project_id> <task_id>) [+time] [msg ...]
+    hcl note <msg ...>
+    hcl stop
+
+### Starting a Timer
+
+To start a new timer you need to identify the project and task. After you've
+used the show command you can use the tasks command to view a cached list of
+available tasks. The first two numbers in each row are the project and task
+IDs. You need both values to start a timer:
+
+    $ hcl show
+    -------------
+    0:00    total
+    $ hcl tasks
+    1234 5678   ClientX Software Development
+    1234 9876   ClientX Admin
+    $ hcl start 1234 5678 adding a new feature
+
+### Task Aliases
+
+Since it's not practical to enter two long numbers every time you want to
+identify a task, HCl supports task aliases:
+
+    $ hcl set task.xdev 1234 5678
+    $ hcl start xdev adding a new feature
+
+### Starting a Timer with Initial Time
+
+You can also provide an initial time when starting a new timer.
+This can be expressed in floating-point or HH:MM. The following two
+commands are identical:
+
+    $ hcl start xdev +0:15 adding a new feature
+    $ hcl start +.25 xdev adding a new feature
+
+### Adding Notes to a Running Task
+
+While a task is running you can append strings to the note for that task:
+
+    $ hcl note Found a good time
+    $ hcl note or not, whatever...
+
+### Stopping a Timer
+
+The following command will stop a running timer (currently only one timer at
+a time is supported):
+
+    $ hcl stop
+
+### Date Formats
+
+Dates can be expressed in a variety of ways. See the [Chronic documentation][cd]
+for more information about available date input formats. The following
+commands show the timesheet for the specified day:
+
+    $ hcl show yesterday
+    $ hcl show last friday
+    $ hcl show 2 days ago
+    $ hcl show 1 week ago
+
+[cd]: http://chronic.rubyforge.org/
+
+## Author
+
+[Zack Hobson][zgh], [OpenSourcery LLC][os]
+
+See LICENSE for copyright details.
+
+[zgh]: mailto:zack@opensourcery.com
+[os]: http://www.opensourcery.com/
+

data/Rakefile

@@ -0,0 +1,24 @@
+require 'rake/testtask'
+
+Rake::TestTask.new do |t|
+  t.libs << 'test'
+  t.test_files = FileList['test/*_test.rb']
+end
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "hcl"
+    gem.summary = "Harvest timesheets from the command-line"
+    gem.description = "HCl is a command-line client for manipulating Harvest time sheets."
+    gem.email = "zack@opensourcery.com"
+    gem.homepage = "http://github.com/zenhob/hcl"
+    gem.authors = ["Zack Hobson"]
+    gem.add_dependency "termios"
+    gem.add_dependency "trollop", ">= 1.10.2"
+    gem.add_dependency "chronic", ">= 0.2.3"
+    gem.add_dependency "highline", ">= 1.5.1"
+  end
+rescue LoadError
+  puts "Jeweler not available. Install it with: sudo gem install technicalpickles-jeweler -s http://gems.github.com"
+end

data/VERSION

@@ -0,0 +1 @@
+0.2.3

data/bin/hcl

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+
+require 'hcl/app'
+
+HCl::App.command *ARGV
+

data/deps.rip

@@ -0,0 +1,3 @@
+git://github.com/lutzky/trollop.git a8d63c816 # 1.10.2
+git://github.com/mojombo/chronic.git 180e44763 # 0.3.0
+git://github.com/JEG2/highline.git rel_1_5_1

data/hcl.gemspec

@@ -0,0 +1,75 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{hcl}
+  s.version = "0.2.3"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Zack Hobson"]
+  s.date = %q{2009-08-23}
+  s.default_executable = %q{hcl}
+  s.description = %q{HCl is a command-line client for manipulating Harvest time sheets.}
+  s.email = %q{zack@opensourcery.com}
+  s.executables = ["hcl"]
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.markdown"
+  ]
+  s.files = [
+    ".document",
+     ".gitignore",
+     "CHANGELOG",
+     "LICENSE",
+     "README.markdown",
+     "Rakefile",
+     "VERSION",
+     "bin/hcl",
+     "deps.rip",
+     "hcl.gemspec",
+     "lib/hcl/app.rb",
+     "lib/hcl/commands.rb",
+     "lib/hcl/day_entry.rb",
+     "lib/hcl/project.rb",
+     "lib/hcl/task.rb",
+     "lib/hcl/timesheet_resource.rb",
+     "lib/hcl/utility.rb",
+     "test/app_test.rb",
+     "test/day_entry_test.rb",
+     "test/test_helper.rb",
+     "test/utility_test.rb"
+  ]
+  s.has_rdoc = true
+  s.homepage = %q{http://github.com/zenhob/hcl}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.1}
+  s.summary = %q{Harvest timesheets from the command-line}
+  s.test_files = [
+    "test/app_test.rb",
+     "test/day_entry_test.rb",
+     "test/test_helper.rb",
+     "test/utility_test.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 2
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<termios>, [">= 0"])
+      s.add_runtime_dependency(%q<trollop>, [">= 1.10.2"])
+      s.add_runtime_dependency(%q<chronic>, [">= 0.2.3"])
+      s.add_runtime_dependency(%q<highline>, [">= 1.5.1"])
+    else
+      s.add_dependency(%q<termios>, [">= 0"])
+      s.add_dependency(%q<trollop>, [">= 1.10.2"])
+      s.add_dependency(%q<chronic>, [">= 0.2.3"])
+      s.add_dependency(%q<highline>, [">= 1.5.1"])
+    end
+  else
+    s.add_dependency(%q<termios>, [">= 0"])
+    s.add_dependency(%q<trollop>, [">= 1.10.2"])
+    s.add_dependency(%q<chronic>, [">= 0.2.3"])
+    s.add_dependency(%q<highline>, [">= 1.5.1"])
+  end
+end

data/lib/hcl/app.rb

@@ -0,0 +1,164 @@
+## stdlib dependencies
+require 'yaml'
+require 'rexml/document'
+require 'net/http'
+require 'net/https'
+
+## gem dependencies
+require 'chronic'
+require 'trollop'
+require 'highline/import'
+
+## app dependencies
+require 'hcl/utility'
+require 'hcl/commands'
+require 'hcl/timesheet_resource'
+require 'hcl/project'
+require 'hcl/task'
+require 'hcl/day_entry'
+
+# Workaround for annoying SSL warning:
+#  >> warning: peer certificate won't be verified in this SSL session
+# http://www.5dollarwhitebox.org/drupal/node/64
+class Net::HTTP
+  alias_method :old_initialize, :initialize
+  def initialize(*args)
+    old_initialize(*args)
+    @ssl_context = OpenSSL::SSL::SSLContext.new
+    @ssl_context.verify_mode = OpenSSL::SSL::VERIFY_NONE
+  end
+end
+
+module HCl
+  VERSION = "0.2.3"
+
+  class App
+    include HCl::Utility
+    include HCl::Commands
+  
+    SETTINGS_FILE = "#{ENV['HOME']}/.hcl_settings"
+    CONFIG_FILE = "#{ENV['HOME']}/.hcl_config"
+  
+    class UnknownCommand < StandardError; end
+  
+    def initialize
+      read_config
+      read_settings
+    end
+
+    # Run the given command and arguments.
+    def self.command *args
+      hcl = new.process_args(*args).run
+    end
+
+    # Return true if the string is a known command, false otherwise.
+    #
+    # @param [#to_s] command name of command
+    # @return [true, false]
+    def command? command
+      Commands.instance_methods.include? command.to_s
+    end
+  
+    # Start the application.
+    def run
+      begin
+        if @command
+          if command? @command
+            result = send @command, *@args
+            if not result.nil?
+              if result.respond_to? :to_a
+                puts result.to_a.join(', ')
+              elsif result.respond_to? :to_s
+                puts result
+              end
+            end
+          else
+            raise UnknownCommand, "unrecognized command `#{@command}'"
+          end
+        else
+          show
+        end
+      rescue TimesheetResource::Failure => e
+        puts "Internal failure. #{e}"
+        exit 1
+      end
+    end
+  
+    def process_args *args
+      Trollop::options(args) do
+        stop_on Commands.instance_methods
+        version "HCl version #{VERSION}"
+        banner <<-EOM
+HCl is a command-line client for manipulating Harvest time sheets.
+
+Commands:
+    hcl show [date]
+    hcl tasks
+    hcl aliases
+    hcl set <key> <value ...>
+    hcl unset <key>
+    hcl start <task> [msg]
+    hcl stop [msg]
+    hcl note <msg>
+
+Examples:
+    $ hcl tasks
+    $ hcl start 1234 4567 this is my log message
+    $ hcl set task.mytask 1234 4567
+    $ hcl start mytask this is my next log message
+    $ hcl show yesterday
+    $ hcl show last tuesday
+
+Options:
+EOM
+      end
+      @command = args.shift
+      @args = args
+      self
+    end
+
+    protected
+  
+    def read_config
+      if File.exists? CONFIG_FILE
+        config = YAML::load File.read(CONFIG_FILE)
+        TimesheetResource.configure config
+      elsif File.exists? old_conf = File.dirname(__FILE__) + "/../hcl_conf.yml"
+        config = YAML::load File.read(old_conf)
+        TimesheetResource.configure config
+        write_config config
+      else
+        config = {}
+        puts "Please specify your Harvest credentials.\n"
+        config['login'] = ask("Email Address: ")
+        config['password'] = ask("Password: ") { |q| q.echo = false }
+        config['subdomain'] = ask("Subdomain: ")
+        TimesheetResource.configure config
+        write_config config
+      end
+    end
+  
+    def write_config config
+      puts "Writing configuration to #{CONFIG_FILE}."
+      File.open(CONFIG_FILE, 'w') do |f|
+       f.write config.to_yaml
+      end
+    end
+  
+    def read_settings
+      if File.exists? SETTINGS_FILE
+        @settings = YAML.load(File.read(SETTINGS_FILE))
+      else
+        @settings = {}
+      end
+    end
+  
+    def write_settings
+      File.open(SETTINGS_FILE, 'w') do |f|
+       f.write @settings.to_yaml
+      end
+      nil
+    end
+  end
+end
+

data/lib/hcl/commands.rb

@@ -0,0 +1,90 @@
+module HCl
+  module Commands
+    def tasks
+      tasks = Task.all
+      if tasks.empty?
+        puts "No cached tasks. Run `hcl show' to populate the cache and try again."
+      else
+        tasks.each { |task| puts "#{task.project.id} #{task.id}\t#{task}" }
+      end
+      nil
+    end
+  
+    def set key = nil, *args
+      if key.nil?
+        @settings.each do |k, v|
+          puts "#{k}: #{v}"
+        end
+      else
+        value = args.join(' ')
+        @settings ||= {}
+        @settings[key] = value
+        write_settings
+      end
+      nil
+    end
+  
+    def unset key
+      @settings.delete key
+      write_settings
+    end
+  
+    def aliases
+      @settings.keys.select { |s| s =~ /^task\./ }.map { |s| s.slice(5..-1) }
+    end
+  
+    def start *args
+      starting_time = args.detect {|x| x =~ /^\+\d*(\.|:)?\d+$/ }
+      if starting_time
+        args.delete(starting_time)
+        starting_time = time2float starting_time
+      end
+      ident = args.shift
+      task_ids = if @settings.key? "task.#{ident}"
+          @settings["task.#{ident}"].split(/\s+/)
+        else
+          [ident, args.shift]
+        end
+      task = Task.find *task_ids
+      if task.nil?
+        puts "Unknown project/task alias, try one of the following: #{aliases.join(', ')}."
+        exit 1
+      end
+      timer = task.start(:starting_time => starting_time, :note => args.join(' '))
+      puts "Started timer for #{timer}."
+    end
+  
+    def stop
+      entry = DayEntry.with_timer
+      if entry
+        entry.toggle
+        puts "Stopped #{entry}."
+      else
+        puts "No running timers found."
+      end
+    end
+  
+    def note *args
+      message = args.join ' '
+      entry = DayEntry.with_timer
+      if entry
+        entry.append_note message
+        puts "Added note '#{message}' to #{entry}."
+      else
+        puts "No running timers found."
+      end
+    end
+  
+    def show *args
+      date = args.empty? ? nil : Chronic.parse(args.join(' '))
+      total_hours = 0.0
+      DayEntry.all(date).each do |day|
+        running = day.running? ? '(running) ' : ''
+        puts "\t#{day.formatted_hours}\t#{running}#{day.project} #{day.notes}"[0..78]
+        total_hours = total_hours + day.hours.to_f
+      end
+      puts "\t" + '-' * 13
+      puts "\t#{as_hours total_hours}\ttotal"
+    end
+  end
+end

data/lib/hcl/day_entry.rb

@@ -0,0 +1,66 @@
+
+module HCl 
+  class DayEntry < TimesheetResource
+    include Utility
+
+    # Get the time sheet entries for a given day. If no date is provided
+    # defaults to today.
+    def self.all date = nil
+      url = date.nil? ? 'daily' : "daily/#{date.strftime '%j/%Y'}"
+      from_xml get(url)
+    end
+
+    def to_s
+      "#{client} #{project} #{task} (#{formatted_hours})"
+    end
+
+    def self.from_xml xml
+      doc = REXML::Document.new xml
+      raise Failure, "No root node in XML document: #{xml}" if doc.root.nil?
+      Task.cache_tasks doc
+      doc.root.elements.collect('//day_entry') do |day|
+        new xml_to_hash(day)
+      end
+    end
+
+    def notes
+      super || @data[:notes] = ''
+    end
+
+    # Append a string to the notes for this task.
+    def append_note new_notes
+      # If I don't include hours it gets reset.
+      # This doens't appear to be the case for task and project.
+      DayEntry.post("daily/update/#{id}", <<-EOD)
+      <request>
+        <notes>#{notes << " #{new_notes}"}</notes>
+        <hours>#{hours}</hours>
+      </request>
+      EOD
+    end
+
+    def self.with_timer
+      all.detect {|t| t.running? }
+    end
+
+    def running?
+      !@data[:timer_started_at].nil? && !@data[:timer_started_at].empty?
+    end
+
+    def initialize *args
+      super
+      # TODO cache client/project names and ids
+    end
+
+    def toggle
+      DayEntry.get("daily/timer/#{id}")
+      self
+    end
+
+    # Returns the hours formatted as "HH:MM"
+    def formatted_hours
+      as_hours hours
+    end
+
+  end
+end

data/lib/hcl/project.rb

@@ -0,0 +1,3 @@
+class HCl::Project < HCl::TimesheetResource
+end
+

data/lib/hcl/task.rb

@@ -0,0 +1,58 @@
+module HCl
+  class Task < TimesheetResource
+    def self.cache_tasks doc
+      tasks = []
+      doc.root.elements.collect('projects/project') do |project_elem|
+        project = Project.new xml_to_hash(project_elem)
+        tasks.concat(project_elem.elements.collect('tasks/task') do |task|
+          new xml_to_hash(task).merge(:project => project)
+        end)
+      end
+      unless tasks.empty?
+        File.open(File.join(ENV['HOME'],'.hcl_tasks'), 'w') do |f|
+          f.write tasks.uniq.to_yaml
+        end
+      end
+    end
+
+    def self.all
+      YAML.load File.read(File.join(ENV['HOME'],'.hcl_tasks'))
+    end
+
+    def self.find project_id, id
+      all.detect do |t|
+        t.project.id.to_i == project_id.to_i && t.id.to_i == id.to_i
+      end
+    end
+
+    def to_s
+      "#{project.name} #{name}"
+    end
+
+    def add opts
+      notes = opts[:note]
+      starting_time = opts[:starting_time] || 0
+      days = DayEntry.from_xml Task.post("daily/add", <<-EOT)
+      <request>
+        <notes>#{notes}</notes>
+        <hours>#{starting_time}</hours>
+        <project_id type="integer">#{project.id}</project_id>
+        <task_id type="integer">#{id}</task_id>
+        <spent_at type="date">#{Date.today}</spent_at>
+      </request>
+      EOT
+      days.first
+    end
+
+    def start opts
+      day = add opts
+      if day.running?
+        day
+      else
+        DayEntry.from_xml(Task.get("daily/timer/#{day.id}")).first
+      end
+    end
+
+  end
+end
+

data/lib/hcl/timesheet_resource.rb

@@ -0,0 +1,74 @@
+module HCl
+  class TimesheetResource
+    class Failure < Exception; end
+
+    def self.configure opts = nil
+      if opts
+        self.login = opts['login']
+        self.password = opts['password']
+        self.subdomain = opts['subdomain']
+      else
+        yield self
+      end
+    end
+  
+    # configuration accessors
+    %w[ login password subdomain ].each do |config_var|
+      class_eval <<-EOC
+        def self.#{config_var}= arg
+          @@#{config_var} = arg
+        end
+        def self.#{config_var}
+          @@#{config_var}
+        end
+      EOC
+    end
+  
+    def initialize params
+      @data = params
+    end
+  
+    def self.get action
+      https_do Net::HTTP::Get, action
+    end
+
+    def self.post action, data
+      https_do Net::HTTP::Post, action, data
+    end
+
+    def self.https_do method_class, action, data = nil
+      https   = Net::HTTP.new "#{subdomain}.harvestapp.com", 443
+      request = method_class.new "/#{action}"
+      https.use_ssl = true
+      request.basic_auth login, password
+      request.content_type = 'application/xml'
+      request['Accept']    = 'application/xml'
+      response = https.request request, data
+      return response.body
+      if response.kind_of? Net::HTTPSuccess
+        response.body
+      else
+        raise 'failure'
+      end
+    end
+
+    def id
+      @data[:id]
+    end
+
+    def method_missing method, *args
+      if @data.key? method.to_sym
+        @data[method]
+      else
+        super
+      end
+    end
+
+    def self.xml_to_hash elem
+      elem.elements.map { |e| e.name }.inject({}) do |a, f|
+        a[f.to_sym] = elem.elements[f].text if elem.elements[f]
+        a
+      end
+    end
+  end
+end

data/lib/hcl/utility.rb

@@ -0,0 +1,25 @@
+module HCl
+  module Utility
+    # Convert from decimal to a string of the form HH:MM.
+    #
+    # @param [#to_f] hours number of hours in decimal
+    # @return [String] of the form "HH:MM"
+    def as_hours hours
+      minutes = hours.to_f * 60.0
+      sprintf "%d:%02d", (minutes / 60).to_i, (minutes % 60).to_i
+    end
+
+    # Convert from a time span in hour or decimal format to a float.
+    #
+    # @param [String] time_string either "M:MM" or decimal
+    # @return [#to_f] converted to a floating-point number
+    def time2float time_string
+      if time_string =~ /:/
+        hours, minutes = time_string.split(':')
+        hours.to_f + (minutes.to_f / 60.0)
+      else
+        time_string.to_f
+      end
+    end
+  end
+end

data/test/app_test.rb

@@ -0,0 +1,8 @@
+require 'test_helper'
+class AppTest < Test::Unit::TestCase
+
+  should "permit commands from the HCl::Commands module" do
+    app = HCl::App.new
+    assert HCl::Commands.instance_methods.all? { |c| app.command? c  }
+  end
+end

data/test/day_entry_test.rb

@@ -0,0 +1,49 @@
+require 'test_helper'
+
+class DayEntryTest < Test::Unit::TestCase
+  should "read DayEntry xml" do
+    entries = HCl::DayEntry.from_xml(<<-EOD)
+<daily>
+  <for_day type="date">Wed, 18 Oct 2006</for_day>
+  <day_entries>
+    <day_entry>
+      <id type="integer">195168</id>
+      <client>Iridesco</client>
+      <project>Harvest</project>
+      <task>Backend Programming</task>
+      <hours type="float">2.06</hours>
+      <notes>Test api support</notes>
+      <timer_started_at type="datetime">
+        Wed, 18 Oct 2006 09:53:06 -0000
+      </timer_started_at>
+      <created_at type="datetime">Wed, 18 Oct 2006 09:53:06 -0000</created_at>
+    </day_entry>
+  </day_entries>
+</daily>
+    EOD
+    assert_equal 1, entries.size
+    {
+      :project => 'Harvest',
+      :client => 'Iridesco',
+      :task => 'Backend Programming',
+      :notes => 'Test api support',
+      :hours => '2.06',
+    }.each do |method, value|
+      assert_equal value, entries.first.send(method)
+    end
+  end
+
+  should "append to an existing note" do
+    entry = HCl::DayEntry.new(:id => '1', :notes => 'yourmom.', :hours => '1.0')
+    HCl::DayEntry.stubs(:post)
+    entry.append_note('hi world')
+    assert_equal 'yourmom. hi world', entry.notes
+  end
+
+  should "append to an undefined note" do
+    entry = HCl::DayEntry.new(:id => '1', :notes => nil, :hours => '1.0')
+    HCl::DayEntry.stubs(:post)
+    entry.append_note('hi world')
+    assert_equal ' hi world', entry.notes
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,6 @@
+$:.unshift(File.dirname(__FILE__) + '/../lib')
+
+require 'test/unit'
+require 'hcl/app'
+require 'shoulda'
+require 'mocha'

data/test/utility_test.rb

@@ -0,0 +1,17 @@
+require 'test_helper'
+
+class UtilityTest < Test::Unit::TestCase
+  include HCl::Utility
+
+  should "convert decimal input when converting time2float" do
+    assert_equal 2.5, time2float("2.5")
+  end
+
+  should "convert HH:MM input when converting time2float" do
+    assert_equal 2.5, time2float("2:30")
+  end
+
+  should "assume decimal input when converting time2float" do
+    assert_equal 2.0, time2float("2")
+  end
+end

metadata

@@ -0,0 +1,118 @@
+--- !ruby/object:Gem::Specification 
+name: hcl
+version: !ruby/object:Gem::Version 
+  version: 0.2.3
+platform: ruby
+authors: 
+- Zack Hobson
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-08-23 00:00:00 -07:00
+default_executable: hcl
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: termios
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: trollop
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.10.2
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: chronic
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.2.3
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: highline
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.5.1
+    version: 
+description: HCl is a command-line client for manipulating Harvest time sheets.
+email: zack@opensourcery.com
+executables: 
+- hcl
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.markdown
+files: 
+- .document
+- .gitignore
+- CHANGELOG
+- LICENSE
+- README.markdown
+- Rakefile
+- VERSION
+- bin/hcl
+- deps.rip
+- hcl.gemspec
+- lib/hcl/app.rb
+- lib/hcl/commands.rb
+- lib/hcl/day_entry.rb
+- lib/hcl/project.rb
+- lib/hcl/task.rb
+- lib/hcl/timesheet_resource.rb
+- lib/hcl/utility.rb
+- test/app_test.rb
+- test/day_entry_test.rb
+- test/test_helper.rb
+- test/utility_test.rb
+has_rdoc: true
+homepage: http://github.com/zenhob/hcl
+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: 2
+summary: Harvest timesheets from the command-line
+test_files: 
+- test/app_test.rb
+- test/day_entry_test.rb
+- test/test_helper.rb
+- test/utility_test.rb