badcards 0.2.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 4cf97c02eabece811867193a76a7c01e0aea1ee8
+  data.tar.gz: 8217a7d8870e2520fe9dc9bcd1f10e730a16239a
+SHA512:
+  metadata.gz: 7b973f25983514a5e507dc0f8891418572570aacbe2285cc75542f6e564debfca71003db0cab30a348d8d042c252e8f946fb0f5c99dccb254b19ae4e6f888111
+  data.tar.gz: 3ab531f6455671af4c0bc0671357d1a4c2d297f6e0330ead76f6ac7b7507a33de1a41cd5b2c026f58eba20a0a01aab614c930fc14e9b2e6bd8a870e160a8a86a

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/.rspec

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

data/.travis.yml

@@ -0,0 +1,3 @@
+language: ruby
+rvm:
+  - 2.1.0

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Benjamin Hsieh
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,35 @@
+# BaDcards
+[![Build Status](https://travis-ci.org/BensPotatoes/BaDCards.svg?branch=master)](https://travis-ci.org/BensPotatoes/BaDCards)
+[![Coverage Status](https://coveralls.io/repos/BensPotatoes/BaDCards/badge.png?branch=master)](https://coveralls.io/r/BensPotatoes/BaDCards?branch=master)
+
+Ruby library of playing cards.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'badcards'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install badcards
+
+## Usage
+
+```
+card = Card.new("Ace", "Spades") # create an "Ace of Spades" card
+hand = Hand.new # create a hand that can hold onto cards
+deck = Deck.new(6) # create a deck consisting of six mini-decks of 52 cards
+```
+
+## Contributing
+
+1. Fork it ( http://github.com/benspotatoes/badcards/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,10 @@
+require "bundler/gem_tasks"
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec
+
+task :report do
+  sh 'coveralls report'
+end

data/badcards.gemspec

@@ -0,0 +1,25 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'badcards/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "badcards"
+  spec.version       = Badcards::VERSION
+  spec.authors       = ["Benjamin Hsieh, Ben's Potatoes"]
+  spec.email         = ["benspotatoes@gmail.com"]
+  spec.summary       = %q{Ruby library for playing cards including BaDEmporium images.}
+  spec.description   = %q{Includes cards, decks (of multiple sizes), hands, and drawing (of multiple cards).}
+  spec.homepage      = "http://github.com/sicophrenic/badcards"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.5"
+  spec.add_development_dependency "rake", "~> 10.1.0", ">= 10.1.0"
+  spec.add_development_dependency "rspec", "~> 2.14.1", ">= 2.14.1"
+  spec.add_development_dependency "coveralls", "~> 0.7.0", ">= 0.7.0"
+end

data/lib/badcards.rb

@@ -0,0 +1,4 @@
+require "badcards/version"
+require "badcards/card"
+require "badcards/deck"
+require "badcards/hand"

data/lib/badcards/card.rb

@@ -0,0 +1,94 @@
+class Card
+  SUITS = %w[Diamonds Clubs Hearts Spades]
+  VALUES = %w[Ace 2 3 4 5 6 7 8 9 10 Jack Queen King]
+
+  S3_URLS = {
+    "ace+diamonds" => "https://s3-us-west-2.amazonaws.com/badcards/cards/diamond/ace.png",
+    "two+diamonds" => "https://s3-us-west-2.amazonaws.com/badcards/cards/diamond/two.png",
+    "three+diamonds" => "https://s3-us-west-2.amazonaws.com/badcards/cards/diamond/three.png",
+    "four+diamonds" => "https://s3-us-west-2.amazonaws.com/badcards/cards/diamond/four.png",
+    "five+diamonds" => "https://s3-us-west-2.amazonaws.com/badcards/cards/diamond/five.png",
+    "six+diamonds" => "https://s3-us-west-2.amazonaws.com/badcards/cards/diamond/six.png",
+    "seven+diamonds" => "https://s3-us-west-2.amazonaws.com/badcards/cards/diamond/seven.png",
+    "eight+diamonds" => "https://s3-us-west-2.amazonaws.com/badcards/cards/diamond/eight.png",
+    "nine+diamonds" => "https://s3-us-west-2.amazonaws.com/badcards/cards/diamond/nine.png",
+    "ten+diamonds" => "https://s3-us-west-2.amazonaws.com/badcards/cards/diamond/ten.png",
+    "jack+diamonds" => "https://s3-us-west-2.amazonaws.com/badcards/cards/diamond/jack.png",
+    "queen+diamonds" => "https://s3-us-west-2.amazonaws.com/badcards/cards/diamond/queen.png",
+    "king+diamonds" => "https://s3-us-west-2.amazonaws.com/badcards/cards/diamond/king.png",
+
+    "ace+clubs" => "https://s3-us-west-2.amazonaws.com/badcards/cards/club/ace.png",
+    "two+clubs" => "https://s3-us-west-2.amazonaws.com/badcards/cards/club/two.png",
+    "three+clubs" => "https://s3-us-west-2.amazonaws.com/badcards/cards/club/three.png",
+    "four+clubs" => "https://s3-us-west-2.amazonaws.com/badcards/cards/club/four.png",
+    "five+clubs" => "https://s3-us-west-2.amazonaws.com/badcards/cards/club/five.png",
+    "six+clubs" => "https://s3-us-west-2.amazonaws.com/badcards/cards/club/six.png",
+    "seven+clubs" => "https://s3-us-west-2.amazonaws.com/badcards/cards/club/seven.png",
+    "eight+clubs" => "https://s3-us-west-2.amazonaws.com/badcards/cards/club/eight.png",
+    "nine+clubs" => "https://s3-us-west-2.amazonaws.com/badcards/cards/club/nine.png",
+    "ten+clubs" => "https://s3-us-west-2.amazonaws.com/badcards/cards/club/ten.png",
+    "jack+clubs" => "https://s3-us-west-2.amazonaws.com/badcards/cards/club/jack.png",
+    "queen+clubs" => "https://s3-us-west-2.amazonaws.com/badcards/cards/club/queen.png",
+    "king+clubs" => "https://s3-us-west-2.amazonaws.com/badcards/cards/club/king.png",
+
+    "ace+hearts" => "https://s3-us-west-2.amazonaws.com/badcards/cards/heart/ace.png",
+    "two+hearts" => "https://s3-us-west-2.amazonaws.com/badcards/cards/heart/two.png",
+    "three+hearts" => "https://s3-us-west-2.amazonaws.com/badcards/cards/heart/three.png",
+    "four+hearts" => "https://s3-us-west-2.amazonaws.com/badcards/cards/heart/four.png",
+    "five+hearts" => "https://s3-us-west-2.amazonaws.com/badcards/cards/heart/five.png",
+    "six+hearts" => "https://s3-us-west-2.amazonaws.com/badcards/cards/heart/six.png",
+    "seven+hearts" => "https://s3-us-west-2.amazonaws.com/badcards/cards/heart/seven.png",
+    "eight+hearts" => "https://s3-us-west-2.amazonaws.com/badcards/cards/heart/eight.png",
+    "nine+hearts" => "https://s3-us-west-2.amazonaws.com/badcards/cards/heart/nine.png",
+    "ten+hearts" => "https://s3-us-west-2.amazonaws.com/badcards/cards/heart/ten.png",
+    "jack+hearts" => "https://s3-us-west-2.amazonaws.com/badcards/cards/heart/jack.png",
+    "queen+hearts" => "https://s3-us-west-2.amazonaws.com/badcards/cards/heart/queen.png",
+    "king+hearts" => "https://s3-us-west-2.amazonaws.com/badcards/cards/heart/king.png",
+
+    "ace+spades" => "https://s3-us-west-2.amazonaws.com/badcards/cards/spade/ace.png",
+    "two+spades" => "https://s3-us-west-2.amazonaws.com/badcards/cards/spade/two.png",
+    "three+spades" => "https://s3-us-west-2.amazonaws.com/badcards/cards/spade/three.png",
+    "four+spades" => "https://s3-us-west-2.amazonaws.com/badcards/cards/spade/four.png",
+    "five+spades" => "https://s3-us-west-2.amazonaws.com/badcards/cards/spade/five.png",
+    "six+spades" => "https://s3-us-west-2.amazonaws.com/badcards/cards/spade/six.png",
+    "seven+spades" => "https://s3-us-west-2.amazonaws.com/badcards/cards/spade/seven.png",
+    "eight+spades" => "https://s3-us-west-2.amazonaws.com/badcards/cards/spade/eight.png",
+    "nine+spades" => "https://s3-us-west-2.amazonaws.com/badcards/cards/spade/nine.png",
+    "ten+spades" => "https://s3-us-west-2.amazonaws.com/badcards/cards/spade/ten.png",
+    "jack+spades" => "https://s3-us-west-2.amazonaws.com/badcards/cards/spade/jack.png",
+    "queen+spades" => "https://s3-us-west-2.amazonaws.com/badcards/cards/spade/queen.png",
+    "king+spades" => "https://s3-us-west-2.amazonaws.com/badcards/cards/spade/king.png"
+  }
+
+  def initialize(value, suit)
+    if !VALUES.include?(value)
+      raise ArgumentError, "Invalid Card value"
+    end
+    if !SUITS.include?(suit)
+      raise ArgumentError, "Invalid Card suit"
+    end
+    @value = value
+    @suit = suit
+    @image = S3_URLS["#{value.downcase}+#{suit.downcase}"]
+  end
+
+  def value
+    @value
+  end
+
+  def suit
+    @suit
+  end
+
+  def img
+    @image
+  end
+
+  def self.all_cards
+    VALUES.each do |value|
+      SUITS.each do |suit|
+        yield value, suit
+      end
+    end
+  end
+end

data/lib/badcards/deck.rb

@@ -0,0 +1,42 @@
+class Deck
+  def initialize(num_decks = 1)
+    @cards = []
+    num_decks.times do
+      Card.all_cards do |value, suit|
+        @cards << Card.new(value, suit)
+      end
+    end
+  end
+
+  def cards
+    @cards
+  end
+
+  def size
+    @cards.count
+  end
+
+  def peek
+    @cards.first
+  end
+
+  def draw(num_to_draw = 1, hand_for_draw = nil)
+    @drawn = []
+    num_to_draw.times do
+      if card = @cards.shift
+        @drawn << card
+      else
+        break
+      end
+    end
+    if hand_for_draw && hand_for_draw.is_a?(Hand)
+      hand_for_draw.cards += @drawn
+    else
+      if @drawn.count <= 1
+        return @drawn.first
+      else
+        return @drawn
+      end
+    end
+  end
+end

data/lib/badcards/hand.rb

@@ -0,0 +1,21 @@
+class Hand
+  def initialize
+    @cards = []
+  end
+
+  def cards
+    @cards
+  end
+
+  def cards=(new_cards)
+    @cards = new_cards
+  end
+
+  def add_card(card)
+    @cards << card
+  end
+
+  def add_cards(cards)
+    @cards += cards
+  end
+end

data/lib/badcards/version.rb

@@ -0,0 +1,3 @@
+module Badcards
+  VERSION = "0.2.0"
+end

data/spec/badcards/card_spec.rb

@@ -0,0 +1,25 @@
+require 'spec_helper'
+
+describe Card do
+  describe 'values' do
+    Card.all_cards do |value, suit|
+      it 'should return the appropriate suit' do
+        make_card(value, suit)
+        @card.suit.should == suit
+      end
+
+      it 'should return the appropriate value' do
+        make_card(value, suit)
+        @card.value.should == value
+      end
+    end
+
+    it 'should fail for an invalid suit' do
+      expect { make_card('Ace', 'fake_suit') }.to raise_error
+    end
+
+    it 'should fail for an invalid value' do
+      expect { make_card('fake_value', 'Spades') }.to raise_error
+    end
+  end
+end

data/spec/badcards/deck_spec.rb

@@ -0,0 +1,119 @@
+require 'spec_helper'
+
+describe Deck do
+  describe 'creation' do
+    describe 'defaults' do
+      before(:all) do
+        make_deck
+      end
+
+      it 'should create a deck with 52 cards' do
+        @deck.size.should == 52
+      end
+
+      it 'should have every single combination of card suit and value' do
+        found_cards = []
+        @deck.cards.each do |card|
+          Card.all_cards do |value, suit|
+            @match = ((card.suit == suit) && (card.value == value))
+            if @match
+              break
+            end
+          end
+          if @match
+            found_cards << true
+            next
+          else
+            found_cards << false
+          end
+        end
+      end
+    end
+
+    describe 'custom' do
+      it 'should create a specific deck size' do
+        custom_size = 6
+        @deck = Deck.new(custom_size)
+        @deck.size.should == custom_size * 52
+      end
+    end
+  end
+
+  describe 'operation' do
+    describe 'shuffling' do
+      pending("can't be tested?")
+    end
+
+    describe 'drawing' do
+      describe 'peek' do
+        before(:all) do
+          @deck_size = 6
+          @card_count = @deck_size * 52
+          make_deck(@deck_size)
+          make_hand
+        end
+
+        it 'should return the first card in the deck' do
+          top_card = @deck.peek
+          top_card.should == @deck.cards.first
+        end
+
+        it 'should not draw a card from the deck' do
+          top_card = @deck.peek
+          @deck.cards.count.should == @card_count
+        end
+      end
+
+      describe 'single' do
+        before(:all) do
+          @deck_size = 6
+          @card_count = @deck_size * 52
+          make_deck(@deck_size)
+          make_hand
+        end
+
+        it 'should return a single card' do
+          new_card = @deck.draw
+          @deck.cards.count.should == @card_count - 1
+        end
+      end
+
+      describe 'multiple' do
+        before(:all) do
+          @deck_size = 6
+          @card_count = @deck_size * 52
+          make_deck(@deck_size)
+          make_hand
+        end
+
+        it 'should return an array of cards' do
+          draw_count = 5
+          new_cards = @deck.draw(draw_count)
+          new_cards.class.should == Array
+          @deck.cards.count.should == @card_count - draw_count
+        end
+      end
+
+      describe 'limit' do
+        it 'should return all possible cards if there are not enough cards' do
+          @new_deck = Deck.new
+          @num_to_draw = 51
+          @new_deck.draw(@num_to_draw)
+          @new_deck.cards.count.should == 52 - @num_to_draw
+          new_cards = @new_deck.draw(5)
+          @new_deck.cards.count.should == 0
+          new_cards.class.should == Card
+        end
+
+        it 'should return nil if there are no more cards' do
+          @new_deck = Deck.new
+          @new_deck.draw(52)
+          @new_deck.cards.count.should == 0
+          new_cards = @new_deck.draw(5)
+          @new_deck.cards.count.should == 0
+          new_cards.should == nil
+        end
+      end
+    end
+  end
+end

data/spec/badcards/hand_spec.rb

@@ -0,0 +1,57 @@
+require 'spec_helper'
+
+describe Hand do
+  describe 'drawing cards' do
+    describe 'manual' do
+      describe 'single' do
+        before(:all) do
+          make_deck(6)
+          make_hand
+        end
+        it 'should add the card(s) to the hand' do
+          new_card = @deck.peek
+          @hand.add_card(@deck.draw)
+          @hand.cards.count.should == 1
+          @hand.cards.should include(new_card)
+        end
+      end
+
+      describe 'multiple' do
+        before(:all) do
+          make_deck(6)
+          make_hand
+        end
+        it 'should add the card(s) to the hand' do
+          @hand.add_cards(@deck.draw(5))
+          @hand.cards.count.should == 5
+        end
+      end
+    end
+
+    describe 'automatic' do
+      describe 'single' do
+        before(:all) do
+          make_deck(6)
+          make_hand
+        end
+        it 'should add the card(s) to the hand' do
+          new_card = @deck.peek
+          @deck.draw(1, @hand)
+          @hand.cards.count.should == 1
+          @hand.cards.should include(new_card)
+        end
+      end
+
+      describe 'multiple' do
+        before(:all) do
+          make_deck(6)
+          make_hand
+        end
+        it 'should add the card(s) to the hand' do
+          @deck.draw(5, @hand)
+          @hand.cards.count.should == 5
+        end
+      end
+    end
+  end
+end

data/spec/helper.rb

@@ -0,0 +1,13 @@
+module Helper
+  def make_card(value, suit)
+    @card = Card.new(value, suit)
+  end
+
+  def make_deck(num_decks = 1)
+    @deck = Deck.new(num_decks)
+  end
+
+  def make_hand
+    @hand = Hand.new
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,25 @@
+require 'coveralls'
+Coveralls.wear!
+
+# 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
+
+require 'badcards'
+
+require 'helper'
+include Helper

metadata

@@ -0,0 +1,142 @@
+--- !ruby/object:Gem::Specification
+name: badcards
+version: !ruby/object:Gem::Version
+  version: 0.2.0
+platform: ruby
+authors:
+- Benjamin Hsieh, Ben's Potatoes
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-03-27 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 10.1.0
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 10.1.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 10.1.0
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 10.1.0
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.14.1
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.14.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.14.1
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.14.1
+- !ruby/object:Gem::Dependency
+  name: coveralls
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.7.0
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.7.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.7.0
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.7.0
+description: Includes cards, decks (of multiple sizes), hands, and drawing (of multiple
+  cards).
+email:
+- benspotatoes@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- badcards.gemspec
+- lib/badcards.rb
+- lib/badcards/card.rb
+- lib/badcards/deck.rb
+- lib/badcards/hand.rb
+- lib/badcards/version.rb
+- spec/badcards/card_spec.rb
+- spec/badcards/deck_spec.rb
+- spec/badcards/hand_spec.rb
+- spec/helper.rb
+- spec/spec_helper.rb
+homepage: http://github.com/sicophrenic/badcards
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Ruby library for playing cards including BaDEmporium images.
+test_files:
+- spec/badcards/card_spec.rb
+- spec/badcards/deck_spec.rb
+- spec/badcards/hand_spec.rb
+- spec/helper.rb
+- spec/spec_helper.rb