steam-condenser 1.3.6 → 1.3.7

data/pkg/steam-condenser-1.3.6/pkg/steam-condenser-1.3.5/lib/steam/community/alien_swarm/alien_swarm_weapon.rb

@@ -0,0 +1,49 @@
+# This code is free software; you can redistribute it and/or modify it under
+# the terms of the new BSD License.
+#
+# Copyright (c) 2010-2011, Sebastian Staudt
+
+require 'steam/community/game_weapon'
+
+# This class holds statistical information about weapons used by a player
+# in Alien Swarm
+#
+# @author Sebastian Staudt
+class AlienSwarmWeapon
+
+  include GameWeapon
+
+  # Returns the accuracy of the player with this weapon
+  #
+  # @return [Float] The accuracy of the player with this weapon
+  attr_reader :accuracy
+
+  # Returns the damage achieved with this weapon
+  #
+  # @return [Fixnum] The damage achieved with this weapon
+  attr_reader :damage
+
+  # Returns the damage dealt to team mates with this weapon
+  #
+  # @return [Fixnum] The damage dealt to team mates with this weapon
+  attr_reader :friendly_fire
+
+  # Returns the name of this weapon
+  #
+  # @return [String] The name of this weapon
+  attr_reader :name
+
+  # Creates a new weapon instance based on the assigned weapon XML data
+  #
+  # @param [Hash<String, Object>] weapon_data The data representing this weapon
+  def initialize(weapon_data)
+    super
+
+    @accuracy      = weapon_data['accuracy'].to_f
+    @damage        = weapon_data['damage'].to_i
+    @friendly_fire = weapon_data['friendlyfire'].to_i
+    @name          = weapon_data['name']
+    @shots         = weapon_data['shotsfired'].to_i
+  end
+
+end

data/pkg/steam-condenser-1.3.6/pkg/steam-condenser-1.3.5/lib/steam/community/app_news.rb

@@ -0,0 +1,133 @@
+# This code is free software; you can redistribute it and/or modify it under
+# the terms of the new BSD License.
+#
+# Copyright (c) 2010-2011, Sebastian Staudt
+
+require 'multi_json'
+
+require 'steam/community/web_api'
+
+# This class represents Steam news and can be used to load a list of current
+# news about specific games
+#
+# @author Sebastian Staudt
+class AppNews
+
+  # Returns the Steam Application ID of the game this news belongs to
+  #
+  # @return [Fixnum] The application ID of the game this news belongs to
+  attr_reader :app_id
+
+  # Returns the name of the author of this news
+  #
+  # @return [String] The author of this news
+  attr_reader :author
+
+  # Returns the contents of this news
+  #
+  # This might contain HTML code.
+  #
+  # @note Depending on the setting for the maximum length of a news (see
+  #       {.news_for_app}), the contents might be truncated.
+  # @return [String] The contents of this news
+  attr_reader :contents
+
+  # Returns the date this news item has been published
+  #
+  # @return [Time] The date this news has been published
+  attr_reader :date
+
+  # Returns the name of the feed this news item belongs to
+  #
+  # @return [String] The name of the feed this news belongs to
+  attr_reader :feed_label
+
+  # Returns the symbolic name of the feed this news item belongs to
+  #
+  # @return [String] The symbolic name of the feed this news belongs to
+  attr_reader :feed_name
+
+  # Returns a unique identifier for this news
+  #
+  # @return [Fixnum] A unique identifier for this news
+  attr_reader :gid
+
+  # Returns the title of this news
+  #
+  # @return [String] The title of this news
+  attr_reader :title
+
+  # Returns the URL of the original news
+  #
+  # This is a direct link to the news on the Steam website or a redirecting
+  # link to the external post.
+  #
+  # @return [String] The URL of the original news
+  attr_reader :url
+
+  # Loads the news for the given game with the given restrictions
+  #
+  # @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.
+  # @param [Fixnum] count The maximum number of news to load. There's no
+  #        reliable way to load all news. Use a really great number instead.
+  # @param [Fixnum] max_length The maximum content length of the news. If a
+  #        maximum length is defined, the content of the news will only be at
+  #        most `max_length` characters long plus an ellipsis.
+  # @return [Array<AppNews>] An array of news items for the specified game with
+  #         the given options
+  def self.news_for_app(app_id, count = 5, max_length = nil)
+    params = { :appid => app_id, :count => count, :maxlength => max_length }
+    data = WebApi.json('ISteamNews', 'GetNewsForApp', 2, params)
+
+    news_items = []
+    MultiJson.load(data, { :symbolize_keys => true })[:appnews][:newsitems].each do |news_data|
+      news_items << AppNews.new(app_id, news_data)
+    end
+
+    news_items
+  end
+
+  # Returns whether this news item originates from a source other than Steam
+  # itself (e.g. an external blog)
+  #
+  # @return [Boolean] `true` if this news item is from an external source
+  def external?
+    @external
+  end
+
+  # Returns a simple textual representation of this news item
+  #
+  # Will consist of the name of the feed this news belongs to and the title of
+  # the news.
+  #
+  # @return [String] A simple text representing this news
+  def to_s
+    "#@feed_label: #@title"
+  end
+
+  private
+
+  # Creates a new instance of an AppNews news item with the given data
+  #
+  # @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.
+  # @param [Hash<Symbol, Object>] news_data The news data extracted from JSON
+  def initialize(app_id, news_data)
+    @app_id      = app_id
+    @author      = news_data[:author]
+    @contents    = news_data[:contents].strip
+    @data        = Time.at(news_data[:date])
+    @external    = news_data[:is_external_url]
+    @feed_label  = news_data[:feedlabel]
+    @feed_name   = news_data[:feedname]
+    @gid         = news_data[:gid]
+    @title       = news_data[:title]
+    @url         = news_data[:url]
+  end
+
+end

data/pkg/steam-condenser-1.3.6/pkg/steam-condenser-1.3.5/lib/steam/community/cacheable.rb

@@ -0,0 +1,199 @@
+# This code is free software; you can redistribute it and/or modify it under
+# the terms of the new BSD License.
+#
+# Copyright (c) 2009-2012, Sebastian Staudt
+
+# @macro [new] cacheable
+#   @overload $0(${1--1}, fetch = true, bypass_cache = false)
+#   @param [Boolean] fetch if `true` the object's data is fetched after
+#          creation
+#   @param [Boolean] bypass_cache if `true` the object's data is fetched again
+#          even if it has been cached already
+
+# This module implements caching functionality to be used in any object class
+# having one or more unique object identifier (i.e. ID) and using a `fetch`
+# method to fetch data, e.g. using a HTTP download.
+#
+# @author Sebastian Staudt
+module Cacheable
+
+  # When this module is included in another class it is initialized to make use
+  # of caching
+  #
+  # The original `initialize` method of the including class will be wrapped,
+  # relaying all instantiations to the `new` method defined in {ClassMethods}.
+  # Additionally the class variable to save the attributes to cache (i.e. cache
+  # IDs) and the cache class variable itself are initialized.
+  #
+  # @param [Class] base The class to extend with caching functionality
+  # @see ClassMethods
+  def self.included(base)
+    base.extend ClassMethods
+    base.send :class_variable_set, :@@cache, {}
+    base.send :class_variable_set, :@@cache_ids, []
+
+    class << base
+      def method_added(name)
+        if name == :fetch && !(@@in_method_added ||= false)
+          @@in_method_added = true
+          alias_method :original_fetch, :fetch
+
+          define_method :fetch do
+            original_fetch
+            @fetch_time = Time.now
+          end
+          @@in_method_added = false
+        end
+      end
+    end
+  end
+
+  # This module implements functionality to access the cache of a class that
+  # includes the {Cacheable} module as class methods
+  #
+  # @author Sebastian Staudt
+  module ClassMethods
+
+    # Defines wich instance variables which should be used to index the cached
+    # objects
+    #
+    # @note A call to this method is needed if you want a class including this
+    #       module to really use the cache.
+    # @param [Array<Symbol, Array<Symbol>>] ids The symbolic names of the
+    #        instance variables representing a unique identifier for this
+    #        object class. Arrays of symbols are also allowed and are used as
+    #        compound IDs.
+    def cacheable_with_ids(*ids)
+      class_variable_set :@@cache_ids, ids
+    end
+
+    # Returns whether an object with the given ID is already cached
+    #
+    # @param [Object] id The ID of the desired object
+    # @return [Boolean] `true` if the object with the given ID is already
+    #         cached
+    def cached?(id)
+      id.downcase! if id.is_a? String
+      cache.key?(id)
+    end
+
+    # Clears the object cache for the class this method is called on
+    def clear_cache
+      class_variable_set :@@cache, {}
+    end
+
+    # This checks the cache for an existing object. If it exists it is
+    # returned, otherwise a new object is created.
+    # Overrides the default `new` method of the cacheable object class.
+    #
+    # @param [Array<Object>] args The parameters of the object that should be
+    #        created and if possible loaded from cache
+    # @see #cached?
+    # @see #fetch
+    def new(*args)
+      arity = self.instance_method(:initialize).arity.abs
+      args += [nil] * (arity - args.size) if args.size < arity
+      bypass_cache = args.size > arity + 1 ? !!args.pop : false
+      fetch = args.size > arity ? !!args.pop : true
+
+      object = self.allocate
+      object.send :initialize, *args
+      cached_object = object.send :cached_instance
+      object = cached_object unless cached_object.nil? || bypass_cache
+
+      if fetch && (bypass_cache || !object.fetched?)
+        object.fetch
+        object.cache
+      end
+
+      object
+    end
+
+    private
+
+    # Returns the current cache for the cacheable class
+    #
+    # @return [Hash<Object, Cacheable>] The cache for cacheable class
+    def cache
+      class_variable_get :@@cache
+    end
+
+    # Returns the list of IDs used for caching objects
+    #
+    # @return [Array<Symbol, Array<Symbol>>] The IDs used for caching objects
+    def cache_ids
+      class_variable_get :@@cache_ids
+    end
+
+  end
+
+  # Returns the time the object's data has been fetched the last time
+  #
+  # @return [Time] The time the object has been updated the last time
+  attr_reader :fetch_time
+
+  # Saves this object in the cache
+  #
+  # This will use the ID attributes selected for caching
+  def cache
+    cache     = self.class.send :cache
+    cache_ids.each do |cache_id|
+      cache[cache_id] = self if cache_id
+    end
+
+    true
+  end
+
+  # Fetches the object from some data source
+  #
+  # @note This method should be overridden in cacheable object classes and
+  #       should implement the logic to retrieve the object's data. Updating
+  #       the time is handled dynamically and does not need to be implemented
+  #       separately.
+  def fetch
+  end
+
+  # Returns whether the data for this object has already been fetched
+  #
+  # @return [Boolean] `true` if this object's data is available
+  def fetched?
+    !@fetch_time.nil?
+  end
+
+  private
+
+  # If available, returns the cached instance for the object it is called on
+  #
+  # This may be used to either replace an initial object with a completely
+  # cached instance of the same ID or to compare a modified object with the
+  # copy that was cached before.
+  #
+  # @see #cache_ids
+  def cached_instance
+    ids = cache_ids
+    cached = self.class.send(:cache).find { |id, object| ids.include? id}
+    cached.nil? ? nil : cached.last
+  end
+
+  # Returns a complete list of all values for the cache IDs of the cachable
+  # object
+  #
+  # @return [Array<Object, Array<Object>>] The values for the cache IDs
+  # @see #cache_id_value
+  def cache_ids
+    values = lambda do |id|
+      id.is_a?(Array) ? id.map(&values) : cache_id_value(id)
+    end
+
+    self.class.send(:cache_ids).map &values
+  end
+
+  # Returns the value for the ID
+  #
+  # @param [Symbol] id The name of an instance variable
+  # @return [Object] The value of the given instance variable
+  def cache_id_value(id)
+    instance_variable_get "@#{id}".to_sym
+  end
+
+end

data/pkg/steam-condenser-1.3.6/pkg/steam-condenser-1.3.5/lib/steam/community/css/css_map.rb

@@ -0,0 +1,61 @@
+# This code is free software; you can redistribute it and/or modify it under
+# the terms of the new BSD License.
+#
+# Copyright (c) 2010-2011, Sebastian Staudt
+
+# Represents the stats for a Counter-Strike: Source map for a specific user
+#
+# @author Sebastian Staudt
+class CSSMap
+
+  # Returns the name of this map
+  #
+  # @return [String] The name of this map
+  attr_reader :name
+
+  # Returns the number of rounds the player has lost on this map
+  #
+  # @return [Fixnum] The number of rounds lost
+  attr_reader :rounds_lost
+
+  # Returns the number of rounds the player has played on this map
+  #
+  # @return [Fixnum] The number of rounds played
+  attr_reader :rounds_played
+
+  # Returns the number of rounds the player has won on this map
+  #
+  # @return [Fixnum] The number of rounds won
+  attr_reader :rounds_won
+
+  # Creates a new instance of a Counter-Strike: Source class based on the
+  # given XML data
+  #
+  # @param [String] map_name The name of the map
+  # @param [Hash<String, Object>] maps_data The XML data of all maps
+  def initialize(map_name, maps_data)
+    @name          = map_name
+
+    @favorite      = (maps_data['favorite'] == @name)
+    @rounds_played = maps_data["#{@name}_rounds"].to_i
+    @rounds_won    = maps_data["#{@name}_wins"].to_i
+
+    @rounds_lost = @rounds_played - @rounds_won
+    @rounds_won_percentage = (@rounds_played > 0) ? @rounds_won.to_f / @rounds_played : 0
+  end
+
+  # Returns whether this map is the favorite map of this player
+  #
+  # @return [Boolean] `true` if this is the favorite map
+  def favorite?
+    @favorite
+  end
+
+  # Returns the percentage of rounds the player has won on this map
+  #
+  # @return [Float] The percentage of rounds won
+  def rounds_won_percentage
+    (@rounds_played > 0) ? @rounds_won.to_f / @rounds_played : 0
+  end
+
+end

data/pkg/steam-condenser-1.3.6/pkg/steam-condenser-1.3.5/lib/steam/community/css/css_stats.rb

@@ -0,0 +1,142 @@
+# This code is free software; you can redistribute it and/or modify it under
+# the terms of the new BSD License.
+#
+# Copyright (c) 2010-2013, Sebastian Staudt
+
+require 'steam/community/css/css_map'
+require 'steam/community/css/css_weapon'
+
+# The is class represents the game statistics for a single user in
+# Counter-Strike: Source
+#
+# @author Sebastian Staudt
+class CSSStats < GameStats
+
+  # The names of the maps in Counter-Strike: Source
+  MAPS = [ 'cs_assault', 'cs_compound', 'cs_havana', 'cs_italy', 'cs_militia',
+           'cs_office', 'de_aztec', 'de_cbble', 'de_chateau', 'de_dust',
+           'de_dust2', 'de_inferno', 'de_nuke', 'de_piranesi', 'de_port',
+           'de_prodigy', 'de_tides', 'de_train' ]
+
+  # The names of the weapons in Counter-Strike: Source
+  WEAPONS = [ 'deagle', 'usp', 'glock', 'p228', 'elite', 'fiveseven', 'awp',
+              'ak47', 'm4a1', 'aug', 'sg552', 'sg550', 'galil', 'famas',
+              'scout', 'g3sg1', 'p90', 'mp5navy', 'tmp', 'mac10', 'ump45',
+              'm3', 'xm1014', 'm249', 'knife', 'grenade' ]
+
+  # Returns statistics about the last match the player played
+  #
+  # @return [Hash<Symbol, Object>] The stats of the last match
+  attr_reader :last_match_stats
+
+  # Returns overall statistics of this player
+  #
+  # @return [Hash<Symbol, Object>] The overall statistics
+  attr_reader :total_stats
+
+  # Creates a `CSSStats` instance by calling the super constructor
+  # with the game name `'cs:s'`
+  #
+  # @param [String, Fixnum] steam_id The custom URL or 64bit Steam ID of the
+  #        user
+  # @macro cacheable
+  def initialize(steam_id)
+    super steam_id, 'cs:s'
+
+    if public?
+      last_match_data = @xml_data['stats']['lastmatch']
+      lifetime_data = @xml_data['stats']['lifetime']
+      summary_data = @xml_data['stats']['summary']
+
+      @last_match_stats = {}
+      @total_stats      = {}
+
+      @last_match_stats[:cost_per_kill]      = last_match_data['costkill'].to_f
+      @last_match_stats[:ct_wins]            = last_match_data['ct_wins'].to_i
+      @last_match_stats[:damage]             = last_match_data['dmg'].to_i
+      @last_match_stats[:deaths]             = last_match_data['deaths'].to_i
+      @last_match_stats[:dominations]        = last_match_data['dominations'].to_i
+      @last_match_stats[:favorite_weapon_id] = last_match_data['favwpnid'].to_i
+      @last_match_stats[:kills]              = last_match_data['kills'].to_i
+      @last_match_stats[:max_players]        = last_match_data['max_players'].to_i
+      @last_match_stats[:money]              = last_match_data['money'].to_i
+      @last_match_stats[:revenges]           = last_match_data['revenges'].to_i
+      @last_match_stats[:stars]              = last_match_data['stars'].to_i
+      @last_match_stats[:t_wins]             = last_match_data['t_wins'].to_i
+      @last_match_stats[:wins]               = last_match_data['wins'].to_i
+
+      @total_stats[:blind_kills]             = lifetime_data['blindkills'].to_i
+      @total_stats[:bombs_defused]           = lifetime_data['bombsdefused'].to_i
+      @total_stats[:bombs_planted]           = lifetime_data['bombsplanted'].to_i
+      @total_stats[:damage]                  = lifetime_data['dmg'].to_i
+      @total_stats[:deaths]                  = summary_data['deaths'].to_i
+      @total_stats[:domination_overkills]    = lifetime_data['dominationoverkills'].to_i
+      @total_stats[:dominations]             = lifetime_data['dominations'].to_i
+      @total_stats[:earned_money]            = lifetime_data['money'].to_i
+      @total_stats[:enemy_weapon_kills]      = lifetime_data['enemywpnkills'].to_i
+      @total_stats[:headshots]               = lifetime_data['headshots'].to_i
+      @total_stats[:hits]                    = summary_data['shotshit'].to_i
+      @total_stats[:hostages_rescued]        = lifetime_data['hostagesrescued'].to_i
+      @total_stats[:kills]                   = summary_data['kills'].to_i
+      @total_stats[:knife_kills]             = lifetime_data['knifekills'].to_i
+      @total_stats[:logos_sprayed]           = lifetime_data['decals'].to_i
+      @total_stats[:nightvision_damage]      = lifetime_data['nvgdmg'].to_i
+      @total_stats[:pistol_rounds_won]       = lifetime_data['pistolrounds'].to_i
+      @total_stats[:revenges]                = lifetime_data['revenges'].to_i
+      @total_stats[:rounds_played]           = summary_data['rounds'].to_i
+      @total_stats[:rounds_won]              = summary_data['wins'].to_i
+      @total_stats[:seconds_played]          = summary_data['timeplayed'].to_i
+      @total_stats[:shots]                   = summary_data['shots'].to_i
+      @total_stats[:stars]                   = summary_data['stars'].to_i
+      @total_stats[:weapons_donated]         = lifetime_data['wpndonated'].to_i
+      @total_stats[:windows_broken]          = lifetime_data['winbroken'].to_i
+      @total_stats[:zoomed_sniper_kills]     = lifetime_data['zsniperkills'].to_i
+
+      @last_match_stats[:kdratio] = (@total_stats[:deaths] > 0) ? @last_match_stats[:kills].to_f / @last_match_stats[:deaths] : 0
+      @total_stats[:accuracy]     = (@total_stats[:shots] > 0) ? @total_stats[:hits].to_f / @total_stats[:shots] : 0
+      @total_stats[:kdratio]      = (@total_stats[:deaths] > 0) ? @total_stats[:kills].to_f / @total_stats[:deaths] : 0
+      @total_stats[:rounds_lost]  = @total_stats[:rounds_played] - @total_stats[:rounds_won]
+    end
+  end
+
+  # Returns a map of `CSSMap` for this user containing all CS:S maps.
+  #
+  # If the maps haven't been parsed already, parsing is done now.
+  #
+  # @return [Hash<String, Object>] The map statistics for this user
+  def map_stats
+    return unless public?
+
+    if @map_stats.nil?
+      @map_stats = {}
+      maps_data = @xml_data['stats']['maps']
+
+      MAPS.each do |map_name|
+        @map_stats[map_name] = CSSMap.new(map_name, maps_data)
+      end
+    end
+
+    @map_stats
+  end
+
+  # Returns a map of `CSSWeapon` for this user containing all CS:S weapons.
+  #
+  # If the weapons haven't been parsed already, parsing is done now.
+  #
+  # @return [Hash<String, Object>] The weapon statistics for this user
+  def weapon_stats
+    return unless public?
+
+    if @weapon_stats.nil?
+      @weapon_stats = {}
+      weapons_data = @xml_data['stats']['weapons']
+
+      WEAPONS.each do |weapon_name|
+        @weapon_stats[weapon_name] = CSSWeapon.new(weapon_name, weapons_data)
+      end
+    end
+
+    @weapon_stats
+  end
+
+end