hon 1.0.0

data/lib/hon.rb

@@ -0,0 +1,7 @@
+# encoding: utf-8
+require 'rexml/document'
+require 'hon/hon'
+require 'hon/stats'
+require 'hon/match'
+require 'hon/hero'
+require 'hon/player'

data/lib/hon/hero.rb

@@ -0,0 +1,28 @@
+# encoding: utf-8
+
+module HoN
+  class HeroStats < Stats
+    
+    def initialize nickname
+      @nickname   = nickname
+      @statistics = Hash.new
+
+      retrieve_statistics
+    end
+
+    private
+    def retrieve_statistics
+      open "http://xml.heroesofnewerth.com/xml_requester.php?f=player_hero_stats&opt=nick&nick[]=#{@nickname}" do |response|
+        data = REXML::Document.new response.read
+        data.elements.each '/xmlRequest/stats/player_hero_stats/hero' do |hero|
+          buffer = Hash.new
+          hero.elements.each do |element|
+            buffer[element.attributes["name"].to_sym] = element.text
+          end
+          @statistics[hero.attributes["cli_name"]] = buffer
+        end
+      end
+    end
+
+  end
+end

data/lib/hon/hon.rb

@@ -0,0 +1,25 @@
+# encoding: utf-8
+
+module HoN
+  class HeroError  <  StandardError; end
+  class MatchError  < StandardError; end
+  class PlayerError < StandardError; end
+
+  def self.heroes nickname
+    hero = HeroStats.new nickname
+    yield hero if block_given?
+    hero
+  end  
+
+  def self.player nickname, *options
+    player = PlayerStats.new nickname, *options
+    yield player if block_given?
+    player
+  end
+
+  def self.match id
+    match = MatchStats.new id
+    yield match if block_given?
+    match
+  end
+end

data/lib/hon/match.rb

@@ -0,0 +1,65 @@
+# encoding: utf-8
+
+module HoN
+  class MatchStats < Stats
+    
+    def initialize match_id
+      @match_id   = match_id
+      @statistics = { server: {}, legion: { players: [] }, hellbourne: { players: [] } }
+
+      retrieve_statistics
+    end
+
+  def server
+    @statistics[:server]
+  end
+
+  def legion
+    @statistics[:legion]
+  end
+
+  def legion_players
+    legion[:players]
+  end
+
+  def hellbourne
+    @statistics[:hellbourne]
+  end
+
+  def hellbourne_players
+    hellbourne[:players]
+  end
+
+  private
+    def retrieve_statistics
+      open "http://xml.heroesofnewerth.com/xml_requester.php?f=match_stats&opt=mid&mid[]=#{@match_id}" do |response|
+        data = REXML::Document.new response.read
+
+        # Server statistics
+        data.elements.each '/xmlRequest/stats/match/summ/stat' do |element|
+          @statistics[:server][element.attributes["name"].to_sym] = element.text
+        end
+
+        data.elements.each '/xmlRequest/stats/match/team[@side=1]/stat' do |element|
+          @statistics[:legion][element.attributes["name"].to_sym] = element.text
+        end
+
+        data.elements.each '/xmlRequest/stats/match/team[@side=2]/stat' do |element|
+          @statistics[:hellbourne][element.attributes["name"].to_sym] = element.text
+        end
+
+        data.elements.each '/xmlRequest/stats/match/match_stats/ms' do |element|
+          buffer, team = Hash.new, 0
+          element.elements.each do |stat|
+            team = stat.text.to_i if stat.attributes["name"] == "team"
+            buffer[stat.attributes["name"]] = stat.text
+          end
+
+          @statistics[(team == 1) ? :legion : :hellbourne][:players].push buffer
+        end
+
+      end
+    end
+
+  end
+end

data/lib/hon/player.rb

@@ -0,0 +1,138 @@
+# encoding: utf-8
+
+module HoN
+  class PlayerStats < Stats
+
+    def initialize nickname, *options
+      @nickname   = nickname
+      @statistics = Hash.new
+
+      retrieve_statistics
+      retrieve_heroes if options.include? :heroes
+      raise PlayerError, "Player not found" if @statistics.empty?
+    end
+
+    def inspect
+      %{<#{self.class} @nickname="#{nickname}" @games=#{games} @wins=#{wins} @losses=#{losses}>}
+    end
+
+    def nickname
+      @statistics[:nickname]
+    end
+
+    # The total amount of games played.
+    def games
+      @statistics[:acc_games_played]
+    end
+
+    # The total amount of victories.
+    def wins
+      @statistics[:acc_wins]
+    end
+
+    # The total amount of defeats.
+    def losses
+      @statistics[:acc_losses]
+    end
+
+    # The total amount of games conceded.
+    def concedes
+      @statistics[:acc_concedes]
+    end
+
+    # The amount of times the player has tried to concede.
+    def concede_votes
+      @statistics[:acc_concedevotes]
+    end
+
+    # The (total? average?) amount of hero buybacks.
+    def buybacks
+      @statistics[:acc_buybacks]
+    end
+
+    # The amount of times the player has disconnected from a game.
+    def disconnects
+      @statistics[:acc_discos]
+    end
+
+    # The amount of times the player has been kicked from a game.
+    def kicked
+      @statistics[:acc_kicked]
+    end
+
+    # The players Public Skill Rating.
+    def psr
+      @statistics[:acc_pub_skill]
+    end
+
+    # The amount of public games the player has played (non-matchmaking games).
+    def public_games
+      @statistics[:acc_pub_count]
+    end
+
+    # The total amount of heroes the player has killed.
+    def kills
+      @statistics[:acc_herokills]
+    end
+
+    # The total amount of damage the player has dealt to heroes.
+    def total_damage
+      @statistics[:acc_herodmg]
+    end
+
+    # The total amount of experience the player has gained.
+    def total_exp
+      @statistics[:acc_heroexp]
+    end
+
+    # The total amount of gold consumed from killing enemy heroes.
+    def total_hero_gold
+      @statistics[:acc_herokillsgold]
+    end
+
+    def assists
+      @statistics[:acc_heroassists]
+    end
+
+    def deaths
+      @statistics[:acc_deaths]
+    end
+
+    def total_gold_lost
+      @statistics[:acc_goldlost2death]
+    end
+
+    def idle_time
+      @statistics[:acc_secs_dead]
+    end
+
+    def win_percentage
+      (wins.to_f / games.to_f * 100).round 1
+    end
+
+    def kdr
+      (kills.to_f / deaths.to_f).round 1
+    end
+
+    def heroes
+      @heroes or {}
+    end
+
+    private
+    # Send a HTTP request to the HoN XML API.
+    def retrieve_statistics
+      open "http://xml.heroesofnewerth.com/xml_requester.php?f=player_stats&opt=nick&nick[]=#{@nickname}" do |response|
+        data = REXML::Document.new response.read
+        data.elements.each '/xmlRequest/stats/player_stats/stat' do |element|
+          @statistics[element.attributes["name"].to_sym] = element.text
+        end
+      end
+    end
+
+    def retrieve_heroes
+      @heroes = HoN.heroes @nickname
+    end
+
+  end
+end
+

data/lib/hon/stats.rb

@@ -0,0 +1,12 @@
+# encoding: utf-8
+require 'open-uri'
+
+module HoN
+  class Stats
+    
+    def [] name
+      @statistics[name]
+    end
+
+  end
+end

metadata

@@ -0,0 +1,72 @@
+--- !ruby/object:Gem::Specification 
+name: hon
+version: !ruby/object:Gem::Version 
+  hash: 23
+  prerelease: false
+  segments: 
+  - 1
+  - 0
+  - 0
+  version: 1.0.0
+platform: ruby
+authors: 
+- Mikkel Kroman
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-07-25 00:00:00 +02:00
+default_executable: 
+dependencies: []
+
+description: Heroes of Newerth API for Ruby.
+email: mk@maero.dk
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- lib/hon.rb
+- lib/hon/hero.rb
+- lib/hon/hon.rb
+- lib/hon/match.rb
+- lib/hon/player.rb
+- lib/hon/stats.rb
+has_rdoc: true
+homepage: http://maero.dk/
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Heroes of Newerth API
+test_files: []
+