mortgage_calc 0.1.5

data/Manifest

@@ -0,0 +1,11 @@
+README.rdoc
+Rakefile
+Version.yml
+features/apr.feature
+features/step_definitions/apr_steps.rb
+features/support/env.rb
+lib/mortgage_calc.rb
+lib/mortgage_calc/mortgage_util.rb
+spec/mortgage_calc/mortgage_util_spec.rb
+spec/spec_helper.rb
+Manifest

data/README.rdoc

@@ -0,0 +1,47 @@
+= mortgage_calc
+
+Calculates mortgage APR, monthly payments, and fees.
+
+== INSTALL
+  $ sudo gem install gemcutter
+  $ gem tumble
+  $ sudo gem install mortgage_calc
+or add the following to your <b>environment.rb</b>
+  config.gem 'mortgage_calc'
+
+==Example:
+    loan_amount = 350000
+    interest_rate = 4.75
+    period = 30 * 12
+    lender_fee = 800
+    points = 1.0
+
+    mort_calc = MortgageCalc::MortgageUtil.new(loan_amount, interest_rate, period, lender_fee, points)
+    
+    mort_calc.apr
+    mort_calc.monthly_payment
+    mort_calc.monthly_payment_with_fees
+    mort_calc.total_fees
+
+==Formulas used
+===Monthly payment with fees
+    P = [(C + E) r (1 + r)^N]/[(1 + r)^N - 1]
+
+    P = monthly payment
+    C = Loan amount
+    r = Interest rate
+    N = Period in months
+    E = Lender fees
+
+===Monthly payment without fees is calculated like above with E = 0.
+
+===APR
+    [a (1 + a)^N] / [(1 + a)^N - 1] - P/C = 0
+    a = A/1200
+    N = Period in months
+    P = Monthly payment
+    C = Loan amount
+
+===Total fees
+Total fees are calculated simply by adding Lender fees to the points paid by borrower.
+    T = E + P(C)

data/Rakefile

@@ -0,0 +1,37 @@
+require 'rubygems'
+require 'rake'
+require 'echoe'
+require 'spec'
+require 'cucumber'
+require 'lib/mortgage_calc'
+
+require 'cucumber/rake/task'
+require 'spec/rake/spectask'
+
+Echoe.new("mortgage_calc", MortgageCalc::VERSION) do |p|
+  p.description = "Mortgage utilities"
+  p.url = "http://github.com/pathfinderdev/mortgage_calc"
+  p.author = "Perry Hertler"
+  p.email = "phertler@pathf.com"
+  p.ignore_pattern = ["tmp/*", "script/*, .idea/*"]
+  p.development_dependencies = []
+end
+
+Dir["#File.dirname(__FILE__)}/tasks/*.rake"].sort.each { |ext| load ext }
+
+spec_files = Rake::FileList["spec/**/*_spec.rb"]
+
+desc "Run specs"
+Spec::Rake::SpecTask.new do |t|
+  t.spec_files = spec_files
+  t.spec_opts = ["-c"]
+end
+
+Cucumber::Rake::Task.new(:features) do |t|
+  t.cucumber_opts = "features --format progress"
+end
+
+task :default => [:spec, :features]
+
+
+

data/Version.yml

@@ -0,0 +1,4 @@
+---
+:major: 0
+:minor: 1
+:patch: 5

data/features/apr.feature

@@ -0,0 +1,19 @@
+Feature Calculate APR
+  In order to show sorted APR search results
+  As a person navigating OMT
+  I want to see correct APRs
+
+  Scenario Outline: Calculate APR
+    Given <loan_amount>, <fees>, <points>, <rate>, <period>
+    Then the resultant apr should be <apr>
+
+  Scenarios: with APR fields
+    | loan_amount | fees  | points  | rate   | period | apr   |
+    | 125000      | 5000  | 0       | 6.5    | 360    | 6.881 |
+    | 125000      | 5000  | -1.25   | 6.5    | 360    | 6.881 |
+    | 400000      | 1200  | 0       | 5.25   | 180    | 5.296 |
+    | 125000      | 811   | 0.375   | 6.125  | 360    | 6.221 |
+    | 125000      | 811   | -0.375  | 6.5    | 360    | 6.562 |
+    | 100000      | 1000  | 0       | 7.0    | 360    | 7.099 |
+    | 100000      | 0     | 0       | 7.0    | 360    | 7.0   |
+    | 250000      | 3135  | 2.125   | 6.5    | 360    | 6.822 |

data/features/step_definitions/apr_steps.rb

@@ -0,0 +1,7 @@
+Given /^(.*), (.*), (.*), (.*), (.*)$/ do |loan_amount, fees, points, rate, period|
+  @mortgage_util = MortgageCalc::MortgageUtil.new(Integer(loan_amount), Float(rate), Integer(period), Float(fees), Float(points))
+end
+
+Then /^the resultant apr should be (.*)$/ do |apr_expected|
+  @mortgage_util.apr.should be_close(Float(apr_expected), 0.001)
+end

data/features/support/env.rb

@@ -0,0 +1,5 @@
+$LOAD_PATH << File.join(File.dirname(__FILE__),"..","..","lib")
+require 'mortgage_calc'
+require 'spec/expectations'
+require 'spec/matchers'
+require 'spec/stubs/cucumber'

data/lib/mortgage_calc/mortgage_util.rb

@@ -0,0 +1,58 @@
+module MortgageCalc
+  class MortgageUtil
+    attr_accessor :loan_amount, :interest_rate, :period, :lender_fee, :points
+
+    def initialize(loan_amount, interest_rate, period=360, lender_fee=0, points=0.0)
+      self.loan_amount = Float(loan_amount.to_s)
+      self.interest_rate = Float(interest_rate.to_s)
+      self.period = Integer(period.to_s)
+      self.lender_fee = lender_fee
+      self.points = Float(points.to_s)
+    end
+
+    def apr
+      calculate_apr_with_newton_raphson(self.period, monthly_payment_with_fees, self.loan_amount, monthly_interst_rate + 1)
+    end
+
+    def monthly_payment
+      calculate_monthly_payment(self.loan_amount, monthly_interst_rate, self.period)
+    end
+
+    def monthly_payment_with_fees
+      calculate_monthly_payment(self.loan_amount + total_fees, monthly_interst_rate, self.period)
+    end
+
+    def total_fees
+      buyer_points = self.points <= 0 ? 0 : self.points
+      self.lender_fee + (self.loan_amount * buyer_points.abs/100)
+    end
+
+    private
+    def monthly_interst_rate
+      self.interest_rate / 100 / 12
+    end
+
+    def calculate_monthly_payment(amount, monthly_rate, period)
+      amount * (monthly_rate/(1 - (1 + monthly_rate)**(-period)))
+    end
+
+    # solves APR
+    # where a = APR/1200, N = period, P = monthly payment, C = loan_amount
+    # calculate APR uses the Newton-Raphson to find the root (the value for 'a' that makes f(a) = 0)
+    # for best performance call this with 'start'= interest rate
+    def calculate_apr_with_newton_raphson(periods, monthly_payment, loan_amount, start=1.1)
+      payment_ratio = monthly_payment / loan_amount
+      f = lambda {|k| (k**(periods + 1) - (k**periods * (payment_ratio + 1)) + payment_ratio)}
+      f_slope = lambda { |k| ((periods + 1) * k**periods) - (periods * (payment_ratio + 1) * k**(periods - 1))}
+
+      k_plus_one = start
+      k = 0.0
+
+      while ((k - 1) * 100000).to_f.floor !=  ((k_plus_one - 1) * 100000).to_f.floor
+        k = k_plus_one
+        k_plus_one = k - f.call(k) / f_slope.call(k)
+      end
+      100 * 12 * (k_plus_one - 1).to_f
+    end
+  end
+end

data/lib/mortgage_calc.rb

@@ -0,0 +1,9 @@
+$:.unshift(File.dirname(__FILE__)) unless $:.include?(File.dirname(__FILE__)) || $:.include?(File.expand_path(File.dirname(__FILE__)))
+require 'yaml'
+
+module MortgageCalc
+  version = YAML.load_file(File.dirname(__FILE__) + "/../Version.yml")
+  VERSION = "#{version[:major]}.#{version[:minor]}.#{version[:patch]}"
+end
+
+require 'mortgage_calc/mortgage_util'

data/mortgage_calc.gemspec

@@ -0,0 +1,30 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{mortgage_calc}
+  s.version = "0.1.5"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Perry Hertler"]
+  s.date = %q{2010-02-13}
+  s.description = %q{Mortgage utilities}
+  s.email = %q{phertler@pathf.com}
+  s.extra_rdoc_files = ["README.rdoc", "lib/mortgage_calc.rb", "lib/mortgage_calc/mortgage_util.rb"]
+  s.files = ["README.rdoc", "Rakefile", "Version.yml", "features/apr.feature", "features/step_definitions/apr_steps.rb", "features/support/env.rb", "lib/mortgage_calc.rb", "lib/mortgage_calc/mortgage_util.rb", "spec/mortgage_calc/mortgage_util_spec.rb", "spec/spec_helper.rb", "Manifest", "mortgage_calc.gemspec"]
+  s.homepage = %q{http://github.com/pathfinderdev/mortgage_calc}
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Mortgage_calc", "--main", "README.rdoc"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{mortgage_calc}
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{Mortgage utilities}
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end

data/spec/mortgage_calc/mortgage_util_spec.rb

@@ -0,0 +1,61 @@
+require File.join(File.dirname(__FILE__), "..", "spec_helper")
+
+module MortgageCalc
+  describe MortgageUtil do
+    def assert_monthly_apr_payment_matches(loan_amount, rate, period, fee, points)
+      mortgage_util = MortgageUtil.new(loan_amount, rate, period, fee, points)
+      monthly_payment_with_fees = mortgage_util.monthly_payment_with_fees
+      monthly_payment_from_apr = MortgageUtil.new(loan_amount, mortgage_util.apr, period, 0, 0).monthly_payment
+      monthly_payment_with_fees.should be_close(monthly_payment_from_apr, 0.01)
+    end
+
+    context "with valid MortgageUtil" do
+      before(:all) do
+        @mortgage_util = MortgageUtil.new(100000, 6.0, 360, 1200, 1.25)
+        @mortgage_util_with_apr_as_rate = MortgageUtil.new(100000, @mortgage_util.apr, 360, 1200, 1.25)
+      end
+      it "should have proper monthly interest rate" do
+        @mortgage_util.send(:monthly_interst_rate).should == 0.005
+      end
+      it "should have proper monthly payment" do
+        @mortgage_util.monthly_payment.should be_close(599.55, 0.001)
+      end
+      it "should have proper total fees" do
+        @mortgage_util.total_fees.should be_close(2450, 0.001)
+      end
+      it "should have proper APR" do
+        @mortgage_util.apr.should be_close(6.22726, 0.00001)
+      end
+    end
+    it "should calculate original monthly payment from APR" do
+      assert_monthly_apr_payment_matches(300000, 6.5, 360, 1200, 1.25)
+      assert_monthly_apr_payment_matches(300000, 6.5, 360, 0, 0)
+      assert_monthly_apr_payment_matches(400000, 1.1, 180, 1200, 1.25)
+      assert_monthly_apr_payment_matches(300000, 6.5, 360, 0, 7.25)
+      assert_monthly_apr_payment_matches(300000, 6.5, 360, 10000, 7.25)
+    end
+  end
+  context "ignore lender points paid to broker" do
+    it "the fee should not include negative points" do
+      mortgage_util = MortgageUtil.new(100000, 6.0, 360, 1200, -1.25)
+      1200.should == mortgage_util.total_fees
+    end
+  end
+  context "initialize convert to best types" do
+    before(:all) do
+      @mortgage_util =  MortgageUtil.new('100000', '6.0', 360, 1200, '-1.25')
+    end
+    it "should convert rate to float if necessary" do
+       @mortgage_util.interest_rate.type.should == Float
+    end
+    it "should convert points to float if necessary" do
+      @mortgage_util.points.type.should == Float
+    end
+    it "should convert loan_amount to float if necessary" do
+      @mortgage_util.loan_amount.type.should == Float
+    end
+    it "should convert period to integer if necessary" do
+      @mortgage_util.period.type.should == Fixnum
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,3 @@
+$LOAD_PATH << File.join(File.dirname(__FILE__),"..","lib")
+require 'spec'
+require 'mortgage_calc'

metadata

@@ -0,0 +1,73 @@
+--- !ruby/object:Gem::Specification 
+name: mortgage_calc
+version: !ruby/object:Gem::Version 
+  version: 0.1.5
+platform: ruby
+authors: 
+- Perry Hertler
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-02-13 00:00:00 -06:00
+default_executable: 
+dependencies: []
+
+description: Mortgage utilities
+email: phertler@pathf.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.rdoc
+- lib/mortgage_calc.rb
+- lib/mortgage_calc/mortgage_util.rb
+files: 
+- README.rdoc
+- Rakefile
+- Version.yml
+- features/apr.feature
+- features/step_definitions/apr_steps.rb
+- features/support/env.rb
+- lib/mortgage_calc.rb
+- lib/mortgage_calc/mortgage_util.rb
+- spec/mortgage_calc/mortgage_util_spec.rb
+- spec/spec_helper.rb
+- Manifest
+- mortgage_calc.gemspec
+has_rdoc: true
+homepage: http://github.com/pathfinderdev/mortgage_calc
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --line-numbers
+- --inline-source
+- --title
+- Mortgage_calc
+- --main
+- README.rdoc
+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: "1.2"
+  version: 
+requirements: []
+
+rubyforge_project: mortgage_calc
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: Mortgage utilities
+test_files: []
+