wowr 0.2.2 → 0.3.0

data/lib/wowr/exceptions.rb

@@ -1,10 +1,11 @@
 module Wowr
 	module Exceptions
-		def self.raise_me(code)
-			#msg = "(#{code.to_s}) #{msg}"
+		def self.raise_me(code, options = {})
 			case code
 				when "noCharacter"
-					raise CharacterNotFound.new("Character with that name not found.")
+					raise CharacterNotFound.new("Character '#{options[:character_name]}' not found.")
+				else
+					raise StandardError.new("The XML returned an error: #{code.to_s}")
 			end
 		end
 		
@@ -15,28 +16,92 @@ module Wowr
 		end
 		
 		class ServerDoesNotExist < StandardError
+			def initialize(string)
+				super "Server at '#{string}' did not respond."
+			end
+		end
+		
+		class CharacterNameNotSet < StandardError
+			def initialize
+				super "Character name not set in options or API constructor."
+			end
 		end
 		
-		# errCode="noCharacter"
-		class CharacterNotFound < StandardError
+		class GuildNameNotSet < StandardError
+			def initialize
+				super "Guild name not set in options or API constructor."
+			end
 		end
 		
-		class ItemNotFound < StandardError
+		class ArenaTeamNameNotSet < StandardError
+			def initialize
+				super "Arena team name not set."
+			end
 		end
 		
-		class GuildNotFound < StandardError
+		class InvalidArenaTeamSize < StandardError
 		end
 		
+		class RealmNotSet < StandardError
+			def initialize
+				super "Realm not set in options or API constructor."
+			end
+		end
+		
+		# Search (fold)
 		class SearchError < StandardError
 		end
 		
-		class InvalidSearchType < StandardError
+		class InvalidSearchType < SearchError
+			def initialize(string)
+				super "'#{string}' is not a valid search type."
+			end
 		end
 		
-		class NoSearchString < StandardError
+		class NoSearchString < SearchError
+			def initialize
+				super "No search string specified or string was empty."
+			end
 		end
 		
-		class InvalidArenaTeamSize < StandardError
+		class ElementNotFoundError < StandardError
+		end
+		
+		class CharacterNotFound < ElementNotFoundError
+			def initialize(string)
+				super "Character not found with name '#{string}'."
+			end
+		end
+		
+		class ItemNotFound < ElementNotFoundError
+			def initialize(string)
+				super "Item not found with name '#{string}'."
+			end
+		end
+		
+		class GuildNotFound < ElementNotFoundError
+			def initialize(string)
+				super "Guild not found with name '#{string}'."
+			end
+		end
+				
+		class ArenaTeamNotFound < ElementNotFoundError
+			def initialize(string)
+				super "Arena team not found with name '#{string}'."
+			end
+		end
+		# (end)
+
+		class InvalidIconSize < StandardError
+			def initialize(array)
+				super "Icon size must be: #{array.keys.inspect}"
+			end
+		end
+		
+		class InvalidIconType < StandardError
+			def initialize(array)
+				super "Icon type must be: #{array.keys.inspect}"
+			end
 		end
 	end
 end

data/lib/wowr/extensions.rb

@@ -1,5 +1,67 @@
 module Wowr
 	module Extensions
 
+		# Rails's cattr_ things. activesupport/lib/active_support/core_ext/class
+		# Really quite handy.
+		# Thanks Reve's Lisa Seelye
+		module Class #:nodoc:
+			def cattr_reader(*syms) #:nodoc:
+				syms.flatten.each do |sym|
+					next if sym.is_a?(Hash)
+					class_eval(<<-EOS, __FILE__, __LINE__)
+						unless defined? @@#{sym}
+							@@#{sym} = nil
+						end
+
+						def self.#{sym}
+							@@#{sym}
+						end
+
+						def #{sym}
+							@@#{sym}
+						end
+					EOS
+				end
+			end
+
+			def cattr_writer(*syms) #:nodoc:
+				options = syms.last.is_a?(Hash) ? syms.pop : {}
+				syms.flatten.each do |sym|
+					class_eval(<<-EOS, __FILE__, __LINE__)
+						unless defined? @@#{sym}
+							@@#{sym} = nil
+						end
+
+						def self.#{sym}=(obj)
+							@@#{sym} = obj
+						end
+						#{"
+						def #{sym}=(obj)
+							@@#{sym} = obj
+						end
+						" unless options[:instance_writer] == false }
+					EOS
+				end
+			end
+			def cattr_accessor(*syms) #:nodoc:
+				cattr_reader(*syms)
+				cattr_writer(*syms)
+			end
+			
+			
+			def stringy(sym) #:nodoc:
+				class_eval(<<-EOS, __FILE__, __LINE__)
+					def to_s
+						@#{sym}
+					end
+				EOS
+			end
+		end
+
 	end
-end
+end
+
+
+class Class #:nodoc:
+	include Wowr::Extensions::Class
+end

data/lib/wowr/guild.rb

@@ -0,0 +1,85 @@
+$:.unshift(File.dirname(__FILE__)) unless $:.include?(File.dirname(__FILE__)) || $:.include?(File.expand_path(File.dirname(__FILE__)))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+
+require 'character.rb'
+
+module Wowr #:nodoc:
+	module Classes #:nodoc:
+		
+		# A player guild containing members
+		# Abstract
+		class Guild
+			attr_reader :name, :url, :realm
+									# :roster_url, :stats_url, :stats_url_escape,
+			alias_method :to_s, :name
+
+			def initialize(elem)
+				if (elem%'guildKey')
+					guild = (elem%'guildKey')
+				else
+					guild = elem
+				end
+				
+				@name					= guild[:name]
+				@url					= guild[:url]
+				@realm				= guild[:realm]
+			end
+		end
+		
+		# Basic search information returned by the search.xml
+		# <guilds>
+		#   <guild
+		# battleGroup="Ruin"
+		# faction="Alliance"
+		# factionId="0"
+		# name="HAND"
+		# realm="Stormrage"
+		# relevance="100"
+		# url="r=Stormrage&amp;n=HAND&amp;p=1"/>
+		# </guilds>
+		class SearchGuild < Guild
+			attr_reader :faction, :faction_id, :battle_group
+			
+			def initialize(elem)
+				super(elem)
+				
+				@battle_group = elem[:battleGroup]
+				@faction			= elem[:faction]
+				@faction_id		= elem[:factionId].to_i
+				
+				@relevance		= elem[:relevance].to_i
+			end
+		end
+		
+		# Full guild data
+		# <guildKey factionId="0" name="HAND" nameUrl="HAND" realm="Stormrage" realmUrl="Stormrage" url="r=Stormrage&amp;n=HAND"/>
+	  # <guildInfo>
+	  #   <guild>
+	  #     <members filterField="" filterValue="" maxPage="1" memberCount="1" page="1" sortDir="a" sortField="">
+	  #       <character class="Paladin" classId="2" gender="Male" genderId="0" level="14" name="Sturky" race="Dwarf" raceId="3" rank="0" url="r=Stormrage&amp;n=Sturky"/>
+	  #     </members>
+	  #   </guild>
+	  # </guildInfo>
+		class FullGuild < Guild
+			attr_reader :members, :name_url, :realm_url #, :member_count
+		
+			def initialize(elem)
+				super(elem)
+				
+				@name_url			= elem[:nameUrl]
+				@realm_url		= elem[:realmUrl]
+				
+				# Guild/guild_id/guild_url not set for characters
+				if (elem%'guildInfo')
+					# @member_count = (elem%'guildInfo'%'guild'%'members')[:memberCount].to_i || nil
+					@members = {}
+					(elem%'guildInfo'%'guild'%'members'/:character).each do |char|
+						# TODO: Change to search character?
+						members[char[:name]] = Character.new(char)
+					end
+				end
+			end
+		
+		end
+	end
+end

data/lib/wowr/item.rb

@@ -0,0 +1,616 @@
+# TODO: Item sources - Vendors
+# sourceType.vendor
+# sourceType.questReward
+# sourceType.createdBySpell
+
+$:.unshift(File.dirname(__FILE__)) unless $:.include?(File.dirname(__FILE__)) || $:.include?(File.expand_path(File.dirname(__FILE__)))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+
+module Wowr
+	module Classes
+
+		# Most basic 
+		# Composed of an ItemInfo and
+		# Needs to be consolidated with ItemInfo and other stuff
+		# to be a parent class that they extend?
+		# TODO: At the moment needs a reference to the API in order to get the base URL for icons
+		# TODO: Make extend Icon class
+		class Item
+			attr_reader :id, :name, :icon_base
+			alias_method :item_id, :id
+			alias_method :to_s, :name
+			alias_method :to_i, :id
+
+			@@icon_url_base = 'images/icons/'
+			@@icon_sizes = {:large => ['64x64', 'jpg'], :medium => ['43x43', 'png'], :small => ['21x21', 'png']}
+			
+			def initialize(elem, api = nil)
+				@api = api
+				
+				@id 				= elem[:id].to_i
+				@name 			= elem[:name]
+				@icon_base 	= elem[:icon]
+			end
+			
+			def icon(size = :medium)
+				if !@@icon_sizes.include?(size)
+					raise Wowr::Exceptions::InvalidIconSize.new(@@icon_sizes)
+				end
+				
+				if @api
+					base = @api.base_url
+				else
+					base = 'http://www.wowarmory.com/'
+				end
+				
+				# http://www.wowarmory.com/images/icons/64x64/blahblah.jpg
+				return base + @@icon_url_base + @@icon_sizes[size][0] + '/' + @icon_base + '.' + @@icon_sizes[size][1]
+			end
+		end
+
+		# Full data from item-info and item-tooltip
+		class FullItem < Item
+			
+			def initialize(info, tooltip, api = nil)
+				super(info, api)
+				@info = ItemInfo.new(info, api)
+				@tooltip = ItemTooltip.new(tooltip, api)
+			end
+			
+			def method_missing(m, *args)
+				begin
+					return @info.send(m, *args)
+				rescue NoMethodError => e
+					begin
+						return @tooltip.send(m, *args)
+					rescue
+						raise NoMethodError.new("undefined method '#{m}' for #{self.class}")
+					end
+				end
+			end
+		end
+		
+		
+		
+		
+		# uses item-info.xml
+		class ItemInfo < Item
+			attr_reader :level, :quality, :type,
+									:cost, :disenchant_items, :disenchant_skill_rank, :vendors,
+									:objective_of_quests,
+									:reward_from_quests,
+									:drop_creatures, 
+									:plans_for, :created_by
+			
+			alias_method :disenchants, :disenchant_items
+	
+			def initialize(elem, api = nil)
+				super(elem, api)
+				
+				@level 		= elem[:level].to_i
+				@quality 	= elem[:quality].to_i
+				@type 		= elem[:type]
+	
+				# Cost can be in gold, or tokens
+				@cost = ItemCost.new(elem%'cost') if (elem%'cost')
+		
+		
+		
+				# is costs really an array?
+				#@costs 		= []
+				#(elem/:cost).each do |cost|
+				#	@costs << ItemCost.new(cost)
+				#end
+				
+				etc = [
+					['disenchantLoot', 		'@disenchant_items', 		'item', 		DisenchantItem, true],
+					['objectiveOfQuests', '@objective_of_quests', 'quest', 		ItemQuest, false],
+					['rewardFromQuests', 	'@reward_from_quests', 	'quest', 		ItemQuest, false],
+					['vendors', 					'@vendors', 						'creature', ItemVendor, false],
+					['dropCreatures', 		'@drop_creatures', 			'creature', ItemDropCreature, false],
+					['plansFor', 					'@plans_for', 					'spell', 		ItemPlansFor, true],
+					['createdBy', 				'@created_by', 					'spell', 		ItemCreatedBy, true],
+				]
+				
+				etc.each do |b|
+					ele = b[0]
+					var = b[1]
+					list = b[2]
+					my_class = b[3]
+					requires_api = b[4]
+					
+					if elem%ele
+						tmp_arr = []
+						(elem%ele/list).each do |x|
+							if requires_api
+								tmp_arr << my_class.new(x, api)
+							else	
+								tmp_arr << my_class.new(x)
+							end
+						end
+						self.instance_variable_set(var, tmp_arr)
+					end
+				end
+	
+				if (elem%'disenchantLoot')
+					@disenchant_skill_rank = (elem%'disenchantLoot')[:requiredSkillRank].to_i 
+					
+					# @disenchant_items = []
+					# (elem%'disenchantLoot'/:item).each do |item|
+					# 	@disenchant_items << DisenchantItem.new(item)
+					# end
+				end
+		
+				# if (elem%'objectiveOfQuests')
+				# 	@objective_of_quests = []
+				# 	(elem%'objectiveOfQuests'/:quest).each do |quest|
+				# 		@objective_of_quests << ItemQuest.new(quest)
+				# 	end
+				# end
+				# 		
+				# if (elem%'rewardFromQuests')
+				# 	@reward_from_quests = []
+				# 	(elem%'rewardFromQuests'/:quest).each do |quest|
+				# 		@reward_from_quests << ItemQuest.new(quest)
+				# 	end
+				# end
+				# 
+				# if (elem%'vendors')
+				# 	@vendors = []
+				# 	(elem%'vendors'/:creature).each do |vendor|
+				# 		@vendors << ItemVendor.new(vendor)
+				# 	end
+				# end
+				# 		
+				# if (elem%'dropCreatures')
+				# 	@drop_creatures = []
+				# 	(elem%'dropCreatures'/:creature).each do |creature|
+				# 		@drop_creatures << ItemDropCreature.new(creature)
+				# 	end
+				# end
+				# 		
+				# if (elem%'plansFor')
+				# 	@plans_for = []
+				# 	(elem%'plansFor'/:spell).each do |plan|
+				# 		@plans_for << ItemPlansFor.new(plan)
+				# 	end
+				# end
+				# 		
+				# if (elem%'createdBy')
+				# 	@created_by = []
+				# 	(elem%'createdBy'/:spell).each do |c|
+				# 		@created_by << ItemCreatedBy.new(c)
+				# 	end
+				# end
+			end
+		end
+		
+		
+		
+		# Provides detailed item information
+		# Note that the item-tooltip.xml just returns an empty document when the item 
+		# can't be found.
+		class ItemTooltip < Item
+			attr_reader :desc, :overall_quality_id, :bonding, :max_count, #:id, :name, :icon, 
+									:class_id, :bonuses, :item_source,
+									:bonuses, :resistances,
+									:required_level,
+									:allowable_classes,
+									:armor, :durability,
+									:sockets, :socket_match_enchant,
+									:gem_properties
+			alias_method :description, :desc
+
+			def initialize(elem, api = nil)
+				super(elem, api)
+				@id									= (elem%'id').html.to_i
+				@name								= (elem%'name').html
+				@icon_base					= (elem%'icon').html
+				@desc								= (elem%'desc').html if (elem%'desc')
+				@overall_quality_id	= (elem%'overallQualityId').html.to_i
+				@bonding						= (elem%'bonding').html.to_i
+				@stackable					= (elem%'stackable').html.to_i if (elem%'stackable')
+				@max_count					= (elem%'maxCount').html.to_i if (elem%'maxCount')
+				@class_id						= (elem%'classId').html.to_i
+				@required_level			= (elem%'requiredLevel').html.to_i if (elem%'requiredLevel')
+				
+				@equipData					= ItemEquipData.new(elem%'equipData')
+				
+				# TODO: This appears to be a plain string at the moment
+				#<gemProperties>+26 Healing +9 Spell Damage and 2% Reduced Threat</gemProperties>
+				@gem_properties			= (elem%'gemProperties').html if (elem%'gemProperties')
+				
+				# not all items have damage data
+				@damage							= ItemDamageData.new(elem%'damageData') if !(elem%'damageData').html.empty?
+				
+				
+				# TODO: Test socket data with a variety of items
+				# TODO: replace with socket Class?
+				if (elem%'socketData')
+					@sockets = []
+					(elem%'socketData'/:socket).each do |socket|
+						@sockets << socket[:color]
+					end
+					
+					@socket_match_enchant = (elem%'socketData'%'socketMatchEnchant')
+				end
+				
+				
+				# When there is no data, stats are not present in @bonuses
+				# TODO: When there is no stats at all, @bonuses shouldn't be set
+				@bonuses = {}
+				
+				bonus_stats = {
+					:strength => :bonusStrength,
+					:agility => :bonusAgility,
+					:stamina => :bonusStamina,
+					:intellect => :bonusIntellect,
+					:spirit => :bonusSpirit
+				}
+				bonus_stats.each do |stat, xml_elem|
+					@bonuses[stat] = test_stat(elem/xml_elem) if test_stat(elem/xml_elem)
+				end
+				
+				# Resistances
+				@resistances = {}
+				
+				resist_stats = {
+					:arcane => :arcaneResist,
+					:fire => :fireResist,
+					:frost => :frostResist,
+					:holy => :holyResist,
+					:nature => :natureResist,
+					:shadow => :shadowResist
+				}
+				resist_stats.each do |stat, xml_elem|
+					@resistances[stat] = test_stat(elem/xml_elem) if test_stat(elem/xml_elem)
+				end
+				
+				
+				if (elem%'allowableClasses')
+					@allowable_classes = []
+					(elem%'allowableClasses'/:class).each do |klass|
+						@allowable_classes << klass.html
+					end
+				end
+				
+				# NOTE not representing armor bonus
+				@armor			= (elem%'armor').html.to_i 						if (elem%'armor')
+				
+				# NOTE not representing max
+				@durability	= (elem%'durability')[:current].to_i	if (elem%'durability')
+				
+				if (elem%'spellData')
+					@spells = []
+					(elem%'spellData'/:spell).each do |spell|
+						@spells << ItemSpell.new(spell)
+					end
+				end
+				
+				@setData = ItemSetData.new(elem%'setData') if (elem%'setData')
+		
+				# @item_sources = []
+				# (elem/:itemSource).each do |source|
+				# 	@item_sources << ItemSource.new(source)
+				# end
+				@item_source = ItemSource.new(elem%'itemSource') if (elem%'itemSource')	 # TODO: More than once source?
+			end
+	
+			private
+			def test_stat(elem)
+				if elem
+					if !elem.html.empty?
+						return elem.html.to_i
+					end
+				end
+				return nil
+			end
+		end
+
+		class ItemEquipData
+			attr_reader :inventory_type, :subclass_name, :container_slots
+
+			def initialize(elem)
+				@inventory_type = (elem%'inventoryType').html.to_i
+				@subclass_name = (elem%'subclassName').html if (elem%'subclassName')
+				@container_slots = (elem%'containerSlots').html.to_i if (elem%'containerSlots') # for baggies
+			end
+		end
+
+		class ItemSetData
+			attr_reader :name, :items, :set_bonuses
+			alias_method :to_s, :name
+			
+			def initialize(elem)
+				@name = elem[:name]
+		
+				@items = []
+				(elem/:item).each do |item|
+					@items << item[:name]
+				end
+		
+				@set_bonuses = []
+				(elem/:setBonus).each do |bonus|
+					@set_bonuses << ItemSetBonus.new(bonus)
+				end
+			end
+		end
+
+		class ItemSetBonus
+			attr_reader :threshold, :description
+			alias_method :desc, :description
+			alias_method :to_s, :description
+	
+			def initialize(elem)
+				@threshold = elem[:threshold].to_i
+				@description = elem[:desc]
+			end
+		end
+
+		class ItemSpell
+			attr_reader :trigger, :description
+			alias_method :desc, :description
+			alias_method :to_s, :description
+
+			def initialize(elem)
+				@trigger = (elem%'trigger').html.to_i
+				@description = (elem%'desc').html
+			end
+		end
+
+		class ItemDamageData
+			attr_reader :type, :min, :max, :speed, :dps
+
+			def initialize(elem)
+				@type 	= (elem%'damage'%'type').html.to_i
+				@min 		= (elem%'damage'%'min').html.to_i
+				@max 		= (elem%'damage'%'max').html.to_i
+				@speed 	= (elem%'speed').html.to_i
+				@dps 		= (elem%'dps').html.to_f
+			end
+		end
+
+		class ItemSource
+			attr_reader :value,
+									:area_id, :area_name,
+									:creature_id, :creature_name,
+									:difficulty, :drop_rate
+
+			def initialize(elem)
+				@value 					= elem[:value]
+				@area_id 				= elem[:areaId].to_i 			if elem[:areaId]
+				@area_name 			= elem[:areaName]					if elem[:areaName]
+				@creature_id 		= elem[:creatureId].to_i	if elem[:creatureId]
+				@creature_name 	= elem[:creatureName]			if elem[:creatureName]
+				@difficulty 		= elem[:difficulty]				if elem[:difficulty]
+				@drop_rate 			= elem[:dropRate].to_i		if elem[:dropRate]
+				@required_level	= elem[:reqLvl].to_i			if elem[:reqLvl]
+			end
+		end
+
+
+
+		# A really basic item type returned by searches
+		class SearchItem < Item
+			attr_reader :url, :rarity,
+									:source, :item_level, :relevance
+			alias_method :level, :item_level
+			
+			def initialize(elem, api = nil)
+				super(elem, api)
+				@rarity			= elem[:rarity].to_i
+				@url				= elem[:url]
+
+				@item_level	= elem.at("filter[@name='itemLevel']")[:value].to_i
+				@source			= elem.at("filter[@name='source']")[:value]
+				@relevance	= elem.at("filter[@name='relevance']")[:value].to_i
+			end
+		end
+
+
+
+
+		# <rewardFromQuests>
+		#   <quest name="Justice Dispensed" level="39" reqMinLevel="30" id="11206" area="Dustwallow Marsh" suggestedPartySize="0"></quest>
+		#   <quest name="Peace at Last" level="39" reqMinLevel="30" id="11152" area="Dustwallow Marsh" suggestedPartySize="0"></quest>
+		# </rewardFromQuests>
+		# TODO: Rename
+		class ItemQuest
+			attr_reader :name, :id, :level, :min_level, :area, :suggested_party_size
+	
+			def initialize(elem)
+				@name 			= elem[:name]
+				@id 				= elem[:id].to_i
+				@level 			= elem[:level].to_i
+				@min_level 	= elem[:min_level].to_i
+				@area 			= elem[:area]
+				@suggested_party_size = elem[:suggested_party_size].to_i
+			end
+		end
+
+
+
+		# Creatures that drop the item
+		# <creature name="Giant Marsh Frog" minLevel="1" type="Critter" maxLevel="1" dropRate="6" id="23979" classification="0" area="Dustwallow Marsh"></creature>
+		# <creature name="Nalorakk" minLevel="73" title="Bear Avatar" url="fl[source]=dungeon&amp;fl[difficulty]=normal&amp;fl[boss]=23576" type="Humanoid" maxLevel="73" dropRate="2" id="23576" classification="3" areaUrl="fl[source]=dungeon&amp;fl[boss]=all&amp;fl[difficulty]=normal&amp;fl[dungeon]=3805" area="Zul'Aman"></creature>
+		class ItemDropCreature
+			attr_reader :name, :id, :type, :min_level, :max_level, :drop_rate, :classification, :area
+	
+			def initialize(elem)
+				@name 					= elem[:name]
+				@id 						= elem[:id].to_i
+				@min_level 			= elem[:minLevel].to_i
+				@max_level 			= elem[:maxLevel].to_i
+				@drop_rate 			= elem[:dropRate].to_i
+				@classification = elem[:classification].to_i
+				@area 					= elem[:area]
+		
+				# optional boss stuff
+				@title 		= elem[:title]		if elem[:title] # TODO: not nil when no property?
+				@url			= elem[:url]			if elem[:url]
+				@type			= elem[:type]			if elem[:type] # Humanoid etc.
+				@area_url = elem[:areaUrl]	if elem[:areaUrl]
+			end	
+		end
+ 
+		# Cost can be gold or a set of required tokens
+		# See ItemCostToken
+		# <cost sellPrice="280" buyPrice="5600"></cost>
+		# <cost>
+		# 	<token icon="spell_holy_championsbond" id="29434" count="60"></token>
+		# </cost>
+		class ItemCost
+			attr_reader :buy_price, :sell_price, :tokens
+	
+			def initialize(elem)
+				@buy_price 	= elem[:buyPrice].to_i	if elem[:buyPrice]
+				@sell_price	= elem[:sellPrice].to_i	if elem[:sellPrice]
+		
+				if (elem%'token')
+					@tokens = []
+					(elem/:token).each do |token|
+						@tokens << ItemCostToken.new(token)
+					end
+				end
+			end
+		end
+
+		# <token icon="spell_holy_championsbond" id="29434" count="60"></token>
+		class ItemCostToken < Item
+			attr_reader :count
+	
+			def initialize(elem, api = nil)
+				super(elem)
+				# @id = elem[:id].to_i
+				# @icon_bse = elem[:icon]
+				@count = elem[:count].to_i
+			end
+		end
+
+		# <item name="Void Crystal" minCount="1" maxCount="2" icon="inv_enchant_voidcrystal" type="Enchanting" level="70" dropRate="6" id="22450" quality="4"></item>
+		class DisenchantItem < Item
+			attr_reader :level, :type, :drop_rate, :min_count, :max_count, :quality
+			# :name, :id, :icon, 
+	
+			def initialize(elem, api = nil)
+				super(elem, api)
+				# @name 			= elem[:name]
+				# @id 				= elem[:id].to_i
+				# @icon 			= elem[:icon]
+				@level 			= elem[:level].to_i
+				@type 			= elem[:type]
+				@drop_rate 	= elem[:dropRate].to_i
+				@min_count 	= elem[:minCount].to_i
+				@max_count 	= elem[:maxCount].to_i
+				@quality 		= elem[:quality].to_i
+			end
+		end
+		
+		
+		class ItemVendor
+			attr_reader :id, :name, :title, :type,
+									:area, :classification, :max_level, :min_level
+			alias_method :to_s, :name
+			alias_method :to_i, :id
+			
+			def initialize(elem)
+				@id 						= elem[:id].to_i
+				@name 					= elem[:name]
+				@title 					= elem[:title]
+				@type 					= elem[:type]
+				@area 					= elem[:area]
+				@classification = elem[:classification].to_i
+				@max_level 			= elem[:maxLevel].to_i
+				@min_level 			= elem[:minLevel].to_i
+			end
+		end
+
+
+
+		# TODO rename
+		# There is some sort of opposite relationship between PlansFor and CreatedBy
+		class ItemCreation < Item
+			attr_reader :item, :reagents
+			
+			def initialize(elem, api = nil)
+				super(elem, api)
+				
+				if (elem%'reagent')
+					@reagents = []
+					(elem/:reagent).each do |reagent|
+						@reagents << Reagent.new(reagent, api)
+					end
+				end
+			end
+		end
+
+		# (fold)
+		# <plansFor>
+		#   <spell name="Shadowprowler's Chestguard" icon="trade_leatherworking" id="42731">
+		#     <item name="Shadowprowler's Chestguard" icon="inv_chest_plate11" type="Leather" level="105" id="33204" quality="4"></item>
+		#     <reagent name="Heavy Knothide Leather" icon="inv_misc_leatherscrap_11" id="23793" count="10"></reagent>
+		#   </spell>
+		# </plansFor>
+		# (end)
+		class ItemPlansFor < ItemCreation
+			def initialize(elem, api = nil)
+				super(elem, api)
+				# TODO: Multiple items?
+				@item = CreatedItem.new(elem%'item')  if (elem%'item')
+			end			
+		end
+
+		# <createdBy>
+		# 	<spell name="Bracing Earthstorm Diamond" icon="temp" id="32867">
+		# 		<item requiredSkill="Jewelcrafting" name="Design: Bracing Earthstorm Diamond" icon="inv_scroll_03" type="Jewelcrafting" level="73" id="25903" requiredSkillRank="365" quality="1"></item>
+		# 		<reagent name="Earthstorm Diamond" icon="inv_misc_gem_diamond_04" id="25867" count="1"></reagent>
+		# 	</spell>
+		# </createdBy>
+		class ItemCreatedBy < ItemCreation
+			def initialize(elem, api = nil)
+				super(elem, api)
+				# TODO: Multiple items?
+				@item = PlanItem.new(elem%'item') if (elem%'item')
+			end
+		end
+
+
+		# <item name="Shadowprowler's Chestguard" icon="inv_chest_plate11" type="Leather" level="105" id="33204" quality="4"></item>
+		class CreatedItem < Item
+			attr_reader :type, :level, :quality
+			
+			def initialize(elem, api = nil)
+				super(elem, api)
+				@type = elem[:type]
+				@level = elem[:level].to_i
+				@quality = elem[:quality].to_i
+			end
+		end
+
+		# <item requiredSkill="Jewelcrafting" name="Design: Bracing Earthstorm Diamond" icon="inv_scroll_03" type="Jewelcrafting" level="73" id="25903" requiredSkillRank="365" quality="1"></item>
+		class PlanItem < Item
+			attr_reader :required_skill, :type, :required_skill_rank, :level, :quality
+			
+			def initialize(elem, api = nil)
+				super(elem, api)
+				@type = elem[:type]
+				@level = elem[:level].to_i
+				@quality = elem[:quality].to_i
+				@required_skill = elem[:requiredSkill]
+				@required_skill_rank = elem[:requiredSkillRank].to_i
+			end
+		end
+	
+		class Reagent < Item
+			attr_reader :count
+			
+			def initialize(elem, api = nil)
+				super(elem, api)
+				# @id = elem[:id].to_i
+				# @name = elem[:name]
+				# @icon = elem[:icon]
+				@count = elem[:count].to_i
+			end
+		end
+	end
+end