ecart 0.0.1

data/.gitignore

@@ -0,0 +1,6 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+.DS_Store
+lib/.DS_Store

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format progress

data/.travis.yml

@@ -0,0 +1,5 @@
+language: ruby
+rvm:
+  - 1.8.7
+  - 1.9.2
+  - 1.9.3

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in ecart.gemspec
+gemspec

data/README.md

@@ -0,0 +1,102 @@
+# Ecart for Rails 3.0 - An e-commerce cart
+Ecart is a simple solution for integrating a cart when you are building
+an online store from scratch, and want to add this functionality
+
+Ecart project integrates a cart to a rails app
+
+[![Build Status](https://secure.travis-ci.org/kurenn/ecart.png?branch=master)](http://travis-ci.org/kurenn/ecart)
+
+## Installing Gem
+
+Include Ecart in Gemfile;
+
+```ruby
+gem "ecart"
+```
+
+or you can install from latest build;
+
+```ruby
+gem 'ecart', :git => 'git@github.com:kurenn/ecart.git'
+```
+
+You can run bundle from command line
+
+    bundle install
+
+## Before installing
+
+I'm assuming you have a Product model on your rails app, but don't worry
+if that's not the case you can customize it as you like
+
+## Installing to App (using Generators)
+
+You can run following generators to get started with Ecart quickly.
+
+
+Install
+
+
+Usage:
+
+
+    rails g ecart:install
+
+This will generate several files that will handle all the cart logic
+(which you can customize later)
+
+## Don't forget to let know rails to load the lib directory
+
+You can do so in the config/application.rb file
+
+```ruby
+config.autoload_paths += Dir["#{config.root}/lib", "#{config.root}/lib/**/"]
+```
+
+## Changelog
+<ul>
+  <li>Current gem v.0.0.1</li>
+</ul>
+
+
+## Contributors & Patches & Forks
+<ul>
+  <li>Abraham Kuri Vargas (@kurenn)</li>
+</ul>
+
+
+## Future
+<ul>
+  <li>Add dinamic association with a model</li>
+  <li>Update the price by fetching from DB</li>
+  <li>Provide views for the cart</li>
+</ul>
+
+
+## Credits
+Abraham Kuri - kurenn@icalialabs.com
+
+[Add Me On Twitter](http://twitter.com/kurenn "Follow me")
+
+[Add Me On Linkedin](http://www.linkedin.com/pub/abraham-kuri/26/a21/b41 "Add Me On Linkedin")
+
+[Add Me On Facebook](https://www.facebook.com/kurenn "Add Me On Facebook")
+
+
+## Score me
+<img src="https://addons.opera.com/media/extensions/55/14355/1.0.1-rev1/icons/icon_64x64.png"></img>
+
+You can +K my influence in Ruby on Rails on @klout
+
+http://klout.com/#/kurenn
+
+
+## License
+Copyright (c) 2011 Abraham Kuri Vargas
+
+This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
+
+This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/gpl.html.
+

data/Rakefile

@@ -0,0 +1,17 @@
+#!/usr/bin/env rake
+require "bundler"
+
+Bundler::GemHelper.install_tasks
+
+desc "Bundle the gem"
+
+task :bundle do
+  sh('bundle install')
+  sh 'gem build *.gemspec'
+  sh 'gem install *.gem'
+  sh 'rm *.gem'
+end
+
+task(:default).clear
+task :default => :bundle
+

data/ecart.gemspec

@@ -0,0 +1,25 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "ecart/version"
+
+Gem::Specification.new do |s|
+  s.name        = "ecart"
+  s.version     = Ecart::VERSION
+  s.authors     = ["Abraham Kuri"]
+  s.email       = ["kurenn@icalialabs.com"]
+  s.homepage    = "https://github.com/kurenn/ecart"
+  s.summary     = %q{E-commerce cart with rails}
+  s.description = %q{Setup a fully functional e-commerce cart}
+
+  s.rubyforge_project = "ecart"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  # specify any dependencies here; for example:
+    s.add_development_dependency 'rails', '>= 3.1'
+    s.add_development_dependency "rspec"
+  # s.add_runtime_dependency "rest-client"
+end

data/lib/cart.rb

@@ -0,0 +1,55 @@
+class Cart
+  attr_reader :cart_items
+
+  def initialize
+    @cart_items = []
+  end
+
+  def add_item(item)
+    cart_item = find_item(item)
+    if !cart_item.nil?
+      cart_item.increment_quantity
+    else
+      @cart_items << CartItem.new(item)
+    end
+  end
+
+  def items
+    @cart_items.map(&:item)
+  end
+
+  def find_item(item)
+    @cart_items.find {|cart_item| cart_item.item.id == item.id }
+  end
+
+  def total
+    total = 0.0
+    @cart_items.each do |cart_item|
+      total += (cart_item.item.price * cart_item.quantity)
+    end
+    total
+  end
+  
+  def total_items
+    @cart_items.map(&:quantity).inject{|sum, q| sum + q}.to_i
+  end
+
+  def remove_item(item)
+    cart_item = find_item(item)
+    if cart_item.quantity > 1
+      cart_item.decrease_quantity
+    else
+      @cart_items.delete_if {|ci| ci == cart_item}
+    end
+  end
+
+  def remove_item!(item)
+    cart_item = find_item(item)
+    @cart_items.delete_if { |ci| ci == cart_item }
+  end
+
+  def empty?
+    self.total_items.zero?
+  end
+
+end

data/lib/cart_item.rb

@@ -0,0 +1,16 @@
+class CartItem
+  attr_reader :item, :quantity
+  
+  def initialize(item)
+    @item = item
+    @quantity = 1
+  end
+
+  def increment_quantity
+    @quantity += 1
+  end
+
+  def decrease_quantity
+    @quantity -= 1
+  end
+end

data/lib/ecart.rb

@@ -0,0 +1,4 @@
+require "ecart/version"
+
+module Ecart
+end

data/lib/ecart/version.rb

@@ -0,0 +1,3 @@
+module Ecart
+  VERSION = "0.0.1"
+end

data/lib/generators/ecart/install/install_generator.rb

@@ -0,0 +1,34 @@
+require 'rails/generators'
+
+module Ecart
+  module Generators
+    class InstallGenerator < ::Rails::Generators::Base
+      source_root File.expand_path("../../../../../lib", __FILE__)
+
+      desc 'This generator install the class cart and cartitem to the lib directory of a rails app'
+
+      def add_ecart
+        copy_file 'cart.rb', 'lib/cart.rb'
+        copy_file 'cart_item.rb', 'lib/cart_item.rb'
+        copy_file 'generators/templates/cart_helper.rb', 'app/helpers/cart_helper.rb'
+        copy_file 'generators/templates/cart_controller.rb', 'app/controllers/cart_controller.rb'
+      end
+
+      def add_ecart_routes
+        app = ::Rails.application
+        @app_name = app.class.to_s.split("::").first
+        insert_into_file 'config/routes.rb', routes, :after => "#{@app_name}::Application.routes.draw do"
+        insert_into_file 'app/controllers/application_controller.rb', "\n\tinclude CartHelper", :after => 'protect_from_forgery'
+      end
+
+      def routes
+        <<CONTENT
+          
+  match 'add_to_cart/:id' => 'cart#add_to_cart', :as => :add_to_cart
+  match 'remove_from_cart/:id' => 'cart#remove_from_cart', :as => :remove_from_cart
+  match 'empty_cart' => 'cart#empty', :as => :empty_cart
+CONTENT
+      end
+    end
+  end
+end

data/lib/generators/templates/cart_controller.rb

@@ -0,0 +1,21 @@
+class CartController < ApplicationController
+
+  def add_to_cart
+    product = Product.find(params[:id]) 
+    @cart = find_cart 
+    @cart.add_item(product)
+    redirect_to :back
+  end
+
+  def remove_from_cart
+    product = Product.find(params[:id]) 
+    @cart = find_cart 
+    @cart.remove_item(product)
+    redirect_to :back
+  end
+
+  def empty
+    empty_cart
+  end
+
+end

data/lib/generators/templates/cart_helper.rb

@@ -0,0 +1,35 @@
+module CartHelper
+  
+  #Find the cart
+  def find_cart
+    session[:cart] ||= Cart.new
+  end
+
+  #Cleans up the cart
+  def empty_cart
+    session[:cart] = nil
+    flash[:notice] = "Your cart is empty"
+    redirect_to :back
+  end
+
+  #Link to empty the cart
+  def link_to_empty_cart
+    link_to "Empty the car", empty_cart_path
+  end
+
+  #Link to add to cart
+  def link_to_add_to_cart(product)
+    link_to "Add to cart", add_to_cart_path(product.id)
+  end
+
+  #Link to remove from cart
+  def link_to_remove_from_cart(product)
+    link_to "Remove from cart", remove_from_cart_path(product.id) if find_cart.find_item(product)
+  end
+
+ #Returns the cart
+  def cart
+    find_cart
+  end
+end
+

data/lib/item.rb

@@ -0,0 +1,10 @@
+class Item
+  attr_accessor :id, :name, :price
+
+  def initialize(attr = {})
+    @id = attr[:id]
+    @price = attr[:price]
+    @name = attr[:name]
+  end
+end
+

data/spec/cart_spec.rb

@@ -0,0 +1,127 @@
+require 'spec_helper'
+require 'cart'
+require 'item'
+require 'cart_item'
+
+
+describe Cart do
+  let(:cart) { Cart.new }
+
+  it 'should initialize with an empty array of items' do
+    cart.items.should == []
+  end
+
+  describe '#add_item' do
+    it 'should add the id of the item to the cart' do
+      item = Item.new({:id => 1})
+      cart.add_item(item)
+      cart.items.should include(item)
+    end
+
+    it 'should increment the quantity of the item if it exists' do
+      item = Item.new({:id => 1})
+      other_item = Item.new({:id => 1})
+      cart.add_item(item)
+      cart.add_item(other_item)
+      cart.cart_items.first.quantity.should == 2
+    end
+  end
+
+  describe '#find_item' do
+    it 'should return nil if no object found' do
+      item = Item.new({:id => 1})
+      cart.find_item(item).should be_nil
+    end
+
+    it 'should return the cart item when item is found' do
+      item = Item.new({:id => 1})
+      cart.add_item(item)
+      cart.find_item(item).should_not be_nil
+    end
+  end
+
+  describe '#total' do
+    it 'should return 0.0 when no cart items' do
+      cart.total.should == 0.0
+    end
+
+    it 'should return the total of the cart' do
+      cart.add_item(Item.new({:id => 1, :price => 12.5, :name => "Ball"}))
+      cart.add_item(Item.new({:id => 2, :price => 10, :name => "Soccer ball"}))
+      cart.add_item(Item.new({:id => 2}))
+      cart.total.should == 32.5
+    end
+  end
+
+  describe '#remove_item' do
+    it 'removes the item from the cart' do
+      item = Item.new({:id => 1})
+      cart.add_item(item)
+      cart.remove_item(item)
+      cart.items.should_not include(item)
+    end
+
+    it 'should decrease the quantity of the cart_item' do
+      item = Item.new({:id => 2, :price => 10, :name => "Soccer ball"})
+      cart.add_item(item)
+      cart.add_item(item)
+      cart.remove_item(item)
+      cart.items.should include(item)
+      cart.find_item(item).quantity.should == 1
+    end
+
+    it 'should delete the item when there is just one' do
+      item = Item.new({:id => 2, :price => 10, :name => "Soccer ball"})
+      cart.add_item(item)
+      cart.remove_item(item)
+      cart.items.should_not include(item)
+    end
+  end
+
+  describe '#remove_item!' do
+    
+    it 'should remove the item no matter what' do
+      item = Item.new({:id => 1})
+      cart.add_item(item)
+      cart.add_item(item)
+      cart.remove_item!(item)
+      cart.items.should_not include(item)
+    end
+
+    it 'should remove only if the cart item is in the cart' do
+      item = Item.new({:id => 1})
+      cart.remove_item!(item).should be_empty
+    end
+  end
+
+  describe '#total_items' do
+
+    it 'should return the total number of items in the cart' do
+      item = Item.new({:id => 1})
+      other_item = Item.new({:id => 2})
+      cart.add_item(item)
+      cart.add_item(other_item)
+      cart.add_item(item)
+      cart.total_items.should == 3
+    end
+
+    it 'should return 0 if no items in the cart' do
+      cart.total_items.should == 0
+    end
+  end
+
+  describe '#empty?' do
+
+    it 'should return true if cart is empty' do
+      cart.should be_empty
+    end
+
+    it 'should return false if the cart is not empty' do
+      item = Item.new({:id => 1})
+      cart.add_item(item)
+      cart.should_not be_empty
+    end
+  end
+
+end
+

data/spec/spec_helper.rb

@@ -0,0 +1,17 @@
+# This file was generated by the `rspec --init` command. Conventionally, all
+# specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
+# Require this file using `require "spec_helper"` to ensure that it is only
+# loaded once.
+#
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+RSpec.configure do |config|
+  config.treat_symbols_as_metadata_keys_with_true_values = true
+  config.run_all_when_everything_filtered = true
+  config.filter_run :focus
+
+  # Run specs in random order to surface order dependencies. If you find an
+  # order dependency and want to debug it, you can fix the order by providing
+  # the seed, which is printed after each run.
+  #     --seed 1234
+  config.order = 'random'
+end

metadata

@@ -0,0 +1,86 @@
+--- !ruby/object:Gem::Specification
+name: ecart
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Abraham Kuri
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-07-09 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: &70212394340520 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '3.1'
+  type: :development
+  prerelease: false
+  version_requirements: *70212394340520
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &70212394339800 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70212394339800
+description: Setup a fully functional e-commerce cart
+email:
+- kurenn@icalialabs.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- .travis.yml
+- Gemfile
+- README.md
+- Rakefile
+- ecart.gemspec
+- lib/cart.rb
+- lib/cart_item.rb
+- lib/ecart.rb
+- lib/ecart/version.rb
+- lib/generators/ecart/install/install_generator.rb
+- lib/generators/templates/cart_controller.rb
+- lib/generators/templates/cart_helper.rb
+- lib/item.rb
+- spec/cart_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/kurenn/ecart
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: ecart
+rubygems_version: 1.8.12
+signing_key: 
+specification_version: 3
+summary: E-commerce cart with rails
+test_files:
+- spec/cart_spec.rb
+- spec/spec_helper.rb