fixes, documenttation and tests for game api

lib/sightstone/match_history.rb

@@ -1,5 +1,8 @@
 require 'sightstone/stat'
 
+# match history of a summoner
+# @attr [Fixnum] summonerId ID of the summoner
+# @attr [Array<HistoryGame>] games unsorted list of recently played games
 class MatchHistory
   attr_accessor :games, :summonerId
   
@@ -7,13 +10,28 @@ class MatchHistory
     @summonerId = data['summonerId']
     @games = []
     data['games'].each do |game|
-      games << Game.new(game)
+      games << HistoryGame.new(game)
     end
   end
 end
 
-class Game
-  attr_accessor :championId, :createDate, :createDateString, :fellowPlayers, :gameId, :gameMode, :gameType, :invalid, :level, :mapId, :spell1, :spell2, :statistics, :subType, :teamId
+# A played game
+# @attr [Fixnum] championId ID of the played champ of requested summoner
+# @attr [Fixnum] createDate UNIX timestamp of creation date of the games
+# @attr [Array<Player>] fellowPlayers a list of all players of the game
+# @attr [Fixnum] gameId ID of the game
+# @attr [String] gameMode mode of the game
+# @attr [String] gameType type of the game
+# @attr [Boolean] invalid Invalid flag #TODO what is this?
+# @attr [Fixnum] level level of the requested summoner
+# @attr [Fixnum] mapId ID of the played map
+# @attr [Fixnum] spell1 selected summoner spell no 1
+# @attr [Fixnum] spell2 selected summoner spell no 2
+# @attr [String] subtype subtype
+# @attr [Fixnum] teamId ID of the team if there is a team associated to the game
+# @attr [Array<Stat>] statistics statistics of the game
+class HistoryGame
+  attr_accessor :championId, :createDate, :fellowPlayers, :gameId, :gameMode, :gameType, :invalid, :level, :mapId, :spell1, :spell2, :statistics, :subType, :teamId
   
   def initialize(data)
     @championId=data['championId']
@@ -29,7 +47,7 @@ class Game
     @invalid=data['invalid']
     @level=data['level']
     @mapId=data['mapId']
-    @spell1=data['spell1]']
+    @spell1=data['spell1']
     @spell2=data['spell2']
     @statistics = []
     data['statistics'].each do |stat|
@@ -40,6 +58,10 @@ class Game
   end
 end
 
+# player of a game
+# @attr [Fixnum] championId ID of played Champion
+# @attr [Fixnum] summonerId ID of the summoner
+# @attr [Fixnum] teammId ID of the team
 class Player
   attr_accessor :championId, :summonerId, :teamId
   
@@ -48,4 +70,22 @@ class Player
     @summonerId = data['summonerId']
     @teamId = data['teamId']
   end
+end
+
+# statistical value of a game
+# @attr [Fixnum] id ID of the statistical value
+# @attr [String] mame name of the statistical value (example: MINIONS_KILLED)
+# @attr [Fixnum] value value
+class Stat
+  attr_accessor :id, :name, :value
+  
+  def initialize(data)
+    @name = data['name']
+    @id = data['id']
+    @value = if data.has_key? 'value'
+      data['value']
+    else
+      data['count']
+    end
+  end
 end

lib/sightstone/modules/game_module.rb

@@ -2,12 +2,17 @@ require 'sightstone/modules/sightstone_base_module'
 require 'sightstone/summoner'
 require 'sightstone/match_history'
 
+# module to access the game api
 class GameModule < SightstoneBaseModule
   
   def initialize(sightstone)
     @sightstone = sightstone
   end
   
+  # returns the match history of a summoner
+  # @param [Summoner, Fixnum] summoner summoner object or id of a summoner
+  # @param optional [Hash] optional arguments: :region => replaces default region
+  # @return [MatchHistory] match history of the summoner
   def recent(summoner, optional={})
     region = optional[:region] || @sightstone.region
    id = if summoner.is_a? Summoner

lib/sightstone/stat.rb

@@ -1,12 +0,0 @@
-class Stat
-  attr_accessor :name, :value
-  
-  def initialize(data)
-    @name = data['name']
-    @value = if data.has_key? 'value'
-      data['value']
-    else
-      data['count']
-    end
-  end
-end