rodders 0.3.0 → 1.0.0

data/VERSION

@@ -1 +1 @@
-0.3.0
+1.0.0

data/lib/MutuallyExclusiveCollection.rb

@@ -8,13 +8,13 @@ class MutuallyExclusiveCollection
 
   # the least likely of the events to occur
   # @return [FixedOdds] the least likely event
-  def underdog
+  def least_likely
     @events.first
   end
 
   # the most likely of the events to occur
   # @return [FixedOdds] the most likely event
-  def favorite
+  def most_likely
     @events.last
   end  
 

data/rodders.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = "rodders"
-  s.version = "0.3.0"
+  s.version = "1.0.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Nigel Lowry"]
-  s.date = "2011-12-11"
+  s.date = "2012-01-02"
   s.description = "Converts between fractional, decimal and moneyline odds for betting and gambling. Calculates how much can be won on a given stake."
   s.email = "nigel-lowry@ultra.eclipse.co.uk"
   s.extra_rdoc_files = [

data/spec/FixedOdds_spec.rb

@@ -3,8 +3,8 @@ require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
 
 describe "FixedOdds" do
 
-  describe "fractional_odds factory" do
-    it "should raise error if not fractional odds" do
+  describe ".fractional_odds" do
+    it "raises error if not fractional odds" do
       expect {
         FixedOdds.fractional_odds '5'
       }.to raise_error(
@@ -13,47 +13,47 @@ describe "FixedOdds" do
       )  
     end
 
-    it "should not modify the input string with 'against'" do
+    it "does not change the input string with 'against'" do
       value = '4/1 against'
       FixedOdds.fractional_odds(value)
       value.end_with?('against').should == true
     end
 
-    it "should not modify the input string with 'on'" do
+    it "does not modify the input string with 'on'" do
       value = '4/1 on'
       FixedOdds.fractional_odds(value)
       value.end_with?('on').should == true
     end
 
-    it "should treat '4/1 against' the same as '4/1'" do
+    it "treats '4/1 against' the same as '4/1'" do
       FixedOdds.fractional_odds('4/1 against').should == FixedOdds.fractional_odds('4/1')
     end
 
-    it "should treat '4/1 on' the same as '1/4'" do
+    it "treats '4/1 on' the same as '1/4'" do
       FixedOdds.fractional_odds('4/1 on').should == FixedOdds.fractional_odds('1/4')
     end
     
-    it "should treat 'evens' as '1/1'" do 
+    it "treats 'evens' as '1/1'" do 
       FixedOdds.fractional_odds('evens').should == FixedOdds.fractional_odds('1/1')
     end 
 
-    it "should treat 'even money' as '1/1'" do
+    it "treats 'even money' as '1/1'" do
       FixedOdds.fractional_odds('even money').should == FixedOdds.fractional_odds('1/1')
     end
 
-    it "should recognise '4-to-1' as '4/1'" do
+    it "recognises '4-to-1' as '4/1'" do
       FixedOdds.fractional_odds('4-to-1').should == FixedOdds.fractional_odds('4/1')
     end
 
-    it "should recognise '4-to-1 against' as '4/1'" do
+    it "recognises '4-to-1 against' as '4/1'" do
       FixedOdds.fractional_odds('4-to-1 against').should == FixedOdds.fractional_odds('4/1')
     end
 
-    it "should recognise '4-to-1 on' as '1/4'" do
+    it "recognises '4-to-1 on' as '1/4'" do
       FixedOdds.fractional_odds('4-to-1 on').should == FixedOdds.fractional_odds('1/4')
     end
 
-    it "should raise error if numerator has decimal point" do
+    it "raises error if numerator has decimal point" do
       expect {
         FixedOdds.fractional_odds '1.1/4'
       }.to raise_error(
@@ -62,7 +62,7 @@ describe "FixedOdds" do
       ) 
     end
 
-    it "should raise error if denominator has decimal point" do
+    it "raises error if denominator has decimal point" do
       expect {
         FixedOdds.fractional_odds '1/4.1'
       }.to raise_error(
@@ -71,7 +71,7 @@ describe "FixedOdds" do
       ) 
     end
 
-    it "should raise error if both numerator and denominator have decimal points" do
+    it "raises error if both numerator and denominator have decimal points" do
       expect {
         FixedOdds.fractional_odds '1.1/4.1'
       }.to raise_error(
@@ -81,17 +81,17 @@ describe "FixedOdds" do
     end
   end
 
-  describe "moneyline_odds factory" do
-    it "should raise error if not moneyline odds" do
+  describe ".moneyline_odds" do
+    it "raises error if not moneyline odds" do
       expect {
-        FixedOdds.moneyline_odds '1.25'
+        FixedOdds.moneyline_odds '1/4'
       }.to raise_error(
         RuntimeError,
-        /could not parse "1.25" as moneyline odds/
+        /could not parse "1\/4" as moneyline odds/
       )  
     end
 
-    it "should raise error if moneyline odds has decimal point" do
+    it "raises error if moneyline odds has decimal point" do
       expect {
         FixedOdds.moneyline_odds '-100.1'
       }.to raise_error(
@@ -101,32 +101,37 @@ describe "FixedOdds" do
     end
 
     describe "positive figures" do
-      it "should treat '+400' as meaning winning £400 on a £100 bet" do
+      it "treats '+400' as meaning winning £400 on a £100 bet" do
         plus400 = FixedOdds.moneyline_odds('+400')
         plus400.profit_on_winning_stake(Money.from_fixnum(100, :GBP)).should == Money.from_fixnum(400, :GBP)
       end
 
-      it "should treat +100 as meaning winning £100 on a £100 bet" do
+      it "treats +100 as meaning winning £100 on a £100 bet" do
         plus100 = FixedOdds.moneyline_odds('+100')
         plus100.profit_on_winning_stake(Money.from_fixnum(100, :GBP)).should == Money.from_fixnum(100, :GBP)
       end
     end
 
     describe "negative figures" do
-      it "should treat '-400' as meaning you need to wager £400 to win £100" do
+      it "treats '-400' as meaning you need to wager £400 to win £100" do
         minus400 = FixedOdds.moneyline_odds('-400')
         minus400.profit_on_winning_stake(Money.from_fixnum(400, :GBP)).should == Money.from_fixnum(100, :GBP)
       end
 
-      it "should treat '-100' as meaning you need to wager £100 to win £100 (which is identical to '+100')" do
+      it "treats '-100' as meaning you need to wager £100 to win £100" do
         minus100 = FixedOdds.moneyline_odds('-100')
         minus100.profit_on_winning_stake(Money.from_fixnum(100, :GBP)).should == Money.from_fixnum(100, :GBP)
       end
+
+      it "treats '+100' as meaning you need to wager £100 to win £100" do
+        plus100 = FixedOdds.moneyline_odds('+100')
+        plus100.profit_on_winning_stake(Money.from_fixnum(100, :GBP)).should == Money.from_fixnum(100, :GBP)
+      end
     end
   end
 
-  describe "decimal_odds factory" do
-    it "should raise error if not decimal odds" do
+  describe ".decimal_odds" do
+    it "raises error if not decimal odds" do
       expect {
         FixedOdds.decimal_odds '-400'
       }.to raise_error(
@@ -135,25 +140,25 @@ describe "FixedOdds" do
       )  
     end
 
-    it "should treat '2' as meaning you have to wager £100 to win £100" do
+    it "treats '2' as meaning you have to wager £100 to win £100" do
       d2 = FixedOdds.decimal_odds('2')
       d2.profit_on_winning_stake(Money.from_fixnum(100, :GBP)).should == Money.from_fixnum(100, :GBP)
     end
 
-    it "should treat '5' as meaning you have to wager £100 to win £400" do
+    it "treats '5' as meaning you have to wager £100 to win £400" do
       d5 = FixedOdds.decimal_odds('5')
       d5.profit_on_winning_stake(Money.from_fixnum(100, :GBP)).should == Money.from_fixnum(400, :GBP)
     end
 
-    it "should treat '1.25' as meaning yo have to wager £400 to win £100" do
+    it "treats '1.25' as meaning yo have to wager £400 to win £100" do
       d1_25 = FixedOdds.decimal_odds('1.25')
       d1_25.profit_on_winning_stake(Money.from_fixnum(400, :GBP)).should == Money.from_fixnum(100, :GBP)
     end
   end
 
-  describe "#from_s" do
+  describe ".from_s" do
     describe "bad input" do
-      it "should reject garbage" do
+      it "rejects garbage" do
         expect {
           FixedOdds.from_s('garbage')  
         }.to raise_error(
@@ -163,7 +168,7 @@ describe "FixedOdds" do
       end
     end
 
-    it "should reject an empty string" do
+    it "rejects an empty string" do
       expect {
         FixedOdds.from_s('')  
       }.to raise_error(
@@ -173,39 +178,39 @@ describe "FixedOdds" do
     end
 
     describe "fractional odds" do
-      it "should parse '4/1'" do
+      it "parses '4/1'" do
         FixedOdds.from_s('4/1').should == FixedOdds.fractional_odds('4/1')
       end
 
-      it "should parse 'evens'" do
+      it "parses 'evens'" do
         FixedOdds.from_s('evens').should == FixedOdds.fractional_odds('1/1')
       end
 
-      it "should parse 'even money'" do
+      it "parses 'even money'" do
         FixedOdds.from_s('even money').should == FixedOdds.fractional_odds('1/1')
       end
 
-      it "should parse '4/1 against'" do
+      it "parses '4/1 against'" do
         FixedOdds.from_s('4/1 against').should == FixedOdds.fractional_odds('4/1')
       end
 
-      it "should parse '4/1 on'" do
+      it "parses '4/1 on'" do
         FixedOdds.from_s('4/1 on').should == FixedOdds.fractional_odds('1/4')
       end
 
-      it "should parse '4-to-1'" do
+      it "parses '4-to-1'" do
         FixedOdds.from_s('4-to-1').should == FixedOdds.fractional_odds('4/1')
       end
 
-      it "should parse '4-to-1 against'" do
+      it "parses '4-to-1 against'" do
         FixedOdds.from_s('4-to-1 against').should == FixedOdds.fractional_odds('4/1')
       end
 
-      it "should parse '4-to-1 on'" do
+      it "parses '4-to-1 on'" do
         FixedOdds.from_s('4-to-1 on').should == FixedOdds.fractional_odds('1/4')
       end
 
-      it "should raise an error for a zero denominator" do
+      it "raises an error for a zero denominator" do
         expect {
           FixedOdds.from_s('4/0')  
         }.to raise_error(
@@ -215,17 +220,17 @@ describe "FixedOdds" do
     end
 
     describe "moneyline odds" do
-      it "should parse positive moneyline odds" do 
+      it "parses positive moneyline odds" do 
         FixedOdds.from_s('+400').should == FixedOdds.moneyline_odds('+400')
       end
 
-      it "should parse negative moneyline odds" do
+      it "parses negative moneyline odds" do
         FixedOdds.from_s('-400').should == FixedOdds.moneyline_odds('-400')
       end
     end
 
     describe "decimal odds" do
-      it "should parse integral odds of '2' as decimal odds, not as fractional odds of '2/1'" do
+      it "parses integral odds of '2' as decimal odds, not as fractional odds of '2/1'" do
         decimal_odds_2 = FixedOdds.from_s('2')
 
         decimal_odds_2.should == FixedOdds.decimal_odds('2')
@@ -239,146 +244,146 @@ describe "FixedOdds" do
   end
 
   describe "#==" do
-    it "should treat similar fractions equally" do 
+    it "treats equivalent fractions equally" do 
       FixedOdds.fractional_odds('100/30').should == FixedOdds.fractional_odds('10/3')
     end
 
-    it "should recognise '1/1' and '2' are the same" do
+    it "recognises '1/1' and '2' are the same" do
       FixedOdds.fractional_odds('1/1').should == FixedOdds.decimal_odds('2')
     end
 
-    it "should recognise '4/1' and '5' are the same" do
+    it "recognises '4/1' and '5' are the same" do
       FixedOdds.fractional_odds('4/1').should == FixedOdds.decimal_odds('5')
     end
 
-    it "should recognise '1/4' and '1.25' are the same" do
+    it "recognises '1/4' and '1.25' are the same" do
       FixedOdds.fractional_odds('1/4').should == FixedOdds.decimal_odds('1.25')
     end
 
-    it "should recognise '4/1' and '+400' are the same" do
+    it "recognises '4/1' and '+400' are the same" do
       FixedOdds.fractional_odds('4/1').should == FixedOdds.moneyline_odds('+400')
     end
 
-    it "should recognise '1/4' and '-400' are the same" do
+    it "recognises '1/4' and '-400' are the same" do
       FixedOdds.fractional_odds('1/4').should == FixedOdds.moneyline_odds('-400')
     end
 
-    it "should recognise '+100' and '-100' are the same" do
+    it "recognises '+100' and '-100' are the same" do
       FixedOdds.moneyline_odds('+100').should == FixedOdds.moneyline_odds('-100')
     end
   end
 
   describe "#to_s" do
-    it "should display the odds in fractional odds format" do
+    it "is in fractional odds format" do
       FixedOdds.from_s('+400').to_s.should == '4/1'
     end
   end
 
   describe "#to_s_fractional" do
-    it "should display '4/1' as '4/1'" do
+    it "displays '4/1' as '4/1'" do
       FixedOdds.fractional_odds('4/1').to_s_fractional.should == '4/1'
     end
 
-    it "should print out '100/30' as '10/3' in lowest terms" do
+    it "is in the lowest terms" do
       FixedOdds.fractional_odds('100/30').to_s_fractional.should == '10/3'
     end
 
-    it "should display '+400' as '4/1'" do
+    it "is '4/1' for '+400'" do
       FixedOdds.moneyline_odds('+400').to_s_fractional.should == '4/1'
     end
 
-    it "should display '5' as '4/1'" do 
+    it "is '4/1' for '5'" do 
       FixedOdds.decimal_odds('5').to_s_fractional.should == '4/1'
     end
 
-    it "should display '+100' as '1/1'" do
+    it "is '1/1' for '+100'" do
       FixedOdds.moneyline_odds('+100').to_s_fractional.should == '1/1'
     end
 
-    it "should display '-100' as '1/1'" do
+    it "is '1/1' for '-100'" do
       FixedOdds.moneyline_odds('-100').to_s_fractional.should == '1/1'
     end
   end
 
   describe "#to_s_moneyline" do
-    it "should display '+400' as '+400'" do
+    it "is '+400' for '+400'" do
       FixedOdds.moneyline_odds('+400').to_s_moneyline.should == ('+400')
     end
 
-    it "should display '+100' as '-100' (but this could have equally been '+100')" do
+    it "is '-100' for '+100' as '-100'" do
       FixedOdds.moneyline_odds('+100').to_s_moneyline.should == ('-100')
     end
 
-    it "should display '-100' as '-100' (but this could have equally been '+100')" do
+    it "is '-100' as '-100'" do
       FixedOdds.moneyline_odds('-100').to_s_moneyline.should == ('-100')
     end
 
-    it "should display '4/1' as '+400'" do
+    it "is '+400' for '4/1'" do
       FixedOdds.fractional_odds('4/1').to_s_moneyline.should == '+400'
     end
 
-    it "should display '5' as '+400'" do
+    it "is '+400' for '5'" do
       FixedOdds.decimal_odds('5').to_s_moneyline.should == '+400'
     end
 
-    it "should display '1.25' as '-400'" do
+    it "is '-400' for '1.25'" do
       FixedOdds.decimal_odds('1.25').to_s_moneyline.should == '-400'
     end
   end
 
   describe "#to_s_decimal" do
-    it "should display '1.25' as '1.25'" do
+    it "is '1.25' for '1.25'" do
       FixedOdds.decimal_odds('1.25').to_s_decimal.should == '1.25'
     end
 
-    it "should display '1/4' as '1.25'" do
+    it "is '1.25' for '1/4'" do
       FixedOdds.fractional_odds('1/4').to_s_decimal.should == '1.25'
     end
 
-    it "should display '-400' as '1.25'" do
+    it "is '1.25' for '-400'" do
       FixedOdds.moneyline_odds('-400').to_s_decimal.should == '1.25'
     end
 
-    it "should display '+100' as '2'" do
+    it "is '2' for '+100'" do
       FixedOdds.moneyline_odds('+100').to_s_decimal.should == '2'
     end
 
-    it "should display '-100' as '2'" do
+    it "is '2' for '-100'" do
       FixedOdds.moneyline_odds('-100').to_s_decimal.should == '2'
     end
   end
 
   describe "#profit_on_winning_stake" do
-    it "should return a profit of £400 on a £100 stake on a 4/1 bet" do 
+    it "is £400 on a £100 stake on a 4/1 bet" do 
       fourToOne = FixedOdds.fractional_odds '4/1'
       fourToOne.profit_on_winning_stake(Money.from_fixnum(100, :GBP)).should == Money.from_fixnum(400, :GBP)
     end
 
-    it "should return a profit of £25 on a £100 stake with a 1/4 bet" do
+    it "is £25 on a £100 stake with a 1/4 bet" do
       oneToFour = FixedOdds.fractional_odds '1/4'
       oneToFour.profit_on_winning_stake(Money.from_fixnum(100, :GBP)).should == Money.from_fixnum(25, :GBP)
     end
   end
 
   describe "#total_return_on_winning_stake" do
-    it "should show that the full amount back on a winning 4/1 bet with a £100 stake is £500" do
+    it "is £500 on a winning 4/1 bet with a £100 stake" do
       fourToOne = FixedOdds.fractional_odds '4/1'
       fourToOne.total_return_on_winning_stake(Money.from_fixnum(100, :GBP)).should == Money.from_fixnum(500, :GBP)
     end
 
-    it "should show that the full amount back on a winning 1/4 bet with a £100 stake is £125" do
+    it "is £125 on a winning 1/4 bet with a £100 stake" do
       oneToFour = FixedOdds.fractional_odds '1/4'
       oneToFour.total_return_on_winning_stake(Money.from_fixnum(100, :GBP)).should == Money.from_fixnum(125, :GBP)
     end
   end
 
   describe "#stake_needed_to_win" do
-    it "should be £1 on a 1/1 to win £1" do
+    it "is £1 on a 1/1 to win £1" do
       oneToOne = FixedOdds.fractional_odds '1/1'
       oneToOne.stake_needed_to_win(Money.from_fixnum(1, :GBP)).should == Money.from_fixnum(1, :GBP)
     end
 
-    it "should be £100 on 4/1 to win £400" do
+    it "is £100 on 4/1 to win £400" do
       fourToOne = FixedOdds.fractional_odds '4/1'
       fourToOne.stake_needed_to_win(Money.from_fixnum(400, :GBP)).should == Money.from_fixnum(100, :GBP)
     end

data/spec/MutuallyExclusiveCollection_spec.rb

@@ -10,20 +10,27 @@ describe "MutuallyExclusiveCollection" do
     @events = MutuallyExclusiveCollection.new [@draw, @bad_team, @good_team]
   end
 
-  it "should return the bad team as the underdog" do
-    @events.underdog.should == @bad_team
+  describe "#least_likely" do
+    it "is the least likely event" do
+      @events.least_likely.should == @bad_team
+    end
   end
 
-  it "should return the good team as the favorite" do
-    @events.favorite.should == @good_team
+  describe "#most_likely" do
+    it "is the most likely event" do
+      @events.most_likely.should == @good_team
+    end
   end
 
-  it "should return the events in descending probability" do
-    @events.in_descending_probability.should == [@good_team, @draw, @bad_team]
+  describe "#in_descending_probability" do
+    it "is in descending order of probability" do
+      @events.in_descending_probability.should == [@good_team, @draw, @bad_team]
+    end
   end
 
-  it "should return the events in ascending probability" do
-    @events.in_ascending_probability.should == [@bad_team, @draw, @good_team]
+  describe "#in_ascending_probability" do
+    it "is in ascending order of probability" do
+      @events.in_ascending_probability.should == [@bad_team, @draw, @good_team]
+    end
   end
-
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rodders
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 1.0.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2011-12-11 00:00:00.000000000Z
+date: 2012-01-02 00:00:00.000000000Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: money
-  requirement: &70347044732340 !ruby/object:Gem::Requirement
+  requirement: &70289789377020 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,10 +21,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70347044732340
+  version_requirements: *70289789377020
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &70347044731860 !ruby/object:Gem::Requirement
+  requirement: &70289789376500 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -32,10 +32,10 @@ dependencies:
         version: 2.3.0
   type: :development
   prerelease: false
-  version_requirements: *70347044731860
+  version_requirements: *70289789376500
 - !ruby/object:Gem::Dependency
   name: yard
-  requirement: &70347044731320 !ruby/object:Gem::Requirement
+  requirement: &70289789353180 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -43,10 +43,10 @@ dependencies:
         version: 0.6.0
   type: :development
   prerelease: false
-  version_requirements: *70347044731320
+  version_requirements: *70289789353180
 - !ruby/object:Gem::Dependency
   name: bundler
-  requirement: &70347044730800 !ruby/object:Gem::Requirement
+  requirement: &70289789352580 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -54,10 +54,10 @@ dependencies:
         version: 1.0.0
   type: :development
   prerelease: false
-  version_requirements: *70347044730800
+  version_requirements: *70289789352580
 - !ruby/object:Gem::Dependency
   name: jeweler
-  requirement: &70347044730320 !ruby/object:Gem::Requirement
+  requirement: &70289789352000 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -65,10 +65,10 @@ dependencies:
         version: 1.6.4
   type: :development
   prerelease: false
-  version_requirements: *70347044730320
+  version_requirements: *70289789352000
 - !ruby/object:Gem::Dependency
   name: rcov
-  requirement: &70347044729800 !ruby/object:Gem::Requirement
+  requirement: &70289789351400 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -76,7 +76,7 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70347044729800
+  version_requirements: *70289789351400
 description: Converts between fractional, decimal and moneyline odds for betting and
   gambling. Calculates how much can be won on a given stake.
 email: nigel-lowry@ultra.eclipse.co.uk
@@ -116,7 +116,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 2781179272829975536
+      hash: 3132446332163279190
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements: