Add #total_on_hand method to Variant model

Fixes spree#3427

core/CHANGELOG.md

@@ -64,4 +64,8 @@ See #3133 for more information.
 
 * Removed `variants_including_master_and_deleted`, in favour of using the Paranoia gem. This scope would now be achieved using `variants_including_master.with_deleted`.
 
-    *Ryan Bigg*
+    *Ryan Bigg*
+
+* You can now find the total amount on hand of a variant by calling `Variant#total_on_hand`. #3427
+
+    *Ruben Ascencio*

core/app/models/spree/variant.rb

@@ -135,6 +135,10 @@ def in_stock?(quantity=1)
       Spree::Stock::Quantifier.new(self).can_supply?(quantity)
     end
 
+    def total_on_hand
+      Spree::Stock::Quantifier.new(self).total_on_hand
+    end
+
     # Product may be created with deleted_at already set,
     # which would make AR's default finder return nil.
     # This is a stopgap for that little problem.

core/spec/models/spree/variant_spec.rb

@@ -332,4 +332,16 @@
       end
     end
   end
+
+  describe '#total_on_hand' do
+    it 'should be infinite if track_inventory_levels is false' do
+      Spree::Config[:track_inventory_levels] = false
+      build(:variant).total_on_hand.should eql(Float::INFINITY)
+    end
+
+    it 'should match quantifier total_on_hand' do
+      variant = build(:variant)
+      expect(variant.total_on_hand).to eq(Spree::Stock::Quantifier.new(variant).total_on_hand)
+    end
+  end
 end