cartman 0.4.0 → 1.0.0

data/README.md

@@ -27,14 +27,16 @@ Cartman has a few (read 3) configuration options you can set, most likely in an
 # config/initializers/cartman.rb
 Cartman.config do
   cart_expires_in 604800 # one week, in seconds.  This is the default
-  cost_field :cost # for cart totaling
+  unit_cost_field :unit_cost # for cart totaling
   quantity_field :quantity # for quantity totaling
   redis Redis.new # set the redis connection here
 end
 ```
 
 - The `cart_expires_in` setting will let you set how long a cart should live.  If no items are added to the cart before the time expires, the cart will be cleared.  If you want to disable cart expiration, set this to `-1`.
-- `cost_field` lets you tell Cartman where you're storing the "cost" of each item, so that when you call `cart.total` it knows which values to sum.
+- `unit_cost_field` lets you tell Cartman where you're storing the unit_cost of each item, so that you can use the `cost` method on the item, and the `total` method on `Cart`.
+- `quantity_field` lets you tell Cartman where you're storing the quantity of each item.  The `Item#cost` method uses this along with the `unit_cost` field to determine the cost.
+- `redis` lets you set the redis connection you want to use.  Note that this is not redis connection options, this is an actual instance of `Redis`.
 
 ## Usage
 
@@ -42,7 +44,8 @@ To create a new shopping cart, just call `Cartman::Cart.new(user.id)`.  The para
 
 The returned Items come back as `Cartman::Item` instances, which have a few special methods to be aware of:
 
-- `remove` - which will remove the item from the cart
+- `cost` - which will return the `:unit_cost` multiplied by the `:quantity`.
+- `destroy` - which will remove the item from the cart
 - `cart` - which will return the parent cart, think ActiveRecord association
 - `_id` - which will return the id of the item, if you need that for whatever reason
 - `_key` - which will return the redis key the data is stored in.  Probably won't need that, but it's there.
@@ -51,17 +54,21 @@ The returned Items come back as `Cartman::Item` instances, which have a few spec
 The `Cart` object also has some handy methods that you should be aware of:
 
 - `add_item(data)` - which is the life blood of Cartman.  This method takes a hash of data you would like to store with the item.  Here's a few suggestions of keys you may want in your hash:
-  - `:id` - to store the ID of the product you're adding
-  - `:type` - to store the class of the product you're adding.  Useful if you have multiple models that can go in the cart.
-  - `:cost` - which if you use will let you use the `Cart#total` method without any extra configuration
-  - `:quantity` - which if you use will let you use the `Cart#quantity` method without any extra configuration
-- `remove_item(item) - which, you guessed it, removes an item.  This method takes an Item object, not a hash.
+  - `:id` - (*required*) to store the ID of the model you're adding
+  - `:type` - (*required*) to store the class of the model you're adding.
+  - `:unit_cost` - This field is required if you want to take advantage of the `Item#cost` method, and the `Cart#total` method.
+  - `:quantity` - which if you use will let you use the `Cart#quantity` and `Cart#total` methods without any extra configuration.
+- `remove_item(item)` - which, you guessed it, removes an item.  This method takes an Item object, not a hash.
 - `contains?(Product)` - This is a biggie.  It will tell you if a certain item is in the cart.  And the way it works is you pass it an object, like an instance of a Product model, and it will examine the class, and the id, and look to see if it's in the cart already.  This method only works if the `:id` and `:type` keys are set in the item's data hash.
+- `find(Product)` - This will return the `Item` object that represents the object passed in.  It works like `contains?` and uses class, and id.  It only works if the `:id` and `:type` keys are set in the item's data hash.
+- `items` - this returns a magic array of all the items.  I call it magic because you can call on it:
+  - `each_with_object` - which will act like a regular `each` call, but the block will yield the `Item` and the object it represents by using the `:type` and `:id` keys.
+- `total` - will sum all of the `cost` return values of all of the items in the cart.  For this to work, the `:unit_cost` and `:quantity` fields need to be set for all items.
 - `count` - which will give you the total number of items in the cart.  Faster than `cart.items.size` because it doesn't load all of the item data from redis.
-- `quantity` - which will return the total quantity of all the items.  The quantity field is set in the config block, by default it's :quantity
-- `ttl` - will tell you how many seconds until the cart expires.  It will return -1 if the cart will never expire
-- `touch` - which will reset the ttl back to whatever expiration length is set in the config.  Touch is automatically called after `add_item` and `remove_item`
-- `destroy!` - which will delete the cart, and all the line_items out of it
+- `quantity` - which will return the total quantity of all the items.  The quantity field is set in the config block, by default it's `:quantity`
+- `ttl` - will tell you how many seconds until the cart expires.  It will return -1 if the cart will never expire.
+- `touch` - which will reset the ttl back to whatever expiration length is set in the config.  Touch is automatically called after `add_item` and `remove_item`.
+- `destroy!` - which will delete the cart, and all the line_items out of it.
 - `reassign(id)` - this method will reassign the cart's unique identifier.  So to access this cart at a later time after reassigning, you would put `Cart.new(reassigned_id)`.  This is useful for having a cart for an unsigned in user.  You can use their session ID while they're unauthenticated, and then when they sign in, you can reassign the cart to the user's ID.  NOTE: Reassigning will overwrite any cart in it's way.
 
 Lets walk through an example implementation with a Rails app that has a User model and a Product model.

data/lib/cartman.rb

@@ -2,6 +2,7 @@ require "cartman/version"
 require "cartman/configuration"
 require "cartman/cart"
 require "cartman/item"
+require "cartman/item_collection"
 require 'redis'
 
 module Cartman

data/lib/cartman/cart.rb

@@ -8,11 +8,13 @@ module Cartman
     end
 
     def add_item(options)
+      raise "Must specify both :id and :type" unless options.has_key?(:id) && options.has_key?(:type)
       line_item_id = @@redis.incr CART_LINE_ITEM_ID_KEY
-      @@redis.mapped_hmset("cartman:line_item:#{line_item_id}", options)
-      @@redis.sadd key, line_item_id
-      if options.has_key?(:id) && options.has_key?(:type)
+      @@redis.pipelined do
+        @@redis.mapped_hmset("cartman:line_item:#{line_item_id}", options)
+        @@redis.sadd key, line_item_id
         @@redis.sadd index_key, "#{options[:type]}:#{options[:id]}"
+        @@redis.set index_key_for(options), line_item_id
       end
       touch
       get_item(line_item_id)
@@ -21,23 +23,28 @@ module Cartman
     def remove_item(item)
       @@redis.del "cartman:line_item:#{item._id}"
       @@redis.srem key, item._id
-      begin
-        @@redis.srem index_key, "#{item.type}:#{item.id}"
-      rescue KeyError
+      @@redis.srem index_key, "#{item.type}:#{item.id}"
+      @@redis.del index_key_for(item)
+      index_keys.each do |key|
+        @@redis.del key
       end
       touch
     end
 
     def items
-      items = line_item_ids.collect { |item_id|
-        get_item(item_id)
-      }
+      ItemCollection.new(line_item_ids.collect{ |item_id| get_item(item_id)})
     end
 
     def contains?(object)
       @@redis.sismember index_key, "#{object.class}:#{object.id}"
     end
 
+    def find(object)
+      if contains?(object)
+        get_item(@@redis.get(index_key_for(object)).to_i)
+      end
+    end
+
     def count
       @@redis.scard key
     end
@@ -50,7 +57,7 @@ module Cartman
 
     def total
       items.collect { |item|
-        (item.send(Cartman::Configuration.cost_field).to_f * 100).to_i
+        (item.cost * 100).to_i
       }.inject{|sum,cost| sum += cost} / 100.0
     end
 
@@ -62,6 +69,8 @@ module Cartman
       keys = line_item_keys
       keys << key
       keys << index_key
+      keys << index_keys
+      keys.flatten!
       @@redis.pipelined do
         keys.each do |key|
           @@redis.del key
@@ -72,7 +81,11 @@ module Cartman
     def touch
       keys_to_expire = line_item_keys
       keys_to_expire << key
-      keys_to_expire << index_key
+      if @@redis.exists index_key
+        keys_to_expire << index_key
+        keys_to_expire << index_keys
+        keys_to_expire.flatten!
+      end
       @@redis.pipelined do
         keys_to_expire.each do |item|
           @@redis.expire item, Cartman::Configuration.cart_expires_in
@@ -82,10 +95,14 @@ module Cartman
 
     def reassign(new_id)
       if @@redis.exists key
+        new_index_keys = items.collect { |item|
+          index_key_for(item, new_id)
+        }
         @@redis.rename key, key(new_id)
-      end
-      if @@redis.exists index_key
         @@redis.rename index_key, index_key(new_id)
+        index_keys.zip(new_index_keys).each do |key, value|
+          @@redis.rename key, value
+        end
       end
       @uid = new_id
     end
@@ -100,6 +117,21 @@ module Cartman
       key(id) + ":index"
     end
 
+    def index_keys(id=@uid)
+      @@redis.keys "#{index_key(id)}:*"
+    end
+
+    def index_key_for(object, id=@uid)
+      case object
+      when Hash
+        index_key(id) + ":#{object[:type]}:#{object[:id]}"
+      when Item
+        index_key(id) + ":#{object.type}:#{object.id}"
+      else
+        index_key(id) + ":#{object.class}:#{object.id}"
+      end
+    end
+
     def line_item_ids
       @@redis.smembers key
     end
@@ -109,7 +141,7 @@ module Cartman
     end
 
     def get_item(id)
-      Item.new(id, @uid, @@redis.hgetall("cartman:line_item:#{id}").inject({}){|memo,(k,v)| memo[k.to_sym] = v; memo})
+      Item.new(id, @uid, @@redis.hgetall("cartman:line_item:#{id}").inject({}){|hash,(k,v)| hash[k.to_sym] = v; hash})
     end
   end
 end

data/lib/cartman/configuration.rb

@@ -4,7 +4,7 @@ module Cartman
   class Configuration
     @@configuration = {
       cart_expires_in: 604800, # one week
-      cost_field: :cost, # for cart totaling
+      unit_cost_field: :unit_cost, # for cart totaling and costing
       quantity_field: :quantity, # for cart totaling
       redis: Redis.new, # Redis connection
     }

data/lib/cartman/item.rb

@@ -10,14 +10,24 @@ module Cartman
       @id
     end
 
+    def cost
+      unit_cost = (@data.fetch(Cartman::Configuration.unit_cost_field).to_f * 100).to_i
+      quantity = @data.fetch(Cartman::Configuration.quantity_field).to_i
+      (unit_cost * quantity) / 100.0
+    end
+
     def cart
       @cart ||= Cart.new(@cart_id)
     end
 
-    def remove
+    def destroy
       cart.remove_item(self)
     end
 
+    def ==(item)
+      @id == item._id
+    end
+
     def _key
       "cartman:line_item:#{@id}"
     end

data/lib/cartman/item_collection.rb

@@ -0,0 +1,19 @@
+require 'delegate'
+
+module Cartman
+  class ItemCollection < DelegateClass(Array)
+    include Enumerable
+
+    def initialize(array)
+      @results = array
+      super(@results)
+    end
+
+    def each_with_object
+      @results.each do |result|
+        yield result, eval(result.type).send(:find, result.id)
+      end
+    end
+
+  end
+end

data/lib/cartman/version.rb

@@ -1,3 +1,3 @@
 module Cartman
-  VERSION = "0.4.0"
+  VERSION = "1.0.0"
 end

data/spec/cart_spec.rb

@@ -2,6 +2,7 @@ require 'spec_helper'
 
 describe Cartman do
   describe Cartman::Cart do
+    let(:Bottle) { Struct.new(:id) }
     let(:cart) { Cartman::Cart.new(1) }
 
     before(:each) do
@@ -16,7 +17,7 @@ describe Cartman do
 
     describe "#add_item" do
       before(:each) do
-        cart.add_item(id: 17, type: "Bottle", name: "Bordeux", unit_cost: 92.12, cost: 184.24, quantity: 2)
+        cart.add_item(id: 17, type: "Bottle", name: "Bordeux", unit_cost: 92.12, quantity: 2)
       end
 
       it "creates a line item key" do
@@ -37,21 +38,21 @@ describe Cartman do
         Cartman.config.redis.sismember("cartman:cart:1:index", "Bottle:17").should be_true
       end
 
-      it "should not add an index key if type and ID are not set" do
-        cart.add_item(id: 18, name: "Cordeux", unit_cost: 92.12, cost: 184.24, quantity: 2)
-        Cartman.config.redis.sismember("cartman:cart:1:index", "Bottle:18").should be_false
-        Cartman.config.redis.scard("cartman:cart:1:index").should eq(1)
+      it "should squack if type and/or ID are not set" do
+        expect { cart.add_item(id: 18, name: "Cordeux", unit_cost: 92.12, quantity: 2) }.to raise_error("Must specify both :id and :type")
+        expect { cart.add_item(type: "Bottle", name: "Cordeux", unit_cost: 92.12, quantity: 2) }.to raise_error("Must specify both :id and :type")
+        expect { cart.add_item(name: "Cordeux", unit_cost: 92.12, quantity: 2) }.to raise_error("Must specify both :id and :type")
       end
 
       it "should return an Item" do
-        item = cart.add_item(id: 34, type: "Bottle", name: "Cabernet", unit_cost: 92.12, cost: 184.24, quantity: 2)
+        item = cart.add_item(id: 34, type: "Bottle", name: "Cabernet", unit_cost: 92.12, quantity: 2)
         item.class.should eq(Cartman::Item)
       end
     end
 
     describe "#remove_item" do
       it "should remove the id from the set, and delete the line_item key" do
-        item = cart.add_item(id: 17, type: "Bottle", name: "Bordeux", unit_cost: 92.12, cost: 184.24, quantity: 2)
+        item = cart.add_item(id: 17, type: "Bottle", name: "Bordeux", unit_cost: 92.12, quantity: 2)
         item_id = item._id
         cart.remove_item(item)
         Cartman.config.redis.sismember(cart.send(:key), item_id).should be_false
@@ -61,12 +62,13 @@ describe Cartman do
 
     describe "#items" do
       before(:each) do
-        cart.add_item(id: 17, type: "Bottle", name: "Bordeux", unit_cost: 92.12, cost: 184.24, quantity: 2)
-        cart.add_item(id: 34, type: "Bottle", name: "Cabernet", unit_cost: 92.12, cost: 184.24, quantity: 2)
+        cart.add_item(id: 17, type: "Bottle", name: "Bordeux", unit_cost: 92.12, quantity: 2)
+        cart.add_item(id: 34, type: "Bottle", name: "Cabernet", unit_cost: 92.12, quantity: 2)
       end
 
-      it "should return an array of Items" do
-        cart.items.first.class.should eq(Cartman::Item)
+      it "should return an ItemCollection of Items" do
+        cart.items.class.should be(Cartman::ItemCollection)
+        cart.items.first.class.should be(Cartman::Item)
         cart.items.first.id.should eq("17")
         cart.items.first.name.should eq("Bordeux")
       end
@@ -78,8 +80,8 @@ describe Cartman do
       end
 
       before(:each) do
-        cart.add_item(id: 17, type: "Bottle", name: "Bordeux", unit_cost: 92.12, cost: 184.24, quantity: 2)
-        cart.add_item(id: 34, name: "Cabernet", unit_cost: 92.12, cost: 184.24, quantity: 2)
+        cart.add_item(id: 17, type: "Bottle", name: "Bordeux", unit_cost: 92.12, quantity: 2)
+        cart.add_item(id: 34, type: "Bottle", name: "Cabernet", unit_cost: 92.12, quantity: 2)
       end
 
       it "should be able to tell you that an item in the cart is present" do
@@ -98,18 +100,36 @@ describe Cartman do
       end
     end
 
+    describe "#find(item)" do
+
+      before(:each) do
+        cart.add_item(id: 17, type: "Bottle", name: "Bordeux", unit_cost: 92.12, quantity: 2)
+        cart.add_item(id: 34, type: "Bottle", name: "Cabernet", unit_cost: 92.12, quantity: 2)
+      end
+
+      it "should take some object, and return the Item that corresponds to it" do
+        cart.find(Bottle.new(17)).quantity.should eq("2")
+        cart.find(Bottle.new(17)).name.should eq("Bordeux")
+        cart.find(Bottle.new(34)).name.should eq("Cabernet")
+      end
+
+      it "should return nil if the Item is not in the cart" do
+        cart.find(Bottle.new(23)).should be(nil)
+      end
+    end
+
     describe "#count" do
       it "should return the number of items in the cart" do
-        cart.add_item(id: 17, type: "Bottle", name: "Bordeux", unit_cost: 92.12, cost: 184.24, quantity: 2)
-        cart.add_item(id: 34, type: "Bottle", name: "Cabernet", unit_cost: 92.12, cost: 184.24, quantity: 2)
+        cart.add_item(id: 17, type: "Bottle", name: "Bordeux", unit_cost: 92.12, quantity: 2)
+        cart.add_item(id: 34, type: "Bottle", name: "Cabernet", unit_cost: 92.12, quantity: 2)
         cart.count.should eq(2)
       end
     end
 
     describe "#quantity" do
       it "should return the sum of the default quantity field" do
-        cart.add_item(id: 17, type: "Bottle", name: "Bordeux", unit_cost: 92.12, cost: 184.24, quantity: 2)
-        cart.add_item(id: 34, type: "Bottle", name: "Cabernet", unit_cost: 92.12, cost: 184.24, quantity: 2)
+        cart.add_item(id: 17, type: "Bottle", name: "Bordeux", unit_cost: 92.12, quantity: 2)
+        cart.add_item(id: 34, type: "Bottle", name: "Cabernet", unit_cost: 92.12, quantity: 2)
         cart.quantity.should eq(4)
       end
 
@@ -117,26 +137,32 @@ describe Cartman do
         Cartman.config do
           quantity_field :qty
         end
-        cart.add_item(id: 17, type: "Bottle", name: "Bordeux", unit_cost: 92.12, cost: 184.24, qty: 2)
-        cart.add_item(id: 34, type: "Bottle", name: "Cabernet", unit_cost: 92.12, cost: 184.24, qty: 2)
+        cart.add_item(id: 17, type: "Bottle", name: "Bordeux", unit_cost: 92.12, qty: 2)
+        cart.add_item(id: 34, type: "Bottle", name: "Cabernet", unit_cost: 92.12, qty: 2)
         cart.quantity.should eq(4)
+        Cartman.config do
+          quantity_field :quantity
+        end
       end
     end
 
     describe "#total" do
       it "should total the default costs field" do
-        cart.add_item(id: 17, type: "Bottle", name: "Bordeux", unit_cost: 92.12, cost: 184.24, quantity: 2)
-        cart.add_item(id: 34, type: "Bottle", name: "Cabernet", unit_cost: 92.12, cost: 184.24, quantity: 2)
+        cart.add_item(id: 17, type: "Bottle", name: "Bordeux", unit_cost: 92.12, quantity: 2)
+        cart.add_item(id: 34, type: "Bottle", name: "Cabernet", unit_cost: 92.12, quantity: 2)
         cart.total.should eq(368.48)
       end
 
       it "should total whatever cost field the user sets" do
         Cartman.config do
-          cost_field :cost_in_cents
+          unit_cost_field :unit_cost_in_cents
         end
-        cart.add_item(id: 17, type: "Bottle", name: "Bordeux", unit_cost: 92.12, cost_in_cents: 18424, quantity: 2)
-        cart.add_item(id: 34, type: "Bottle", name: "Cabernet", unit_cost: 92.12, cost_in_cents: 18424, quantity: 2)
+        cart.add_item(id: 17, type: "Bottle", name: "Bordeux", unit_cost_in_cents: 9212, quantity: 2)
+        cart.add_item(id: 34, type: "Bottle", name: "Cabernet", unit_cost_in_cents: 9212, quantity: 2)
         cart.total.should eq(36848)
+        Cartman.config do
+          unit_cost_field :unit_cost
+        end
       end
     end
 
@@ -149,6 +175,7 @@ describe Cartman do
         Cartman.config.redis.exists("cartman:line_item:1").should be_false
         Cartman.config.redis.exists("cartman:line_item:2").should be_false
         Cartman.config.redis.exists("cartman:cart:1:index").should be_false
+        Cartman.config.redis.exists("cartman:cart:1:index:Bottle:17").should be_false
       end
     end
 
@@ -157,6 +184,8 @@ describe Cartman do
         cart.add_item(id: 17, type: "Bottle", name: "Bordeux", unit_cost: 92.12, cost_in_cents: 18424, quantity: 2)
         cart.touch
         cart.ttl.should eq(Cartman.config.cart_expires_in)
+        Cartman.config.redis.ttl("cartman:cart:1:index").should eq(Cartman.config.cart_expires_in)
+        Cartman.config.redis.ttl("cartman:cart:1:index:Bottle:17").should eq(Cartman.config.cart_expires_in)
       end
     end
 
@@ -167,12 +196,14 @@ describe Cartman do
       end
 
       it "should rename the key, and index_key if it exists" do
-        cart.add_item(id: 17, name: "Bordeux", unit_cost: 92.12, cost_in_cents: 18424, quantity: 2)
+        cart.add_item(id: 17, type: "Bottle", name: "Bordeux", unit_cost: 92.12, cost_in_cents: 18424, quantity: 2)
         cart.reassign(2)
         Cartman.config.redis.exists("cartman:cart:1").should be_false
         Cartman.config.redis.exists("cartman:cart:1:index").should be_false
+        Cartman.config.redis.exists("cartman:cart:1:index:Bottle:17").should be_false
         Cartman.config.redis.exists("cartman:cart:2").should be_true
-        Cartman.config.redis.exists("cartman:cart:2:index").should be_false
+        Cartman.config.redis.exists("cartman:cart:2:index").should be_true
+        Cartman.config.redis.exists("cartman:cart:2:index:Bottle:17").should be_true
         cart.send(:key)[-1].should eq("2")
         cart.add_item(id: 18, type: "Bottle", name: "Bordeux", unit_cost: 92.12, cost_in_cents: 18424, quantity: 2)
         cart.reassign(1)

data/spec/item_collection_spec.rb

@@ -0,0 +1,24 @@
+require 'spec_helper'
+
+describe Cartman do
+  describe Cartman::ItemCollection do
+    before(:all) do
+    end
+
+    before(:each) do
+      Cartman.config.redis.flushdb
+      Object.send(:remove_const, :Bottle) if defined?(Bottle)
+      Bottle = double
+      Bottle.stub(:find).and_return(bottle)
+    end
+    
+    describe "#each_with_object" do
+      let(:bottle) { double("Bottle") }
+      it "should be magical" do
+        cart = Cartman::Cart.new(1)
+        cart.add_item(id: 17, type: "Bottle", name: "Bordeux", unit_cost: 92.12, cost: 184.24, quantity: 2) 
+        expect { |b| cart.items.each_with_object(&b)}.to yield_successive_args([cart.items.first, bottle])
+      end
+    end
+  end
+end

data/spec/item_spec.rb

@@ -3,13 +3,13 @@ require 'spec_helper'
 describe Cartman do
   describe Cartman::Item do
     let(:cart) { Cartman::Cart.new(1) }
-    let(:item) { cart.add_item(id: 17, type: "Bottle", name: "Bordeux", unit_cost: 92.12, cost: 184.24, quantity: 2) }
+    let(:item) { cart.add_item(id: 17, type: "Bottle", name: "Bordeux", unit_cost: 92.12, quantity: 2) }
  
     describe "data getters and setters" do
       it "should let me get data stored for the item" do
         item.id.should eq("17")
         item.type.should eq("Bottle")
-        item.cost.should eq("184.24")
+        item.cost.should eq(184.24)
       end
 
       it "should let me modify data stored for the item" do
@@ -26,10 +26,18 @@ describe Cartman do
       end
     end
 
-    describe "#remove" do
+    describe "#cost" do
+      it "should be equal to the unit_cost multiplied by the quantity" do
+        item.cost.should eq(184.24)
+        item.quantity = 3
+        item.cost.should eq(276.36)
+      end
+    end
+
+    describe "#destroy" do
       it "should remove the item from the cart" do
         item_id = item._id
-        item.remove
+        item.destroy
         Cartman.config.redis.sismember(cart.send(:key), item_id).should be_false
         Cartman.config.redis.exists("cartman:line_item:#{item_id}").should be_false
       end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: cartman
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 1.0.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-10-24 00:00:00.000000000 Z
+date: 2012-10-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: redis
@@ -61,8 +61,10 @@ files:
 - lib/cartman/cart.rb
 - lib/cartman/configuration.rb
 - lib/cartman/item.rb
+- lib/cartman/item_collection.rb
 - lib/cartman/version.rb
 - spec/cart_spec.rb
+- spec/item_collection_spec.rb
 - spec/item_spec.rb
 - spec/spec_helper.rb
 homepage: http://github.com/willcosgrove/cartman
@@ -79,7 +81,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 1475251034207197325
+      hash: -4477531500718157343
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
@@ -88,7 +90,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 1475251034207197325
+      hash: -4477531500718157343
 requirements: []
 rubyforge_project: 
 rubygems_version: 1.8.23
@@ -97,5 +99,6 @@ specification_version: 3
 summary: Doing shopping carts like a boss since 2012
 test_files:
 - spec/cart_spec.rb
+- spec/item_collection_spec.rb
 - spec/item_spec.rb
 - spec/spec_helper.rb