adam 1.3.1 → 1.4.0

data/lib/adam.rb

@@ -1,8 +1,9 @@
 module Adam
-  VERSION = '1.3.1'
+  VERSION = '1.4.0'
   
   autoload :Killmail, 'adam/killmail'
   autoload :KillLog, 'adam/kill_log'
   autoload :Kill, 'adam/kill'
   autoload :Killboard, 'adam/killboard'
+  autoload :Image, 'adam/image'
 end

data/lib/adam/image.rb

@@ -0,0 +1,83 @@
+require 'uri'
+require 'net/http'
+
+module Adam
+  
+  class Image
+    
+    @@character_portrait_uri  = "http://image.eveonline.com/Character/"
+    @@corporation_logo_uri    = "http://image.eveonline.com/Corporation/"
+    @@alliance_logo_uri       = "http://image.eveonline.com/Alliance/"
+    
+    # Retrieves a character portrait.
+    #
+    # Parameters:
+    # * +options+ - A hash with these keys:
+    #   * +id+ - An integer describing an EVE Online character id.
+    #   * +size+ - An integer describing what size to retrieve. Valid sizes are 32, 64, 128 or 256.
+    def self.character_portrait(options = {})
+      id    = options.fetch(:id)
+      size  = options.fetch(:size)
+      
+      raise ArgumentError, "Valid sizes are 32, 64, 128 or 256" unless [32, 64, 128, 256].include?(size)
+      
+      request(@@character_portrait_uri + "#{id}_#{size}.jpg")
+    end
+    
+    # Retrieves a corporation logo.
+    #
+    # Parameters:
+    # * +options+ - A hash with these keys:
+    #   * +id+ - An integer describing an EVE Online character id.
+    #   * +size+ - An integer describing what size to retrieve. Valid sizes are 32, 64, 128 or 256.
+    def self.corporation_logo(options = {})
+      id    = options.fetch(:id)
+      size  = options.fetch(:size)
+      
+      raise ArgumentError, "Valid sizes are 32, 64, 128 or 256" unless [32, 64, 128, 256].include?(size)
+      
+      request(@@corporation_logo_uri + "#{id}_#{size}.png")
+    end
+    
+    # Retrieves a alliance logo.
+    #
+    # Parameters:
+    # * +options+ - A hash with these keys:
+    #   * +id+ - An integer describing an EVE Online character id.
+    #   * +size+ - An integer describing what size to retrieve. Valid sizes are 32, 64 or 128.
+    def self.alliance_logo(options = {})
+      id    = options.fetch(:id)
+      size  = options.fetch(:size)
+      
+      raise ArgumentError, "Valid sizes are 32, 64 or 128" unless [32, 64, 128].include?(size)
+      
+      request(@@alliance_logo_uri + "#{id}_#{size}.png")
+    end
+    
+    private
+    
+    # Queries the EVE Online API for data.
+    #
+    # Parameters:
+    # * +uri+ - A string describing the URI to send a request to.
+    def self.request(uri)
+      uri = URI.parse(uri)
+      
+      response, body = nil, nil
+      Net::HTTP.new(uri.host, uri.port).start do |http|
+        tries = 0
+        begin
+          response, body = http.get("#{uri.path}?#{uri.query}")
+        rescue Timeout::Error
+          tries += 1
+          sleep 5
+          retry if tries < 3
+        end
+      end
+      
+      body
+    end
+    
+  end
+  
+end

metadata

@@ -4,9 +4,9 @@ version: !ruby/object:Gem::Version
   prerelease: false
   segments: 
   - 1
-  - 3
-  - 1
-  version: 1.3.1
+  - 4
+  - 0
+  version: 1.4.0
 platform: ruby
 authors: 
 - Johannes Gorset
@@ -14,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-10-04 00:00:00 +02:00
+date: 2010-10-07 00:00:00 +02:00
 default_executable: 
 dependencies: []
 
@@ -31,6 +31,7 @@ files:
 - db/factions.sql
 - db/items.sql
 - db/solar_systems.sql
+- lib/adam/image.rb
 - lib/adam/kill.rb
 - lib/adam/kill_log/validation_error.rb
 - lib/adam/kill_log.rb