sightstone 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: f116214f33400d4753fc864706fbeb8ec8da2b2c
-  data.tar.gz: 15eadac3ff6f1e9429ea9a82dda928b53c2beb51
+  metadata.gz: e1ae542a57feb0c02b9c0edda4af3f15c12efc3e
+  data.tar.gz: 8190b20a31a41ed7049b5c61117abe922efa4822
 SHA512:
-  metadata.gz: 04d66bd583fdbf2390f82a8ced8f874eb6a3251078b756d35b119a4ab3dcac01880be6692067fda38318c577630188eb38142f2855c53b58f686715bf3cb6580
-  data.tar.gz: 9bb9f4c21fe1f406e5815c1ff0348df8e3cafab35d61d076bb8634f4f6c9e4308e925c80a7ea5ff43e4d2cb007bbdb7a0d13c24cfa1113bf934da660a5f1e601
+  metadata.gz: d1ff572e25f88aad085f6ba142e851511b44af196830ed2d8271c0d51d9af49ced9c3119d2501ab4670f5a8c1541d52e611e2874fb1ebb68f484776ccadb2d39
+  data.tar.gz: 1e3c54e978dbbea24cd2fef83aaf34d561f0682a9817aa112940c04f8a2e6fcd407443d60d6ac53372d38632bca6ef405eaf471984e6faa3cb6651990c630840

data/lib/sightstone/masterybook.rb

@@ -1,3 +1,6 @@
+# Class to represent the masterybook of a summoner
+# @attr [Numeric] summonerId id of the summoner
+# @attr [Array<MasteryPage>] pages of the masterybook
 class MasteryBook
   attr_accessor :pages, :summonerId
   
@@ -10,6 +13,11 @@ class MasteryBook
   end
 end
 
+# Class to represent a page of a masterybook
+# @attr [Numeric] id ID of the page
+# @attr [String] name page name
+# @attr [Boolean] current indicates if the page is selected
+# @attr [Array<Talent>] array of selected talents
 class MasteryPage
   attr_accessor :id, :talents, :name, :current
   
@@ -25,6 +33,10 @@ class MasteryPage
 
 end
 
+# Class to represent a talent of a mastery page
+# @attr [Numeric] id id of the mastery
+# @attr [String] name of the mastery
+# @attr [Numeric] rank rank of the mastery
 class Talent
   attr_accessor :id,:rank, :name
   

data/lib/sightstone/modules/summoner_module.rb

@@ -4,17 +4,23 @@ require 'sightstone/masterybook'
 require 'sightstone/runebook'
 require 'open-uri'
 
+# Module to provide calls to the summoner api
 class SummonerModule < SightstoneBaseModule
+  
   def initialize(sightstone)
     @sightstone = sightstone
   end
 
+  # returns a summoner object
+  # @param name_or_id [Integer, String] name or id of the summoner
+  # @param optional [Hash] optional arguments: :region => replaces default region
+  # @ return [Summoner] summoner
   def summoner(name_or_id, optional={})
     region = optional[:region] || @sightstone.region
     uri = if name_or_id.is_a? Integer
-      "https://prod.api.pvp.net/api/lol/#{region}/v1.1/summoner/#{name_or_id}"
+      "https://prod.api.pvp.net/api/lol/#{region}/v1.2/summoner/#{name_or_id}"
     else
-      "https://prod.api.pvp.net/api/lol/#{region}/v1.1/summoner/by-name/#{URI::encode(name_or_id)}"
+      "https://prod.api.pvp.net/api/lol/#{region}/v1.2/summoner/by-name/#{URI::encode(name_or_id)}"
     end
     
     response = _get_api_response(uri)
@@ -24,18 +30,30 @@ class SummonerModule < SightstoneBaseModule
     }
   end
 
-
+  # returns the names for the ids
+  # @param ids [Array<Numeric>] ids
+  # @param optional [Hash<Symbol, String>] optional arguments: :region => replaces default region
+  # @return [Hash<Numeric, String>] a hash matching each id to the summoners name
   def names(ids, optional={})
     region = optional[:region] || @sightstone.region
     ids = ids.join(',')
-    uri = "http://prod.api.pvp.net/api/lol/#{region}/v1.1/summoner/#{ids}/name"
+    uri = "http://prod.api.pvp.net/api/lol/#{region}/v1.2/summoner/#{ids}/name"
     response = _get_api_response(uri)
     _parse_response(response) { |resp|
       data = JSON.parse(resp)
-      return data['summoners']
+      names_array = data['summoners']
+      names_hash = Hash.new
+      names_array.each do |summoner|
+        names_hash[summoner['id']] = summoner['name']
+      end
+      return names_hash
     }
   end
 
+  # returns the runebook of a summoner
+  # @param summoner [Summoner, id] summoner object or id of a summoner
+  # @param optional [Hash<Symbol, String>] optional arguments: :region => replaces default region
+  # @return [Runebook] runebook of the summoner
   def runes(summoner, optional={})
     region = optional[:region] || @sightstone.region
     id = if summoner.is_a? Summoner
@@ -43,7 +61,7 @@ class SummonerModule < SightstoneBaseModule
     else
       summoner
     end
-    uri = "http://prod.api.pvp.net/api/lol/#{region}/v1.1/summoner/#{id}/runes"
+    uri = "http://prod.api.pvp.net/api/lol/#{region}/v1.2/summoner/#{id}/runes"
     response = _get_api_response(uri)
     _parse_response(response) { |resp|
       data = JSON.parse(resp)
@@ -51,6 +69,10 @@ class SummonerModule < SightstoneBaseModule
     }
   end
 
+  # returns the masterybook of a summoner
+  # @param summoner [Summoner, id] summoner object or id of a summoner
+  # @param optional [Hash<Symbol, String>] optional arguments: :region => replaces default region
+  # @return [Masterybook] masterybook of the summoner
   def masteries(summoner, optional={})
     region = optional[:region] || @sightstone.region
      id = if summoner.is_a? Summoner
@@ -58,7 +80,7 @@ class SummonerModule < SightstoneBaseModule
     else
       summoner
     end
-    uri = "http://prod.api.pvp.net/api/lol/#{region}/v1.1/summoner/#{id}/masteries"
+    uri = "http://prod.api.pvp.net/api/lol/#{region}/v1.2/summoner/#{id}/masteries"
     response = _get_api_response(uri)
     _parse_response(response) { |resp|
       data = JSON.parse(resp)

data/lib/sightstone/runebook.rb

@@ -1,3 +1,6 @@
+# Class to represent the runebook of a summoner
+# @attr [Numeric] summonerId id of the summoner
+# @attr [Array<RunePage>] pages of the runebook
 class RuneBook
   attr_accessor :pages, :summonerId
   
@@ -10,6 +13,11 @@ class RuneBook
   end
 end
 
+# Class to represent a page of a runebook
+# @attr [Numeric] id ID of the page
+# @attr [String] name page name
+# @attr [Boolean] current indicates if the page is selected
+# @attr [Hash<Numeric, Rune>] slots matches slot ids to the rune  
 class RunePage
   attr_accessor :id, :slots, :name, :current
   
@@ -25,6 +33,11 @@ class RunePage
 
 end
 
+# Class to represent a rune
+# @attr [Numeric] id ID of the rune
+# @attr [String] description description
+# @attr [String] name name of the rune
+# @attr [Numeric] tier rune tier (1,2,3)
 class Rune
   attr_accessor :id, :description, :name, :tier
   

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sightstone
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Daniel Bauer
@@ -63,7 +63,7 @@ files:
 - lib/sightstone/summoner.rb
 - lib/sightstone/team.rb
 - lib/sightstone.rb
-homepage: http://rubygems.org/gems/outrage
+homepage: https://github.com/danijoo/Sightstone
 licenses:
 - MIT
 metadata: {}
@@ -83,7 +83,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.1.10
+rubygems_version: 2.0.6
 signing_key: 
 specification_version: 4
 summary: Ruby wrapper for riots league of legends api