rbinvoice 0.2.0

data/Gemfile

@@ -0,0 +1,18 @@
+source "http://rubygems.org"
+# Add dependencies required to use your gem here.
+# Example:
+#   gem "activesupport", ">= 2.3.5"
+
+gem 'trollop'
+gem 'roo'
+gem 'prawn'
+gem 'liquid'
+
+# Add dependencies to develop your gem here.
+# Include everything needed to run rake, tests, features, etc.
+group :development do
+  gem "rspec"
+  gem "bundler"
+  gem "jeweler"
+  gem "simplecov", ">= 0"
+end

data/Gemfile.lock

@@ -0,0 +1,87 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    Ascii85 (1.0.1)
+    choice (0.1.6)
+    diff-lcs (1.1.3)
+    faraday (0.8.1)
+      multipart-post (~> 1.1)
+    git (1.2.5)
+    google-spreadsheet-ruby (0.3.0)
+      google_drive (>= 0.3.0)
+    google_drive (0.3.1)
+      nokogiri (>= 1.4.4, != 1.5.2, != 1.5.1)
+      oauth (>= 0.3.6)
+      oauth2 (>= 0.5.0)
+    httpauth (0.1)
+    jeweler (1.8.4)
+      bundler (~> 1.0)
+      git (>= 1.2.5)
+      rake
+      rdoc
+    json (1.7.4)
+    jwt (0.1.5)
+      multi_json (>= 1.0)
+    liquid (2.3.0)
+    log4r (1.1.10)
+    multi_json (1.3.6)
+    multipart-post (1.1.5)
+    nokogiri (1.5.5)
+    oauth (0.4.6)
+    oauth2 (0.8.0)
+      faraday (~> 0.8)
+      httpauth (~> 0.1)
+      jwt (~> 0.1.4)
+      multi_json (~> 1.0)
+      rack (~> 1.2)
+    pdf-reader (1.1.1)
+      Ascii85 (~> 1.0.0)
+      ruby-rc4
+    prawn (0.12.0)
+      pdf-reader (>= 0.9.0)
+      ttfunk (~> 1.0.2)
+    rack (1.4.1)
+    rake (0.9.2.2)
+    rdoc (3.12)
+      json (~> 1.4)
+    roo (1.10.1)
+      choice (>= 0.1.4)
+      google-spreadsheet-ruby (>= 0.1.5)
+      nokogiri (>= 1.5.0)
+      rubyzip (>= 0.9.4)
+      spreadsheet (> 0.6.4)
+      todonotes (>= 0.1.0)
+    rspec (2.11.0)
+      rspec-core (~> 2.11.0)
+      rspec-expectations (~> 2.11.0)
+      rspec-mocks (~> 2.11.0)
+    rspec-core (2.11.1)
+    rspec-expectations (2.11.2)
+      diff-lcs (~> 1.1.3)
+    rspec-mocks (2.11.1)
+    ruby-ole (1.2.11.4)
+    ruby-rc4 (0.1.5)
+    rubyzip (0.9.9)
+    simplecov (0.6.4)
+      multi_json (~> 1.0)
+      simplecov-html (~> 0.5.3)
+    simplecov-html (0.5.3)
+    spreadsheet (0.7.3)
+      ruby-ole (>= 1.0)
+    todonotes (0.1.0)
+      log4r
+    trollop (1.16.2)
+    ttfunk (1.0.3)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler
+  jeweler
+  liquid
+  prawn
+  roo
+  rspec
+  simplecov
+  trollop

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2012 Paul A. Jungwirth
+
+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/NOTES

@@ -0,0 +1,12 @@
+To create a new gem:
+  - `rake version` to bump the version number. Also:
+    - `rake version:bump:major`
+    - `rake version:bump:minor`
+    - `rake version:bump:patch`
+  - `rake gemspec` to use jeweler to autogenerate the gemspec based on the Rakefile.
+  - `gem build rbinvoice.gemspec` to build a rbinvoice-$version.gem file.
+  - `gem install ./rbinvoice-$version.gem` to install it locally for testing.
+    - OR `rake install` to build and install.
+  - `gem push rbinvoice-$version.gem` to push it to RubyGems.org.
+    - OR `rake release` to release the gem.
+

data/README.md

@@ -0,0 +1,6 @@
+rbinvoice
+=========
+
+rbinvoice lets you generate PDF invoices from a Google Spreadsheet.
+It's pretty obscure; you probably haven't heard of it.
+

data/Rakefile

@@ -0,0 +1,60 @@
+# encoding: utf-8
+
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "rbinvoice"
+  gem.homepage = "http://github.com/pjungwir/rbinvoice"
+  gem.license = "MIT"
+  gem.summary = 'Used to invoice my clients'
+  gem.description = <<-EOT
+      Reads hours from a Google Spreadsheet and generates a PDF invoice.
+  EOT
+  gem.email = "pj@illuminatedcomputing.com"
+  gem.authors = ["Paul A. Jungwirth"]
+  gem.executables << 'rbinvoice'
+  # dependencies defined in Gemfile
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end
+
+=begin
+RSpec::Core::RakeTask.new(:rcov) do |spec|
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+=end
+
+task :default => :spec
+
+require 'rdoc/task'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "rbinvoice #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+task :run, [] => [] do |t, args|
+  require 'rbinvoice'
+  RbInvoice::write_invoice(*RbInvoice::Options::parse_command_line(%w{okvenue}))
+end
+

data/TODO

@@ -0,0 +1,10 @@
+- Write the README
+  - overview
+  - options
+  - spreadsheet format
+  - .rbinvoice
+  - .rbinvoicerc
+  - LaTeX+liquid template
+- more tests
+- print the pdflatex results to std{out,err}
+

data/VERSION

@@ -0,0 +1 @@
+0.2.0

data/bin/rbinvoice

@@ -0,0 +1,3 @@
+#!/usr/bin/env ruby
+require 'rbinvoice'
+RbInvoice::write_invoices(*RbInvoice::Options::parse_command_line(ARGV))

data/lib/rbinvoice/options.rb

@@ -0,0 +1,271 @@
+require 'yaml'
+require 'trollop'
+require 'rbinvoice/util'
+
+module RbInvoice
+  module Options
+
+    # This is a method rather than a constant
+    # so that we don't evaulate ENV['HOME']
+    # until it's called. That makes it possible
+    # for tests to set ENV['HOME'] before running the code.
+    def self.default_rc_file
+      File.join(ENV['HOME'] || '.', '.rbinvoicerc')
+    end
+
+    # This is a method rather than a constant
+    # so that we don't evaulate ENV['HOME']
+    # until it's called. That makes it possible
+    # for tests to set ENV['HOME'] before running the code.
+    def self.default_data_file
+      File.join(ENV['HOME'] || '.', '.rbinvoice')
+    end
+
+    def self.default_template_filename
+      File.join(File.dirname(__FILE__), '..', '..', 'templates', 'invoice.tex.liquid')
+    end
+
+    def self.write_data_file(opts)
+      # Add the new invoice to the list of client invoices.
+      File.open(opts[:data_file], 'w') { |f| f.puts YAML::dump(opts[:data]) }
+    end
+
+    def self.read_data_file(opts)
+      if File.exist?(opts[:data_file])
+        ret = parse_data_file(File.read(opts[:data_file]), opts)
+        client = data_for_client(ret, opts[:client])
+        opts[:rate] = client[:rate] if client
+        return ret
+      else
+        return {}
+      end
+    end
+
+    def self.parse_data_file(text, opts)
+      text ? RbInvoice::Util::read_with_yaml(text) : {}
+    end
+
+    def self.read_rc_file(opts)
+      Trollop::die :rcfile, "doesn't exist" if opts[:rcfile] and not File.exist?(opts[:rcfile])
+
+      # Don't apply the default until now
+      # so we know if the user requested one specifically or not:
+      opts[:rcfile] ||= default_rc_file
+
+      if File.exist?(opts[:rcfile])
+        return parse_rc_file(File.read(opts[:rcfile]), opts)
+      else
+        return opts
+      end
+    end
+
+    def self.parse_rc_file(text, opts)
+      rc = (text ? RbInvoice::Util::read_with_yaml(text) : {})
+      %w{spreadsheet spreadsheet_user spreadsheet_password out_directory}.each do |key|
+        key = key.to_sym
+        opts[key] ||= rc[key]
+      end
+      return opts
+    end
+
+    # TODO: Allow per-client settings to override the global setting
+    def self.default_out_directory(opts)
+      opts[:out_directory] || '.'
+    end
+
+    # Looks in ~/.rbinvoice 
+    def self.default_out_filename(opts)
+      if opts[:client] and opts[:invoice_number]
+        File.join(default_out_directory(opts), "invoice-#{opts[:invoice_number]}-#{opts[:client]}.pdf")
+      else
+        nil
+      end
+    end
+
+    def self.first_day_of_the_month(d)
+      Date.new(d.year, d.month, 1)
+    end
+
+    def self.last_day_of_the_month(d)
+      n = d.next_month
+      Date.new(d.year, d.month, (Date.new(n.year, n.month, 1) - 1).day)
+    end
+
+    def self.semimonth_end(d)
+      if d.day <= 15
+        Date.new(d.year, d.month, 15)
+      else
+        Date.new(d.year, d.month, last_day_of_the_month(d).day)
+      end
+    end
+
+    def self.semimonth_start(d)
+      if d.day <= 15
+        first_day_of_the_month(d)
+      else
+        Date.new(d.year, d.month, 15)
+      end
+    end
+
+    def self.week_start(d)
+      # Assumes the week starts on a Sunday:
+      d - d.wday
+    end
+
+    def self.week_end(d)
+      week_start(d) + 7
+    end
+
+    # second_half_of_biweek - indicates that `d` is from the second half of the biweek.
+    # If false (the default), we assume `d` is from the first half.
+    def self.find_invoice_bounds(d, freq, second_half_of_biweek=false)
+      case freq.to_sym
+      when :weekly
+        return week_start(d), week_end(d)
+      when :biweekly
+        if second_half_of_biweek
+          return week_start(d) - 7, week_end(d)
+        else
+          return week_start(d), week_end(d) + 7
+        end
+      when :semimonthly
+        return semimonth_start(d), semimonth_end(d)
+      when :monthly
+        return first_day_of_the_month(d), last_day_of_the_month(d)
+      else
+        raise "Unknown frequency: #{freq}"
+      end
+    end
+
+    def self.add_new_client_data(client, data)
+      h = {
+        'name' => client,
+        'key' => client,
+        'invoices' => []
+      }
+      (data[:clients] ||= []) << h
+      return h
+    end
+
+    def self.add_invoice_to_data(tasks, start_date, end_date, filename, opts)
+      data = opts[:data]
+      client = data_for_client(data, opts[:client]) || add_new_client_data(opts[:client], data)
+      (client[:invoices] ||= []) << {
+        'id' => opts[:invoice_number],
+        'start_date' => start_date.strftime("%Y-%m-%d"),
+        'end_date' => end_date.strftime("%Y-%m-%d"),
+        'filename' => filename
+      }
+      if not data[:last_invoice] or opts[:invoice_number] > data[:last_invoice]
+        data[:last_invoice] = opts[:invoice_number]
+      end
+      write_data_file(opts)
+    end
+
+    def self.all_clients(data)
+      data[:clients] || []
+    end
+
+    def self.last_invoice_number(data)
+      data[:last_invoice]
+    end
+
+    def self.data_for_client(data, client)
+      all_clients(data).select{|x| x[:key] == RbInvoice::to_client_key(client)}.first
+    end
+
+    def self.key_for_client(data, client, key)
+      d = data_for_client(data, client)
+      d = d ? d[key] : nil
+    end
+
+    def self.frequncy_for_client(data, client)
+      key_for_client(data, client, :frequency)
+    end
+
+    def self.invoices_for_client(data, client)
+      key_for_client(data, client, :invoices) || []
+    end
+
+    def self.last_invoice_for_client(data, client)
+      invoices_for_client(data, client).sort_by{|x| x[:end_date]}.last
+    end
+
+    def self.frequency_for_client(data, client)
+      key_for_client(data, client, :frequency)
+    end
+
+    def self.parse_command_line(argv)
+      opts = Trollop::options(argv) do
+        version "rbinvoice 0.1.0 (c) 2012 Paul A. Jungwirth"
+        banner <<-EOH
+          USAGE: rbinvoice [options] <client> [filename]
+        EOH
+        opt :help, "Show a help message"
+
+        opt :rcfile, "Use an rc file other than ~/.rbinvoicerc", :short => '-r'
+        opt :no_rcfile, "Don't read an rc file", :default => false, :short => '-R'
+
+        opt :data_file, "Use a data file other than ~/.rbinvoice", :default => RbInvoice::Options.default_data_file, :short => '-d'
+        opt :no_data_file, "Don't read or write to a data file", :default => false, :short => '-D'
+
+        opt :invoice_number, "Use a specific invoice number", :type => :int, :short => '-n'
+        opt :no_write_invoice_number, "Record the invoice number", :default => false, :short => '-N'
+
+        opt :spreadsheet, "Read the given spreadsheet URL", :type => :string, :short => '-u'
+        opt :start_date, "Date to begin the invoice (yyyy-mm-dd)", :type => :string
+        opt :end_date, "Date to end the invoice (yyyy-mm-dd)", :type => :string
+
+        opt :template, "Use the given liquid template", :type => :string, :default => RbInvoice::Options::default_template_filename
+      end
+      Trollop::die "client must be given" unless argv.size > 0
+      opts[:client] = argv.shift
+
+      read_rc_file(opts) unless opts[:no_rcfile]
+      opts[:data] = opts[:no_data_file] ? {} : read_data_file(opts)
+
+      if not opts[:invoice_number] and not last_invoice_number(opts[:data])
+        Trollop::die "Can't determine invoice number"
+      end
+      opts[:invoice_number] ||= last_invoice_number(opts[:data]) + 1
+
+      Trollop::die "can't determine hourly spreadsheet" unless opts[:spreadsheet]
+
+      opts[:out_filename] = argv.shift
+      if not opts[:out_filename]
+        opts[:out_filename] = default_out_filename(opts)
+        opts[:used_default_out_filename] = true     # TODO if this is set and not quiet, then print the name of the file we wrote to: "Wrote invoice to #{out_filename}"
+      end
+      Trollop::die "can't infer output filename; please provide one" unless opts[:out_filename]
+
+      # opts[:start_date] = '2012-07-15'
+      # opts[:end_date]   = '2012-07-31'
+      opts[:start_date] = Date.strptime(opts[:start_date], "%Y-%m-%d")  if opts[:start_date]
+      opts[:end_date]   = Date.strptime(opts[:end_date], "%Y-%m-%d")    if opts[:end_date]
+
+      # Read the list of past invoices.
+      # If there are none, assume there is only one invoice to do.
+
+      jobs = []
+
+      last_invoice = last_invoice_for_client(opts[:data], opts[:client])
+      if opts[:end_date] and opts[:start_date]
+        # just do it, regardless of frequency.
+      elsif opts[:end_date] or opts[:start_date]
+        freq = frequency_for_client(opts[:data], opts[:client])
+        if freq
+          opts[:start_date], opts[:end_date] = find_invoice_bounds(opts[:start_date] || opts[:end_date], freq, !!opts[:end_date])
+        else
+          Trollop::die "can't determine invoice range without frequency"
+        end
+      else
+        # Do all pending invoices (leave start_date and end_date nil).
+      end
+
+      # return jobs
+
+      return opts[:client], opts[:start_date], opts[:end_date], opts[:out_filename], opts
+    end
+
+  end
+end

data/lib/rbinvoice/util.rb

@@ -0,0 +1,29 @@
+module RbInvoice
+  module Util
+
+    def self.symbolize_array(arr)
+      arr.map{|x|
+        case x
+        when Hash; symbolize_hash(x)
+        when Array; symbolize_array(x)
+        else x
+        end
+      }
+    end
+
+    def self.symbolize_hash(h)
+      h.each_with_object({}) {|(k,v), h|
+        h[k.to_sym] = case v
+                      when Hash; symbolize_hash(v)
+                      when Array; symbolize_array(v)
+                      else; v
+                      end
+      }
+    end
+
+    def self.read_with_yaml(text)
+      symbolize_hash(YAML::load(text) || {})
+    end
+
+  end
+end

data/lib/rbinvoice.rb

@@ -0,0 +1,157 @@
+require 'date'
+require 'bigdecimal'
+require 'trollop'
+# require 'prawn'
+
+require 'rbinvoice/options'
+require 'roo'
+require 'liquid'
+
+module RbInvoice
+
+  COL_DATE       = 'B'
+  COL_CLIENT     = 'C'
+  COL_TASK       = 'D'
+  COL_START_TIME = 'E'
+  COL_END_TIME   = 'F'
+  COL_TOTAL_TIME = 'G'
+
+  # TODO:
+  #   - Figure out the next invoice_number.
+  #   - Record the invoice & the new invoice_number.
+  #   - Default dir for the tex & pdf files.
+
+  def self.parse_date(str)
+    return str if str.class == Date
+    Date.strptime(str, "%m/%d/%Y")
+  end
+
+  def self.earliest_task_date(hours)
+    row = hours.sort_by { |row| parse_date(row[0]) }.first
+    row ? row[0] : nil
+  end
+
+  def self.write_invoices(client, start_date, end_date, filename, opts)
+    if start_date and end_date
+      tasks = hourly_breakdown(client, start_date, end_date, opts)
+      make_pdf(tasks, start_date, end_date, filename, opts)
+    else
+      # Write all the outstanding spreadsheets
+      freq = RbInvoice::Options::frequency_for_client(opts[:data], client)
+      last_invoice = RbInvoice::Options::last_invoice_for_client(opts[:data], client)
+      hours = read_all_hours(client, opts)
+      earliest_date = if last_invoice
+                     last_invoice[:end_date] + 1
+                   else
+                     parse_date(earliest_task_date)
+                   end
+      start_date, end_date = RbInvoice::Options::find_invoice_bounds(earliest_date, freq)
+      tasks = hourly_breakdown(client, start_date, end_date, opts)
+      while tasks.size > 0
+        filename = RbInvoice::Options::default_out_filename(opts)
+        make_pdf(tasks, start_date, end_date, filename, opts)
+        start_date, end_date = RbInvoice::Options::find_invoice_bounds(end_date + 1, freq)
+        tasks = hourly_breakdown(client, start_date, end_date, opts)
+        opts[:invoice_number] += 1
+      end
+    end
+  end
+
+  def self.make_pdf(tasks, start_date, end_date, filename, opts)
+    write_latex(tasks, end_date, filename, opts)
+    `cd "#{File.dirname(filename)}" && pdflatex "#{File.basename(filename, '.pdf')}"`
+    RbInvoice::Options::add_invoice_to_data(tasks, start_date, end_date, filename, opts) unless opts[:no_data_file]
+  end
+
+  def self.escape_for_latex(str)
+    str.gsub('&', '\\\\&').   # tricky b/c '\&' has special meaning to gsub.
+      gsub('"', '\"').
+      gsub('$', '\$')
+  end
+
+  def self.write_latex(tasks, invoice_date, filename, opts)
+    template = File.open(opts[:template]) { |f| f.read }
+    rate = opts[:rate]    # TODO: Support per-task rates
+    items = tasks.map{|task, details|
+      task_total_hours = details.inject(0) {|t, row| t + row[2]}
+      {
+        'name' => escape_for_latex(task),
+        'duration_decimal' => task_total_hours,
+        'duration' => decimal_to_interval(task_total_hours),
+        'price_decimal' => task_total_hours * rate,
+        'price' => "%0.02f" % (task_total_hours * rate)
+      }
+    }
+
+
+    args = Hash[
+      {
+        invoice_number: opts[:invoice_number],
+        invoice_date: invoice_date.strftime("%d %B %Y"),
+        line_items: items,
+        total_duration: decimal_to_interval(items.inject(0) {|t, item| t + item['duration_decimal']}),
+        total_price: "%0.02f" % items.inject(0) {|t, item| t + item['price_decimal']},
+      }.map{|k, v| [k.to_s, v]}
+    ]
+    latex = Liquid::Template.parse(template).render args
+    File.open("#{filename.gsub(/\.pdf$/, '')}.tex", 'w') { |f| f.write(latex) }
+  end
+
+  def self.hourly_breakdown(client, start_date, end_date, opts)
+    hours = group_by_task(select_date_range(start_date, end_date, read_all_hours(client, opts)))
+  end
+
+  def self.open_worksheet(spreadsheet, username, password)
+    g = Google.new(spreadsheet, username, password)
+    g.date_format = '%m/%d/%Y'
+    g.default_sheet = g.sheets.first
+    return g
+  end
+
+  def self.to_client_key(client)
+    client.downcase.gsub(' ', '')
+  end
+
+  def self.read_all_hours(client, opts)
+    ss = nil
+    begin
+      ss = open_worksheet(opts[:spreadsheet], opts[:spreadsheet_user], opts[:spreadsheet_password])
+    rescue Exception => e
+      $stderr.puts "rbinvoice: Failed to open spreadsheet #{opts[:spreadsheet]}: #{$!}"
+      exit 1
+    end
+
+    client = to_client_key(client)
+    return 3.upto(ss.last_row).select { |row|
+      to_client_key(ss.cell(row, COL_CLIENT) || '') == client
+    }.map { |row|
+      [ss.cell(row, COL_DATE), ss.cell(row, COL_TASK), interval_to_decimal(ss.cell(row, COL_TOTAL_TIME))]
+    }
+  end
+
+  def self.interval_to_decimal(time)
+    return nil unless time
+    d = Date._strptime(time, "%H:%M")
+    BigDecimal.new(d[:hour] * 60 + d[:min]) / 60
+  end
+
+  def self.decimal_to_interval(time)
+    "%d:%02d" % [time.to_i, (60*time) % 60]
+  end
+
+  def self.select_date_range(start_date, end_date, hours)
+    hours.select do |row|
+      # puts "#{row[0].class}: #{row.join("\t")}"
+      # Sometimes we get a String, sometimes a Date,
+      # and changing the cell's format in the spreadsheet
+      # doesn't have any effect. So do our best to support both:
+      d = row[0].class == String ? parse_date(row[0]) : row[0]
+      start_date <= d and d <= end_date
+    end
+  end
+  
+  def self.group_by_task(rows)
+    rows.group_by{|r| r[1]}
+  end
+
+end

data/rbinvoice.gemspec

@@ -0,0 +1,76 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = "rbinvoice"
+  s.version = "0.2.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Paul A. Jungwirth"]
+  s.date = "2012-08-07"
+  s.description = "      Reads hours from a Google Spreadsheet and generates a PDF invoice.\n"
+  s.email = "pj@illuminatedcomputing.com"
+  s.executables = ["rbinvoice", "rbinvoice"]
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.md",
+    "TODO"
+  ]
+  s.files = [
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE.txt",
+    "NOTES",
+    "README.md",
+    "Rakefile",
+    "VERSION",
+    "bin/rbinvoice",
+    "lib/rbinvoice.rb",
+    "lib/rbinvoice/options.rb",
+    "lib/rbinvoice/util.rb",
+    "rbinvoice.gemspec",
+    "spec/options_spec.rb",
+    "templates/invoice.tex.liquid"
+  ]
+  s.homepage = "http://github.com/pjungwir/rbinvoice"
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = "1.8.24"
+  s.summary = "Used to invoice my clients"
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<trollop>, [">= 0"])
+      s.add_runtime_dependency(%q<roo>, [">= 0"])
+      s.add_runtime_dependency(%q<prawn>, [">= 0"])
+      s.add_runtime_dependency(%q<liquid>, [">= 0"])
+      s.add_development_dependency(%q<rspec>, [">= 0"])
+      s.add_development_dependency(%q<bundler>, [">= 0"])
+      s.add_development_dependency(%q<jeweler>, [">= 0"])
+      s.add_development_dependency(%q<simplecov>, [">= 0"])
+    else
+      s.add_dependency(%q<trollop>, [">= 0"])
+      s.add_dependency(%q<roo>, [">= 0"])
+      s.add_dependency(%q<prawn>, [">= 0"])
+      s.add_dependency(%q<liquid>, [">= 0"])
+      s.add_dependency(%q<rspec>, [">= 0"])
+      s.add_dependency(%q<bundler>, [">= 0"])
+      s.add_dependency(%q<jeweler>, [">= 0"])
+      s.add_dependency(%q<simplecov>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<trollop>, [">= 0"])
+    s.add_dependency(%q<roo>, [">= 0"])
+    s.add_dependency(%q<prawn>, [">= 0"])
+    s.add_dependency(%q<liquid>, [">= 0"])
+    s.add_dependency(%q<rspec>, [">= 0"])
+    s.add_dependency(%q<bundler>, [">= 0"])
+    s.add_dependency(%q<jeweler>, [">= 0"])
+    s.add_dependency(%q<simplecov>, [">= 0"])
+  end
+end
+

data/spec/options_spec.rb

@@ -0,0 +1,139 @@
+require 'rbinvoice'
+
+describe RbInvoice::Options do
+
+  before :each do
+    @tmpdir = "/tmp/rbinvoice-test-#{$$}"
+    FileUtils.rm_rf @tmpdir
+    FileUtils.mkdir_p @tmpdir
+    ENV['HOME'] = @tmpdir
+  end
+
+  after :each do
+    FileUtils.rm_rf @tmpdir
+  end
+
+  it "should compute the first day of the month" do
+    RbInvoice::Options::first_day_of_the_month(Date.new(2011, 3, 5)).should == Date.new(2011, 3,1)
+    RbInvoice::Options::first_day_of_the_month(Date.new(2011, 3,31)).should == Date.new(2011, 3,1)
+    RbInvoice::Options::first_day_of_the_month(Date.new(2011, 3, 1)).should == Date.new(2011, 3,1)
+    RbInvoice::Options::first_day_of_the_month(Date.new(2011, 2,28)).should == Date.new(2011, 2,1)
+    RbInvoice::Options::first_day_of_the_month(Date.new(2012, 2,29)).should == Date.new(2012, 2,1)
+    RbInvoice::Options::first_day_of_the_month(Date.new(2012, 1, 5)).should == Date.new(2012, 1,1)
+    RbInvoice::Options::first_day_of_the_month(Date.new(2011,12, 5)).should == Date.new(2011,12,1)
+  end
+
+  it "should compute the last day of the month" do
+    RbInvoice::Options::last_day_of_the_month(Date.new(2011, 3, 5)).should == Date.new(2011, 3,31)
+    RbInvoice::Options::last_day_of_the_month(Date.new(2011, 3,31)).should == Date.new(2011, 3,31)
+    RbInvoice::Options::last_day_of_the_month(Date.new(2011, 3, 1)).should == Date.new(2011, 3,31)
+    RbInvoice::Options::last_day_of_the_month(Date.new(2011, 4, 8)).should == Date.new(2011, 4,30)
+    RbInvoice::Options::last_day_of_the_month(Date.new(2011, 2,28)).should == Date.new(2011, 2,28)
+    RbInvoice::Options::last_day_of_the_month(Date.new(2012, 2,29)).should == Date.new(2012, 2,29)
+    RbInvoice::Options::last_day_of_the_month(Date.new(2011, 2,19)).should == Date.new(2011, 2,28)
+    RbInvoice::Options::last_day_of_the_month(Date.new(2012, 2,19)).should == Date.new(2012, 2,29)
+    RbInvoice::Options::last_day_of_the_month(Date.new(2012, 1, 5)).should == Date.new(2012, 1,31)
+    RbInvoice::Options::last_day_of_the_month(Date.new(2011,12, 5)).should == Date.new(2011,12,31)
+  end
+
+  it "should compute the semimonth end date" do
+    RbInvoice::Options::semimonth_end(Date.new(2011, 3, 5)).should == Date.new(2011, 3,15)
+    RbInvoice::Options::semimonth_end(Date.new(2011, 3,21)).should == Date.new(2011, 3,31)
+    RbInvoice::Options::semimonth_end(Date.new(2011, 3,31)).should == Date.new(2011, 3,31)
+    RbInvoice::Options::semimonth_end(Date.new(2011, 3, 1)).should == Date.new(2011, 3,15)
+    RbInvoice::Options::semimonth_end(Date.new(2011, 4, 8)).should == Date.new(2011, 4,15)
+    RbInvoice::Options::semimonth_end(Date.new(2011, 2,28)).should == Date.new(2011, 2,28)
+    RbInvoice::Options::semimonth_end(Date.new(2012, 2,28)).should == Date.new(2012, 2,29)
+    RbInvoice::Options::semimonth_end(Date.new(2012, 2,29)).should == Date.new(2012, 2,29)
+    RbInvoice::Options::semimonth_end(Date.new(2011, 2,19)).should == Date.new(2011, 2,28)
+    RbInvoice::Options::semimonth_end(Date.new(2012, 2,19)).should == Date.new(2012, 2,29)
+    RbInvoice::Options::semimonth_end(Date.new(2012, 1, 5)).should == Date.new(2012, 1,15)
+    RbInvoice::Options::semimonth_end(Date.new(2011,12, 1)).should == Date.new(2011,12,15)
+    RbInvoice::Options::semimonth_end(Date.new(2011,12, 5)).should == Date.new(2011,12,15)
+    RbInvoice::Options::semimonth_end(Date.new(2011,12,15)).should == Date.new(2011,12,15)
+    RbInvoice::Options::semimonth_end(Date.new(2011,12,25)).should == Date.new(2011,12,31)
+  end
+
+  it "should compute the semimonth start date" do
+    RbInvoice::Options::semimonth_start(Date.new(2011, 3, 5)).should == Date.new(2011, 3, 1)
+    RbInvoice::Options::semimonth_start(Date.new(2011, 3,21)).should == Date.new(2011, 3,15)
+    RbInvoice::Options::semimonth_start(Date.new(2011, 3,31)).should == Date.new(2011, 3,15)
+    RbInvoice::Options::semimonth_start(Date.new(2011, 3, 1)).should == Date.new(2011, 3, 1)
+    RbInvoice::Options::semimonth_start(Date.new(2011, 4, 8)).should == Date.new(2011, 4, 1)
+    RbInvoice::Options::semimonth_start(Date.new(2011, 2,28)).should == Date.new(2011, 2,15)
+    RbInvoice::Options::semimonth_start(Date.new(2012, 2,28)).should == Date.new(2012, 2,15)
+    RbInvoice::Options::semimonth_start(Date.new(2012, 2,29)).should == Date.new(2012, 2,15)
+    RbInvoice::Options::semimonth_start(Date.new(2011, 2,19)).should == Date.new(2011, 2,15)
+    RbInvoice::Options::semimonth_start(Date.new(2012, 2,19)).should == Date.new(2012, 2,15)
+    RbInvoice::Options::semimonth_start(Date.new(2012, 1, 5)).should == Date.new(2012, 1, 1)
+    RbInvoice::Options::semimonth_start(Date.new(2011,12, 1)).should == Date.new(2011,12, 1)
+    RbInvoice::Options::semimonth_start(Date.new(2011,12, 5)).should == Date.new(2011,12, 1)
+    RbInvoice::Options::semimonth_start(Date.new(2011,12,15)).should == Date.new(2011,12, 1)
+    RbInvoice::Options::semimonth_start(Date.new(2011,12,25)).should == Date.new(2011,12,15)
+  end
+
+  it "should compute the previous semimonth" do
+  end
+
+  it "should have good defaults" do
+    ret = RbInvoice::Options::parse_command_line(%w{--spreadsheet=foo --invoice-number=5 my-client outfile})
+    (client, start_date, end_date, out_filename, opts) = RbInvoice::Options::parse_command_line(%w{--spreadsheet=foo --invoice-number=5 my-client outfile})
+    client.should == 'my-client'
+    out_filename.should == 'outfile'
+
+    opts[:no_rcfile].should == false
+    opts[:rcfile].should == "#{@tmpdir}/.rbinvoicerc"
+    opts[:no_data_file].should == false
+    opts[:data_file].should == "#{@tmpdir}/.rbinvoice"
+    opts[:no_write_invoice_number].should == false
+  end
+
+  it "should require an output filename if it can't infer one" do
+    lambda {
+      RbInvoice::Options::parse_command_line(%w{--spreadsheet=foo my-client})
+    }.should raise_error SystemExit
+  end
+
+  it "should require a spreadsheet URL if it can't find one in .rbinvoicerc" do
+    lambda {
+      RbInvoice::Options::parse_command_line(%w{--invoice-number=5 my-client outfile})
+    }.should raise_error SystemExit
+  end
+
+  it "should require an invoice number if it can't infer one" do
+    lambda {
+      RbInvoice::Options::parse_command_line(%w{--spreadsheet=foo my-client outfile})
+    }.should raise_error SystemExit
+  end
+
+  it "should use the given invoice number" do
+    client, start_date, end_date, out_filename, opts = *RbInvoice::Options::parse_command_line(%w{--spreadsheet=foo --invoice-number=1041 my-client outfile})
+    opts[:invoice_number].should == 1041
+  end
+
+  it "should use the next invoice number" do
+    File.open("#{@tmpdir}/.rbinvoice", 'w') { |f| f.write("last_invoice: 1040") }
+    client, start_date, end_date, out_filename, opts = *RbInvoice::Options::parse_command_line(%w{--spreadsheet=foo my-client outfile})
+    opts[:invoice_number].should == 1041
+  end
+
+  it "should infer output filename from invoice number and client" do
+    client, start_date, end_date, out_filename, opts = *RbInvoice::Options::parse_command_line(%w{--spreadsheet=foo --invoice-number=1041 my-client})
+    opts[:out_filename].should == './invoice-1041-my-client.pdf'
+  end
+
+  it "should use the spreadsheet URL from --spreadsheet" do
+    client, start_date, end_date, out_filename, opts = *RbInvoice::Options::parse_command_line(%w{--spreadsheet=foo --invoice-number=5 my-client outfile})
+    opts[:spreadsheet].should == 'foo'
+
+    client, start_date, end_date, out_filename, opts = *RbInvoice::Options::parse_command_line(%w{-u foo --invoice-number=5 my-client outfile})
+    opts[:spreadsheet].should == 'foo'
+  end
+
+  it "should use the spreadsheet URL from .rbinvoicerc" do
+    File.open("#{@tmpdir}/.rbinvoicerc", 'w') { |f| f.write("spreadsheet: http://foo") }
+    client, start_date, end_date, out_filename, opts = *RbInvoice::Options::parse_command_line(%w{--invoice-number=1040 my-client outfile})
+    opts[:spreadsheet].should == 'http://foo'
+  end
+
+end

data/templates/invoice.tex.liquid

@@ -0,0 +1,55 @@
+\documentclass[12pt]{article}
+
+\pagestyle{empty}
+
+\begin{document}
+
+% \section*{Invoice 12/31/2007}
+
+\noindent
+\begin{minipage}[t]{3in}
+Paul Jungwirth \\
+2520 SW Edgemoor Ave. \\
+Beaverton, OR 97005 \\
+909 557-0421 \\
+\end{minipage}
+\begin{minipage}[t]{1.9in}
+\begin{flushright}
+{\Large \textbf{Invoice}} \\
+\# {{ invoice_number }} \\
+{{ invoice_date }} \\
+\end{flushright}
+\end{minipage} \\
+{% raw %}
+% \makebox[3.9in][r]{{\Large \textbf{Invoice}} \\ 31 December 2007} \\
+{% endraw %}
+
+\noindent {\sc to}: \\
+OK Venue LLC \\
+116 W 23rd St. \\
+New York, NY 10011 \\
+\smallskip
+
+\noindent {\sc for}: \\
+Consulting and programming for the okvenue.com website and related projects. \\
+\linebreak[4]
+
+\begin{tabular}{lrr}
+\textbf{Description} & \textbf{Hours} & \textbf{Cost} \\
+\hline
+{% for item in line_items %}
+  {{ item.name }} & {{ item.duration }} & \${{ item.price }} \\ {% endfor %}
+\textbf{Total:} & {{ total_duration }} & \${{ total_price }} \\
+\end{tabular}
+
+\bigskip
+
+\noindent
+Please make all checks payable to Paul Jungwirth. \\
+Payment due net 30 days. \\
+
+\begin{center}
+\textbf{Thank you for your business!}
+\end{center}
+
+\end{document}

metadata

@@ -0,0 +1,197 @@
+--- !ruby/object:Gem::Specification
+name: rbinvoice
+version: !ruby/object:Gem::Version
+  version: 0.2.0
+  prerelease: 
+platform: ruby
+authors:
+- Paul A. Jungwirth
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-08-07 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: trollop
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: roo
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: prawn
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: liquid
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: jeweler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: ! '      Reads hours from a Google Spreadsheet and generates a PDF invoice.
+
+'
+email: pj@illuminatedcomputing.com
+executables:
+- rbinvoice
+extensions: []
+extra_rdoc_files:
+- LICENSE.txt
+- README.md
+- TODO
+files:
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- NOTES
+- README.md
+- Rakefile
+- VERSION
+- bin/rbinvoice
+- lib/rbinvoice.rb
+- lib/rbinvoice/options.rb
+- lib/rbinvoice/util.rb
+- rbinvoice.gemspec
+- spec/options_spec.rb
+- templates/invoice.tex.liquid
+- TODO
+homepage: http://github.com/pjungwir/rbinvoice
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -1042798753782564714
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: Used to invoice my clients
+test_files: []