steam-condenser 1.3.7 → 1.3.8

data/pkg/steam-condenser-1.3.7/pkg/steam-condenser-1.3.6/lib/steam/community/dods/dods_weapon.rb

@@ -0,0 +1,67 @@
+# 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
+
+require 'steam/community/game_weapon'
+
+# Represents the stats for a Day of Defeat: Source weapon for a specific user
+#
+# @author Sebastian Staudt
+class DoDSWeapon
+
+  include GameWeapon
+
+  # Returns the number of headshots achieved with this weapon
+  #
+  # @return [Fixnum] The number of headshots achieved
+  attr_reader :headshots
+
+  # Returns the name of this weapon
+  #
+  # @return [String] The name of this weapon
+  attr_reader :name
+
+  # Returns the number of hits achieved with this weapon
+  #
+  # @return [Fixnum] The number of hits achieved
+  attr_reader :hits
+
+  # Creates a new instance of a Day of Defeat: Source weapon based on the
+  # given XML data
+  #
+  # @param [Hash<String, Object>] weapon_data The XML data of the class
+  def initialize(weapon_data)
+    super weapon_data
+
+    @headshots = weapon_data['headshots'].to_i
+    @id        = weapon_data['key']
+    @name      = weapon_data['name']
+    @shots     = weapon_data['shotsfired'].to_i
+    @hits      = weapon_data['shotshit'].to_i
+  end
+
+  # Returns the average number of hits needed for a kill with this weapon
+  #
+  # @return [Float] The average number of hits needed for a kill
+  def avg_hits_per_kill
+    @hits.to_f / @kill
+  end
+
+  # Returns the percentage of headshots relative to the shots hit with this
+  # weapon
+  #
+  # @return [Float] The percentage of headshots
+  def headshot_percentage
+    @headshots.to_f / @hits
+  end
+
+  # Returns the percentage of hits relative to the shots fired with this
+  # weapon
+  #
+  # @return [Float] The percentage of hits
+  def hit_percentage
+    @hits.to_f / @shots
+  end
+
+end

data/pkg/steam-condenser-1.3.7/pkg/steam-condenser-1.3.6/lib/steam/community/dota2/dota2_beta_inventory.rb

@@ -0,0 +1,30 @@
+# This code is free software; you can redistribute it and/or modify it under
+# the terms of the new BSD License.
+#
+# Copyright (c) 2012, Sebastian Staudt
+
+require 'steam/community/dota2/dota2_item'
+require 'steam/community/game_inventory'
+
+# Represents the inventory of a player of the DotA 2 beta
+#
+# @author Sebastian Staudt
+class Dota2BetaInventory < GameInventory
+
+  # The Steam application ID of the DotA 2 beta
+  APP_ID = 205790
+
+  # Creates a new inventory object for the given SteamID64 in the DotA 2 beta
+  # (App ID 205790)
+  #
+  # @param [Fixnum] steam_id64 The 64bit SteamID of the player to get the
+  #        inventory for
+  # @macro cacheable
+  def initialize(steam_id64)
+    super APP_ID, steam_id64
+  end
+
+  # The class representing DotA 2 items
+  @@item_class = Dota2Item
+
+end

data/pkg/steam-condenser-1.3.7/pkg/steam-condenser-1.3.6/lib/steam/community/dota2/dota2_inventory.rb

@@ -0,0 +1,30 @@
+# This code is free software; you can redistribute it and/or modify it under
+# the terms of the new BSD License.
+#
+# Copyright (c) 2012, Sebastian Staudt
+
+require 'steam/community/dota2/dota2_item'
+require 'steam/community/game_inventory'
+
+# Represents the inventory of a DotA 2 player
+#
+# @author Sebastian Staudt
+class Dota2Inventory < GameInventory
+
+  # The Steam application ID of DotA 2
+  APP_ID = 570
+
+  # Creates a new inventory object for the given SteamID64 in DotA 2
+  # (App ID 570)
+  #
+  # @param [Fixnum] steam_id64 The 64bit SteamID of the player to get the
+  #        inventory for
+  # @macro cacheable
+  def initialize(steam_id64)
+    super APP_ID, steam_id64
+  end
+
+  # The class representing DotA 2 items
+  @@item_class = Dota2Item
+
+end

data/pkg/steam-condenser-1.3.7/pkg/steam-condenser-1.3.6/lib/steam/community/dota2/dota2_item.rb

@@ -0,0 +1,33 @@
+# This code is free software; you can redistribute it and/or modify it under
+# the terms of the new BSD License.
+#
+# Copyright (c) 2012, Sebastian Staudt
+
+require 'steam/community/game_item'
+
+# Represents a DotA 2 item
+#
+# @author Sebastian Staudt
+class Dota2Item
+
+  include GameItem
+
+  # Creates a new instance of a DotA 2 item with the given data
+  #
+  # @param [Dota2Inventory] inventory The inventory this item is contained in
+  # @param [Hash<Symbol, Object>] item_data The data specifying this item
+  # @raise [WebApiError] on Web API errors
+  def initialize(inventory, item_data)
+    super
+
+    @equipped = !item_data[:equipped].nil?
+  end
+
+  # Returns whether this item is equipped by this player at all
+  #
+  # @return [Boolean] Whether this item is equipped by this player at all
+  def equipped?
+    @equipped
+  end
+
+end

data/pkg/steam-condenser-1.3.7/pkg/steam-condenser-1.3.6/lib/steam/community/game_achievement.rb

@@ -0,0 +1,109 @@
+# 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 'multi_json'
+
+require 'steam/community/web_api'
+
+# The GameAchievement class represents a specific achievement for a single game
+# and for a single user
+#
+# It also provides the ability to load the global unlock percentages of all
+# achievements of a specific game.
+#
+# @author Sebastian Staudt
+class GameAchievement
+
+  # Returns the symbolic API name of this achievement
+  #
+  # @return [String] The API name of this achievement
+  attr_reader :api_name
+
+  # Returns the description of this achievement
+  #
+  # @return [String] The description of this achievement
+  attr_reader :description
+
+  # Return the game this achievement belongs to
+  #
+  # @return [Steam] The game this achievement belongs to
+  attr_reader :game
+
+  # Returns the url for the closed icon of this achievement
+  #
+  # @return [String] The url of the closed achievement icon
+  attr_reader :icon_closed_url
+
+  # Returns the url for the open icon of this achievement
+  #
+  # @return [String] The url of the open achievement icon
+  attr_reader :icon_open_url
+
+  # Returns the name of this achievement
+  #
+  # @return [String] The name of this achievement
+  attr_reader :name
+
+  # Returns the time this achievement has been unlocked by its owner
+  #
+  # @return [Time] The time this achievement has been unlocked
+  attr_reader :timestamp
+
+  # Returns the SteamID of the user who owns this achievement
+  #
+  # @return [Fixnum] The SteamID of this achievement's owner
+  attr_reader :user
+
+  # Loads the global unlock percentages of all achievements for the game with
+  # the given Steam Application ID
+  #
+  # @param [Fixnum] app_id The unique Steam Application ID of the game (e.g.
+  #        `440` for Team Fortress 2). See
+  #         http://developer.valvesoftware.com/wiki/Steam_Application_IDs for
+  #         all application IDs
+  # @raise [WebApiError] if the request to Steam's Web API fails
+  # @return [Hash<Symbol, Float>] The symbolic achievement names with their
+  #         corresponding unlock percentages
+  def self.global_percentages(app_id)
+    percentages = {}
+
+    data = WebApi.json('ISteamUserStats', 'GetGlobalAchievementPercentagesForApp', 2, { :gameid => app_id })
+    MultiJson.load(data, { :symbolize_keys => true })[:achievementpercentages][:achievements].each do |percentage|
+      percentages[percentage[:name].to_sym] = percentage[:percent]
+    end
+
+    percentages
+  end
+
+  # Creates the achievement with the given name for the given user and game
+  # and achievement data
+  #
+  # @param [SteamId] user The SteamID of the player this achievement belongs to
+  # @param [SteamGame] game The game this achievement belongs to
+  # @param [Hash<String, Object>] achievement_data The achievement data
+  #        extracted from XML
+  def initialize(user, game, achievement_data)
+    @api_name        = achievement_data['apiname']
+    @description     = achievement_data['description']
+    @game            = game
+    @icon_closed_url = achievement_data['iconClosed']
+    @icon_open_url   = achievement_data['iconOpen']
+    @name            = achievement_data['name']
+    @unlocked        = (achievement_data['closed'].to_i == 1)
+    @user            = user
+
+    if @unlocked && !achievement_data['unlockTimestamp'].nil?
+      @timestamp  = Time.at(achievement_data['unlockTimestamp'].to_i)
+    end
+  end
+
+  # Returns whether this achievement has been unlocked by its owner
+  #
+  # @return [Boolean] `true` if the achievement has been unlocked by the user
+  def unlocked?
+    @unlocked
+  end
+
+end

data/pkg/steam-condenser-1.3.7/pkg/steam-condenser-1.3.6/lib/steam/community/game_class.rb

@@ -0,0 +1,22 @@
+# 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 player
+# classes
+#
+# @author Sebastian Staudt
+module GameClass
+
+  # Returns the name of this class
+  #
+  # @return [String] The name of this class
+  attr_reader :name
+
+  # Returns the time in minutes the player has played with this class
+  #
+  # @return [Fixnum] The time this class has been played
+  attr_reader :play_time
+
+end

data/pkg/steam-condenser-1.3.7/pkg/steam-condenser-1.3.6/lib/steam/community/game_inventory.rb

@@ -0,0 +1,171 @@
+# This code is free software; you can redistribute it and/or modify it under
+# the terms of the new BSD License.
+#
+# Copyright (c) 2011-2013, Sebastian Staudt
+
+require 'steam/community/cacheable'
+require 'steam/community/game_item'
+require 'steam/community/game_item_schema'
+require 'steam/community/steam_id'
+require 'steam/community/web_api'
+
+class GameInventory
+end
+
+require 'steam/community/dota2/dota2_beta_inventory'
+require 'steam/community/dota2/dota2_inventory'
+require 'steam/community/portal2/portal2_inventory'
+require 'steam/community/tf2/tf2_beta_inventory'
+require 'steam/community/tf2/tf2_inventory'
+
+# Provides basic functionality to represent an inventory of player in a game
+#
+# @author Sebastian Staudt
+class GameInventory
+
+  include Cacheable
+  cacheable_with_ids [:app_id, :steam_id64]
+
+  # Returns the application ID of the game this inventory class belongs to
+  #
+  # @return [Fixnum] The application ID of the game
+  attr_reader :app_id
+
+  # Returns an array of all items in this players inventory.
+  #
+  # @return [Array<GameItem>] All items in the backpack
+  attr_reader :items
+
+  # Returns an array of all items that this player just found or traded
+  #
+  # @return [Array<GameItem>] All preliminary items of the inventory
+  attr_reader :preliminary_items
+
+  # Returns the Steam ID of the player owning this inventory
+  #
+  # @return [SteamId] The Steam ID of the owner of this inventory
+  attr_reader :user
+
+  @@item_class = GameItem
+
+  @@schema_language = 'en'
+
+  # This is a wrapper around all subclasses of `GameInventory` so that an
+  # instance of correct subclass is returned for a given application ID. If
+  # there's no specific subclass for an application ID exists, a generic
+  # instance of `GameInventory` is created.
+  #
+  # @param [Fixnum] app_id The application ID of the game
+  # @param [Fixnum] steam_id The 64bit Steam ID or vanity URL of the user
+  # @return [GameInventory] The inventory for the given user and game
+  # @raise [SteamCondenserException] if creating the inventory fails
+  # @macro cacheable
+  def self.new(app_id, steam_id = nil, *args)
+    args = args.unshift steam_id unless steam_id.nil?
+    if self == GameInventory
+      raise ArgumentError, 'wrong number of arguments (1 for 2)' if args.empty?
+    else
+      args = args.unshift app_id
+      app_id = self::APP_ID
+    end
+
+    cacheable_new = Cacheable::ClassMethods.instance_method :new
+
+    case app_id
+      when Dota2BetaInventory::APP_ID
+        cacheable_new = cacheable_new.bind Dota2BetaInventory
+      when Dota2Inventory::APP_ID
+        cacheable_new = cacheable_new.bind Dota2Inventory
+      when Portal2Inventory::APP_ID
+        cacheable_new = cacheable_new.bind Portal2Inventory
+      when TF2BetaInventory::APP_ID
+        cacheable_new = cacheable_new.bind TF2BetaInventory
+      when TF2Inventory::APP_ID
+        cacheable_new = cacheable_new.bind TF2Inventory
+      else
+        cacheable_new = cacheable_new.bind GameInventory
+        return cacheable_new.call app_id, *args
+    end
+
+    cacheable_new.call *args
+  end
+
+  # Sets the language the schema should be fetched in (default is: `'en'`)
+  #
+  # @param [String] language The ISO 639-1 code of the schema language
+  def self.schema_language=(language)
+    @@schema_language = language
+  end
+
+  # Creates a new inventory object for the given AppID and SteamID64. This
+  # calls update to fetch the data and create the item instances contained in
+  # this players backpack
+  #
+  # @param [Fixnum] app_id The application ID of the game
+  # @param [Fixnum] steam_id64 The 64bit SteamID of the player to get the
+  #        inventory for
+  # @macro cacheable
+  def initialize(app_id, steam_id64)
+    unless steam_id64.is_a? Fixnum
+      steam_id64 = SteamId.resolve_vanity_url steam_id64.to_s
+      raise SteamCondenserError.new 'User not found' if steam_id64.nil?
+    end
+
+    @app_id     = app_id
+    @items      = []
+    @steam_id64 = steam_id64
+    @user       = SteamId.new steam_id64, false
+  end
+
+  # Returns the item at the given position in the inventory. The positions
+  # range from 1 to 100 instead of the usual array indices (0 to 99).
+  #
+  # @return [GameItem] The item at the given position in the inventory
+  def [](index)
+    @items[index - 1]
+  end
+
+  # Updates the contents of the inventory using the Steam Web API
+  def fetch
+    params = { :SteamID => @user.steam_id64 }
+    result = WebApi.json! "IEconItems_#@app_id", 'GetPlayerItems', 1, params
+    item_class = self.class.send :class_variable_get, :@@item_class
+
+    @items = []
+    @preliminary_items = []
+    result[:items].each do |item_data|
+      unless item_data.nil?
+        item = item_class.new(self, item_data)
+        if item.preliminary?
+          @preliminary_items << item
+        else
+          @items[item.backpack_position - 1] = item
+        end
+      end
+    end
+  end
+
+  # Returns a short, human-readable string representation of this inventory
+  #
+  # @return [String] A string representation of this inventory
+  def inspect
+    "#<#{self.class}:#@app_id #@steam_id64 (#{size} items) - " +
+    "#{fetch_time || 'not fetched'}>"
+  end
+
+  # Returns the item schema for this inventory
+  #
+  # @return [GameItemSchema] The item schema for the game this inventory
+  #         belongs to
+  def item_schema
+    @item_schema ||= GameItemSchema.new app_id, @@schema_language
+  end
+
+  # Returns the number of items in the user's inventory
+  #
+  # @return [Fixnum] The number of items in the inventory
+  def size
+    @items.size
+  end
+
+end