fiftytwo 0.0.2 → 0.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f841300403b3e5e84bd2094a711ee89c13333537e3cabd08f3dfff000d59f69c
-  data.tar.gz: be8c200b6207437b4cabe5c500df1ff80caccf17ca8845a048c124c6ac86d97d
+  metadata.gz: a5c1752b761a6a418abc5635ece62d1dde656012ca5b548e107ab633a915d868
+  data.tar.gz: f044e63524c51c7f25987f8a682e5876157bda0bbb10c2c3b7959535afbe88c3
 SHA512:
-  metadata.gz: 579cf55130a79d92779edf40dce3f99e232270845c4f8a48097d1f904b759317f3aa19cba206e62bf60917306ac05b008b02cc938e21a4d017b5a97e529662b9
-  data.tar.gz: '0643844dd685e0f5c44f629f5db3c70b5599c00cfe136ba914448c88cf2974b864f7e30c6a661cb69a90544da82e65eff527b2eef7618f8a37191cef0f581c23'
+  metadata.gz: 3e413c3f029b93322be3ed98725dc99dc7621ddc2bd53f9e3d18abb417419be200b53d055620e3dbffce932e691c56dd5466d097a4ffb24800d7c20a8dfc34df
+  data.tar.gz: a1db0d51936d8c0d20b4bf25ac1f9d9f6525e509cbe557a5b327c582c22d32831c2e0fb460a96ddf30a0826299c9e2039759937def354e1fa7851483c0f5d081

data/README.md

@@ -116,15 +116,15 @@ deck.deal([my_hand, your_hand], 5)
 # => "Deck has 42 cards, I have 5 cards, you have 5 cards"
 
 puts my_hand.render, your_hand.render # by the way renderings are colored red/black in your terminal, just like the suit!
- 3♦  4♠  5♦  7♥  2♣
- 6♠  A♦  5♠ 10♦  Q♣
+# 3♦  4♠  5♦  7♥  2♣
+# 6♠  A♦  5♠ 10♦  Q♣
 ```
 
 Hands, just like the deck, can be shuffled, sorted, searched, etc:
 ```ruby
 your_hand.sort!
 puts your_hand.render
- 5♠  6♠ 10♦  Q♣  A♦
+# 5♠  6♠ 10♦  Q♣  A♦
 
 your_hand.aces.count
 # => 1
@@ -132,15 +132,15 @@ your_hand.aces.count
 
 Pass your cards around:
 ```ruby
-my_hand.transfer("4S", your_hand)
+my_hand.transfer("4S", your_hand) # try an array of card identifiers, too!
 puts my_hand.render, your_hand.render
- 3♦  5♦  7♥  2♣
- 5♠  6♠ 10♦  Q♣  A♦  4♠
+# 3♦  5♦  7♥  2♣
+# 5♠  6♠ 10♦  Q♣  A♦  4♠
 
 your_hand.transfer("QC") # goes back to the deck
 puts my_hand.render, your_hand.render
- 3♦  5♦  7♥  2♣
- 5♠  6♠ 10♦  A♦  4♠
+# 3♦  5♦  7♥  2♣
+# 5♠  6♠ 10♦  A♦  4♠
 
 deck.count
 # => 43
@@ -155,6 +155,44 @@ your_hand.release
 # => "Deck has 52 cards, I have 0 cards, you have 0 cards"
 ```
 
+## Example: 5 card draw poker
+_Reminder, we are implementing a deck of cards, and the operations you can perform with that deck. Evaluation of hands is dependent upon some
+particular game, and is outside the scope of this gem!_
+
+```ruby
+require "fiftytwo"
+
+deck = FiftyTwo::Deck.standard
+deck.shuffle!
+
+my_hand = FiftyTwo::Hand.new
+your_hand = FiftyTwo::Hand.new
+discard = FiftyTwo::Hand.new
+
+deck.deal([your_hand, my_hand], 5)
+
+[my_hand, your_hand].each(&:sort!)
+puts "you: #{your_hand.render}", "me:  #{my_hand.render}"
+# you:  6♦  6♠  7♠  K♣  A♦
+# me:   2♦  5♥  8♠  9♥ 10♦
+
+your_hand.transfer(%w[7s kc], discard)
+deck.deal(your_hand, 2)
+
+my_hand.transfer(%w[2D 5H], discard)
+deck.deal(my_hand, 2)
+
+[my_hand, your_hand].each(&:sort!)
+puts "you: #{your_hand.render}", "me:  #{my_hand.render}"
+# you:  4♠  6♦  6♠  K♦  A♦
+# me:   2♣  4♣  8♠  9♥ 10♦
+
+puts "Congratulations, you win!"
+
+[my_hand, your_hand, discard].each(&:release)
+deck.shuffle!
+```
+
 # Problems?
 Please submit an [issue](https://github.com/kevinstuffandthings/fiftytwo/issues).
 We'll figure out how to get you up and running with FiftyTwo as smoothly as possible.

data/lib/fiftytwo/has_cards.rb

@@ -24,11 +24,8 @@ module FiftyTwo
       cards.find { |c| c.identifier == identifier.upcase }
     end
 
-    def transfer(card, destination = nil)
-      card = locate(card) unless card.is_a?(FiftyTwo::Card)
-      raise CardUnavailableError if card.nil?
-      raise CardUnavailableError unless cards.include?(card)
-      (destination || card.deck) << cards.delete(card)
+    def transfer(cards, destination = nil)
+      gather(cards).map { |c| (destination || c.deck) << self.cards.delete(c) }
     end
 
     FiftyTwo::Suit::ALL.each do |suit|
@@ -48,5 +45,14 @@ module FiftyTwo
     def select(identifier)
       self.class.new(cards.select { |c| c.send("#{identifier}?") })
     end
+
+    def gather(cards)
+      Array(cards).map do |card|
+        card = locate(card) unless card.is_a?(FiftyTwo::Card)
+        raise CardUnavailableError if card.nil?
+        raise CardUnavailableError unless self.cards.include?(card)
+        card
+      end
+    end
   end
 end

data/lib/fiftytwo/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module FiftyTwo
-  VERSION = "0.0.2"
+  VERSION = "0.0.3"
 end

data/spec/lib/fiftytwo/deck_spec.rb

@@ -7,6 +7,7 @@ module FiftyTwo
     before(:each) do
       minideck << FiftyTwo::Card.new(minideck, FiftyTwo::Rank::THREE, FiftyTwo::Suit::CLUBS)
       minideck << FiftyTwo::Card.new(minideck, FiftyTwo::Rank::NINE, FiftyTwo::Suit::DIAMONDS)
+      minideck << FiftyTwo::Card.new(minideck, FiftyTwo::Rank::TEN, FiftyTwo::Suit::DIAMONDS)
     end
 
     it "is a deck, made up of cards" do
@@ -117,17 +118,22 @@ module FiftyTwo
       let(:subject) { minideck }
 
       it "takes cards in order from the deck" do
+        expect(subject.count).to eq 3
+
+        card = subject.draw
         expect(subject.count).to eq 2
+        expect(card).to be_a FiftyTwo::Card
+        expect(card.identifier).to eq "3C"
 
         card = subject.draw
         expect(subject.count).to eq 1
         expect(card).to be_a FiftyTwo::Card
-        expect(card.identifier).to eq "3C"
+        expect(card.identifier).to eq "9D"
 
         card = subject.draw
         expect(subject.count).to eq 0
         expect(card).to be_a FiftyTwo::Card
-        expect(card.identifier).to eq "9D"
+        expect(card.identifier).to eq "10D"
 
         card = subject.draw
         expect(subject.count).to eq 0
@@ -174,22 +180,34 @@ module FiftyTwo
       let(:hand) { FiftyTwo::Hand.new }
 
       it "has a deck with 2 cards, and a hand with none" do
-        expect(subject.count).to eq 2
+        expect(subject.count).to eq 3
         expect(hand.count).to eq 0
       end
 
       it "can transfer a card by object" do
         subject.transfer(subject[1], hand)
-        expect(subject.count).to eq 1
+        expect(subject.count).to eq 2
         expect(hand.count).to eq 1
       end
 
       it "can transfer a card by identifier" do
         subject.transfer("3C", hand)
-        expect(subject.count).to eq 1
+        expect(subject.count).to eq 2
         expect(hand.count).to eq 1
       end
 
+      it "can transfer multiple cards" do
+        subject.transfer(%w[3C 10D], hand)
+        expect(subject.count).to eq 1
+        expect(hand.count).to eq 2
+      end
+
+      it "will not transfer any and raise an error if any one card reference is invalid" do
+        expect { subject.transfer(%w[3C 10K], hand) }.to raise_error FiftyTwo::HasCards::CardUnavailableError
+        expect(subject.count).to eq 3
+        expect(hand.count).to eq 0
+      end
+
       context "missing card" do
         let(:missing_card) { FiftyTwo::Card.new(subject, FiftyTwo::Rank::THREE, FiftyTwo::Suit::HEARTS) }
 
@@ -206,14 +224,14 @@ module FiftyTwo
         let(:card) { subject[1] }
         before(:each) { subject.transfer(card, hand) }
 
-        it "starts with a card in the hand and a card in the deck" do
-          expect(subject.count).to eq 1
+        it "starts with a card in the hand and 2 in the deck" do
+          expect(subject.count).to eq 2
           expect(hand.count).to eq 1
         end
 
         it "can transfer a card from a hand back to the bottom of its originating deck" do
           hand.transfer(card)
-          expect(subject.count).to eq 2
+          expect(subject.count).to eq 3
           expect(hand.count).to eq 0
           expect(subject.last).to eq card
         end
@@ -230,7 +248,7 @@ module FiftyTwo
       end
 
       it "renders the set of cards in this deck" do
-        expect(subject.render).to eq "CARD0 CARD1"
+        expect(subject.render).to eq "CARD0 CARD1 CARD2"
       end
     end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: fiftytwo
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.0.3
 platform: ruby
 authors:
 - Kevin McDonald
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-07-30 00:00:00.000000000 Z
+date: 2021-07-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport