elo 0.0.2.alpha → 0.0.3.alpha

data/README.rdoc

@@ -45,16 +45,16 @@ There is more than one way to do it, choose whatever works from your other code:
 
 You can get all kinds of info from a player:
 
-  bob.rating
-  bob.pro?
-  bob.starter?
-  bob.pro_rating?
-  bob.games_played
-  bob.games
+  bob.rating       # => 1084
+  bob.pro?         # => false
+  bob.starter?     # => true
+  bob.games_played # => 7
+  bob.games        # => [ game1, game2, ... game7 ]
 
 Or get a list of players:
 
-  Elo::Player.all
+  Elo::Player.all  # => [ bob, jane ]
+  Elo::Game.all    # => [ game1, game2, ... game7 ]
 
 
 == Configuration
@@ -91,14 +91,15 @@ Once you reach a pro status, you're K-factor never changes, even if your rating
 
 You need to provide Elo the amount of games played, their rating and their pro-status.
 
-  bob = Elo::Player.new(:games_played => 29, :rating => 2300, :pro => true)
+  bob = Elo::Player.new(:games_played => 29, :rating => 2399, :pro => true)
+  bob.k_factor == 10
 
 You can define your own K-factors by adding K-factor rules.
-This code will change the K-factor to 12, for every player who's name starts with a B,
-and 16 for everybody else.
+This code will change the K-factor to 12, for every player that played less than 10
+games, and 16 for everybody else.
 
   Elo.configure do |config|
-    config.k_factor(12) { name =~ /^b/i }
+    config.k_factor(12) { games_played < 10 }
     config.default_k_factor = 16
     config.use_FIDE_settings = false
   end

data/VERSION

@@ -1 +1 @@
-0.0.2.alpha
+0.0.3.alpha

data/elo.gemspec

@@ -0,0 +1,73 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{elo}
+  s.version = "0.0.3.alpha"
+
+  s.required_rubygems_version = Gem::Requirement.new("> 1.3.1") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Iain Hecker"]
+  s.date = %q{2010-03-15}
+  s.description = %q{The Elo rating system is a method for calculating the relative skill levels of players in two-player games such as cess and Go.}
+  s.email = %q{iain@iain.nl}
+  s.extra_rdoc_files = [
+    "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+     ".gitignore",
+     "README.rdoc",
+     "Rakefile",
+     "VERSION",
+     "doc/classes/Elo.html",
+     "doc/classes/Elo/Configuration.html",
+     "doc/classes/Elo/EloHelper.html",
+     "doc/classes/Elo/EloHelper/ClassMethods.html",
+     "doc/classes/Elo/Game.html",
+     "doc/classes/Elo/Player.html",
+     "doc/classes/Elo/Rating.html",
+     "doc/created.rid",
+     "doc/files/README_rdoc.html",
+     "doc/files/lib/elo_rb.html",
+     "doc/fr_class_index.html",
+     "doc/fr_file_index.html",
+     "doc/fr_method_index.html",
+     "doc/index.html",
+     "doc/rdoc-style.css",
+     "elo.gemspec",
+     "lib/elo.rb",
+     "lib/elo/configuration.rb",
+     "lib/elo/game.rb",
+     "lib/elo/helper.rb",
+     "lib/elo/player.rb",
+     "lib/elo/rating.rb",
+     "spec/elo_spec.rb",
+     "spec/spec.opts",
+     "spec/spec_helper.rb"
+  ]
+  s.homepage = %q{http://github.com/iain/elo}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.6}
+  s.summary = %q{The Elo rating system is a method for calculating the relative skill levels of players in two-player games such as cess and Go.}
+  s.test_files = [
+    "spec/elo_spec.rb",
+     "spec/spec_helper.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<rspec>, [">= 1.2.9"])
+    else
+      s.add_dependency(%q<rspec>, [">= 1.2.9"])
+    end
+  else
+    s.add_dependency(%q<rspec>, [">= 1.2.9"])
+  end
+end
+

data/lib/elo.rb

@@ -1,298 +1,26 @@
-# The configuration of Elo is done here.
-#
+require 'elo/helper'
+require 'elo/configuration'
+require 'elo/game'
+require 'elo/player'
+require 'elo/rating'
+
 # See README.rdoc for general information about Elo.
 module Elo
 
-  @pro_rating_boundry = 2400
-  @starter_boundry    = 30
-  @default_rating     = 1000
-  @default_k_factor   = 15
-  @use_FIDE_settings  = true
-
-  module Configuration
-
-    # Add a K-factor rule. The first argument is the k-factor value.
-    # The block should return a boolean that determines if this K-factor rule applies.
-    # The first rule that applies is the one determining the K-factor.
-    #
-    # The block is instance_eval'ed into the player, so you can access all it's
-    # properties directly. The K-factor is recalculated every time a match is played.
-    #
-    # By default, the FIDE settings are used (see: +use_FIDE_settings+). To implement
-    # that yourself, you could write:
-    #
-    #   Elo.configure do |config|
-    #     config.k_factor(10) { pro? or pro_rating? }
-    #     config.k_factor(25) { starter? }
-    #     config.default_k_factor = 15
-    #   end
-    #
-    def k_factor(factor, &rule)
-      k_factors << { :factor => factor, :rule => rule }
-    end
-
-    # This is the lower boundry of the rating you need to be a pro player.
-    # This setting is used in the FIDE k-factor rules. (default = 2400)
-    attr_accessor :pro_rating_boundry
-
-    # This is the lower boundry in the amount of games played to be a starting player
-    # This setting is used in the FIDE k-factor rules. (default = 30)
-    attr_accessor :starter_boundry
-
-    # The default k-factor is chosen when no k-factor rules apply.
-    # K-factor rules can be added by using the +k_factor+-method. (default = 15)
-    attr_accessor :default_k_factor
-
-    # This is the rating every player starts out with. (default = 1000)
-    attr_accessor :default_rating
-
-    # Use the settings that FIDE use for determening the K-factor.
-    # This is the case when all settings are unaltered. (default = true)
-    # 
-    # In short:
-    # 
-    # * K-factor is 25 when a player is a starter (less than 30 games played)
-    # * K-factor is 10 when a player is a pro (rating above 2400, now or in the past)
-    # * K-factor is 15 when a player in other cases
-    #
-    # If you want to use your own settings, either change the boundry settings,
-    # or set this setting to false and add you're own k-factor rules.
-    # K-factor rules can be added by using the +k_factor+-method.
-    attr_accessor :use_FIDE_settings
-
-    # Configure Elo in a block style.
-    #
-    #   Elo.configure do |config|
-    #     config.setting = value
-    #   end
-    def configure(&block)
-      yield(self)
-    end
-
-    private
-
-    def k_factors
-      @k_factors ||= []
-    end
-
-    def applied_k_factors
-      apply_fide_k_factors if use_FIDE_settings
-      k_factors
-    end
-
-    def apply_fide_k_factors
-      unless @applied_fide_k_factors
-        k_factor(10) { pro? or pro_rating? }
-        k_factor(25) { starter? }
-        @applied_fide_k_factors = true
-      end
-    end
-
+  # Accessor to the configuration object, which,
+  # should be instantiated only once (and automatically).
+  def self.config
+    @config ||= Configuration.new
   end
 
-  extend Configuration
-
-  # Common methods for Elo classes.
-  module EloHelper
-
-    def self.included(base)
-      base.extend ClassMethods
-    end
-
-    # Every object can be initialized with a hash, just like in ActiveRecord.
-    def initialize(attributes)
-      @attributes == attributes.keys
-      attributes.each do |key, value|
-        self.class.attr_reader key
-        instance_variable_set("@#{key}", value)
-      end
-      self.class.all << self
-    end
-
-    # Get a hash of all attributes provided
-    def attributes
-      hash = {}
-      @attributes.each do |attribute|
-        hash.update attribute => send(attribute)
-      end
-      hash
-    end
-    
-    module ClassMethods
-
-      # Provides a list of all instantiated objects of the class.
-      def all
-        @all ||= []
-      end
-
-    end
-
-  end
-
-  # A player. You need at least two play a Game.
-  class Player
-
-    include EloHelper
-
-    # Rating
-    def rating
-      @rating ||= Elo.default_rating
-    end
-
-    def games_played
-      @games_played ||= games.size
-    end
-
-    def games
-      @games ||= []
-    end
-
-    def pro_rating?
-      rating > Elo.pro_rating_boundry
-    end
-
-    def starter?
-      games_played < Elo.starter_boundry
-    end
-
-    def pro?
-      !!@pro
-    end
-
-    # TODO
-    def save
-      # hook for your own model
-      # which I don't know yet how to do
-    end
-
-    def k_factor
-      Elo.applied_k_factors.each do |rule|
-        return rule[:factor] if instance_eval(&rule[:rule])
-      end
-      Elo.default_k_factor
-    end
-
-    def versus(other_player)
-      Game.new(:one => self, :two => other_player)
-    end
-
-    def wins_from(other_player)
-      versus(other_player).win
-    end
-
-    def plays_draw(other_player)
-      versus(other_player).draw
-    end
-
-    def loses_from(other_player)
-      versus(other_player).lose
-    end
-
-    private
-
-    # A Game tells the players informed to update their
-    # scores, after it knows the result (so it can calculate the rating).
-    #
-    # This method is private, because it is called automatically.
-    # Therefore it is not part of the public API of Elo.
-    def played(game)
-      games_played += 1
-      games << game
-      @rating = game.new_rating(self)
-      @pro    = true if pro_rating?
-      save
-    end
-
-
-  end
-
-  class Game
-
-    include EloHelper
-
-    # Result is from the perspective of player one.
-    def result=(result)
-      @result = result
-      one.send(:played, self)
-      two.send(:played, self)
-      save
-    end
-
-    def win
-      self.result = 1.0
-    end
-
-    def lose
-      self.result = 0.0
-    end
-
-    def draw
-      self.result = 0.5
-    end
-
-    # TODO
-    def save
-    end
-
-    def winner=(player)
-      self.result = (player == :one ? 1.0 : 0.0)
-    end
-
-    def loser=(player)
-      self.result = (player == :one ? 0.0 : 1.0)
-    end
-
-    def new_rating(player)
-      ratings[player].new_rating
-    end
-
-    private
-
-    def ratings
-      @ratings ||= { one => rating_one, two => rating_two }
-    end
-
-    def rating_one
-      Rating.new(:result        => result,
-                 :old_rating    => one.rating,
-                 :other_rating  => two.rating,
-                 :k_factor      => one.k_factor)
-    end
-
-    def rating_two
-      Rating.new(:result        => (1.0 - result),
-                 :old_rating    => two.rating,
-                 :other_rating  => one.rating,
-                 :k_factor      => two.k_factor)
-    end
-
-  end
-
-  class Rating
-
-    include EloHelper
-
-    def result
-      raise "Invalid result: #{@result.inspect}" unless valid_result?
-      @result.to_f
-    end
-
-    def valid_result?
-      (0..1).include? @result
-    end
-
-    def expected
-      1.0 / ( 1.0 + ( 10.0 ** ((other_rating.to_f - old_rating.to_f) / 400.0) ) )
-    end
-
-    def change
-      k_factor.to_f * ( result.to_f - expected )
-    end
-
-    def new_rating
-      (old_rating.to_f + change).to_i
-    end
-
+  # Configure Elo in a block style.
+  # See Elo::Configuration for more details.
+  #
+  #   Elo.configure do |config|
+  #     config.attribute = :value
+  #   end
+  def self.configure(&block)
+    yield(config)
   end
 
 end

data/lib/elo/configuration.rb

@@ -0,0 +1,83 @@
+module Elo
+
+  class Configuration
+
+    # This is the lower boundry of the rating you need to be a pro player.
+    # This setting is used in the FIDE k-factor rules. (default = 2400)
+    attr_accessor :pro_rating_boundry
+
+    # This is the lower boundry in the amount of games played to be a starting player
+    # This setting is used in the FIDE k-factor rules. (default = 30)
+    attr_accessor :starter_boundry
+
+    # The default k-factor is chosen when no k-factor rules apply.
+    # K-factor rules can be added by using the +k_factor+-method. (default = 15)
+    attr_accessor :default_k_factor
+
+    # This is the rating every player starts out with. (default = 1000)
+    attr_accessor :default_rating
+
+    # Use the settings that FIDE use for determening the K-factor.
+    # This is the case when all settings are unaltered. (default = true)
+    # 
+    # In short:
+    # 
+    # * K-factor is 25 when a player is a starter (less than 30 games played)
+    # * K-factor is 10 when a player is a pro (rating above 2400, now or in the past)
+    # * K-factor is 15 when a player in other cases
+    #
+    # If you want to use your own settings, either change the boundry settings,
+    # or set this setting to false and add you're own k-factor rules.
+    # K-factor rules can be added by using the +k_factor+-method.
+    attr_accessor :use_FIDE_settings
+
+    def initialize #:nodoc:
+      @pro_rating_boundry = 2400
+      @starter_boundry    = 30
+      @default_rating     = 1000
+      @default_k_factor   = 15
+      @use_FIDE_settings  = true
+    end
+
+    # Add a K-factor rule. The first argument is the k-factor value.
+    # The block should return a boolean that determines if this K-factor rule applies.
+    # The first rule that applies is the one determining the K-factor.
+    #
+    # The block is instance_eval'ed into the player, so you can access all it's
+    # properties directly. The K-factor is recalculated every time a match is played.
+    #
+    # By default, the FIDE settings are used (see: +use_FIDE_settings+). To implement
+    # that yourself, you could write:
+    #
+    #   Elo.configure do |config|
+    #     config.k_factor(10) { pro? or pro_rating? }
+    #     config.k_factor(25) { starter? }
+    #     config.default_k_factor = 15
+    #   end
+    #
+    def k_factor(factor, &rule)
+      k_factors << { :factor => factor, :rule => rule }
+    end
+
+    def applied_k_factors #:nodoc:
+      apply_fide_k_factors if use_FIDE_settings
+      k_factors
+    end
+
+    private
+
+    def k_factors
+      @k_factors ||= []
+    end
+
+    def apply_fide_k_factors
+      unless @applied_fide_k_factors
+        k_factor(10) { pro? or pro_rating? }
+        k_factor(25) { starter? }
+        @applied_fide_k_factors = true
+      end
+    end
+
+  end
+
+end

data/lib/elo/game.rb

@@ -0,0 +1,92 @@
+module Elo
+
+	# A Game is a collection of two Elo::Player objects
+	# and a result.
+	# Once the result is known, it propagates the new
+	# ratings to the players.
+  class Game
+
+    include Helper
+
+		# The result is the result of the match. It's a nubmer
+		# from 0 to 1 from the perspective of player +:one+.
+    attr_reader :result
+
+		# The first Elo::Player. The result is in perspecive of
+		# this player.
+    attr_reader :one
+
+		# The second Elo::Player.
+    attr_reader :two
+
+    # Every time a result is set, it tells the Elo::Player
+		# objects to update their scores.
+    def process_result(result)
+      @result = result
+      one.send(:played, self)
+      two.send(:played, self)
+      save
+      self
+    end
+    alias result= process_result
+
+		# Player +:one+ has won!
+		# This is a shortcut method for setting the score to 1
+    def win
+      process_result 1.0
+    end
+
+		# Player +:one+ has lost!
+		# This is a shortcut method for setting the score to 0
+    def lose
+      process_result 0.0
+    end
+
+		# It was a draw.
+		# This is a shortcut method for setting the score to 0.5
+    def draw
+      process_result 0.5
+    end
+
+    # You can override this method if you store each game
+		# in a database or something like that.
+		# This method will be called when a result is known.
+    def save
+    end
+
+		# Set the winner. Provide it with a Elo::Player. 
+    def winner=(player)
+      process_result(player == one ? 1.0 : 0.0)
+    end
+
+		# Set the loser. Provide it with a Elo::Player. 
+    def loser=(player)
+      process_result(player == one ? 0.0 : 1.0)
+    end
+
+		# Access the Elo::Rating objects for both players.
+    def ratings
+      @ratings ||= { one => rating_one, two => rating_two }
+    end
+
+    private
+
+		# Create an Elo::Rating object for player one
+    def rating_one
+      Rating.new(:result        => result,
+                 :old_rating    => one.rating,
+                 :other_rating  => two.rating,
+                 :k_factor      => one.k_factor)
+    end
+
+		# Create an Elo::Rating object for player two
+    def rating_two
+      Rating.new(:result        => (1.0 - result),
+                 :old_rating    => two.rating,
+                 :other_rating  => one.rating,
+                 :k_factor      => two.k_factor)
+    end
+
+  end
+
+end

data/lib/elo/helper.rb

@@ -0,0 +1,29 @@
+module Elo
+
+	module Helper
+
+    def self.included(base)
+      base.extend ClassMethods
+    end
+
+    # Every object can be initialized with a hash,
+		# almost, but not quite, entirely unlike ActiveRecord.
+    def initialize(attributes = {})
+      attributes.each do |key, value|
+        instance_variable_set("@#{key}", value)
+      end
+      self.class.all << self
+    end
+
+    module ClassMethods
+
+      # Provides a list of all instantiated objects of the class.
+      def all
+        @all ||= []
+      end
+
+    end
+
+	end
+
+end

data/lib/elo/player.rb

@@ -0,0 +1,110 @@
+module Elo
+
+  # A player. You need at least two play a Game.
+  class Player
+
+    include Helper
+
+    # The rating you provided, or the default rating from configuration
+    def rating
+      @rating ||= Elo.config.default_rating
+    end
+
+		# The number of games played is needed for calculating the K-factor.
+    def games_played
+      @games_played ||= games.size
+    end
+
+		# A list of games played by the player.
+    def games
+      @games ||= []
+    end
+
+		# Is the player considered a pro, because his/her rating crossed
+		# the threshold configured? This is needed for calculating the K-factor.
+    def pro_rating?
+      rating >= Elo.config.pro_rating_boundry
+    end
+
+		# Is the player just starting? Provide the boundry for
+		# the amount of games played in the configuration.
+		# This is needed for calculating the K-factor.
+    def starter?
+      games_played < Elo.config.starter_boundry
+    end
+
+		# FIDE regulations specify that once you reach a pro status
+		# (see +pro_rating?+), you are considered a pro for life.
+		#
+		# You might need to specify it manually, when depending on
+		# external persistence of players.
+		#
+		#		Elo::Player.new(:pro => true)
+    def pro?
+      !!@pro
+    end
+
+    # You can override this method if you store each game
+		# in a database or something like that.
+		# This method will be called when a result is known.
+    def save
+    end
+
+		# Calculates the K-factor for the player.
+		# Elo allows you specify custom Rules (see Elo::Configuration).
+		#
+		# You can set it manually, if you wish:
+		#
+		#		Elo::Player.new(:k_factor => 10)
+		#
+		#	This stops this player from using the K-factor rules.
+    def k_factor
+      return @k_factor if @k_factor
+      Elo.config.applied_k_factors.each do |rule|
+        return rule[:factor] if instance_eval(&rule[:rule])
+      end
+      Elo.config.default_k_factor
+    end
+
+		# Start a game with another player. At this point, no
+		# result is known and nothing really happens.
+    def versus(other_player)
+      Game.new(:one => self, :two => other_player)
+    end
+
+		# Start a game with another player and set the score
+		# immediately.
+    def wins_from(other_player)
+      versus(other_player).win
+    end
+
+		# Start a game with another player and set the score
+		# immediately.
+    def plays_draw(other_player)
+      versus(other_player).draw
+    end
+
+		# Start a game with another player and set the score
+		# immediately.
+    def loses_from(other_player)
+      versus(other_player).lose
+    end
+
+    private
+
+    # A Game tells the players informed to update their
+    # scores, after it knows the result (so it can calculate the rating).
+    #
+    # This method is private, because it is called automatically.
+    # Therefore it is not part of the public API of Elo.
+    def played(game)
+      @games_played = games_played + 1
+      games << game
+      @rating = game.ratings[self].new_rating
+      @pro    = true if pro_rating?
+      save
+    end
+
+  end
+
+end

data/lib/elo/rating.rb

@@ -0,0 +1,59 @@
+module Elo
+
+	# This class calculates the rating between two players,
+	# but only from one persons perspective. You need two Rating-instances
+	# to calculate ratings for both players. Luckily, Elo::Game handles
+	# this for you automatically.
+  class Rating
+
+    include Helper
+
+		# The rating of the player you DON"T wish to calculate.
+    attr_reader :other_rating
+
+		# The rating of the player you wish to calculate.
+    attr_reader :old_rating
+
+		# The k-factor you wish to use for this calculation.
+    attr_reader :k_factor
+
+		# The new rating is... wait for it... the new rating!
+    def new_rating
+      (old_rating.to_f + change).to_i
+    end
+
+		private
+
+		# The result of the match. 1 means that the player won, 0 means that the
+		# player lost and 0.5 means that it was a draw.
+    def result
+      raise "Invalid result: #{@result.inspect}" unless valid_result?
+      @result.to_f
+    end
+
+		# Only values between 0 and 1 are considered to be valid scores.
+    def valid_result?
+      (0..1).include? @result
+    end
+
+		# The expected score is the probably outcome of the match, depending
+		# on the difference in rating between the two players.
+		# 
+		# For more information visit
+		# {Wikipedia}[http://en.wikipedia.org/wiki/Elo_rating_system#Mathematical_details]
+    def expected
+      1.0 / ( 1.0 + ( 10.0 ** ((other_rating.to_f - old_rating.to_f) / 400.0) ) )
+    end
+
+		# The change is the points you earn or lose.
+		# 
+		# For more information visit
+		# {Wikipedia}[http://en.wikipedia.org/wiki/Elo_rating_system#Mathematical_details]
+    def change
+      k_factor.to_f * ( result.to_f - expected )
+    end
+
+
+  end
+
+end

data/spec/elo_spec.rb

@@ -1,7 +1,148 @@
 require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
 
 describe "Elo" do
-  it "fails" do
-    fail "hey buddy, you should probably rename this file and start specing for real"
+
+  after do
+    Elo.instance_eval { @config = nil }
+  end
+
+  it "should work as advertised" do
+
+    bob  = Elo::Player.new
+    jane = Elo::Player.new(:rating => 1500)
+
+    game1 = bob.wins_from(jane)
+    game2 = bob.loses_from(jane)
+    game3 = bob.plays_draw(jane)
+
+    game4 = bob.versus(jane)
+    game4.winner = jane
+
+    game5 = bob.versus(jane)
+    game5.loser = jane
+
+    game6 = bob.versus(jane)
+    game6.draw
+
+    game7 = bob.versus(jane)
+    game7.result = 1
+
+    bob.rating.should == 1084
+    jane.rating.should == 1409
+    bob.should_not be_pro
+    bob.should be_starter
+    bob.games_played.should == 7
+    bob.games.should == [ game1, game2, game3, game4, game5, game6, game7 ]
+
+    Elo::Player.all.should == [ bob, jane ]
+    Elo::Game.all.should == [ game1, game2, game3, game4, game5, game6, game7 ]
+
+  end
+
+  describe "Configuration" do
+
+    it "default_rating" do
+      Elo.config.default_rating.should == 1000
+      Elo::Player.new.rating.should    == 1000
+
+      Elo.config.default_rating = 1337
+
+      Elo.config.default_rating.should == 1337
+      Elo::Player.new.rating.should    == 1337
+    end
+
+    it "starter_boundry" do
+      Elo.config.starter_boundry.should == 30
+      Elo::Player.new(:games_played => 20).should be_starter
+
+      Elo.config.starter_boundry = 15
+
+      Elo.config.starter_boundry.should == 15
+      Elo::Player.new(:games_played => 20).should_not be_starter
+    end
+
+    it "default_k_factor and FIDE settings" do
+      Elo.config.use_FIDE_settings.should    == true
+      Elo.config.default_k_factor.should     == 15
+
+      Elo.config.default_k_factor = 20
+      Elo.config.use_FIDE_settings = false
+
+      Elo.config.default_k_factor.should     == 20
+      Elo.config.use_FIDE_settings.should    == false
+      Elo::Player.new.k_factor.should == 20
+    end
+
+    it "pro_rating_boundry" do
+      Elo.config.pro_rating_boundry.should == 2400
+
+      Elo.config.pro_rating_boundry = 1337
+
+      Elo.config.pro_rating_boundry.should == 1337
+      Elo::Player.new(:rating => 1337).should be_pro_rating
+    end
+
   end
+
+  describe "according to FIDE" do
+
+    it "starter" do
+      player = Elo::Player.new
+      player.k_factor.should == 25
+      player.should be_starter
+      player.should_not be_pro
+      player.should_not be_pro_rating
+    end
+
+    it "normal" do
+      player = Elo::Player.new(:rating => 2399, :games_played => 30)
+      player.k_factor.should == 15
+      player.should_not be_starter
+      player.should_not be_pro
+      player.should_not be_pro_rating
+    end
+
+    it "pro rating" do
+      player = Elo::Player.new(:rating => 2400)
+      player.k_factor.should == 10
+      player.should be_starter
+      player.should be_pro_rating
+      player.should_not be_pro
+    end
+
+    it "historically a pro" do
+      player = Elo::Player.new(:rating => 2399, :pro => true)
+      player.k_factor.should == 10
+      player.should be_starter
+      player.should_not be_pro_rating
+      player.should be_pro
+    end
+  end
+
+  describe "examples for calculating rating correctly" do
+
+    # examples from http://chesselo.com/
+
+    before do
+      @a = Elo::Player.new(:rating => 2000, :k_factor => 10)
+      @b = Elo::Player.new(:rating => 1900, :k_factor => 10)
+    end
+
+    it "winning" do
+      @a.wins_from(@b)
+      @a.rating.should == 2003
+    end
+
+    it "losing" do
+      @a.loses_from(@b)
+      @a.rating.should == 1993
+    end
+
+    it "draw" do
+      @a.plays_draw(@b)
+      @a.rating.should == 1998
+    end
+
+  end
+
 end

metadata

@@ -5,9 +5,9 @@ version: !ruby/object:Gem::Version
   segments: 
   - 0
   - 0
-  - 2
+  - 3
   - alpha
-  version: 0.0.2.alpha
+  version: 0.0.3.alpha
 platform: ruby
 authors: 
 - Iain Hecker
@@ -61,7 +61,13 @@ files:
 - doc/fr_method_index.html
 - doc/index.html
 - doc/rdoc-style.css
+- elo.gemspec
 - lib/elo.rb
+- lib/elo/configuration.rb
+- lib/elo/game.rb
+- lib/elo/helper.rb
+- lib/elo/player.rb
+- lib/elo/rating.rb
 - spec/elo_spec.rb
 - spec/spec.opts
 - spec/spec_helper.rb