card_nine 0.4.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 854dfb09dcd2e62f7ec6b5c965862bb9f962753b
+  data.tar.gz: 9f052c35d78081007e70e590297399bd45aea9f9
+SHA512:
+  metadata.gz: 84002ce61aa852ffd44c0d75e20fa0718595248bd02175d78ad3fab7ceda2ab3f8a6b3d5d9a28d779809ee2000e263c8aafa8de768be3c82cf2f29b281220b9e
+  data.tar.gz: 9d195cbcb17037dab55d72f8fa4f3180525342f242ba1c608d18f4315371864161827ce355d0f34bbac8e5d7b8d968bc925b50a2af468bcaa335b3a9d5ec681d

data/.gitignore

@@ -0,0 +1,15 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log
+.idea

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--require spec_helper

data/.travis.yml

@@ -0,0 +1,7 @@
+language: ruby
+before_install:
+- gem uninstall bundler
+- gem install bundler --version '1.7.6'
+rvm:
+- 2.1
+script: bundle exec rake

data/Gemfile

@@ -0,0 +1,8 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in card_nine.gemspec
+gemspec
+
+group :test do
+  gem 'pullreview-coverage', require: false
+end

data/Guardfile

@@ -0,0 +1,24 @@
+# A sample Guardfile
+# More info at https://github.com/guard/guard#readme
+
+guard :bundler do
+  watch('Gemfile')
+
+  watch(/^.+\.gemspec/)
+end
+
+# Note: The cmd option is now required due to the increasing number of ways
+#       rspec may be run, below are examples of the most common uses.
+#  * bundler: 'bundle exec rspec'
+#  * bundler binstubs: 'bin/rspec'
+#  * spring: 'bin/rsspec' (This will use spring if running and you have
+#                          installed the spring binstubs per the docs)
+#  * zeus: 'zeus rspec' (requires the server to be started separetly)
+#  * 'just' rspec: 'rspec'
+guard :rspec, cmd: 'bundle exec rspec' do
+  watch(%r{^spec/.+_spec\.rb$})
+  watch(%r{^lib/(.+)\.rb$}) { |m| "spec/lib/#{m[1]}_spec.rb" }
+  watch('spec/spec_helper.rb') { "spec" }
+
+end
+

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Scott M Parrish
+
+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 @@
+# CardNine
+[![Build Status](https://travis-ci.org/anithri/card_nine.svg?branch=master)](https://travis-ci.org/anithri/card_nine)
+[![PullReview stats](https://www.pullreview.com/github/anithri/card_nine/badges/master.svg?)](https://www.pullreview.com/github/anithri/card_nine/reviews/master)
+[![Dependency Status](https://gemnasium.com/anithri/card_nine.svg)](https://gemnasium.com/anithri/card_nine)
+
+A Small set of classes to help model decks of cards for board games.  Cards,
+Decks and Deals to help you make your games.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'card_nine'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install card_nine
+
+## Usage
+
+TODO: Write usage instructions here
+
+## Contributing
+
+1. Fork it ( https://github.com/[my-github-username]/card_nine/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 a new Pull Request

data/Rakefile

@@ -0,0 +1,10 @@
+require "bundler/gem_tasks"
+require 'rake/version_task'
+require 'rspec/core/rake_task'
+
+Rake::VersionTask.new
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default  => :spec
+

data/Thorfile

@@ -0,0 +1,39 @@
+require 'facets/string/pathize'
+require 'facets/string/camelcase'
+class NewMethod < Thor::Group
+  include Thor::Actions
+
+  # Define arguments and options
+  argument :name
+
+  def self.source_root
+    File.dirname(__FILE__)
+  end
+
+  def create_lib_file
+    file_name = name.pathize
+    parts     = name.split('::')
+    create_file "lib/#{file_name}.rb" do
+      out = ''
+      parts.each_with_index do |part, i|
+        keyword = (i == parts.length - 1) ? 'class' : 'module'
+        indent  = '  ' * i
+        out     += indent + keyword + ' ' + part.camelcase(:upper) + "\n"
+      end
+      parts.length.times do |i|
+        indent = '  ' * (parts.length - i - 1)
+        out    += "#{indent}end\n"
+      end
+      out
+    end
+  end
+
+  def create_spec_file
+    file_name = name.pathize
+    create_file "spec/#{file_name}_spec.rb" do
+      "require 'rspec'\nrequire '#{file_name}'\n\ndescribe #{name} do\n\nend\n"
+
+    end
+  end
+end
+

data/VERSION

@@ -0,0 +1 @@
+0.4.1

data/card_nine.gemspec

@@ -0,0 +1,33 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+Gem::Specification.new do |spec|
+  spec.name          = 'card_nine'
+  spec.version       = File.read('VERSION')
+  spec.authors       = ['Scott M Parrish']
+  spec.email         = ['anithri@gmail.com']
+  spec.summary       = %q{Game Dev Toolbox. Cards }
+  spec.description   = %q{A Toolbox to help me build a board game.}
+  spec.homepage      = ''
+  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_runtime_dependency 'virtus', '~> 1.0.3'
+  spec.add_runtime_dependency 'facets', '~> 2.9.3'
+  spec.add_runtime_dependency 'hashie', '~> 3.3.1'
+
+  spec.add_development_dependency 'bundler', '~> 1.7.6'
+  spec.add_development_dependency 'rake', '~> 10.3.2'
+  spec.add_development_dependency 'thor', '~> 0.19.1'
+  spec.add_development_dependency 'rspec', '~> 3.1.0'
+  spec.add_development_dependency 'guard-rspec', '~> 4.3.1'
+  spec.add_development_dependency 'guard-bundler', '~> 2.0.0'
+  spec.add_development_dependency 'version', '~> 1.0.0'
+  spec.add_development_dependency 'fuubar', '~> 2.0.0'
+  spec.add_development_dependency 'pry'
+end

data/lib/card_nine/card.rb

@@ -0,0 +1,22 @@
+require 'virtus'
+
+module CardNine
+  # provides the base functionality required of a card
+  module Card
+    # @!method initialize(args = nil)
+    #   will set the instance vars using the keys of args as a attribute name
+    #   @param [Hash, Nil] args
+
+    include Virtus.module
+
+    attribute :name
+    attribute :id
+
+    # @!attribute [rw] name
+    #   @return [String,Symbol,#to_s,Object] name of the card
+    # @!attribute [rw] id
+    #   @return [String,Symbol,Object] id of the card
+
+  end
+
+end

data/lib/card_nine/cards/playing_card.rb

@@ -0,0 +1,46 @@
+require 'card_nine/card'
+
+module CardNine
+  module Cards
+    class PlayingCard
+      # @note implements comparable
+      include Comparable
+
+      # @!method initialize(args = nil)
+      #   will set the instance vars using the keys of args as a attribute name
+      #   @param [Hash, Nil] args
+      include Card
+
+      # ALL Suits of cards
+      SUITS = %w|Clubs Hearts Diamonds Spades|.freeze
+      # All Ranks of cards
+      RANKS = %w|2 3 4 5 6 7 8 9 10 Jack Queen King Ace|.freeze
+
+      # @!attribute [rw] suit
+      #   @return [String] suit of card
+      attribute :suit, String
+      # @!attribute [rw] rank
+      #   @return [String] rank of card
+      attribute :rank, String
+
+      # implement sort based on rank of the card, 2 low ace high
+      def <=>(other)
+        RANKS.find_index(rank) <=> RANKS.find_index(other.rank)
+      end
+
+      # create and return a standard 52 card deck of playing cards
+      def self.deck(rng = Random.new)
+        all = []
+        SUITS.each do |suit|
+          RANKS.each do |rank|
+            id = rank.to_i > 0 ? rank : rank[0]
+            id += suit[0]
+            all << { rank: rank, suit: suit, id: id, name: "#{rank} of #{suit}" }
+          end
+        end
+        Deck.new(cards: all.map { |c| self.new(c) }, rng: rng)
+
+      end
+    end
+  end
+end

data/lib/card_nine/cards/simple_card.rb

@@ -0,0 +1,11 @@
+module CardNine
+  module Cards
+    # The simplest card possible.  A Nothing added class with Card included
+    class SimpleCard
+      # @!method initialize(args = nil)
+      #   will set the instance vars using the keys of args as a attribute name
+      #   @param [Hash, Nil] args
+      include Card
+    end
+  end
+end

data/lib/card_nine/dealer.rb

@@ -0,0 +1,4 @@
+module CardNine
+  class Dealer
+  end
+end

data/lib/card_nine/dealers/texas_holdem.rb

@@ -0,0 +1,46 @@
+require 'card_nine/cards/playing_card'
+module CardNine
+  module Dealers
+    # implements a CardNine::Dealer for the game of Texas Holdem.  This is only
+    #   the card movement, the betting, UI, and hand evaluation are out of the
+    #   scope of this library
+    # @example
+    # card_eval = PretendCardEval.new
+    # ui = PretendUI.new
+    # wagering = PretendTexasHoldemBettingService.new
+    # players = %w|Bruce Barbera Dick|
+    # dealer = CardNine::Dealers::TexasHoldem.new(players: players)
+    # hand = dealer.new_hand
+    # ui.update(hand)
+    # wagering(:ante, hand)
+    # [:deal_hole_cards, :flop, :turn, :river].each do |stage|
+    #   ui.update(hand.deal_stage(stage))
+    #   wagering(:round, hand)
+    # end
+    # wager(:resolve, hand)
+    class TexasHoldem
+
+      attr_accessor :players, :deck
+
+      STAGES = {
+          deal_hole_cards: ->(h) { h.deal_players(2) },
+          flop:            ->(h) { h.discard; h.deal(3, to: :community) },
+          turn:            ->(h) { h.discard; h.deal(to: :community) },
+          river:           ->(h) { h.discard; h.deal(to: :community) }
+      }
+
+      def initialize(players:, deck: CardNine::Cards::PlayingCard.deck)
+        @players = players
+        @deck    = deck
+      end
+
+      # generate a new hand from this dealer
+      # @return [CardNine::Hand]
+      def new_hand
+        players.rotate!
+        Hand.start(players: players, deck: deck, stages: STAGES)
+      end
+
+    end
+  end
+end

data/lib/card_nine/deck.rb

@@ -0,0 +1,21 @@
+module CardNine
+  class Deck
+    # @!method initialize(args = nil)
+    #   will set the instance vars using the keys of args as a attribute name
+    #   @param [Hash, Nil] args
+    include Virtus.model
+
+    # @!attribute [rw] cards
+    #   @return [Array<Card>] all cards in the deck
+    attribute :cards, Array[Card], default: []
+
+    # @!attribute [rw] rng
+    #   @return [Random,#rand]
+    attribute :rng, Random, default: ->(*a) { Random.new }
+
+    # @return Array[Card] randomized
+    def shuffle
+      cards.shuffle(random: rng)
+    end
+  end
+end

data/lib/card_nine/hand.rb

@@ -0,0 +1,63 @@
+require 'virtus'
+require 'card_nine/deck'
+require 'card_nine/table'
+module CardNine
+  class Hand
+    include Virtus.model
+
+    # @!attribute [rw] deck
+    #   @return [CardNine::Deck]
+    attribute :deck, CardNine::Deck
+
+    # @!attribute [rw] players
+    #   @return [Array]
+    attribute :players, Array, default: []
+
+    # @!attribute [rw] table
+    #   @return [CardNine::Table]
+    attribute :table, CardNine::Table, default: :initialize_table
+
+    attribute :stages, Hash, default: {}
+
+    # create a new hand, yield to a setup block if given
+    def self.start(args = nil)
+      hand = self.new(args)
+      yield hand if block_given?
+      hand
+    end
+
+    # pass deal commands to table
+    # @yieldparam [Table] table for current hand
+    def deal(count = 1, from: :shoe, to:)
+      table.move_card(count, from: from, to: to)
+    end
+
+    def deal_players(count = 1, from: :shoe)
+      count.times do
+        players.each do |p|
+          deal(1, from: from, to: p)
+        end
+      end
+    end
+
+    def discard(count = 1, from: :shoe)
+      deal(count, from: from, to: :discards)
+    end
+
+    def deal_stage(stage_name = nil, &blk)
+      stages[stage_name].call(self) if stage_name && stages[stage_name]
+      blk.call(self) if blk
+      self
+    end
+
+    # @return Array<Card> cards at +loc+ location on table
+    def at(loc)
+      table.at(loc)
+    end
+
+    private
+    def initialize_table
+      CardNine::Table.new(players: players, deck: deck)
+    end
+  end
+end

data/lib/card_nine/table.rb

@@ -0,0 +1,38 @@
+require 'virtus'
+module CardNine
+  # a CardNine::Table is the shoe, discard pile, and player hands
+  class Table
+    include Virtus.model
+
+    # @!attribute [rw] deck
+    #   @return [CardNine::Deck, #shuffle]
+    attribute :deck
+
+    # @!attribute [rw] players
+    #   @return [Array<Object>] all players at this table
+    attribute :players, Array, default: []
+
+    # locations as key for array of cards
+    def layout
+      @layout ||= init_layout
+    end
+
+    # deal move +count+ card(s) +from+ the top of one @layout location +to+ top of another
+    def move_card(count = 1, from: :shoe, to:)
+      layout[to].unshift(*(layout[from].shift(count)))
+    end
+
+    # return all cards at +loc+ in layout
+    def at(loc)
+      layout[loc]
+    end
+
+    private
+    def init_layout
+      l        = Hash.new { |h, k| h[k] = [] }
+      l[:shoe] = self.deck.shuffle
+      return l
+    end
+
+  end
+end

data/lib/card_nine.rb

@@ -0,0 +1,13 @@
+# CardNine is a programmers toolkit providing abstractions for cards, decks, dealers, and
+#   hands.  It also provides a pair of sample games that use the system.
+#   A Card is the base unit and can be as simple as a name, slightly more complicated like
+#   a playing card with ranks, suits and sorting.  Attributes and keyword lists will make even
+#   the most complicated
+module CardNine
+  require 'card_nine/card'
+  require 'card_nine/deck'
+  require 'card_nine/dealer'
+  require 'card_nine/table'
+  require 'card_nine/hand'
+
+end

data/spec/card_nine/card_spec.rb

@@ -0,0 +1,18 @@
+require 'rspec'
+require 'card_nine/card'
+
+describe CardNine::Card do
+  before(:all) do
+    class CardKlass
+      include CardNine::Card
+    end
+  end
+  let(:name) { 'Batman' }
+  let(:card_id) { :batman }
+
+  subject { CardKlass.new(id: card_id, name: name) }
+  it { is_expected.to be_a described_class }
+  it { expect(subject.id).to eq :batman }
+  it { expect(subject.name).to eq 'Batman' }
+
+end

data/spec/card_nine/cards/playing_card_spec.rb

@@ -0,0 +1,56 @@
+require 'rspec'
+require 'card_nine/cards/playing_card'
+
+describe CardNine::Cards::PlayingCard do
+  let(:name) { '7 of Diamonds' }
+  let(:suit) { 'Diamonds' }
+  let(:rank) { '7' }
+  let(:id) { '7d' }
+  let(:args) { { id: id, name: name, suit: suit, rank: rank } }
+  subject { described_class.new(args) }
+  it { is_expected.to be_a described_class }
+  it { expect(subject.id).to eq id }
+  it { expect(subject.name).to eq name }
+  it { expect(subject.suit).to eq suit }
+  it { expect(subject.rank).to eq rank }
+
+  describe 'sorting' do
+    let(:name_h) { 'King of Spades' }
+    let(:suit_h) { 'Spades' }
+    let(:rank_h) { 'King' }
+    let(:id_h) { 'KS' }
+    let(:args_h) { { id: id_h, name: name_h, suit: suit_h, rank: rank_h } }
+    let(:higher) { described_class.new(args_h) }
+
+    it { is_expected.to respond_to :<, :> }
+
+    it { expect(subject < higher).to be_truthy }
+    it { expect(subject > higher).to be_falsey }
+    it { expect(subject == higher).to be_falsey }
+
+    let(:name_l) { '2 of Clubs' }
+    let(:suit_l) { 'Clubs' }
+    let(:rank_l) { '2' }
+    let(:id_l) { '2C' }
+    let(:args_l) { { id: id_l, name: name_l, suit: suit_l, rank: rank_l } }
+    let(:lower) { described_class.new(args_l) }
+
+    it { expect(subject < lower).to be_falsey }
+    it { expect(subject > lower).to be_truthy }
+    it { expect(subject == lower).to be_falsey }
+
+    let(:same) { described_class.new(args) }
+
+    it { expect(subject < same).to be_falsey }
+    it { expect(subject > same).to be_falsey }
+    it { expect(subject == same).to be_truthy }
+  end
+
+  describe '#deck' do
+    subject { described_class.deck() }
+    it { is_expected.to be_a CardNine::Deck }
+    it { expect(subject.cards.length).to eq 52 }
+    it { expect(subject.cards).to all(be_a CardNine::Card) }
+    it { expect(subject.cards.map(&:id).uniq.length).to eq 52 }
+  end
+end

data/spec/card_nine/cards/simple_card_spec.rb

@@ -0,0 +1,11 @@
+require 'rspec'
+require 'card_nine/cards/simple_card'
+
+describe CardNine::Cards::SimpleCard do
+  let(:name) { 'Batman' }
+  let(:card_id) { :batman }
+  subject { described_class.new(id: card_id, name: name) }
+  it { is_expected.to be_a described_class }
+  it { expect(subject.id).to eq :batman }
+  it { expect(subject.name).to eq 'Batman' }
+end

data/spec/card_nine/dealer_spec.rb

@@ -0,0 +1,6 @@
+require 'rspec'
+require 'card_nine/dealer'
+
+describe CardNine::Dealer do
+
+end

data/spec/card_nine/dealers/texas_holdem_spec.rb

@@ -0,0 +1,89 @@
+require 'rspec'
+require 'card_nine/dealers/texas_holdem'
+
+describe CardNine::Dealers::TexasHoldem do
+  let(:players) { %w|Barbera Stephanie Cassandra| }
+
+  subject { described_class.new(players: players) }
+
+  it { is_expected.to be_a described_class }
+  it { is_expected.to respond_to :new_hand }
+
+  describe '.new_hand' do
+    subject { described_class.new(players: players).new_hand }
+    it { is_expected.to be_a CardNine::Hand }
+  end
+
+  describe 'STAGES' do
+    context ':hole_cards' do
+      subject do
+        h = described_class.new(players: players).new_hand
+        h.deal_stage(:deal_hole_cards)
+        h
+      end
+      it { is_expected.to be_a CardNine::Hand }
+      it { expect(subject.at('Barbera').length).to eq 2 }
+      it { expect(subject.at('Stephanie').length).to eq 2 }
+      it { expect(subject.at('Cassandra').length).to eq 2 }
+      it { expect(subject.at(:discards)).to be_empty }
+      it { expect(subject.at(:shoe).length).to eq 46 }
+    end
+
+    context ':flop' do
+      subject do
+        h = described_class.new(players: players).new_hand
+        h.deal_stage(:flop)
+        h
+      end
+      it { is_expected.to be_a CardNine::Hand }
+      it { expect(subject.at(:community).length).to eq 3 }
+      it { expect(subject.at(:discards).length).to eq 1 }
+      it { expect(subject.at(:shoe).length).to eq 48 }
+    end
+
+    context ':turn' do
+      subject do
+        h = described_class.new(players: players).new_hand
+        h.deal_stage(:turn)
+        h
+      end
+      it { is_expected.to be_a CardNine::Hand }
+      it { expect(subject.at(:community).length).to eq 1 }
+      it { expect(subject.at(:discards).length).to eq 1 }
+      it { expect(subject.at(:shoe).length).to eq 50 }
+    end
+
+    context ':river' do
+      subject do
+        h = described_class.new(players: players).new_hand
+        h.deal_stage(:river)
+        h
+      end
+      it { is_expected.to be_a CardNine::Hand }
+      it { expect(subject.at(:community).length).to eq 1 }
+      it { expect(subject.at(:discards).length).to eq 1 }
+      it { expect(subject.at(:shoe).length).to eq 50 }
+    end
+
+    context 'all in order' do
+      subject do
+        h = described_class.new(players: players).new_hand
+        h.deal_stage(:deal_hole_cards)
+        h.deal_stage(:flop)
+        h.deal_stage(:turn)
+        h.deal_stage(:river)
+        h
+      end
+      it { is_expected.to be_a CardNine::Hand }
+      it { expect(subject.at('Barbera').length).to eq 2 }
+      it { expect(subject.at('Stephanie').length).to eq 2 }
+      it { expect(subject.at('Cassandra').length).to eq 2 }
+      it { expect(subject.at(:community).length).to eq 5 }
+      it { expect(subject.at(:discards).length).to eq 3 }
+      it { expect(subject.at(:shoe).length).to eq 38 }
+
+
+    end
+  end
+
+end

data/spec/card_nine/deck_spec.rb

@@ -0,0 +1,27 @@
+require 'rspec'
+
+require 'card_nine/deck'
+
+describe CardNine::Deck do
+  let(:cards) { %w|Batman Batgirl Robin Nightwing| }
+  let(:rng) { Random.new }
+  subject { described_class.new(cards: cards) }
+  it { is_expected.to have_attributes(cards: cards) }
+  it { expect(subject.rng).to respond_to :rand }
+  it { is_expected.to respond_to :shuffle }
+  it 'should call shuffle on cards list' do
+    cards = %w|Batman Batgirl Robin Nightwing|.map { |n| CardNine::Cards::SimpleCard.new(name: n) }
+    rng   = Random.new(1234)
+    deck  = described_class.new(rng: rng, cards: cards)
+    expect(deck.cards).to receive(:shuffle)
+    deck.shuffle
+  end
+
+  describe 'defaults to' do
+    subject { described_class.new }
+    it { is_expected.to be_a described_class }
+    it { expect(subject.cards).to eq [] }
+    it { expect(subject.rng).to be_a Random }
+  end
+
+end

data/spec/card_nine/hand_spec.rb

@@ -0,0 +1,68 @@
+require 'rspec'
+require 'card_nine/hand'
+
+describe CardNine::Hand do
+  let(:players) { %w|Batman Batgirl Robin| }
+  let(:deck) { CardNine::Cards::PlayingCard.deck }
+  let(:table) { CardNine::Table.new(players: players, deck: deck) }
+  let(:stages) { { deal_five: ->(h) { h.deal_players(5) } } }
+  let(:args) { { players: players, deck: deck } }
+  subject { described_class.new(args) }
+  it { is_expected.to be_a described_class }
+
+  it { expect(subject.deck).to eq deck }
+  it { expect(subject.players).to eq players }
+  it { expect(subject.table).to be_a CardNine::Table }
+  it { expect(subject.stages).to be_a Hash }
+
+  describe '#start(args = nil, &blk)' do
+    it { expect(described_class.start(args)).to be_a described_class }
+    it 'executes block with hand as argument' do
+      hand = described_class.start(args) { |h| h.players << 'Nightwing' }
+      expect(hand.players).to include 'Nightwing'
+    end
+  end
+
+  describe '.at(loc)' do
+    subject { described_class.start(args) }
+    it { is_expected.to be_a described_class }
+    it { expect(subject.at(:shoe).length).to eq 52 }
+    it { expect(subject.at(:discards)).to eq [] }
+  end
+
+  describe '.deal_stage(stage_name = nil, &blk)' do
+    context 'with only block' do
+      subject do
+        h = described_class.start(players: players, deck: deck, table: table, stages: stages)
+        h.deal_stage do |h|
+          h.deal(3, to: :discards)
+        end
+        h
+      end
+      it { expect(subject.at(:discards).length).to eq 3 }
+    end
+
+    context 'with only stage' do
+      subject do
+        h = described_class.start(players: players, deck: deck, table: table, stages: stages)
+        h.deal_stage(:deal_five)
+        h
+      end
+      it { expect(subject.at('Batman').length).to eq 5 }
+      it { expect(subject.at('Batgirl').length).to eq 5 }
+      it { expect(subject.at('Robin').length).to eq 5 }
+    end
+    context 'with both stages and block' do
+      subject do
+        h = described_class.start(players: players, deck: deck, table: table, stages: stages)
+        h.deal_stage(:deal_five) { |h| h.deal(6, to: :discards) }
+        h
+      end
+      it { expect(subject.at('Batman').length).to eq 5 }
+      it { expect(subject.at('Batgirl').length).to eq 5 }
+      it { expect(subject.at('Robin').length).to eq 5 }
+      it { expect(subject.at(:discards).length).to eq 6 }
+      it { expect(subject.at(:shoe).length).to eq 31 }
+    end
+  end
+end

data/spec/card_nine/table_spec.rb

@@ -0,0 +1,74 @@
+require 'rspec'
+require 'card_nine/table'
+
+describe CardNine::Table do
+  let(:cards) do
+    %w|Batman Batgirl Robin Nightwing|.
+        map { |n| CardNine::Cards::SimpleCard.new(name: n) }
+  end
+  let(:deck) { CardNine::Deck.new(cards: cards) }
+  subject { described_class.new(deck: deck) }
+  it { is_expected.to be_a described_class }
+  it { expect(subject.deck).to eq deck }
+  it { expect(subject.players).to eq [] }
+  it { expect(subject.layout).to be_a Hash }
+  it { expect(subject.layout[:shoe].length).to eq 4 }
+  it { expect(subject.layout[:discards]).to eq [] }
+  describe '.move_card(from: old_pile, to: new_pile)' do
+    context 'using default count and :from' do
+      subject do
+        table = described_class.new(deck: deck, players: %w|Jason Tim|)
+        table.move_card(to: 'Tim')
+        table.move_card(to: 'Jason')
+        table.move_card(to: :discards)
+        table
+      end
+
+      it { is_expected.to be_a CardNine::Table }
+
+      it 'moves each card to the right spot' do
+        expect(subject.at('Tim').length).to eq 1
+        expect(subject.at('Jason').length).to eq 1
+        expect(subject.at(:shoe).length).to eq 1
+        expect(subject.at(:discards).length).to eq 1
+
+      end
+
+    end
+    context 'with count' do
+      subject do
+        table = described_class.new(deck: deck, players: %w|Jason Tim|)
+        table.move_card(2, to: 'Tim')
+        table.move_card(2, to: 'Jason')
+        table
+      end
+
+      it { is_expected.to be_a CardNine::Table }
+
+      it 'moves each card to the right spot' do
+        expect(subject.at('Tim').length).to eq 2
+        expect(subject.at('Jason').length).to eq 2
+        expect(subject.at(:shoe).length).to eq 0
+        expect(subject.at(:discards).length).to eq 0
+      end
+    end
+    context 'with count' do
+      subject do
+        table = described_class.new(deck: deck, players: %w|Jason Tim|)
+        table.move_card(4, to: 'Tim')
+        table.move_card(2, to: 'Jason', from: 'Tim')
+        table
+      end
+
+      it { is_expected.to be_a CardNine::Table }
+
+      it 'moves each card to the right spot' do
+        expect(subject.at('Tim').length).to eq 2
+        expect(subject.at('Jason').length).to eq 2
+        expect(subject.at(:shoe).length).to eq 0
+        expect(subject.at(:discards).length).to eq 0
+      end
+    end
+
+  end
+end

data/spec/card_nine_spec.rb

@@ -0,0 +1,10 @@
+require 'rspec'
+require 'card_nine'
+
+describe CardNine do
+
+  subject { described_class.constants }
+  it { is_expected.to include :Card, :Deck, :Dealer, :Hand }
+
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,29 @@
+require 'pry'
+RSpec.configure do |config|
+  # rspec-expectations config goes here. You can use an alternate
+  # assertion/expectation library such as wrong or the stdlib/minitest
+  # assertions if you prefer.
+  config.expect_with :rspec do |expectations|
+    # This option will default to `true` in RSpec 4. It makes the `description`
+    # and `failure_message` of custom matchers include text for helper methods
+    # defined using `chain`, e.g.:
+    # be_bigger_than(2).and_smaller_than(4).description
+    #   # => "be bigger than 2 and smaller than 4"
+    # ...rather than:
+    #   # => "be bigger than 2"
+    expectations.include_chain_clauses_in_custom_matcher_descriptions = true
+  end
+
+  config.filter_run :focus
+  config.run_all_when_everything_filtered = true
+  config.filter_run_excluding :rewrite => true
+
+  # rspec-mocks config goes here. You can use an alternate test double
+  # library (such as bogus or mocha) by changing the `mock_with` option here.
+  config.mock_with :rspec do |mocks|
+    # Prevents you from mocking or stubbing a method that does not exist on
+    # a real object. This is generally recommended, and will default to
+    # `true` in RSpec 4.
+    mocks.verify_partial_doubles = true
+  end
+end

metadata

@@ -0,0 +1,252 @@
+--- !ruby/object:Gem::Specification
+name: card_nine
+version: !ruby/object:Gem::Version
+  version: 0.4.1
+platform: ruby
+authors:
+- Scott M Parrish
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-12-08 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: virtus
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.0.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.0.3
+- !ruby/object:Gem::Dependency
+  name: facets
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.9.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.9.3
+- !ruby/object:Gem::Dependency
+  name: hashie
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.3.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.3.1
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.7.6
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.7.6
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 10.3.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 10.3.2
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.19.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.19.1
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.1.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.1.0
+- !ruby/object:Gem::Dependency
+  name: guard-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 4.3.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 4.3.1
+- !ruby/object:Gem::Dependency
+  name: guard-bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.0.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.0.0
+- !ruby/object:Gem::Dependency
+  name: version
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+- !ruby/object:Gem::Dependency
+  name: fuubar
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.0.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.0.0
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: A Toolbox to help me build a board game.
+email:
+- anithri@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- Gemfile
+- Guardfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- Thorfile
+- VERSION
+- card_nine.gemspec
+- lib/card_nine.rb
+- lib/card_nine/card.rb
+- lib/card_nine/cards/playing_card.rb
+- lib/card_nine/cards/simple_card.rb
+- lib/card_nine/dealer.rb
+- lib/card_nine/dealers/texas_holdem.rb
+- lib/card_nine/deck.rb
+- lib/card_nine/hand.rb
+- lib/card_nine/table.rb
+- spec/card_nine/card_spec.rb
+- spec/card_nine/cards/playing_card_spec.rb
+- spec/card_nine/cards/simple_card_spec.rb
+- spec/card_nine/dealer_spec.rb
+- spec/card_nine/dealers/texas_holdem_spec.rb
+- spec/card_nine/deck_spec.rb
+- spec/card_nine/hand_spec.rb
+- spec/card_nine/table_spec.rb
+- spec/card_nine_spec.rb
+- spec/spec_helper.rb
+homepage: ''
+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.4.2
+signing_key: 
+specification_version: 4
+summary: Game Dev Toolbox. Cards
+test_files:
+- spec/card_nine/card_spec.rb
+- spec/card_nine/cards/playing_card_spec.rb
+- spec/card_nine/cards/simple_card_spec.rb
+- spec/card_nine/dealer_spec.rb
+- spec/card_nine/dealers/texas_holdem_spec.rb
+- spec/card_nine/deck_spec.rb
+- spec/card_nine/hand_spec.rb
+- spec/card_nine/table_spec.rb
+- spec/card_nine_spec.rb
+- spec/spec_helper.rb