instance_accountant 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 659797969092d787410c4789f8379c33b9b10ccb
+  data.tar.gz: 0c858e6a0c0a6ae6f7bec5877cbbf450f6de665c
+SHA512:
+  metadata.gz: a442d471310a881effe735f4b7d6ff5118af02e238e20e908178e5e845409cc51a4c123e08e9f0acebac655badec7cc0fbd4278a7e8a21d20c95d03132015af6
+  data.tar.gz: cb5df07e2c58e9905134bf3d1683846f1ddeaa41cffb503b68e6dc6c99d5fb36a7119693c31e86553cf64a0e2b71ac3093636bf527a796528a68c17e0141f872

data/LICENSE.txt

@@ -0,0 +1,12 @@
+Copyright (c) 2014, Subledger, Inc.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/README.md

@@ -0,0 +1,76 @@
+Subledger instance accountant Ruby gem
+
+Installation:
+
+    gem install instance_accountant
+
+Gemfile:
+
+    gem 'instance_accountant'
+
+The gem provides an executable that can be invoked two ways:
+
+If you want to account for the hourly cost of instances, use this form:
+
+    instance_accountant account                                          \
+      --description       'instance usage for: %s'                       \
+      --reference         'http://test.com/journal_entry'                \
+      --cost              0.1                                            \
+      --cost_description  'cost for: %s'                                 \
+      --cost_reference    'http://test.com/cost'                         \
+      --expense_acct      subledger_account_id                           \
+      --payable_acct      subledger_account_id                           \
+      --key_id            subledger_key_id                               \
+      --secret            subledger_secret                               \
+      --org_id            subledger_org_id                               \
+      --book_id           subledger_book_id                              \
+      --daemon
+
+If you want to account for both the hourly cost of instances, and hourly income instances, use this form:
+
+    instance_accountant account                                          \
+      --description       'instance usage for: %s'                       \
+      --reference         'http://test.com/journal_entry'                \
+      --cost              0.1                                            \
+      --cost_description  'cost for: %s'                                 \
+      --cost_reference    'http://test.com/cost'                         \
+      --expense_acct      subledger_account_id                           \
+      --payable_acct      subledger_account_id                           \
+      --price             0.2                                            \
+      --price_description 'price for: %s'                                \
+      --price_reference   'http://test.com/price'                        \
+      --receivable_acct   subledger_account_id                           \
+      --income_acct       subledger_account_id                           \
+      --key_id            subledger_key_id                               \
+      --secret            subledger_secret                               \
+      --org_id            subledger_org_id                               \
+      --book_id           subledger_book_id                              \
+      --daemon
+
+Note: %s in descriptions will be replaced by the ISO 8601 of the hour in UTC
+
+Here's a complete set of options:
+
+    Options:
+      f, [--filepath=FILEPATH]
+                                                   # Default: ~/.instance_accountant
+      d, --description=DESCRIPTION
+                                                   # Default: instance usage for
+          [--reference=REFERENCE]
+      c, --cost=COST
+          [--cost-description=COST_DESCRIPTION]
+                                                   # Default: cost for
+          [--cost-reference=COST_REFERENCE]
+      e, --expense-acct=EXPENSE_ACCT
+      p, --payable-acct=PAYABLE_ACCT
+      p, [--price=PRICE]
+          [--price-description=PRICE_DESCRIPTION]
+                                                   # Default: price for
+          [--price-reference=PRICE_REFERENCE]
+      i, [--income-acct=INCOME_ACCT]
+      r, [--receivable-acct=RECEIVABLE_ACCT]
+      k, --key-id=KEY_ID
+      s, --secret=SECRET
+      o, --org-id=ORG_ID
+      b, --book-id=BOOK_ID
+          [--daemon], [--no-daemon]

data/Rakefile

@@ -0,0 +1,6 @@
+# -*- encoding : utf-8 -*-
+# DO NOT EDIT THIS FILE! (Create new task(s) using lib/tasks/*.rake convention
+
+Dir[File.expand_path(__FILE__ + '/..') + '/tasks/*.rake' ].each do |f|
+  load f
+end

data/bin/instance_accountant

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby
+# -*- encoding : utf-8 -*-
+
+$LOAD_PATH.unshift 'lib'
+
+require 'rubygems'
+
+require 'instance_accountant/cli'
+
+InstanceAccountant::CLI.start

data/instance_accountant.gemspec

@@ -0,0 +1,43 @@
+# -*- encoding: utf-8 -*-
+
+$LOAD_PATH.unshift 'lib'
+
+require 'instance_accountant'
+
+Gem::Specification.new do |gem|
+  gem.authors       = [ 'Tom Mornini', 'John McKee' ]
+
+  gem.files         = Dir.glob( 'lib/**/*.rb' )
+
+  gem.files        << 'instance_accountant.gemspec'
+  gem.files        << 'LICENSE.txt'
+  gem.files        << 'Rakefile'
+  gem.files        << 'README.md'
+
+  gem.test_files    = Dir.glob( 'spec/**/*.rb' )
+
+  gem.name          = 'instance_accountant'
+  gem.description   = 'account for hourly instance usage using Subledger'
+  gem.summary       = 'account for hourly instance usage using Subledger'
+  gem.version       = InstanceAccountant::VERSION
+  gem.email         = 'admin@subledger.com'
+  gem.licenses      = ['BSD 3-Clause']
+
+  gem.homepage      = 'https://github.com/subledger/instance_accountant'
+
+  gem.bindir        = 'bin'
+  gem.executables   = 'instance_accountant'
+
+  gem.add_runtime_dependency     'subledger',          '~> 0.7'
+  gem.add_runtime_dependency     'thor',               '~> 0.19'
+
+  gem.add_development_dependency 'guard',              '~> 2.8'
+  gem.add_development_dependency 'guard-minitest',     '~> 2.3'
+  gem.add_development_dependency 'guard-rubocop',      '~> 1.1'
+  gem.add_development_dependency 'minitest',           '~> 5.4'
+  gem.add_development_dependency 'rake',               '~> 10.3'
+  gem.add_development_dependency 'rb-fsevent',         '~> 0.9'
+  gem.add_development_dependency 'rspec-expectations', '~> 3.1'
+  gem.add_development_dependency 'rspec-mocks',        '~> 3.1'
+  gem.add_development_dependency 'rubocop',            '~> 0.27'
+end

data/lib/instance_accountant/cli.rb

@@ -0,0 +1,123 @@
+# -*- encoding : utf-8 -*-
+require 'thor'
+
+require 'instance_accountant'
+
+module InstanceAccountant
+  class CLI < Thor
+    desc 'account', 'Accounts for hours in Subledger'
+
+    method_option :filepath,
+                  aliases: :f,
+                  default: '~/.instance_accountant'
+
+    method_option :description,
+                  aliases:  :d,
+                  required: true,
+                  default:  'instance usage for'
+
+    method_option :reference
+
+    method_option :cost,
+                  aliases:  :c,
+                  required: true
+    method_option :cost_description,
+                  default: 'cost for'
+
+    method_option :cost_reference
+
+    method_option :expense_acct,
+                  aliases:  :e,
+                  required: true
+
+    method_option :payable_acct,
+                  aliases:  :p,
+                  required: true
+
+    method_option :price,
+                  aliases: :p
+
+    method_option :price_description,
+                  default: 'price for'
+
+    method_option :price_reference
+
+    method_option :income_acct,
+                  aliases: :i
+
+    method_option :receivable_acct,
+                  aliases: :r
+
+    method_option :key_id,
+                  aliases:  :k,
+                  required: true
+
+    method_option :secret,
+                  aliases:  :s,
+                  required: true
+
+    method_option :org_id,
+                  aliases:  :o,
+                  required: true
+
+    method_option :book_id,
+                  aliases:  :b,
+                  required: true
+
+    method_option :daemon, type: :boolean
+
+    SIGNALS = []
+
+    TWENTY_MINUTES = 20 * 60
+
+    %w(ABRT ALRM HUP INT STOP TERM QUIT).each do |signal|
+      Signal.trap signal do
+        SIGNALS << signal
+      end
+    end
+
+    def account
+      if price_but_not_income_and_receivable options
+        STDERR.puts '--price requires --income_acct and --receivable_acct'
+        exit 0
+      end
+
+      i = 0
+
+      loop do
+        consider_posting i, options
+        consider_exiting
+        sleep 1
+        i += 1
+      end
+    end
+
+    private
+
+    def consider_posting i, options
+      Poster.new(options).post(Hour.new, Time.now) if posting_required? i
+    end
+
+    def posting_required? i
+      (i % TWENTY_MINUTES).zero? or signal?
+    end
+
+    def consider_exiting
+      exit 1 if signal?
+      exit 0 if not_daemon?
+    end
+
+    def signal?
+      SIGNALS.length > 0
+    end
+
+    def not_daemon?
+      options[:daemon].nil?
+    end
+
+    def price_but_not_income_and_receivable options
+      options[:price] and
+        ! (options[:income_acct] and options[:receivable_acct])
+    end
+  end
+end

data/lib/instance_accountant/filer.rb

@@ -0,0 +1,37 @@
+# -*- encoding : utf-8 -*-
+
+module InstanceAccountant
+  class Filer
+    def initialize options = { }
+      @file_klass = options[:file_klass] || File
+      @time_klass = options[:time_klass] || Time
+
+      @filepath = @file_klass.expand_path options[:filepath]
+    end
+
+    def read
+      @time_klass.parse @file_klass.open( @filepath,
+                                          File::RDWR | File::CREAT,
+                                          0644 ) do |file|
+        file.flock File::LOCK_EX
+        file.read
+      end
+    rescue
+      nil
+    end
+
+    def write hour
+      hour_string = hour.to_s
+
+      @file_klass.open( @filepath,
+                        File::RDWR | File::CREAT,
+                        0644 ) do |file|
+        file.flock File::LOCK_EX
+        file.rewind
+        file.write hour_string
+      end
+
+      hour_string
+    end
+  end
+end

data/lib/instance_accountant/hour.rb

@@ -0,0 +1,28 @@
+# -*- encoding : utf-8 -*-
+require 'time'
+
+module InstanceAccountant
+  class Hour
+    def initialize options = { }
+      @time = options[:time] ? options[:time].utc : now(options)
+    end
+
+    def == other
+      hour_string == other.hour_string
+    end
+
+    def to_s
+      @time.iso8601
+    end
+
+    def hour_string
+      to_s[0..12] + ':00:00Z'
+    end
+
+    private
+
+    def now options
+      (options[:time_klass] || ::Time).now.utc
+    end
+  end
+end

data/lib/instance_accountant/journal_entry.rb

@@ -0,0 +1,116 @@
+# -*- encoding : utf-8 -*-
+require 'subledger'
+
+module InstanceAccountant
+  class JournalEntry
+    def initialize options = { }
+      @options = options
+
+      @subledger = options[:subledger] || Subledger.new(@options.dup)
+    end
+
+    def hash_for hour, now
+      hour_string = hour.hour_string
+
+      lines = cost_lines hour_string
+
+      lines += price_lines(hour_string) if include_price_lines?
+
+      hash = {
+        effective_at: now,
+        description:  description(hour_string),
+        lines:        lines
+      }
+
+      hash.merge!(reference: @options[:reference]) if @options[:reference]
+
+      hash
+    end
+
+    private
+
+    def include_price_lines?
+      @options[:receivable_acct]     and
+        @options[:income_acct]       and
+        @options[:price]
+    end
+
+    def description hour_string
+      format @options[:description], hour_string
+    end
+
+    def cost_lines hour_string
+      lines = [ ]
+
+      common = { description: @options[:cost_description],
+                 reference:   @options[:cost_reference] }
+
+      lines << complete(
+                 hour_string,
+                 common.merge( account: expense_acct,
+                               value:   @subledger.debit(@options[:cost]) ) )
+
+      lines << complete(
+                 hour_string,
+                 common.merge( account: payable_acct,
+                               value:   @subledger.credit(@options[:cost]) ) )
+
+      lines
+    end
+
+    def price_lines hour_string
+      lines = [ ]
+
+      common = { description: @options[:price_description],
+                 reference:   @options[:price_reference] }
+
+      lines << complete(
+                 hour_string,
+                 common.merge( account: receivable_acct,
+                               value:   @subledger.debit(@options[:price]) ) )
+
+      lines << complete(
+                 hour_string,
+                 common.merge( account: income_acct,
+                               value:   @subledger.credit(@options[:price]) ) )
+
+      lines
+    end
+
+    def complete hour_string, args
+      description = args[:description].nil? ? nil : description(hour_string)
+
+      if description
+        args.merge! description: description
+      else
+        args.delete :description
+      end
+
+      reference = args[:reference]
+
+      if reference
+        args.merge! reference: reference
+      else
+        args.delete :reference
+      end
+
+      args
+    end
+
+    def expense_acct
+      @subledger.account id: @options[:expense_acct]
+    end
+
+    def payable_acct
+      @subledger.account id: @options[:payable_acct]
+    end
+
+    def receivable_acct
+      @subledger.account id: @options[:receivable_acct]
+    end
+
+    def income_acct
+      @subledger.account id: @options[:income_acct]
+    end
+  end
+end

data/lib/instance_accountant/poster.rb

@@ -0,0 +1,52 @@
+# -*- encoding : utf-8 -*-
+require 'subledger'
+
+require 'time'
+
+require 'instance_accountant/filer'
+require 'instance_accountant/hour'
+require 'instance_accountant/journal_entry'
+
+module InstanceAccountant
+  class Poster
+    def initialize options = { }
+      @options = options
+
+      @time_klass = @options[:time_klass] || Time
+      @hour_klass = @options[:hour_klass] || Hour
+
+      @subledger     = @options[:subledger]     || Subledger.new(@options.dup)
+      @filer         = @options[:filer]         || Filer.new(@options)
+      @journal_entry = @options[:journal_entry] || JournalEntry.new(@options)
+    end
+
+    def post hour, now
+      if posted? hour
+        false
+      else
+        write hour, now
+        true
+      end
+    end
+
+    private
+
+    def posted? hour
+      file_time = @filer.read
+
+      if file_time.nil?
+        false
+      else
+        @hour_klass.new( time: file_time ) == hour
+      end
+    end
+
+    def write hour, now
+      @subledger
+        .journal_entry
+        .create_and_post( @journal_entry.hash_for hour, now )
+
+      @filer.write hour
+    end
+  end
+end

data/lib/instance_accountant.rb

@@ -0,0 +1,8 @@
+# -*- encoding : utf-8 -*-
+require 'instance_accountant/filer'
+require 'instance_accountant/hour'
+require 'instance_accountant/poster'
+
+module InstanceAccountant
+  VERSION = '0.0.1'
+end

data/spec/helpers/minitest.rb

@@ -0,0 +1,83 @@
+# -*- encoding : utf-8 -*-
+require 'singleton'
+
+gem 'minitest'
+
+require 'minitest/spec'
+
+require 'minitest/pride' unless ENV['SUBLEDGER_ENV'] == 'ci'
+
+require 'minitest/autorun'
+
+MiniTest::Test.parallelize_me!
+
+module Kernel
+  def Class thing, &block
+    describe_set_subject thing, &block
+  end
+
+  def Constant thing, &block
+    describe_set_subject thing, &block
+  end
+
+  def Module thing, &block
+    describe_set_subject thing, &block
+  end
+
+  def Instance &block
+    describe 'instance', &block
+  end
+
+  def RespondsTo desc, &block
+    describe "responds to #{desc}", &block
+  end
+
+  def When desc, &block
+    describe "when #{desc}", &block
+  end
+
+  def And desc, &block
+    describe "and #{desc}", &block
+  end
+
+  def RoleTest desc
+    load Subledger::ROOT + "/spec/roles/#{desc}_spec.rb"
+  end
+
+  private
+
+  # Thanks Anton Lindqvist!
+  # https://github.com/mptre/minitest-implicit-subject
+
+  def describe_set_subject *args, &block
+    cls = describe *args, &block
+
+    subject = args.first
+
+    if subject.respond_to?(:included_modules) &&
+       Array(subject.included_modules).include?(Singleton)
+
+      subject = subject.instance
+    end
+
+    cls.subject { subject }
+
+    cls
+  end
+end
+
+module MiniTest
+  class Spec
+    def self.ByRaising desc, &block
+      it "by raising #{desc}", &block
+    end
+
+    def self.ByReturning desc, &block
+      it "by returning #{desc}", &block
+    end
+
+    def self.ByYielding desc, &block
+      it "by yielding #{desc}", &block
+    end
+  end
+end

data/spec/helpers/rspec.rb

@@ -0,0 +1,25 @@
+# -*- encoding : utf-8 -*-
+require 'rspec/expectations'
+require 'rspec/mocks'
+
+module MiniTest
+  class Test
+    include ::RSpec::Mocks::ExampleMethods
+
+    def before_setup
+      ::RSpec::Mocks.setup
+      super
+    end
+
+    def after_teardown
+      super
+      ::RSpec::Mocks.verify
+    ensure
+      ::RSpec::Mocks.teardown
+    end
+  end
+
+  class Spec
+    include RSpec::Matchers
+  end
+end

data/spec/helpers.rb

@@ -0,0 +1,9 @@
+# -*- encoding : utf-8 -*-
+
+require 'rubygems'
+require 'bundler'
+
+Bundler.setup
+
+require 'helpers/minitest'
+require 'helpers/rspec'

data/spec/instance_accountant/cli_spec.rb

@@ -0,0 +1,7 @@
+# -*- encoding : utf-8 -*-
+require 'helpers'
+
+require 'instance_accountant/cli'
+
+module InstanceAccountant
+end

data/spec/instance_accountant/filer_spec.rb

@@ -0,0 +1,72 @@
+# -*- encoding : utf-8 -*-
+require 'helpers'
+
+require 'instance_accountant/filer'
+
+module InstanceAccountant
+  Class File do
+    Instance do
+      subject { Filer.new options }
+
+      let(:options) do
+        {
+          filepath:   filepath,
+          file_klass: file_klass,
+          time_klass: time_klass
+        }
+      end
+
+      let(:filepath)          { double 'filepath'          }
+      let(:expanded_filepath) { double 'expanded_filepath' }
+      let(:file_klass)        { double 'file_klass'        }
+      let(:time_klass)        { double 'time_klass'        }
+      let(:time_inst)         { double 'time_inst'         }
+
+      let(:time_string)       { double 'time_string' }
+      let(:hour)              { double 'hour'        }
+
+      RespondsTo :read do
+        When 'it has been written before' do
+          ByReturning 'a Time' do
+            expect(file_klass)
+              .to receive(:expand_path)
+              .with(filepath)
+              .and_return(expanded_filepath)
+
+            expect(file_klass)
+              .to receive(:open)
+              .with(expanded_filepath, File::RDWR | File::CREAT, 0644)
+              .and_return(time_string)
+
+            expect(time_klass)
+              .to receive(:parse)
+              .with(time_string)
+              .and_return(time_inst)
+
+            subject.read.must_be_same_as time_inst
+          end
+        end
+      end
+
+      RespondsTo :write do
+        ByReturning 'the hour' do
+          expect(file_klass)
+            .to receive(:expand_path)
+            .with(filepath)
+            .and_return(expanded_filepath)
+
+          expect(hour)
+            .to receive(:to_s)
+            .and_return(time_string)
+
+          expect(file_klass)
+            .to receive(:open)
+            .with(expanded_filepath, File::RDWR | File::CREAT, 0644)
+            .and_return(time_string)
+
+          subject.write(hour).must_be_same_as time_string
+        end
+      end
+    end
+  end
+end

data/spec/instance_accountant/hour_spec.rb

@@ -0,0 +1,136 @@
+# -*- encoding : utf-8 -*-
+require 'helpers'
+
+require 'instance_accountant/hour'
+
+module InstanceAccountant
+  Class Hour do
+    Instance do
+      subject { Hour.new options }
+
+      let(:options) do
+        {
+          time_klass: time_klass
+        }
+      end
+
+      let(:time_klass)  { double 'time_klass'     }
+
+      let(:time_local)  { double 'time_local'     }
+      let(:time_utc)    { double 'time_utc'       }
+      let(:time_iso)    { double 'time_iso'       }
+      let(:hour_string) { double 'hour_string'    }
+
+      let(:other_hour)        { double 'other_hour'        }
+      let(:other_hour_string) { double 'other_hour_string' }
+
+      let(:other_time_local)  { double 'other_time_local'  }
+      let(:other_time_utc)    { double 'other_time_utc'    }
+      let(:other_time_iso)    { double 'other_time_iso'    }
+
+      RespondsTo :to_s do
+        ByReturning 'an hour string' do
+          expect(time_klass)
+            .to receive(:now)
+            .and_return(time_local)
+
+          expect(time_local)
+            .to receive(:utc)
+            .and_return(time_utc)
+
+          expect(time_utc)
+            .to receive(:iso8601)
+            .and_return(time_iso)
+
+          subject.to_s.must_equal time_iso
+        end
+      end
+
+      RespondsTo :hour_string do
+        ByReturning 'an hour string' do
+          expect(time_klass)
+            .to receive(:now)
+            .and_return(time_local)
+
+          expect(time_local)
+            .to receive(:utc)
+            .and_return(time_utc)
+
+          expect(time_utc)
+            .to receive(:iso8601)
+            .and_return('2014-11-05T00')
+
+          subject.hour_string.must_equal '2014-11-05T00:00:00Z'
+        end
+      end
+
+      RespondsTo :== do
+        When 'other is equal' do
+          ByReturning true do
+
+            expect(time_klass)
+              .to receive(:now)
+              .and_return(time_local)
+
+            expect(time_local)
+              .to receive(:utc)
+              .and_return(time_utc)
+
+            expect(time_utc)
+              .to receive(:iso8601)
+              .and_return(time_iso)
+
+            expect(time_iso)
+              .to receive(:[])
+              .with(0..12)
+              .and_return(hour_string)
+
+            expect(other_hour)
+              .to receive(:hour_string)
+              .and_return(hour_string)
+
+            expect(hour_string)
+              .to receive(:+)
+              .with(':00:00Z')
+              .and_return(hour_string)
+
+            (subject == other_hour).must_equal true
+          end
+        end
+
+        When 'other is not equal' do
+          ByReturning false do
+
+            expect(time_klass)
+              .to receive(:now)
+              .and_return(time_local)
+
+            expect(time_local)
+              .to receive(:utc)
+              .and_return(time_utc)
+
+            expect(time_utc)
+              .to receive(:iso8601)
+              .and_return(time_iso)
+
+            expect(time_iso)
+              .to receive(:[])
+              .with(0..12)
+              .and_return(hour_string)
+
+            expect(hour_string)
+              .to receive(:+)
+              .with(':00:00Z')
+              .and_return(hour_string)
+
+            expect(other_hour)
+              .to receive(:hour_string)
+              .and_return(other_hour_string)
+
+            (subject == other_hour).must_equal false
+          end
+        end
+      end
+    end
+  end
+end

data/spec/instance_accountant/journal_entry_spec.rb

@@ -0,0 +1,178 @@
+# -*- encoding : utf-8 -*-
+require 'helpers'
+
+require 'instance_accountant/journal_entry'
+
+module InstanceAccountant
+  Class JournalEntry do
+    Instance do
+      let(:options) do
+        {
+          subledger:    subledger,
+          description:  description,
+          cost:         cost,
+          expense_acct: expense_acct,
+          payable_acct: payable_acct
+        }
+      end
+
+      let(:price_options) do
+        {
+          price:           price,
+          income_acct:     income_acct,
+          receivable_acct: receivable_acct
+        }
+      end
+
+      let(:subledger)    { double 'subledger'         }
+      let(:description)  { 'description with time %s' }
+
+      let(:cost)         { double 'cost'         }
+      let(:expense_acct) { double 'expense_acct' }
+      let(:payable_acct) { double 'payable_acct' }
+
+      let(:price)           { double 'price'           }
+      let(:income_acct)     { double 'income_acct'     }
+      let(:receivable_acct) { double 'receivable_acct' }
+
+      let(:expense_debit)  { double 'expense_debit'  }
+      let(:payable_credit) { double 'payable_credit' }
+
+      let(:receivable_debit) { double 'receivable_debit' }
+      let(:income_credit)    { double 'income_credit'    }
+
+      let(:concat_desc) { 'description with time 2014-11-05T18:00:00Z' }
+
+      let(:hour)        { double 'hour' }
+      let(:hour_string) { '2014-11-05T18:00:00Z' }
+
+      let(:now)  { double 'now'  }
+
+      RespondsTo :hash_for do
+        When 'price lines are not included' do
+          subject { JournalEntry.new options }
+
+          ByReturning true do
+            expect(hour)
+              .to receive(:hour_string)
+              .and_return(hour_string)
+
+            expect(subledger)
+              .to receive(:account)
+              .with(id: expense_acct)
+              .and_return(expense_acct)
+
+            expect(subledger)
+              .to receive(:debit)
+              .with(cost)
+              .and_return(expense_debit)
+
+            expect(subledger)
+              .to receive(:account)
+              .with(id: payable_acct)
+              .and_return(payable_acct)
+
+            expect(subledger)
+              .to receive(:credit)
+              .with(cost)
+              .and_return(payable_credit)
+
+            # expect(description)
+            #   .to receive(:+)
+            #   .and_return(concat_desc)
+
+            subject.hash_for(hour, now)
+              .must_equal effective_at: now,
+                          description:  concat_desc,
+                          lines: [
+                            {
+                              account: expense_acct,
+                              value:   expense_debit
+                            },
+                            {
+                              account: payable_acct,
+                              value:   payable_credit
+                            }
+                          ]
+          end
+        end
+
+        When 'price lines are included' do
+          subject { JournalEntry.new options.merge price_options }
+
+          ByReturning true do
+            expect(hour)
+              .to receive(:hour_string)
+              .and_return(hour_string)
+
+            expect(subledger)
+              .to receive(:account)
+              .with(id: expense_acct)
+              .and_return(expense_acct)
+
+            expect(subledger)
+              .to receive(:debit)
+              .with(cost)
+              .and_return(expense_debit)
+
+            expect(subledger)
+              .to receive(:account)
+              .with(id: payable_acct)
+              .and_return(payable_acct)
+
+            expect(subledger)
+              .to receive(:credit)
+              .with(cost)
+              .and_return(payable_credit)
+
+            expect(subledger)
+              .to receive(:account)
+              .with(id: receivable_acct)
+              .and_return(receivable_acct)
+
+            expect(subledger)
+              .to receive(:debit)
+              .with(price)
+              .and_return(receivable_debit)
+
+            expect(subledger)
+              .to receive(:account)
+              .with(id: income_acct)
+              .and_return(income_acct)
+
+            expect(subledger)
+              .to receive(:credit)
+              .with(price)
+              .and_return(income_credit)
+
+            # expect(description)
+            #   .to receive(:+)
+            #   .and_return(concat_desc)
+
+            subject.hash_for(hour, now)
+              .must_equal effective_at: now,
+                          description:  concat_desc,
+                          lines: [
+                            {
+                              account: expense_acct,
+                              value:   expense_debit
+                            },
+                            {
+                              account: payable_acct,
+                              value:   payable_credit
+                            },
+                            {
+                              account: receivable_acct,
+                              value:   receivable_debit
+                            },
+                            {
+                              account: income_acct,
+                              value:   income_credit
+                            }
+                          ]
+          end
+        end
+      end
+    end
+  end
+end

data/spec/instance_accountant/poster_spec.rb

@@ -0,0 +1,109 @@
+# -*- encoding : utf-8 -*-
+require 'helpers'
+
+require 'instance_accountant/poster'
+
+module InstanceAccountant
+  Class Poster do
+    Instance do
+      subject { Poster.new options }
+
+      let(:options) do
+        {
+          subledger:         subledger,
+          filer:             filer,
+          hour_klass:        hour_klass,
+          journal_entry:     journal_entry
+        }
+      end
+
+      let(:subledger)          { double 'subledger'          }
+      let(:sl_journal_entry)   { double 'sl_journal_entry'   }
+
+      let(:filer)              { double 'filer'              }
+      let(:hour_klass)         { double 'hour_klass'         }
+      let(:journal_entry)      { double 'journal_entry'      }
+
+      let(:journal_entry_hash) { double 'journal_entry_hash' }
+      let(:hour)               { double 'hour'               }
+      let(:different_hour)     { double 'different_hour'     }
+      let(:now)                { double 'now'                }
+
+      RespondsTo :post do
+        When 'no hours have been posted' do
+          ByReturning true do
+            expect(filer)
+              .to receive(:read)
+              .and_return(nil)
+
+            expect(journal_entry)
+              .to receive(:hash_for)
+              .with(hour, now)
+              .and_return(journal_entry_hash)
+
+            expect(filer)
+              .to receive(:write)
+              .with(hour)
+
+            expect(subledger)
+              .to receive(:journal_entry)
+              .and_return(sl_journal_entry)
+
+            expect(sl_journal_entry)
+              .to receive(:create_and_post)
+              .with(journal_entry_hash)
+
+            subject.post(hour, now).must_equal true
+          end
+        end
+
+        When 'the hour has not been posted' do
+          ByReturning true do
+            expect(filer)
+              .to receive(:read)
+              .and_return(different_hour)
+
+            expect(hour_klass)
+              .to receive(:new)
+              .with(time: different_hour)
+              .and_return(different_hour)
+
+            expect(journal_entry)
+              .to receive(:hash_for)
+              .with(hour, now)
+              .and_return(journal_entry_hash)
+
+            expect(subledger)
+              .to receive(:journal_entry)
+              .and_return(sl_journal_entry)
+
+            expect(sl_journal_entry)
+              .to receive(:create_and_post)
+              .with(journal_entry_hash)
+
+            expect(filer)
+              .to receive(:write)
+              .with(hour)
+
+            subject.post(hour, now).must_equal true
+          end
+        end
+
+        When 'the hour has been posted' do
+          ByReturning false do
+            expect(filer)
+              .to receive(:read)
+              .and_return(hour)
+
+            expect(hour_klass)
+              .to receive(:new)
+              .with(time: hour)
+              .and_return(hour)
+
+            subject.post(hour, now).must_equal false
+          end
+        end
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,226 @@
+--- !ruby/object:Gem::Specification
+name: instance_accountant
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Tom Mornini
+- John McKee
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-11-05 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: subledger
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.19'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.19'
+- !ruby/object:Gem::Dependency
+  name: guard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.8'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.8'
+- !ruby/object:Gem::Dependency
+  name: guard-minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.3'
+- !ruby/object:Gem::Dependency
+  name: guard-rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.4'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.3'
+- !ruby/object:Gem::Dependency
+  name: rb-fsevent
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+- !ruby/object:Gem::Dependency
+  name: rspec-expectations
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+- !ruby/object:Gem::Dependency
+  name: rspec-mocks
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.27'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.27'
+description: account for hourly instance usage using Subledger
+email: admin@subledger.com
+executables:
+- instance_accountant
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/instance_accountant
+- instance_accountant.gemspec
+- lib/instance_accountant.rb
+- lib/instance_accountant/cli.rb
+- lib/instance_accountant/filer.rb
+- lib/instance_accountant/hour.rb
+- lib/instance_accountant/journal_entry.rb
+- lib/instance_accountant/poster.rb
+- spec/helpers.rb
+- spec/helpers/minitest.rb
+- spec/helpers/rspec.rb
+- spec/instance_accountant/cli_spec.rb
+- spec/instance_accountant/filer_spec.rb
+- spec/instance_accountant/hour_spec.rb
+- spec/instance_accountant/journal_entry_spec.rb
+- spec/instance_accountant/poster_spec.rb
+homepage: https://github.com/subledger/instance_accountant
+licenses:
+- BSD 3-Clause
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.2
+signing_key: 
+specification_version: 4
+summary: account for hourly instance usage using Subledger
+test_files:
+- spec/helpers/minitest.rb
+- spec/helpers/rspec.rb
+- spec/helpers.rb
+- spec/instance_accountant/cli_spec.rb
+- spec/instance_accountant/filer_spec.rb
+- spec/instance_accountant/hour_spec.rb
+- spec/instance_accountant/journal_entry_spec.rb
+- spec/instance_accountant/poster_spec.rb