partyhat 0.0.1

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/.rspec

@@ -0,0 +1 @@
+--color

data/Gemfile

@@ -0,0 +1,12 @@
+source "http://rubygems.org"
+
+gem "curb"
+gem "nokogiri"
+
+group :development do
+  gem "rspec"
+  gem "bundler"
+  gem "jeweler"
+  gem "simplecov"
+  gem "simplecov-gem-adapter"
+end

data/Gemfile.lock

@@ -0,0 +1,39 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    curb (0.7.16)
+    diff-lcs (1.1.3)
+    git (1.2.5)
+    jeweler (1.6.4)
+      bundler (~> 1.0)
+      git (>= 1.2.5)
+      rake
+    multi_json (1.0.4)
+    nokogiri (1.5.0)
+    rake (0.9.2.2)
+    rspec (2.7.0)
+      rspec-core (~> 2.7.0)
+      rspec-expectations (~> 2.7.0)
+      rspec-mocks (~> 2.7.0)
+    rspec-core (2.7.1)
+    rspec-expectations (2.7.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.7.0)
+    simplecov (0.5.4)
+      multi_json (~> 1.0.3)
+      simplecov-html (~> 0.5.3)
+    simplecov-gem-adapter (1.0.1)
+      simplecov
+    simplecov-html (0.5.3)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler
+  curb
+  jeweler
+  nokogiri
+  rspec
+  simplecov
+  simplecov-gem-adapter

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Nico Hämäläinen
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.rdoc

@@ -0,0 +1,23 @@
+= Partyhat
+== usage
+
+  require 'partyhat'
+  first_skill  = Partyhat::Skill.new(:attack, 99, 23_784_441, 2509)
+  second_skill = Partyhat::Skill.new(:attack, 99, 16_700_194, 6492)
+  first_skill.compare_to(second_skill).experience # returns experience difference
+
+== Contributing to partyhat
+ 
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
+* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
+* Fork the project
+* Start a feature/bugfix branch
+* Commit and push until you are happy with your contribution
+* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+
+== Copyright
+
+Copyright (c) 2011 Clooth. See LICENSE.txt for
+further details.
+

data/Rakefile

@@ -0,0 +1,43 @@
+# encoding: utf-8
+
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name        = "partyhat"
+  gem.homepage    = "http://github.com/clooth/partyhat"
+  gem.license     = "MIT"
+  gem.summary     = %Q{General Runescape Gem}
+  gem.description = %Q{Versatile runescape gem offering useful tools for runescape-related apps}
+  gem.authors     = ["clooth"]
+  gem.email       = "zenverse@gmail.com"
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end
+
+task :default => :spec
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "partyhat #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.0.1

data/lib/partyhat.rb

@@ -0,0 +1,19 @@
+module Partyhat
+end
+
+require 'open-uri'
+require 'curb'
+require 'nokogiri'
+require 'partyhat/util'
+require 'partyhat/stat'
+require 'partyhat/skill'
+require 'partyhat/skill_comparison'
+require 'partyhat/activity'
+require 'partyhat/activity_comparison'
+require 'partyhat/forums'
+require 'partyhat/forums/forum_post'
+require 'partyhat/forums/forum_thread'
+require 'partyhat/calculators'
+require 'partyhat/calculators/combat'
+require 'partyhat/player'
+require 'partyhat/highscores'

data/lib/partyhat/activity.rb

@@ -0,0 +1,34 @@
+module Partyhat
+  class Activity < Partyhat::Stat
+    @name  = nil
+    @score = nil
+    @rank  = nil
+
+    def initialize name, score, rank
+      raise ArgumentError, 'Invalid activity name' unless ActivitiesList.include? name
+      @name  = name
+      @score = score < 0 ? nil : score
+      @rank  = rank < 0 ? nil : rank
+    end
+
+    def name
+      @name
+    end
+
+    def human_name
+      Partyhat::Stat.human_name_for @name
+    end
+
+    def score
+      @score
+    end
+
+    def rank
+      @rank
+    end
+
+    def compare_to another_activity
+      Partyhat::ActivityComparison.new(self, another_activity)
+    end
+  end
+end

data/lib/partyhat/activity_comparison.rb

@@ -0,0 +1,29 @@
+module Partyhat
+  class ActivityComparison
+    @first_activity  = nil
+    @second_activity = nil
+    @score           = nil
+    @rank            = nil
+
+    def initialize first_activity, second_activity
+      # Check the classes so they don't fail
+      unless (first_activity.class == Partyhat::Activity) && (second_activity.class == Partyhat::Activity)
+        raise InvalidArgumentError 'You can only compare two Partyhat::Activity objects.'
+      end
+      # Assign instance variables
+      @first_activity  = first_activity
+      @second_activity = second_activity
+      # Perform comparison
+      @score = @second_activity.score - @first_activity.score
+      @rank  = @second_activity.rank - @first_activity.rank
+    end
+
+    def score
+      @score
+    end
+
+    def rank
+      @rank
+    end
+  end
+end

data/lib/partyhat/calculators.rb

@@ -0,0 +1,4 @@
+module Partyhat
+  module Calculators
+  end
+end

data/lib/partyhat/calculators/combat.rb

@@ -0,0 +1,43 @@
+module Partyhat
+  module Calculators
+    # Calculate a user's combat level with the given stats hash
+    # The method defaults to runescape starter stats if any of
+    # the skills are missing from the hash.
+    def self.combat stats
+      return nil if stats.nil? || stats.empty?
+      # Default combat calculator stats
+      default_stats = {
+        :attack       => 1,
+        :defence      => 1,
+        :strength     => 1,
+        :constitution => 10,
+        :ranged       => 1,
+        :prayer       => 1,
+        :magic        => 1,
+        :summoning    => 1
+      }
+      # Replace non-set values with defaults
+      values = default_stats.inject({}) { |h, (k, v)| h[k] = stats[k].level.to_i || v; h }
+
+      # Level calculations
+      base_level = (values[:defence] + values[:constitution] + (values[:prayer] / 2).floor + (values[:summoning] / 2).floor) * 0.25
+      base_melee = (values[:attack] + values[:strength]) * 0.325
+      base_range = (values[:ranged] * 1.5).floor * 0.325
+      base_magic = (values[:magic] * 1.5).floor * 0.325
+
+      combat_level = base_level + [base_melee, base_range, base_magic].max
+
+      # Remainder calculations
+      remainder_diff = combat_level + 1
+      remainder_diff = combat_level.ceil - combat_level if combat_level.is_a?(Float)
+      remainders = {
+        :strength_attack      => (remainder_diff / (1.0/3.0)).ceil,
+        :defence_constitution => (remainder_diff / 0.25).ceil,
+        :prayer_summoning     => (remainder_diff / 0.125).ceil
+      }
+
+      { :level      => combat_level,
+        :remainders => remainders }
+    end
+  end
+end

data/lib/partyhat/forums.rb

@@ -0,0 +1,10 @@
+module Partyhat
+  module Forums
+    QUICK_FIND_CODE_FORMAT = /^\d+-\d+-\d+-\d+$/
+
+    def self.valid_qfc? qfc
+      return false if qfc.match(QUICK_FIND_CODE_FORMAT).nil?
+      true
+    end
+  end
+end

data/lib/partyhat/forums/forum_post.rb

@@ -0,0 +1,30 @@
+module Partyhat
+	module Forums
+    # TODO: Deleted post type
+    # TODO: Make sure it cannot be instantiated with invalid information (date in the future etc)
+    # TODO: Check for moderator posts
+		class ForumPost
+      @author   = nil
+      @posted   = nil
+      @contents = nil
+
+      def initialize author, posted, contents
+        @author   = author
+        @posted   = posted
+        @contents = contents
+      end
+
+      def author
+        @author
+      end
+
+      def posted
+        @posted
+      end
+
+      def contents
+        @contents
+      end
+		end
+	end
+end

data/lib/partyhat/forums/forum_thread.rb

@@ -0,0 +1,48 @@
+module Partyhat
+  module Forums
+    # TODO: Add pagination support
+    #       e.g. thread.next_page
+    class ForumThread
+      URL_FORMAT = 'http://services.runescape.com/m=forum/forums.ws?%s'
+      @posts     = []
+      @link      = nil
+      @qfc       = nil
+
+      def initialize qfc
+        raise InvalidArgumentError('Invalid quick find code') unless Forums.valid_qfc?(qfc)
+        @posts = []
+        @qfc   = qfc
+        @link  = URL_FORMAT % qfc.gsub(/-/, ",")
+        parse_from_page Partyhat::Util.fetch_remote(@link)
+      end
+
+      def title
+        @title
+      end
+
+      def posts
+        @posts
+      end
+
+      def link
+        @link
+      end
+
+      def qfc
+        @qfc
+      end
+
+    protected
+      def parse_from_page page
+        document = Nokogiri::HTML(page)
+        # Get title
+        @title = document.css('.BarFullTop span.G0').first.content
+        # Get posts on the page
+        document.css('#MainContent .message').each do |post|
+          author, posted, contents = [post.css('.author'), post.css('.BubbleCreation span'), post.css('.msgcontents td')].map(&:text)
+          @posts << Partyhat::Forums::ForumPost.new(author, posted, contents)
+        end
+      end
+    end
+  end
+end

data/lib/partyhat/highscores.rb

@@ -0,0 +1,31 @@
+module Partyhat
+  module Highscores
+    HIGHSCORES_PAGE_URL = 'http://hiscore.runescape.com/index_lite.ws?player=%s'
+
+    # Fetch a user's highscores object
+    def self.find_player name
+      page_url = HIGHSCORES_PAGE_URL % URI::encode(name)
+      page_src = Partyhat::Util.fetch_remote(page_url)
+      self.parse_lite_page(page_src) unless page_src.nil?
+    end
+
+    # Parse the result page from the highscores into
+    # A hash containing skill/activity objects with
+    # the corresponding stat name as key.
+    def self.parse_lite_page page
+      lite_page_lines = page.split("\n")
+      user_stats = {}
+      Partyhat::Stat::List.each do |stat|
+        line_parts = lite_page_lines.shift.split(',').map(&:to_i)
+        if line_parts.size == 3
+          rank, level, experience = line_parts.shift, line_parts.shift, line_parts.shift
+          user_stats[stat]        = Partyhat::Skill.new(stat, level, experience, rank)
+        else
+          rank, score      = line_parts.shift, line_parts.shift
+          user_stats[stat] = Partyhat::Activity.new(stat, score, rank)
+        end
+      end
+      user_stats
+    end
+  end
+end

data/lib/partyhat/player.rb

@@ -0,0 +1,23 @@
+module Partyhat
+  class Player
+    @name  = nil
+    @stats = nil
+
+    def initialize name
+      @name = name
+      @stats = Partyhat::Highscores.find_player(@name)
+    end
+
+    def name
+      @name
+    end
+
+    def stats
+      @stats
+    end
+
+    def combat
+      Partyhat::Calculators.combat(stats)
+    end
+  end
+end

data/lib/partyhat/skill.rb

@@ -0,0 +1,42 @@
+module Partyhat
+  class Skill < Partyhat::Stat
+    @name       = nil
+    @level      = nil
+    @experience = nil
+    @rank       = nil
+
+    def initialize name, level, experience, rank
+      raise ArgumentError, 'Invalid skill name "' + name.to_s + '"' unless (SkillsList+[:overall]).include? name
+      @name       = name
+
+      # Nilify negative values
+      @level      = level < 0 ? nil : level
+      @experience = experience < 0 ? nil : experience
+      @rank       = rank < 0 ? nil : rank
+    end
+
+    def name
+      @name
+    end
+
+    def human_name
+      Partyhat::Stat.human_name_for @name
+    end
+
+    def level
+      @level
+    end
+
+    def experience
+      @experience
+    end
+
+    def rank
+      @rank
+    end
+
+    def compare_to another_skill
+      Partyhat::SkillComparison.new(self, another_skill)
+    end
+  end
+end

data/lib/partyhat/skill_comparison.rb

@@ -0,0 +1,35 @@
+module Partyhat
+  class SkillComparison
+    @first_skill  = nil
+    @second_skill = nil
+    @level        = nil
+    @experience   = nil
+    @rank         = nil
+
+    def initialize first_skill, second_skill
+      # Check the classes so they don't fail
+      unless (first_skill.class == Partyhat::Skill) && (second_skill.class == Partyhat::Skill)
+        raise InvalidArgumentError 'You can only compare two Skill objects.'
+      end
+      # Assign instance variables
+      @first_skill  = first_skill
+      @second_skill = second_skill
+      # Perform comparison
+      @level        = @second_skill.level - @first_skill.level
+      @experience   = @second_skill.experience - @first_skill.experience
+      @rank         = @second_skill.rank - @first_skill.rank
+    end
+
+    def level
+      @level
+    end
+
+    def experience
+      @experience
+    end
+
+    def rank
+      @rank
+    end
+  end
+end

data/lib/partyhat/stat.rb

@@ -0,0 +1,112 @@
+module Partyhat
+  class Stat
+    # List of skills that appear in the highscores
+    SkillsList = [
+      :attack,
+      :defence,
+      :strength,
+      :constitution,
+      :ranged,
+      :prayer,
+      :magic,
+      :cooking,
+      :woodcutting,
+      :fletching,
+      :fishing,
+      :firemaking,
+      :crafting,
+      :smithing,
+      :mining,
+      :herblore,
+      :agility,
+      :thieving,
+      :slayer,
+      :farming,
+      :runecrafting,
+      :hunter,
+      :construction,
+      :summoning,
+      :dungeoneering
+    ]
+
+    # List of activities that appear in the highscores
+    ActivitiesList = [
+      :duel_tournament,
+      :bounty_hunters,
+      :bounty_hunter_rogues,
+      :fist_of_guthix,
+      :mobilising_armies,
+      :ba_attackers,
+      :ba_defenders,
+      :ba_collectors,
+      :ba_healers,
+      :castle_wars_games,
+      :conquest,
+      :dominion_tower
+    ]
+
+    # List of skills that count in your combat level
+    CombatSkillsList = [
+      :attack,
+      :defence,
+      :strength,
+      :constitution,
+      :ranged,
+      :prayer,
+      :magic,
+      :summoning
+    ]
+
+    # List of all stats that can belong to a player
+    List = [:overall] + SkillsList + ActivitiesList
+
+    # Human readable names for all skills and activities
+    HumanNames = {
+      :overall              => 'Overall',
+      :attack               => 'Attack',
+      :defence              => 'Defence',
+      :strength             => 'Strength',
+      :constitution         => 'Constitution',
+      :ranged               => 'Ranged',
+      :prayer               => 'Prayer',
+      :magic                => 'Magic',
+      :cooking              => 'Cooking',
+      :woodcutting          => 'Woodcutting',
+      :fletching            => 'Fletching',
+      :fishing              => 'Fishing',
+      :firemaking           => 'Firemaking',
+      :crafting             => 'Crafting',
+      :smithing             => 'Smithing',
+      :mining               => 'Mining',
+      :herblore             => 'Herblore',
+      :agility              => 'Agility',
+      :thieving             => 'Thieving',
+      :slayer               => 'Slayer',
+      :farming              => 'Farming',
+      :runecrafting         => 'Runecrafting',
+      :hunter               => 'Hunter',
+      :construction         => 'Construction',
+      :summoning            => 'Summoning',
+      :dungeoneering        => 'Dungeoneering',
+      :duel_tournament      => 'Duel Tournament',
+      :bounty_hunters       => 'Bounty Hunters',
+      :bounty_hunter_rogues => 'Bounty Hunter Rogues',
+      :fist_of_guthix       => 'Fist of Guthix',
+      :mobilising_armies    => 'Mobilising Armies',
+      :ba_attackers         => 'B.A Attackers',
+      :ba_defenders         => 'B.A Defenders',
+      :ba_collectors        => 'B.A Collectors',
+      :ba_healers           => 'B.A Healers',
+      :castle_wars_games    => 'Castle Wars Games',
+      :conquest             => 'Conquest',
+      :dominion_tower       => 'Dominion Tower'
+    }
+
+    # Get the human readable name for a stat name
+    #
+    # * returns 'Undefined' if not found
+    def self.human_name_for stat
+      HumanNames[stat] || 'Undefined'
+    end
+  end
+end

data/lib/partyhat/util.rb

@@ -0,0 +1,92 @@
+module Partyhat
+  class Util
+    # Convert an experience value to a level
+    # Uses a formula from somewhere.
+    # TODO: Add source for formula.
+    def self.experience_to_level experience
+      modifier = 0
+      (1..200).each do |n|
+        modifier += (n + 300 * (2 ** (n.to_f/7.0))).floor
+        level     = (modifier/4).floor
+        return n if experience < level
+      end
+      200
+    end
+
+    # Convert a level value into experience
+    # Uses a formula from somewhere.
+    # FIXME: This is not accurate, check partyhat_util_spec results
+    # TODO: Add source for formula.
+    def self.level_to_experience level
+      experience = 0
+      (1..level-1).each do |n|
+        experience += (n + 300 * (2 ** (n.to_f/7.0))).floor
+      end
+      (experience/4).floor
+    end
+
+    # Abbreviate a small or large number into compressed form
+    # Usage:
+    # Partyhat::Util.abbreviate_number(55_500) => "55K"
+    # as seen all over the game. e.g. "5K"
+    def self.shorten_number number
+      divider = 1
+      suffix  = nil
+      if number >= 1_000_000_000
+        divider = 1_000_000_000
+        suffix = 'B'
+      elsif number >= 1_000_000
+        divider = 1_000_000
+        suffix = 'M'
+      elsif number >= 1_000
+        divider = 1_000
+        suffix = 'K'
+      end
+      (number / divider.to_f).round(1).to_s + suffix
+    end
+
+    # De-abbreviate the already compressed number with the
+    # abbreviate_number method.
+    # Note:
+    # Values might not stay the same if abbreviated
+    # and then deabbreviated
+    def self.parse_number string
+      number     = string.chop.to_f
+      ending     = string[-1, 1]
+      multiplier = 1
+      case ending.upcase
+        when 'B' then multiplier = 1_000_000_000
+        when 'M' then multiplier = 1_000_000
+        when 'K' then multiplier = 1_000
+      end
+      (number * (multiplier || 1)).round(1)
+    end
+
+    # Fetch a remote page and return it
+    # If you pass in only one URL, direct source will be returneds
+    # If you pass in multiple URLs, a hash will be returned with url indexes
+    def self.fetch_remote urls
+      urls = [urls] unless urls.is_a?(Array)
+      responses = {}
+      m = Curl::Multi.new
+      urls.reject.each do |url|
+        responses[url] = ""
+        c = Curl::Easy.new(url) do|curl|
+          curl.follow_location = true
+          curl.on_body do |data|
+            responses[url] << data
+            data.size
+          end
+        end
+        m.add(c)
+      end
+      m.perform
+
+      if responses.size > 1
+        responses
+      else
+        responses[urls.pop]
+      end
+    end
+  end
+end

data/partyhat.gemspec

@@ -0,0 +1,89 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = "partyhat"
+  s.version = "0.0.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["clooth"]
+  s.date = "2011-12-15"
+  s.description = "Versatile runescape gem offering useful tools for runescape-related apps"
+  s.email = "zenverse@gmail.com"
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+    ".rspec",
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE.txt",
+    "README.rdoc",
+    "Rakefile",
+    "VERSION",
+    "lib/partyhat.rb",
+    "lib/partyhat/activity.rb",
+    "lib/partyhat/activity_comparison.rb",
+    "lib/partyhat/calculators.rb",
+    "lib/partyhat/calculators/combat.rb",
+    "lib/partyhat/forums.rb",
+    "lib/partyhat/forums/forum_post.rb",
+    "lib/partyhat/forums/forum_thread.rb",
+    "lib/partyhat/highscores.rb",
+    "lib/partyhat/player.rb",
+    "lib/partyhat/skill.rb",
+    "lib/partyhat/skill_comparison.rb",
+    "lib/partyhat/stat.rb",
+    "lib/partyhat/util.rb",
+    "partyhat.gemspec",
+    "spec/activity_spec.rb",
+    "spec/calculators_spec.rb",
+    "spec/forums_spec.rb",
+    "spec/highscores_spec.rb",
+    "spec/player_spec.rb",
+    "spec/skill_spec.rb",
+    "spec/spec_helper.rb",
+    "spec/stat_spec.rb",
+    "spec/util_spec.rb"
+  ]
+  s.homepage = "http://github.com/clooth/partyhat"
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = "1.8.10"
+  s.summary = "General Runescape Gem"
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<curb>, [">= 0"])
+      s.add_runtime_dependency(%q<nokogiri>, [">= 0"])
+      s.add_development_dependency(%q<rspec>, [">= 0"])
+      s.add_development_dependency(%q<bundler>, [">= 0"])
+      s.add_development_dependency(%q<jeweler>, [">= 0"])
+      s.add_development_dependency(%q<simplecov>, [">= 0"])
+      s.add_development_dependency(%q<simplecov-gem-adapter>, [">= 0"])
+    else
+      s.add_dependency(%q<curb>, [">= 0"])
+      s.add_dependency(%q<nokogiri>, [">= 0"])
+      s.add_dependency(%q<rspec>, [">= 0"])
+      s.add_dependency(%q<bundler>, [">= 0"])
+      s.add_dependency(%q<jeweler>, [">= 0"])
+      s.add_dependency(%q<simplecov>, [">= 0"])
+      s.add_dependency(%q<simplecov-gem-adapter>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<curb>, [">= 0"])
+    s.add_dependency(%q<nokogiri>, [">= 0"])
+    s.add_dependency(%q<rspec>, [">= 0"])
+    s.add_dependency(%q<bundler>, [">= 0"])
+    s.add_dependency(%q<jeweler>, [">= 0"])
+    s.add_dependency(%q<simplecov>, [">= 0"])
+    s.add_dependency(%q<simplecov-gem-adapter>, [">= 0"])
+  end
+end
+

data/spec/activity_spec.rb

@@ -0,0 +1,49 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe "Partyhat::Activity" do
+  before :each do
+    @activity          = Partyhat::Activity.new(:ba_attackers, 5000, 10)
+    @better_activity   = Partyhat::Activity.new(:ba_attackers, 59834, 2)
+    @unranked_activity = Partyhat::Activity.new(:fist_of_guthix, -1, -1)
+  end
+
+  it "should be initializable" do
+    @activity.should be_instance_of(Partyhat::Activity)
+  end
+
+  it "should raise error on invalid skill name" do
+    lambda {
+      Partyhat::Activity.new(:jingle_bells, 1, 0)
+    }.should raise_error
+  end
+
+  it "should have accessible information" do
+    @activity.name.should             eq(:ba_attackers)
+    @activity.human_name.should       eq(Partyhat::Stat.human_name_for(@activity.name))
+    @activity.score.should_not        be_nil
+    @activity.rank.should_not         be_nil
+  end
+
+  it "should turn negative and/or 0 values into nils" do
+    @unranked_activity.score.should     eq(nil)
+    @unranked_activity.rank.should      eq(nil)
+  end
+
+  context "Comparing" do
+    it "should be able to compare two activities" do
+      @activity.compare_to(@better_activity).should be_instance_of(Partyhat::ActivityComparison)
+    end
+
+    it "should not be possible to compare an activity and a skill" do
+      lambda {
+        @activity.compare_to(Partyhat::Skill.new(:defence, 5000, 10, 2000))
+      }.should raise_error
+    end
+
+    it "should be comparable to other activities" do
+      comparison = @activity.compare_to(@better_activity)
+      comparison.score.should       eq(54834)
+      comparison.rank.should        eq(-8) # smaller is better
+    end
+  end
+end

data/spec/calculators_spec.rb

@@ -0,0 +1,18 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe "Partyhat::Calculators" do
+  it "should calculate combat" do
+    maxed = Partyhat::Calculators.combat({
+      :attack => Partyhat::Skill.new(:attack, 99, 99, 99),
+      :defence => Partyhat::Skill.new(:defence, 99, 99, 99),
+      :strength => Partyhat::Skill.new(:strength, 99, 99, 99),
+      :constitution => Partyhat::Skill.new(:constitution, 99, 99, 99),
+      :ranged => Partyhat::Skill.new(:ranged, 99, 99, 99),
+      :prayer => Partyhat::Skill.new(:prayer, 99, 99, 99),
+      :magic => Partyhat::Skill.new(:magic, 99, 99, 99),
+      :summoning => Partyhat::Skill.new(:summoning, 99, 99, 99)
+    })
+
+    maxed[:level].to_i.should eq(138)
+  end
+end

data/spec/forums_spec.rb

@@ -0,0 +1,46 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe "Partyhat::Forums" do
+
+  before :all do
+    @valid_qfc = "13-14-933-63418737"
+    @invalid_qfc = "13--14-14-933-63418737"
+  end
+
+  it "should validate quick find codes" do
+    Partyhat::Forums.valid_qfc?(@valid_qfc).should eq(true)
+    Partyhat::Forums.valid_qfc?(@invalid_qfc).should eq(false)
+  end
+
+  context "Partyhat::Forums::ForumThread" do
+    before :all do
+      @thread = Partyhat::Forums::ForumThread.new(@valid_qfc)
+    end
+
+    it "should be instantiable with a qfc" do
+      @thread.should be_instance_of(Partyhat::Forums::ForumThread)
+    end
+
+    it "should have accessible values" do
+      @thread.title.should eq('Behind The Scenes - December')
+      @thread.posts.size.should > 0
+      @thread.qfc.should eq(@valid_qfc)
+      @thread.link.should eq(Partyhat::Forums::ForumThread::URL_FORMAT % @valid_qfc.gsub(/-/, ','))
+    end
+  end
+
+  describe "Partyhat::Forums::ForumPost" do
+    before :all do
+      @thread = Partyhat::Forums::ForumThread.new(@valid_qfc)
+      @posts = @thread.posts
+    end
+
+    it "should have the right information" do
+      @posts.each do |post|
+        post.author.should_not be_nil
+        post.posted.should_not be_nil
+        post.contents.should_not be_nil
+      end
+    end
+  end
+end

data/spec/highscores_spec.rb

@@ -0,0 +1,10 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe "Partyhat::Highscores" do
+  it "should fetch highscores properly" do
+    stats = Partyhat::Highscores.find_player("Not Clooth")
+    Partyhat::Stat::List.each do |stat|
+      stats.has_key?(stat).should == true
+    end
+  end
+end

data/spec/player_spec.rb

@@ -0,0 +1,22 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe "Partyhat::Player" do
+  before :each do
+    @player = Partyhat::Player.new("Not Clooth")
+  end
+
+  it "should should be instantiable with name" do
+    @player.should be_instance_of(Partyhat::Player)
+    @player.name.should eq("Not Clooth")
+  end
+
+  it "should have stats accessible" do
+    Partyhat::Stat::List.each do |stat|
+      @player.stats.has_key?(stat).should == true
+    end
+  end
+
+  it "should calculate combat correctly" do
+    @player.combat[:level].to_i.should == 109
+  end
+end

data/spec/skill_spec.rb

@@ -0,0 +1,52 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe "Partyhat::Skill" do
+  before :each do
+    @skill          = Partyhat::Skill.new(:attack, 1, 0, 50000)
+    @better_skill   = Partyhat::Skill.new(:attack, 4, 500, 234)
+    @unranked_skill = Partyhat::Skill.new(:dungeoneering, -1, -1, -1)
+  end
+
+  it "should be initializable" do
+    @skill.should be_instance_of(Partyhat::Skill)
+  end
+
+  it "should raise error on invalid skill name" do
+    lambda {
+      Partyhat::Skill.new(:jingle_bells, 1, 0, 49999)
+    }.should raise_error
+  end
+
+  it "should have accessible information" do
+    @skill.name.should            eq(:attack)
+    @skill.human_name.should      eq(Partyhat::Stat.human_name_for(@skill.name))
+    @skill.level.should_not       be_nil
+    @skill.experience.should_not  be_nil
+    @skill.rank.should_not        be_nil
+  end
+
+  it "should turn negative and/or 0 values into nils" do
+    @unranked_skill.level.should      eq(nil)
+    @unranked_skill.experience.should eq(nil)
+    @unranked_skill.rank.should       eq(nil)
+  end
+
+  context "Comparing" do
+    it "should be able to compare two skills" do
+      @skill.compare_to(@better_skill).should be_instance_of(Partyhat::SkillComparison)
+    end
+
+    it "should not be possible to compare a skill and an activity" do
+      lambda {
+        @skill.compare_to(Partyhat::Activity.new(:ba_attackers, 5000, 10))
+      }.should raise_error
+    end
+
+    it "should be comparable to other skills" do
+      comparison = @skill.compare_to(@better_skill)
+      comparison.level.should       eq(3)      # Level is better when it's higher
+      comparison.experience.should  eq(500)    # Experience is higher than the first skill
+      comparison.rank.should        eq(-49766) # Rank should be higher (smaller is better)
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,13 @@
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'simplecov'
+require 'simplecov-gem-adapter'
+SimpleCov.start 'gem'
+
+require 'rspec'
+require 'curb'
+require 'partyhat'
+
+RSpec.configure do |config|
+
+end

data/spec/stat_spec.rb

@@ -0,0 +1,26 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe "Partyhat::Stat" do
+  it "should have lists of stats" do
+    [
+      Partyhat::Stat::SkillsList,
+      Partyhat::Stat::ActivitiesList,
+      Partyhat::Stat::CombatSkillsList,
+      Partyhat::Stat::List
+    ].each do |property|
+      property.should_not be_nil
+    end
+  end
+
+  context "Human names" do
+    it "should be able to get names for stats" do
+      Partyhat::Stat::List.each do |stat|
+        Partyhat::Stat.human_name_for(stat).should_not eq('Undefined')
+      end
+    end
+
+    it "should gracefully degrade on unknown stat" do
+      Partyhat::Stat.human_name_for(:jingle_bells).should eq('Undefined')
+    end
+  end
+end

data/spec/util_spec.rb

@@ -0,0 +1,87 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe "Partyhat::Util" do
+  before :all do
+    @sliding_experiences = {
+      2   => 150,
+      34  => 21_000,
+      60  => 280_000,
+      83  => 2_800_000,
+      99  => 13_500_000,
+      115 => 67_000_000,
+      119 => 96_000_000
+    }
+    @exact_experiences = {
+      29  => 12_031,
+      52  => 123_660,
+      70  => 737_627,
+      98  => 11_805_606
+    }
+    @numbers_and_shorts = {
+      55_000        => '55.0K',
+      123_500       => '123.5K',
+      5_123_000     => '5.1M',
+      123_100_000   => '123.1M',
+      4_500_000_000 => '4.5B'
+    }
+    @shorts_and_numbers = {
+      '55.0K'  => 55_000,
+      '55.5K'   => 55_500,
+      '123.54K' => 123_540,
+      '5.123M'  => 5_123_000,
+      '123.12M' => 123_120_000,
+      '4.72B'   => 4_720_000_000
+    }
+  end
+
+  context "Experience to Level" do
+    it "should successfully convert experience to level" do
+      @sliding_experiences.each do |key, value|
+        converted = Partyhat::Util.experience_to_level(value)
+        converted.should eq(key)
+      end
+    end
+
+    it "should return a maximum level of 200" do
+      Partyhat::Util.experience_to_level(500_000_000_000).should eq(200)
+    end
+  end
+
+  context "Level to experience" do
+    it "should successfully convert level to experience" do
+      @exact_experiences.each do |key, value|
+        converted = Partyhat::Util.level_to_experience(key)
+        converted.should eq(value)
+      end
+    end
+  end
+
+  context "Shortening and parsing numbers" do
+    it "should be able to shorten a number" do
+      @numbers_and_shorts.each do |number, short|
+        Partyhat::Util.shorten_number(number).should eq(short)
+      end
+    end
+
+    it "should be able to parse a number" do
+      @shorts_and_numbers.each do |short, number|
+        Partyhat::Util.parse_number(short).should eq(number)
+      end
+    end
+  end
+
+  context "Fetching remote pages" do
+    it "should be able to fetch and return a single page" do
+      url = 'http://google.com'
+      Partyhat::Util.fetch_remote(url).class.should == String
+    end
+
+    it "should be able to fetch and return multiple pages" do
+      urls = ['http://google.com', 'http://microsoft.com']
+      pages = Partyhat::Util.fetch_remote(urls)
+      pages.class.should == Hash
+      pages["http://google.com"].class.should == String
+      pages["http://microsoft.com"].class.should == String
+    end
+  end
+end

metadata

@@ -0,0 +1,159 @@
+--- !ruby/object:Gem::Specification
+name: partyhat
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- clooth
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-12-15 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: curb
+  requirement: &70291871068960 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70291871068960
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: &70291871066920 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70291871066920
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &70291871066040 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70291871066040
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: &70291871064340 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70291871064340
+- !ruby/object:Gem::Dependency
+  name: jeweler
+  requirement: &70291871079620 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70291871079620
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: &70291871078980 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70291871078980
+- !ruby/object:Gem::Dependency
+  name: simplecov-gem-adapter
+  requirement: &70291871078200 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70291871078200
+description: Versatile runescape gem offering useful tools for runescape-related apps
+email: zenverse@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- LICENSE.txt
+- README.rdoc
+files:
+- .document
+- .rspec
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.rdoc
+- Rakefile
+- VERSION
+- lib/partyhat.rb
+- lib/partyhat/activity.rb
+- lib/partyhat/activity_comparison.rb
+- lib/partyhat/calculators.rb
+- lib/partyhat/calculators/combat.rb
+- lib/partyhat/forums.rb
+- lib/partyhat/forums/forum_post.rb
+- lib/partyhat/forums/forum_thread.rb
+- lib/partyhat/highscores.rb
+- lib/partyhat/player.rb
+- lib/partyhat/skill.rb
+- lib/partyhat/skill_comparison.rb
+- lib/partyhat/stat.rb
+- lib/partyhat/util.rb
+- partyhat.gemspec
+- spec/activity_spec.rb
+- spec/calculators_spec.rb
+- spec/forums_spec.rb
+- spec/highscores_spec.rb
+- spec/player_spec.rb
+- spec/skill_spec.rb
+- spec/spec_helper.rb
+- spec/stat_spec.rb
+- spec/util_spec.rb
+homepage: http://github.com/clooth/partyhat
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -1818227121818652947
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.10
+signing_key: 
+specification_version: 3
+summary: General Runescape Gem
+test_files: []