steam-condenser 1.2.1 → 1.3.0

data/pkg/steam-condenser-1.2.0/lib/steam/community/game_leaderboard.rb

@@ -1,201 +0,0 @@
-# This code is free software; you can redistribute it and/or modify it under
-# the terms of the new BSD License.
-#
-# Copyright (c) 2011-2012, Sebastian Staudt
-
-require 'multi_xml'
-
-require 'steam/community/game_leaderboard_entry'
-require 'steam/community/steam_id'
-
-# The GameLeaderboard class represents a single leaderboard for a specific game
-#
-# @author Sebastian Staudt
-class GameLeaderboard
-
-  LEADERBOARD_DISPLAY_TYPE_NONE         = 0
-  LEADERBOARD_DISPLAY_TYPE_NUMERIC      = 1
-  LEADERBOARD_DISPLAY_TYPE_SECONDS      = 2
-  LEADERBOARD_DISPLAY_TYPE_MILLISECONDS = 3
-
-  LEADERBOARD_SORT_METHOD_NONE = 0
-  LEADERBOARD_SORT_METHOD_ASC  = 1
-  LEADERBOARD_SORT_METHOD_DESC = 2
-
-  @@leaderboards = {}
-
-  # Returns the display type of the scores on this leaderboard
-  #
-  # @return [Fixnum] The display type of the scores
-  attr_reader :display_type
-
-  # Returns the number of entries on this leaderboard
-  #
-  # @return [Fixnum] The number of entries on this leaderboard
-  attr_reader :entry_count
-
-  # Returns the ID of the leaderboard
-  #
-  # @return [Fixnum] The ID of the leaderboard
-  attr_reader :id
-
-  # Returns the name of the leaderboard
-  #
-  # @return [String] The name of the leaderboard
-  attr_reader :name
-
-  # Returns the method that is used to sort the entries on the leaderboard
-  #
-  # @return [Fixnum] The sort method
-  attr_reader :sort_method
-
-  # Returns the leaderboard for the given game and leaderboard ID or name
-  #
-  # @param [String] game_name The short name of the game
-  # @param [Fixnum, String] id The ID or name of the leaderboard to return
-  # @return [GameLeaderboard] The matching leaderboard if available
-  def self.leaderboard(game_name, id)
-    leaderboards = self.leaderboards game_name
-
-    if id.is_a? Fixnum
-      leaderboards[id]
-    else
-      leaderboards.each_value do |board|
-        return board if board.name == id
-      end
-    end
-  end
-
-  # Returns an array containing all of a game's leaderboards
-  #
-  # @param [String] game_name The name of the game
-  # @return [Array<GameLeaderboard>] The leaderboards for this game
-  def self.leaderboards(game_name)
-    self.load_leaderboards game_name unless @@leaderboards.key? game_name
-
-    @@leaderboards[game_name]
-  end
-
-  # Returns the entry on this leaderboard for the user with the given SteamID
-  #
-  # @param [Fixnum, SteamId] steam_id The 64bit SteamID or the `SteamId` object
-  #        of the user
-  # @return [GameLeaderboardEntry] The entry of the user if available
-  # raise [SteamCondenserException] if an error occurs while fetching the
-  #         leaderboard
-  def entry_for_steam_id(steam_id)
-    steam_id = steam_id.steam_id64 if steam_id.is_a? SteamId
-
-    url = "#@url&steamid=#{steam_id}"
-    xml_data = MultiXml.parse(open(url, {:proxy => true})).values.first
-
-    error = xml_data['error']
-    raise SteamCondenserError, error unless error.nil?
-
-    xml_data['entries']['entry'].each do |entry_data|
-      if entry_data['steamid'].to_i == steam_id
-        return GameLeaderboardEntry.new entry_data, self
-      end
-    end
-
-    nil
-  end
-
-  # Returns an array of entries on this leaderboard for the user with the given
-  # SteamID and his/her friends
-  #
-  # @param [Fixnum, SteamId] steam_id The 64bit SteamID or the `SteamId` object
-  #        of the user
-  # @return [Array<GameLeaderboardEntry>] The entries of the user and his/her
-  #         friends
-  # raise [SteamCondenserException] if an error occurs while fetching the
-  #         leaderboard
-  def entry_for_steam_id_friends(steam_id)
-    steam_id = steam_id.steam_id64 if steam_id.is_a? SteamId
-
-    url = "#@url&steamid=#{steam_id}"
-    xml_data = MultiXml.parse(open(url, {:proxy => true})).values.first
-
-    error = xml_data['error']
-    raise SteamCondenserError, error unless error.nil?
-
-    entries = []
-    xml_data['entries']['entry'].each do |entry_data|
-      rank = entry_data['rank'].to_i
-      entries[rank] = GameLeaderboardEntry.new entry_data, self
-    end
-
-    entries
-  end
-
-  # Returns the entries on this leaderboard for a given rank range
-  #
-  # The range is inclusive and a maximum of 5001 entries can be returned in a
-  # single request.
-  #
-  # @param [Fixnum] first The first entry to return from the leaderboard
-  # @param [Fixnum] last The last entry to return from the leaderboard
-  # @return [Array<GameLeaderboardEntry>] The entries that match the given rank
-  #         range
-  # raise [SteamCondenserException] if an error occurs while fetching the
-  #         leaderboard
-  def entry_range(first, last)
-    if last < first
-      raise SteamCondenserException,
-        'First entry must be prior to last entry for leaderboard entry lookup.'
-    end
-
-    if (last - first) > 5000
-      raise SteamCondenserException,
-        'Leaderboard entry lookup is currently limited to a maximum of 5001 entries per request.'
-    end
-
-    url = "#@url&start=#{first}&end=#{last}"
-    xml_data = MultiXml.parse(open(url, {:proxy => true})).values.first
-
-    error = xml_data['error']
-    raise SteamCondenserError, error unless error.nil?
-
-    entries = []
-    xml_data['entries']['entry'].each do |entry_data|
-      rank = entry_data['rank'].to_i
-      entries[rank] = GameLeaderboardEntry.new entry_data, self
-    end
-
-    entries
-  end
-
-  private
-
-  # Creates a new leaderboard instance with the given XML data
-  #
-  # @param [Hash<String, Object>] board_data The XML data of the leaderboard
-  def initialize(board_data)
-    @url          = board_data['url']
-    @id           = board_data['lbid'].to_i
-    @name         = board_data['name']
-    @entry_count  = board_data['entries'].to_i
-    @sort_method  = board_data['sortmethod'].to_i
-    @display_type = board_data['displaytype'].to_i
-  end
-
-  # Loads the leaderboards of the specified games into the cache
-  #
-  # @param [String] game_name The short name of the game
-  # @raise [SteamCondenserException] if an error occurs while fetching the
-  #         leaderboards
-  def self.load_leaderboards(game_name)
-    url = "http://steamcommunity.com/stats/#{game_name}/leaderboards/?xml=1"
-    boards_data = MultiXml.parse(open(url, {:proxy => true})).values.first
-
-    error = boards_data['error']
-    raise SteamCondenserError, error unless error.nil?
-
-    @@leaderboards[game_name] = []
-    boards_data['leaderboard'].each do |board_data|
-      leaderboard = GameLeaderboard.new board_data
-      @@leaderboards[game_name][leaderboard.id] = leaderboard
-    end
-  end
-
-end

data/pkg/steam-condenser-1.2.0/lib/steam/community/game_leaderboard_entry.rb

@@ -1,43 +0,0 @@
-# This code is free software; you can redistribute it and/or modify it under
-# the terms of the new BSD License.
-#
-# Copyright (c) 2011-2012, Sebastian Staudt
-
-# The GameLeaderboard class represents a single entry in a leaderboard
-#
-# @author Sebastian Staudt
-class GameLeaderboardEntry
-
-  # Returns the Steam ID of this entry's player
-  #
-  # @return [SteamId] The Steam ID of the player
-  attr_reader :steam_id
-
-  # Returns the score of this entry
-  #
-  # @return [Fixnum] The score of this player
-  attr_reader :score
-
-  # Returns the rank where this entry is listed in the leaderboard
-  #
-  # @return [Fixnum] The rank of this entry
-  attr_reader :rank
-
-  # Returns the leaderboard this entry belongs to
-  #
-  # @return [GameLeaderboard] The leaderboard of this entry
-  attr_reader :leaderboard
-
-  # Creates new entry instance for the given XML data and leaderboard
-  #
-  # @param [Hash<String, Object>] entry_data The XML data of the leaderboard of
-  #        the leaderboard entry
-  # @param [GameLeaderboard] leaderboard The leaderboard this entry belongs to
-  def initialize(entry_data, leaderboard)
-    @steam_id    = SteamId.new entry_data['steamid'].to_i, false
-    @score       = entry_data['score'].to_i
-    @rank        = entry_data['rank'].to_i
-    @leaderboard = leaderboard
-  end
-
-end

data/pkg/steam-condenser-1.2.0/lib/steam/community/game_stats.rb

@@ -1,175 +0,0 @@
-# This code is free software; you can redistribute it and/or modify it under
-# the terms of the new BSD License.
-#
-# Copyright (c) 2008-2012, Sebastian Staudt
-
-require 'steam/community/game_achievement'
-require 'steam/community/game_leaderboard'
-require 'steam/community/xml_data'
-
-# This class represents the game statistics for a single user and a specific
-# game
-#
-# It is subclassed for individual games if the games provide special statistics
-# that are unique to this game.
-#
-# @author Sebastian Staudt
-class GameStats
-
-  include XMLData
-
-  # Returns the game these stats belong to
-  #
-  # @return [SteamGame] The game object
-  attr_reader :game
-
-  # Returns the number of hours this game has been played by the player
-  #
-  # @return [String] The number of hours this game has been played
-  attr_reader :hours_played
-
-  # Returns the privacy setting of the Steam ID profile
-  #
-  # @return [String] The privacy setting of the Steam ID
-  attr_reader :privacy_state
-
-  # Returns the Steam ID of the player these stats belong to
-  #
-  # @return [SteamId] The Steam ID instance of the player
-  attr_reader :user
-
-  # Returns the base Steam Communtiy URL for the given player and game IDs
-  #
-  # @param [Fixnum, String] user_id The 64bit SteamID or custom URL of the user
-  # @param [Fixnum, String] game_id The application ID or short name of the
-  #        game
-  # @return The base URL used for the given stats IDs
-  def self.base_url(user_id, game_id)
-    game_url = game_id.is_a?(Fixnum) ? "appid/#{game_id}" : game_id
-
-    if user_id.is_a? Fixnum
-      "http://steamcommunity.com/profiles/#{user_id}/stats/#{game_url}"
-    else
-      "http://steamcommunity.com/id/#{user_id}/stats/#{game_url}"
-    end
-  end
-
-  # Creates a `GameStats` (or one of its subclasses) instance for the given
-  # user and game
-  #
-  # @param [String, Fixnum] steam_id The custom URL or the 64bit Steam ID of
-  #        the user
-  # @param [String] game_name The friendly name of the game
-  # @return [GameStats] The game stats object for the given user and game
-  def self.create_game_stats(steam_id, game_name)
-    case game_name
-      when 'alienswarm'
-        require 'steam/community/alien_swarm/alien_swarm_stats'
-        AlienSwarmStats.new(steam_id)
-      when 'cs:s'
-        require 'steam/community/css/css_stats'
-        CSSStats.new(steam_id)
-      when 'defensegrid:awakening'
-        require 'steam/community/defense_grid/defense_grid_stats'
-        DefenseGridStats.new(steam_id)
-      when 'dod:s'
-        require 'steam/community/dods/dods_stats'
-        DoDSStats.new(steam_id)
-      when 'l4d'
-        require 'steam/community/l4d/l4d_stats'
-        L4DStats.new(steam_id)
-      when 'l4d2'
-        require 'steam/community/l4d/l4d2_stats'
-        L4D2Stats.new(steam_id)
-      when 'portal2'
-        require 'steam/community/portal2/portal2_stats'
-        Portal2Stats.new steam_id
-      when 'tf2'
-        require 'steam/community/tf2/tf2_stats'
-        TF2Stats.new(steam_id)
-      else
-        new(steam_id, game_name)
-    end
-  end
-
-  # Creates a `GameStats` object and fetches data from the Steam Community for
-  # the given user and game
-  #
-  # @param [String, Fixnum] user_id The custom URL or the 64bit Steam ID of the
-  #        user
-  # @param [String] game_id The application ID or friendly name of the game
-  # @raise [SteamCondenserError] if the stats cannot be fetched
-  def initialize(user_id, game_id)
-    @xml_data = parse "#{self.class.base_url(user_id, game_id)}?xml=all"
-
-    @user = SteamId.new user_id, false
-
-    error = @xml_data['error']
-    raise SteamCondenserError, error unless error.nil?
-
-    @privacy_state = @xml_data['privacyState']
-    if public?
-      app_id        = @xml_data['game']['gameLink'].match(/http:\/\/store.steampowered.com\/app\/([1-9][0-9]+)/)[1].to_i
-      @game         = SteamGame.new app_id, @xml_data['game']
-      @hours_played = @xml_data['stats']['hoursPlayed'] unless @xml_data['stats']['hoursPlayed'].nil?
-    end
-  end
-
-  # Returns the achievements for this stats' user and game
-  #
-  # If the achievements' data hasn't been parsed yet, parsing is done now.
-  #
-  # @return [Array<GameAchievement>] All achievements belonging to this game
-  def achievements
-    return unless public?
-
-    if @achievements.nil?
-      @achievements = Array.new
-      @xml_data['achievements']['achievement'].each do |achievement|
-        @achievements << GameAchievement.new(@user, @game, achievement)
-      end
-
-      @achievements_done = @achievements.reject{ |a| !a.unlocked? }.size
-    end
-
-    @achievements
-  end
-
-  # Returns the number of achievements done by this player
-  #
-  # If achievements haven't been parsed yet for this player and this game,
-  # parsing is done now.
-  #
-  # @return [Fixnum] The number of achievements completed
-  # @see #achievements
-  def achievements_done
-    achievements if @achievements_done.nil?
-    @achievements_done
-  end
-
-  # Returns the percentage of achievements done by this player
-  #
-  # If achievements haven't been parsed yet for this player and this game,
-  # parsing is done now.
-  #
-  # @return [Float] The percentage of achievements completed
-  # @see #achievements_done
-  def achievements_percentage
-    achievements_done.to_f / @achievements.size
-  end
-
-  # Returns the base Steam Communtiy URL for the stats contained in this object
-  #
-  # @return [String] The base URL used for queries on these stats
-  def base_url
-    self.class.base_url @user.id, @game.id
-  end
-
-  # Returns whether this Steam ID is publicly accessible
-  #
-  # @return [Boolean] `true` if this Steam ID is publicly accessible
-  def public?
-    @privacy_state == 'public'
-  end
-
-end

data/pkg/steam-condenser-1.2.0/lib/steam/community/game_weapon.rb

@@ -1,41 +0,0 @@
-# This code is free software; you can redistribute it and/or modify it under
-# the terms of the new BSD License.
-#
-# Copyright (c) 2009-2011, Sebastian Staudt
-
-# A module implementing basic functionality for classes representing game
-# weapons
-#
-# @author Sebastian Staudt
-module GameWeapon
-
-  # Returns the number of kills achieved with this weapon
-  #
-  # @return [Fixnum] The number of kills achieved
-  attr_reader :kills
-
-  # Returns the unique identifier for this weapon
-  #
-  # @return [String] The identifier of this weapon
-  attr_reader :id
-
-  # Returns the number of shots fired with this weapon
-  #
-  # @return [Fixnum] The number of shots fired
-  attr_reader :shots
-
-  # Creates a new game weapon instance with the data provided
-  #
-  # @param [Hash<String, Object>] weapon_data The data representing this weapon
-  def initialize(weapon_data)
-    @kills = weapon_data['kills'].to_i
-  end
-
-  # Returns the average number of shots needed for a kill with this weapon
-  #
-  # @return [Float] The average number of shots needed for a kill
-  def avg_shots_per_kill
-    @shots.to_f / @kills
-  end
-
-end