acts_as_shopping_cart 0.0.3 → 0.1.0

data/.gitignore

@@ -4,3 +4,4 @@ Gemfile.lock
 pkg/*
 .rvmrc
 coverage
+coverage.features

data/README.markdown

@@ -94,6 +94,48 @@ You can find out about the total using the _total_ method:
 
     @cart.total # => 99.99
 
+### Taxes
+
+Taxes by default are calculated by multiplying subtotal times 8.25
+
+If you want to change the way taxes are calculated, override the taxes
+method on your class that acts_as_shopping_cart.
+
+Example:
+
+    class ShoppingCart < ActiveRecord::Base
+      acts_as_shopping_cart
+
+      def taxes
+        (subtotal - 10) * 8.3
+      end
+    end
+
+If you just want to update the percentage, just override the tax_pct
+method.
+
+    class ShoppingCart < ActiveRecord::Base
+      acts_as_shopping_cart
+
+      def tax_pct
+        3.5
+      end
+    end
+
+### Shipping Cost
+
+Shipping cost will be added to the total. By default its calculated as
+0, but you can just override the shipping_cost method on your cart
+class depending on your needs.
+
+    class ShoppingCart < ActiveRecord::Base
+      acts_as_shopping_cart
+
+      def shipping_cost
+        5 # defines a flat $5 rate
+      end
+    end
+
 ### Total unique items
 
 You can find out how many unique items you have on your cart using the _total_unique_items_ method.
@@ -118,8 +160,12 @@ Run rspec
 
     rspec spec
 
-## TODO
+Run cucumber features
+
+    bundle exec cucumber
+
+# About the Author
 
-* Finish this document
-* Test it on Rails 2
-* Some more useful methods, like @cart.quantity_for(@product), @cart.price_for(@product)
+[Crowd Interactive](http://www.crowdint.com) is an American web design and development company that happens to work in Colima, Mexico.
+We specialize in building and growing online retail stores. We don’t work with everyone – just companies we believe in. Call us today to see if there’s a fit.
+Find more info [here](http://www.crowdint.com)!

data/acts_as_shopping_cart.gemspec

@@ -19,6 +19,8 @@ Gem::Specification.new do |s|
   s.require_paths = ["lib"]
 
   s.add_dependency 'activerecord', '~> 3.0'
+  s.add_development_dependency "cucumber"
+  s.add_development_dependency "database_cleaner"
   s.add_development_dependency "rspec"
   s.add_development_dependency "sqlite3"
   s.add_development_dependency "simplecov"

data/features/shopping_cart.feature

@@ -0,0 +1,46 @@
+Feature: Shopping Cart
+
+  Background:
+    Given a product "Apple" exists
+    And a shopping cart exists
+
+  Scenario: Cart totals
+    When I add product "Apple" to cart with price "99.99"
+    Then the subtotal for the cart should be "99.99"
+    And the total for the cart should be "108.24"
+    And the total unique items on the cart should be "1"
+
+  Scenario: Add a product to cart twice
+    When I add product "Apple" to cart with price "99.99"
+    And I add product "Apple" to cart with price "99.99"
+    Then the subtotal for the cart should be "199.98"
+    Then the total for the cart should be "216.48"
+    And the total unique items on the cart should be "2"
+
+  Scenario: Remove products from cart
+    Given I add 3 "Apple" products to cart with price "99.99"
+    When I remove 1 "Apple" unit from cart
+    Then the total unique items on the cart should be "2"
+    When I remove 99 "Apple" units from cart
+    Then the total unique items on the cart should be "0"
+    And cart should be empty
+
+  Scenario: Totals for a single item
+    Given I add 3 "Apple" products to cart with price "99.99"
+    Then the subtotal for "Apple" on the cart should be "299.97"
+    And the quantity for "Apple" on the cart should be "3"
+    And the price for "Apple" on the cart should be "99.99"
+
+  Scenario: Subtotal for a product that is not on cart
+    Then the subtotal for "Apple" on the cart should be "0"
+
+  Scenario: Update the quantity of a cart item
+    Given I add 99 "Apple" products to cart with price "99.99"
+    When I update the "Apple" quantity to "2"
+    Then the quantity for "Apple" on the cart should be "2"
+
+  Scenario: Update the price of a cart item
+    Given I add 99 "Apple" products to cart with price "99.99"
+    When I update the "Apple" price to "10.99"
+    Then the price for "Apple" on the cart should be "10.99"
+

data/features/step_definitions/product_steps.rb

@@ -0,0 +1,3 @@
+Given /^a product "([^"]*)" exists$/ do |name|
+  Product.create(:name => name)
+end

data/features/step_definitions/shopping_cart_steps.rb

@@ -0,0 +1,69 @@
+Given /^a shopping cart exists$/ do
+  @cart = ShoppingCart.create
+end
+
+Then /^the total for the cart should be "([^"]*)"$/ do |total|
+  @cart.reload
+  @cart.total.should eq(total.to_f)
+end
+
+Then /^the subtotal for the cart should be "([^"]*)"$/ do |subtotal|
+  @cart.reload
+  @cart.subtotal.should eq(subtotal.to_f)
+end
+
+When /^I add product "([^"]*)" to cart with price "([^"]*)"$/ do |product_name, price|
+  product = Product.find_by_name(product_name)
+  @cart.add(product, price)
+end
+
+Then /^the total unique items on the cart should be "([^"]*)"$/ do |total|
+  @cart.reload
+  @cart.total_unique_items.should eq(total.to_i)
+end
+
+When /^I remove (\d+) "([^"]*)" unit(s?) from cart$/ do |quantity, product_name, plural|
+  @cart.reload
+  product = Product.find_by_name(product_name)
+  @cart.remove(product, quantity.to_i)
+end
+
+Then /^cart should be empty$/ do
+  @cart.reload
+  @cart.cart_items.should be_empty
+end
+
+Given /^I add (\d+) "([^"]*)" products to cart with price "([^"]*)"$/ do |quantity, product_name, price|
+  product = Product.find_by_name(product_name)
+  @cart.add(product, price.to_f, quantity.to_i)
+end
+
+Then /^the subtotal for "([^"]*)" on the cart should be "([^"]*)"$/ do |product_name, subtotal|
+  @cart.reload
+  product = Product.find_by_name(product_name)
+  @cart.subtotal_for(product).should eq(subtotal.to_f)
+end
+
+Then /^the quantity for "([^"]*)" on the cart should be "([^"]*)"$/ do |product_name, quantity|
+  @cart.reload
+  product = Product.find_by_name(product_name)
+  @cart.quantity_for(product).should eq(quantity.to_f)
+end
+
+Then /^the price for "([^"]*)" on the cart should be "([^"]*)"$/ do |product_name, price|
+  @cart.reload
+  product = Product.find_by_name(product_name)
+  @cart.price_for(product).should eq(price.to_f)
+end
+
+When /^I update the "([^"]*)" quantity to "([^"]*)"$/ do |product_name, quantity|
+  @cart.reload
+  product = Product.find_by_name(product_name)
+  @cart.update_quantity_for(product, quantity.to_i)
+end
+
+When /^I update the "([^"]*)" price to "([^"]*)"$/ do |product_name, price|
+  @cart.reload
+  product = Product.find_by_name(product_name)
+  @cart.update_price_for(product, price.to_f)
+end

data/features/support/env.rb

@@ -0,0 +1,8 @@
+require 'active_record'
+require 'database_cleaner'
+require 'acts_as_shopping_cart'
+
+require 'simplecov'
+
+SimpleCov.coverage_dir 'coverage.features'
+SimpleCov.start

data/features/support/rails_env.rb

@@ -0,0 +1,24 @@
+ActiveRecord::Base.establish_connection(:adapter => "sqlite3", :database => ":memory:")
+
+ActiveRecord::Schema.define(:version => 1) do
+  create_table :shopping_carts
+  create_table :shopping_cart_items do |t|
+    t.shopping_cart_item_fields
+  end
+
+  create_table :products do |t|
+    t.string :name
+  end
+end
+
+class Product < ActiveRecord::Base
+
+end
+
+class ShoppingCart < ActiveRecord::Base
+  acts_as_shopping_cart
+end
+
+class ShoppingCartItem < ActiveRecord::Base
+  acts_as_shopping_cart_item
+end

data/lib/active_record/acts/shopping_cart.rb

@@ -10,14 +10,15 @@ module ActiveRecord
         # Prepares the class to act as a cart.
         #
         # Receives as a parameter the name of the class that will hold the items
-        # 
+        #
         # Example:
         #
         #   acts_as_shopping_cart :cart_item
         #
         #
         def acts_as_shopping_cart_using(item_class)
-          self.send :include, ActiveRecord::Acts::ShoppingCart::InstanceMethods
+          self.send :include, ActiveRecord::Acts::ShoppingCart::Cart::InstanceMethods
+          self.send :include, ActiveRecord::Acts::ShoppingCart::Item::InstanceMethods
           has_many :cart_items, :class_name => item_class.to_s.classify, :as => :owner
         end
 
@@ -32,4 +33,4 @@ module ActiveRecord
       end
     end
   end
-end
+end

data/lib/active_record/acts/shopping_cart/cart/instance_methods.rb

@@ -0,0 +1,70 @@
+module ActiveRecord
+  module Acts
+    module ShoppingCart
+      module Cart
+        module InstanceMethods
+          #
+          # Adds a product to the cart
+          #
+          def add(object, price, quantity = 1)
+            cart_item = item_for(object)
+
+            unless cart_item
+              cart_items.create(:item => object, :price => price, :quantity => quantity)
+            else
+              cart_item.quantity = (cart_item.quantity + quantity)
+              cart_item.save
+            end
+          end
+
+          #
+          # Remove an item from the cart
+          #
+          def remove(object, quantity = 1)
+            if cart_item = item_for(object)
+              if cart_item.quantity <= quantity
+                cart_item.delete
+              else
+                cart_item.quantity = (cart_item.quantity - quantity)
+                cart_item.save
+              end
+            end
+          end
+
+          #
+          # Returns the subtotal by summing the price times quantity for all the items in the cart
+          #
+          def subtotal
+            ("%.2f" % cart_items.inject(0) { |sum, item| sum += (item.price * item.quantity) }).to_f
+          end
+
+          def shipping_cost
+            0
+          end
+
+          def taxes
+            subtotal * self.tax_pct * 0.01
+          end
+
+          def tax_pct
+            8.25
+          end
+
+          #
+          # Returns the total by summing the subtotal, taxes and shipping_cost
+          #
+          def total
+            ("%.2f" % (self.subtotal + self.taxes + self.shipping_cost)).to_f
+          end
+
+          #
+          # Return the number of unique items in the cart
+          #
+          def total_unique_items
+            cart_items.inject(0) { |sum, item| sum += item.quantity }
+          end
+        end
+      end
+    end
+  end
+end

data/lib/active_record/acts/shopping_cart/item/instance_methods.rb

@@ -0,0 +1,58 @@
+module ActiveRecord
+  module Acts
+    module ShoppingCart
+      module Item
+        module InstanceMethods
+
+          #
+          # Returns the cart item for the specified object
+          #
+          def item_for(object)
+            cart_items.where(:item_id => object.id).first
+          end
+
+          #
+          # Returns the subtotal of a specified item by multiplying the quantity times
+          # the price of the item.
+          #
+          def subtotal_for(object)
+            item = item_for(object)
+            item ? item.subtotal : 0
+          end
+
+          #
+          # Returns the quantity of the specified object
+          #
+          def quantity_for(object)
+            item = item_for(object)
+            item ? item.quantity : 0
+          end
+
+          #
+          # Updates the quantity of the specified object
+          #
+          def update_quantity_for(object, new_quantity)
+            item = item_for(object)
+            item.update_quantity(new_quantity) if item
+          end
+
+          #
+          # Returns the price of the specified object
+          #
+          def price_for(object)
+            item = item_for(object)
+            item ? item.price : 0
+          end
+
+          #
+          # Updates the price of the specified object
+          #
+          def update_price_for(object, new_price)
+            item = item_for(object)
+            item.update_price(new_price) if item
+          end
+        end
+      end
+    end
+  end
+end

data/lib/active_record/acts/shopping_cart_item.rb

@@ -10,7 +10,7 @@ module ActiveRecord
         # Prepares the class to act as a cart item.
         #
         # Receives as a parameter the name of the class that acts as a cart
-        # 
+        #
         # Example:
         #
         #   acts_as_shopping_cart_item :cart
@@ -33,4 +33,4 @@ module ActiveRecord
       end
     end
   end
-end
+end

data/lib/active_record/acts/shopping_cart_item/{cart_item_instance_methods.rb → instance_methods.rb}

@@ -4,9 +4,9 @@ module ActiveRecord
       module InstanceMethods
         #
         # Returns the subtotal, multiplying the quantity times the price of the item.
-        # 
+        #
         def subtotal
-          self.quantity * self.price
+          ("%.2f" % (self.quantity * self.price)).to_f
         end
 
         #
@@ -16,7 +16,7 @@ module ActiveRecord
             self.quantity = new_quantity
             self.save
         end
-        
+
         #
         # Updates the price of the item
         #
@@ -27,4 +27,4 @@ module ActiveRecord
       end
     end
   end
-end
+end

data/lib/acts_as_shopping_cart.rb

@@ -1,10 +1,32 @@
 require 'acts_as_shopping_cart/version'
 require 'active_record/acts/shopping_cart'
-require 'active_record/acts/shopping_cart/cart_instance_methods'
-require 'active_record/acts/shopping_cart/item_instance_methods'
-
 require 'active_record/acts/shopping_cart_item'
-require 'active_record/acts/shopping_cart_item/cart_item_instance_methods'
 
-ActiveRecord::Base.send :extend, ActiveRecord::Acts::ShoppingCart::ClassMethods
-ActiveRecord::Base.send :extend, ActiveRecord::Acts::ShoppingCartItem::ClassMethods
+# require 'active_record/acts/shopping_cart/cart_instance_methods'
+# require 'active_record/acts/shopping_cart/item_instance_methods'
+
+# require 'active_record/acts/shopping_cart_item'
+# require 'active_record/acts/shopping_cart_item/cart_item_instance_methods'
+
+require 'acts_as_shopping_cart/schema'
+
+module ActiveRecord
+  module Acts
+    module ShoppingCart
+      module Cart
+        autoload :InstanceMethods, 'active_record/acts/shopping_cart/cart/instance_methods'
+      end
+
+      module Item
+        autoload :InstanceMethods, 'active_record/acts/shopping_cart/item/instance_methods'
+      end
+    end
+
+    module ShoppingCartItem
+      autoload :InstanceMethods, 'active_record/acts/shopping_cart_item/instance_methods'
+    end
+  end
+end
+
+ActiveRecord::Base.send :include, ActiveRecord::Acts::ShoppingCart
+ActiveRecord::Base.send :include, ActiveRecord::Acts::ShoppingCartItem