cards_lib 0.1.2 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 27b41260f30a649a682facf503c2b7affcd03ee9
-  data.tar.gz: 5540fb1936dc356312778adc2bd1bf6838c59e53
+  metadata.gz: 116128e753df7d33bdbbf92dff21cc56f44e2712
+  data.tar.gz: eb7424abd1a29cd3d0940bcc5eca8e7e3d8303f6
 SHA512:
-  metadata.gz: 67d11e2507051f32b4c56faa8c692b05feb713b8779b68f82a40fb0e56f53450a3dbbc9f0579c7c46a1ce7a558854edb7a49edcf1fa4fc4907e61dea162e0408
-  data.tar.gz: bb7d3ee9f17ad5ab2456da4295783904f083c559a3ddacd8247b800c25404a8d069c9e7b802505a6e6f39b170a47af399fd169143667bacadc2107f3236233bb
+  metadata.gz: 786ec4e653b8bc177b9f34800960aeb76410c2a28c12595d353426fb71326f85bc55f5922b30163c71315313b68982af9ac8e820af71ffad408134677749b125
+  data.tar.gz: 602402ad77e0bc9318b8be79bc7d82ab2b633f303c24dc2e5781c926e0caf9b97746876bb35e2fb6b180176c6e7f383ef03638b2c81fc1fce3ba421d1298ea8f

data/.gitignore

@@ -1,6 +1,7 @@
+.byebug_history
 .idea
 .idea/*
-*.swp
+**/*.swp
 *.gem
 /.bundle/
 /.yardoc

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,3 @@
+# Contributor Code of Conduct
+
+For you, brethren, have been called to liberty; only do not use liberty as an opportunity for the flesh, but through love serve one another. For all the law is fulfilled in one word, even in this: “You shall love your neighbor as yourself.” But if you bite and devour one another, beware lest you be consumed by one another! - [Galatians 5:13-15](https://www.biblegateway.com/passage/?search=Gal.5.13-Gal.5.15&version=NKJV)

data/Guardfile

@@ -19,6 +19,10 @@ guard :minitest do
   # with Minitest::Unit
   watch(%r{^test/(.*)\/?(.*)_test\.rb$})
   watch(%r{^lib/cards_lib/([^/]+)\.rb$})     { |m| "test/#{m[1]}_test.rb" }
+  watch(%r{^lib/cards_lib/standard/([^/]+)\.rb$})     { |m| "test/standard/#{m[1]}_test.rb" }
+  watch(%r{^lib/cards_lib/standard/evaluators/([^/]+)\.rb$})     { |m| "test/standard/evaluators/#{m[1]}_test.rb" }
+  watch(%r{^lib/cards_lib/standard/rules/([^/]+)\.rb$})     { |m| "test/standard/rules/#{m[1]}_test.rb" }
+  watch(%r{^lib/cards_lib/standard/rankers/([^/]+)\.rb$})     { |m| "test/standard/rankers/#{m[1]}_test.rb" }
   watch(%r{^test/minitest_helper\.rb$})      { 'test' }
   watch(%r{^lib/cards_lib/card.rb$})         { 'test' }
 

data/README.md

@@ -15,6 +15,15 @@ I'm willing to bet you that there is no other Ruby card game library
 out there as easy to use, as well thought out, and as simple to
 understand as mine. Come on, I dare you to use it and review it! ;-)
 
+##Scope
+
+The scope of this project aims to be a game agnostic card management
+and evaluation system.  Game logic itself will not be provided with
+this library.  The creation, grouping, comparison, and evaluation of
+cards is the sole purpose of this gem.
+
+Feel free to contribute or raise suggestions via the issue tracker.
+I welcome participation of all kinds! :-)
 
 ##Install
 
@@ -61,7 +70,9 @@ CardsLib::IsSet.verify(
 
 * In **lib/cards_lib/standard.rb** there are some basic deck templates.
 
-* In **lib/cards_lib/standard/rules/poker.rb** there are some working Poker hand verification methods.
+* In **lib/cards_lib/standard/rules/poker_rule.rb** there are some working Poker hand verification methods.
+
+* In **lib/cards_lib/standard/evaluators/blackjack_evaluator.rb** there is a Blackjack hand worth evaluation tool.  See the **test/standard/evaluators/blackjack_evaluator_test.rb** for examples.
 
 ##License
 

data/cards_lib.gemspec

@@ -21,9 +21,10 @@ Gem::Specification.new do |spec|
 
   spec.required_ruby_version = '>= 2.0.0'
 
-  spec.add_development_dependency "bundler", "~> 1.10.6"
+  spec.add_development_dependency "bundler", "~> 1.11.0"
   spec.add_development_dependency "rake", "~> 10.4"
   spec.add_development_dependency "color_pound_spec_reporter", "~> 0.0.5"
   spec.add_development_dependency "minitest", "~> 5.8.1"
   spec.add_development_dependency "minitest-reporters", "~> 1.1.4"
+  spec.add_development_dependency "minitest-byebug", "~> 0.0.3"
 end

data/lib/cards_lib/card.rb

@@ -8,7 +8,7 @@ module CardsLib
       @face = face_from_rank_and_suit(@rank, @suit) if face.is_a? Hash
       
       @face ||= face
-      @ranker = ranker.new(rank)
+      @ranker = ranker.new(self.rank)
     end
 
     def face
@@ -23,14 +23,24 @@ module CardsLib
       @rank || @face[0]
     end
 
+    def value
+      @ranker.ranker
+    end
+
     def pair?(other)
       self.rank == other.rank
     end
 
+    # equal by both rank and suit
     def ==(other)
       pair?(other) && self.suit == other.suit
     end
 
+    # equal by value
+    def eql?(other)
+      value == other.value
+    end
+
     def <=>(other)
       @ranker.<=>(other)
     end

data/lib/cards_lib/ranker.rb

@@ -1,21 +1,26 @@
 module CardsLib
   class Ranker
     include Comparable
-    attr :rank, :ranks, :rank_lookup
-    def initialize rank = nil,
-                   ranks: "A23456789TJQK".chars,
-                   rank_lookup: nil
-    
-      @rank, @ranks, @rank_lookup = rank, ranks, rank_lookup ||
-                     ->rank_face{ @ranks.index(rank_face).to_i + 1 }
+    attr :rank, :rank_lookup
+    def initialize(rank = nil, ranks = nil, rank_lookup = nil)
+      @rank, @ranks, @rank_lookup = rank, ranks, rank_lookup
+    end
+
+    def ranks
+      @ranks || Standard::RANKS
+    end
+
+    def ranker(rank_face = @rank)
+      @rank_lookup ? @rank_lookup.(rank_face) :
+      ranks.index(rank_face).to_i + 1
     end
 
     def <=>(item)
-      @rank_lookup[self.rank] <=> @rank_lookup[item.rank]
+      ranker(self.rank) <=> ranker(item.rank)
     end
 
     def sequential?(item)
-      (@rank_lookup[self.rank] - @rank_lookup[item.rank]).abs == 1
+      (ranker(self.rank) - ranker(item.rank)).abs == 1
     end
   end
 end

data/lib/cards_lib/standard/evaluators/blackjack_evaluator.rb

@@ -0,0 +1,38 @@
+module CardsLib
+  module Standard
+    module Evaluators
+      class BlackjackEvaluator
+        def initialize(cards)
+          @cards = cards
+          @reduced_ace_count = 0
+        end
+        
+        def worth
+          @worth ||= @cards.map(&:value).inject(:+)
+          if @worth > 21
+            attempt = reduce_by_ace
+            until @worth < 22 || !attempt
+              attempt = reduce_by_ace
+            end
+          end 
+          @worth
+        end
+
+        private
+        def reduce_by_ace
+          if count_aces > @reduced_ace_count
+            @worth -= 10
+            @reduced_ace_count += 1
+            true
+          else
+            false
+          end
+        end
+
+        def count_aces
+          @cards.count {|c| c.rank == "A"}
+        end
+      end
+    end
+  end
+end

data/lib/cards_lib/standard/evaluators.rb

@@ -0,0 +1,8 @@
+require_relative "evaluators/blackjack_evaluator"
+
+module CardsLib
+  module Standard
+    module Evaluators
+    end
+  end
+end

data/lib/cards_lib/standard/rankers/blackjack_ranker.rb

@@ -0,0 +1,30 @@
+module CardsLib
+  module Standard
+    module Rankers
+      class BlackjackRanker < CardsLib::Ranker
+        def initialize(card)
+          super(
+            card,
+            {
+              "2" => 2,
+              "3" => 3,
+              "4" => 4,
+              "5" => 5,
+              "6" => 6,
+              "7" => 7,
+              "8" => 8,
+              "9" => 9,
+              "T" => 10,
+              "J" => 10,
+              "Q" => 10,
+              "K" => 10,
+              "A" => 11
+            },
+            ->rank{@ranks[rank]}
+          )
+        end
+      end
+    end
+  end
+end
+

data/lib/cards_lib/standard/rankers.rb

@@ -0,0 +1,2 @@
+require_relative "../ranker"
+require_relative "rankers/blackjack_ranker"

data/lib/cards_lib/standard/rules/{poker.rb → poker_rule.rb}

@@ -1,7 +1,7 @@
 module CardsLib
   module Standard
     module Rules
-      module Poker
+      module PokerRule
         def self.precedence
           [
             :royal_flush, :straight_flush, :four_of_a_kind,

data/lib/cards_lib/standard/rules.rb

@@ -1,4 +1,4 @@
-require_relative 'rules/poker.rb'
+require_relative 'rules/poker_rule'
 
 module CardsLib
   module Standard

data/lib/cards_lib/standard.rb

@@ -1,8 +1,12 @@
 require_relative 'standard/rules'
+require_relative 'standard/rankers'
+require_relative 'standard/evaluators'
 
 module CardsLib
   module Standard
-    PLAYING_CARDS = 'A23456789TJQK'.chars.product('cdhs'.chars).map(&:join)
-    ASCII_CARDS   = 'A23456789TJQK'.chars.product('♣♦♥♠'.chars).map(&:join)
+    RANKS         = 'A23456789TJQK'.chars
+    SUITS         = 'cdhs'.chars
+    PLAYING_CARDS = RANKS.product(SUITS       ).map(&:join)
+    ASCII_CARDS   = RANKS.product('♣♦♥♠'.chars).map(&:join)
   end
 end

data/lib/cards_lib/version.rb

@@ -1,3 +1,3 @@
 module CardsLib
-  VERSION = "0.1.2"
+  VERSION = "0.2.0"
 end

data/lib/cards_lib.rb

@@ -12,5 +12,5 @@ module CardsLib
   # Cards[]
   #  generate Card instances from string
   #  representations of their faces
-  Cards = ->*c{ c.map {|face| Card.new(face)} }
+  Cards = ->*c{ c.map {|*opts| Card.new(*opts.flatten)} }
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: cards_lib
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.2.0
 platform: ruby
 authors:
 - Daniel P. Clark
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2015-11-29 00:00:00.000000000 Z
+date: 2015-12-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.10.6
+        version: 1.11.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.10.6
+        version: 1.11.0
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -80,6 +80,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 1.1.4
+- !ruby/object:Gem::Dependency
+  name: minitest-byebug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.0.3
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.0.3
 description: Card Game Library.  Testable and Object Oriented.
 email:
 - 6ftdan@gmail.com
@@ -89,6 +103,7 @@ extra_rdoc_files: []
 files:
 - ".gitignore"
 - ".travis.yml"
+- CODE_OF_CONDUCT.md
 - Gemfile
 - Guardfile
 - LICENSE.txt
@@ -104,8 +119,12 @@ files:
 - lib/cards_lib/ranker.rb
 - lib/cards_lib/refinements.rb
 - lib/cards_lib/standard.rb
+- lib/cards_lib/standard/evaluators.rb
+- lib/cards_lib/standard/evaluators/blackjack_evaluator.rb
+- lib/cards_lib/standard/rankers.rb
+- lib/cards_lib/standard/rankers/blackjack_ranker.rb
 - lib/cards_lib/standard/rules.rb
-- lib/cards_lib/standard/rules/poker.rb
+- lib/cards_lib/standard/rules/poker_rule.rb
 - lib/cards_lib/version.rb
 homepage: http://github.com/danielpclark/CardsLib
 licenses: