champions api: rdoc, tests, removed debug strings

lib/sightstone/champion.rb

@@ -1,3 +1,15 @@
+# Class to represent a champion
+# @attr [Boolean] active determines if champion is active
+# @attr [Integer] attackRank attack rank
+# @attr [Boolean] botEnabled Bot enabled flag (for custom games)
+# @attr [Boolean] botMmEnabled Bot Match Made enabeld flag (for Coop/AI games)
+# @attr [Integer] defenseRank	Champion defense rank.
+# @attr [Integer] difficultyRank Champion difficulty rank.
+# @attr [Boolean] freeToPlay Indicates if the champion is free to play. Free to play champions are rotated periodically.
+# @attr [Fixnum] id	Champion ID.
+# @attr [Integer] magicRank	Champion magic rank.
+# @attr [String] name Champion name.
+# @attr [boolean] rankedPlayEnabled	Ranked play enabled flag.
 class Champion
   attr_accessor :active, :attackRank, :botEnabled, :botMmEnabled
   attr_accessor :defenseRank, :difficultyRank, :freeToPlay, :id, :magicRank, :name, :rankedPlayEnabled

lib/sightstone/modules/champion_module.rb

@@ -1,18 +1,21 @@
 require 'sightstone/champion'
 require 'sightstone/modules/sightstone_base_module'
 
+# Module to provide calls to the summoner api
 class ChampionModule < SightstoneBaseModule
 
   def initialize(sightstone)
     @sightstone = sightstone
   end
 
+  # call to get champions
+  # @param optional [Hash] optional arguments: :region => replaces default region, :free_to_play => boolean (only free to play champs if true)
+  # @return [Array<Champion>] array of champs
   def champions(optional={})
     region = optional[:region] || @sightstone.region
     free_to_play = optional[:free_to_play]
     uri = "https://prod.api.pvp.net/api/lol/#{region}/v1.1/champion"
     response = _get_api_response(uri, {'freeToPlay' => free_to_play})
-  puts response
 
     _parse_response(response) { |resp|
       data = JSON.parse(resp)