finance_rb 0.1.2 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3f920db19ed5b406b8e263c09fac4aba9cd203ebdca989c096b44b441753757e
-  data.tar.gz: 435cd054975eee4b5027245d0301551b1b0cfd889153879f02929f1885d55f77
+  metadata.gz: d76ff15f6be262332aa729708a548d775f1caaaefaa3135c1d545660c34717ca
+  data.tar.gz: 2d75e526b34bf1704686e3fb9bf5198b4b2d302f05e714207d8d06833ce96acf
 SHA512:
-  metadata.gz: 15fa362a606eacc22aeff3c89312bbedbfbe2d78319b66cd3c146a985a6c5a68114fcb1601986facdc823fa14b03a798708faae3adf704aad8c8ee89c59ec07b
-  data.tar.gz: c96d0f272ccee5c88cab312981f7795bac101e7bd3b229b88cfb34f05db3334b63bc61d9f41f13404105c6b6ab6bd4d318ecf3ad98ac89dbe443f1cc920a453a
+  metadata.gz: 9545eebb0c540d6e5f3d75cdbf8a5b7fabe0ed75860601dd278f2c0b13ca05285a9d0865d978837532c92c2fb70815c5f450a10d6ff7bd008330ae81ac4d915b
+  data.tar.gz: bffcb93c73279bea34db04dbc39d0b6747e9d609e91a3a5f8006aaefe6ca08be2a4109b033b622a3382a4232a4e3ffba4d1a2eb168fbf6f1e6fe73fd971ab20c

data/README.md

@@ -14,7 +14,7 @@ which are as follows:
 | fv                           |   ✅    |   Computes the  future value|
 | ipmt                         |   ✅   |   Computes interest payment for a loan|
 | pmt                          |  ✅    |   Computes the fixed periodic payment(principal + interest) made against a loan amount|
-| ppmt                         |       |   Computes principal payment for a loan|
+| ppmt                         |   ✅   |   Computes principal payment for a loan|
 | nper                         |       |    Computes the number of periodic payments|
 | pv                           |       |   Computes the present value of a payment|
 | rate                         |     |    Computes the rate of interest per period|

data/lib/finance/loan.rb

@@ -80,7 +80,7 @@ module Finance
           (factor - 1) * (1 + monthly_rate * ptype) / monthly_rate
         end
 
-      (-future_value + amount * factor) / second_factor
+      -((future_value + amount * factor) / second_factor)
     end
 
     # IPmt computes interest payment for a loan under a given period.
@@ -111,6 +111,27 @@ module Finance
       end
     end
 
+    # PPmt computes principal payment for a loan under a given period.
+    #
+    #   Required Loan arguments: period, nominal_rate, duration, amount, future_value*
+    #
+    # @return [Float] Principal payment for a loan under a given period.
+    #
+    # @example
+    #   require 'finance_rb'
+    #   Finance::Loan.new(nominal_rate: 0.0824, duration: 12, amount: 2500, period: 1).ppmt
+    #   #=> -200.58192368678277
+    #
+    # @see http://www.oasis-open.org/committees/documents.php?wg_abbrev=office-formulaOpenDocument-formula-20090508.odt
+    # @see [WRW] Wheeler, D. A., E. Rathke, and R. Weir (Eds.) (2009, May).
+    #   Open Document Format for Office Applications (OpenDocument)v1.2,
+    #   Part 2: Recalculated Formula (OpenFormula) Format - Annotated Version,
+    #   Pre-Draft 12. Organization for the Advancement of Structured Information
+    #   Standards (OASIS). Billerica, MA, USA. [ODT Document].
+    def ppmt
+      pmt - ipmt
+    end
+
     # Fv computes future value at the end of some periods (duration).
     #   Required Loan arguments: nominal_rate, duration, payment, amount*
     #
@@ -156,7 +177,7 @@ module Finance
       self.class.new(
         nominal_rate: nominal_rate.to_f, duration: period - 1.0,
         amount: amount.to_f, ptype: PAYMENT_TYPE_MAPPING.key(ptype)
-      ).fv(payment: -pmt)
+      ).fv(payment: pmt)
     end
   end
 end

data/lib/finance/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Finance
-  VERSION = "0.1.2"
+  VERSION = "0.2.0"
 end

data/spec/finance/loan_spec.rb

@@ -5,37 +5,37 @@ RSpec.describe Finance::Loan do
     context 'w/o a full set of params' do
       it 'calculates correct pmt value w/o :ptype' do
         loan = Finance::Loan.new(nominal_rate: 0.1, duration: 12, amount: 1000)
-        expect(loan.pmt).to eq(87.9158872300099)
+        expect(loan.pmt).to eq(-87.9158872300099)
       end
 
       it 'calculates correct pmt value w/o :nominal_rate' do
         loan = Finance::Loan.new(duration: 12, amount: 1200, ptype: :end)
-        expect(loan.pmt).to eq(100)
+        expect(loan.pmt).to eq(-100)
       end
     end
 
     context 'with zero rates' do
       it 'calculates correct pmt value for 3 years' do
         loan = Finance::Loan.new(nominal_rate: 0, duration: 36, amount: 10_000, ptype: :end)
-        expect(loan.pmt).to eq(277.77777777777777)
+        expect(loan.pmt).to eq(-277.77777777777777)
       end
 
       it 'calculates correct pmt value for 6 months' do
         loan = Finance::Loan.new(nominal_rate: 0, duration: 6, amount: 10_000, ptype: :end)
-        expect(loan.pmt).to eq(1666.6666666666667)
+        expect(loan.pmt).to eq(-1666.6666666666667)
       end
     end
 
     context 'with :beginning ptype' do
       it 'calculates correct pmt value' do
         loan = Finance::Loan.new(nominal_rate: 0.12, duration: 6, amount: 1000, ptype: :beginning)
-        expect(loan.pmt).to eq(170.8399670404763)
+        expect(loan.pmt).to eq(-170.8399670404763)
       end
     end
 
     it 'calculates correct pmt value' do
       loan = Finance::Loan.new(nominal_rate: 0.13, duration: 90, amount: 1_000_000, ptype: :end)
-      expect(loan.pmt).to eq(17_449.90775727763)
+      expect(loan.pmt).to eq(-17_449.90775727763)
     end
   end
 
@@ -99,4 +99,51 @@ RSpec.describe Finance::Loan do
       end
     end
   end
+
+  describe '#ppmt' do
+    context 'when 1 period' do
+      it 'calculates correct ppmt value' do
+        loan = Finance::Loan.new(
+          nominal_rate: 0.0824, duration: 12, amount: 2500, period: 1
+        )
+        expect(loan.ppmt).to eq(-200.58192368678277)
+      end
+    end
+
+    context 'when 2 periods' do
+      it 'calculates correct ppmt value' do
+        loan = Finance::Loan.new(
+          nominal_rate: 0.0824, duration: 12, amount: 2500, period: 2
+        )
+        expect(loan.ppmt).to eq(-201.95925289609866)
+      end
+    end
+
+    context 'when 3 periods' do
+      it 'calculates correct ppmt value' do
+        loan = Finance::Loan.new(
+          nominal_rate: 0.0824, duration: 12, amount: 2500, period: 3
+        )
+        expect(loan.ppmt).to eq(-203.34603976598518)
+      end
+    end
+
+    context 'when 4 periods' do
+      it 'calculates correct ppmt value' do
+        loan = Finance::Loan.new(
+          nominal_rate: 0.0824, duration: 12, amount: 2500, period: 4
+        )
+        expect(loan.ppmt).to eq(-204.7423492390449)
+      end
+    end
+
+    context 'when 5 periods' do
+      it 'calculates correct ppmt value' do
+        loan = Finance::Loan.new(
+          nominal_rate: 0.0824, duration: 12, amount: 2500, period: 5
+        )
+        expect(loan.ppmt).to eq(-206.1482467038197)
+      end
+    end
+  end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: finance_rb
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.2.0
 platform: ruby
 authors:
 - Vlad Dyachenko
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2021-04-04 00:00:00.000000000 Z
+date: 2021-04-30 00:00:00.000000000 Z
 dependencies: []
 description: A ruby port of numpy-financial functions. This library provides a Ruby
   interface for working with interest rates, mortgage amortization, and cashflows