dambalah-openaim 2009.03.24

data/README

@@ -0,0 +1,13 @@
+OpenAIM Ruby Library
+
+Very basic. Only has Presence API for now. For more info on OpenAIM Presence API, check out http://dev.aol.com/aim/presence
+
+Disclaimer: I don't have the need for more than the presence API now so I don't intend to add more than that functionality to the gem.
+
+Example:
+require 'rubygems'
+require 'openaim'
+
+presence = OpenAIM::Presence.new('YOUR OPEN AIM API KEY')
+user = presence.get('aim_username')
+puts "User is #{user.status}"

data/lib/openaim.rb

@@ -0,0 +1,7 @@
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+ 
+module OpenAIM
+  VERSION = '2009.03.24'
+end
+
+require 'openaim/presence.rb'

data/lib/openaim/presence.rb

@@ -0,0 +1,73 @@
+require 'rubygems'
+require 'xmlsimple'
+require 'net/http'
+
+module OpenAIM
+  
+  PRESENCE_BASE_URL = 'http://api.oscar.aol.com/presence/'
+  
+  class Presence
+  
+    attr_reader :key
+    
+    def initialize(key)
+      @key = key
+    end
+    
+    def get(usernames)      
+      usernames = [usernames] if usernames.class == String
+      
+      url = PRESENCE_BASE_URL + "get?k=#{self.key}&f=xml"
+      usernames.each do |username|
+        url << "&t=#{username}"
+      end
+            
+      xml_data = Net::HTTP.get_response(URI.parse(url)).body
+      
+      data = XmlSimple.xml_in(xml_data)
+      
+      users = []
+      data['data'][0]["users"][0]['user'].each do |item|
+        user = OpenAIM::User.new
+        user.aim_id = item["aimId"][0] if item["aimId"]
+        user.display_id = item["displayId"][0] if item["displayId"]
+        user.status = item["state"][0] if item["state"]
+        user.online_time = item["onlineTime"][0] if item["onlineTime"]
+        user.away_time = item["awayTime"][0] if item["awayTime"]
+        user.user_type = item["userType"][0] if item["userType"]
+        user.buddy_icon = item["buddyIcon"][0] if item["buddyIcon"]
+        user.presence_icon = item["presenceIcon"][0] if item["presenceIcon"]
+        users << user  
+      end
+
+      if users.size == 1
+        users[0]
+      else
+        users
+      end
+    end
+  
+  end
+  
+  
+  class User
+    attr_accessor :aim_id, :display_id, :status, :online_time, :away_time, :user_type, :buddy_icon, :presence_icon
+  
+    def initialize
+      @aim_id = ''
+      @display_id = ''
+      @status = ''
+      @online_time = ''
+      @away_time = ''
+      @user_type = ''
+      @buddy_icon = ''
+      @presence_icon = ''
+    end
+    
+    def is_online?
+      @status == 'online'
+    end
+
+  end
+
+end

data/openaim.gemspec

@@ -0,0 +1,21 @@
+Gem::Specification.new do |s|
+  s.name = "openaim"
+  s.version = "2009.03.24"
+ 
+  s.summary = "OpenAIM is a simple ruby library for OpenAIM API."
+  s.description = "Ruby library for openaim - only Presence API implemented so far."
+  s.platform = "ruby"
+  s.has_rdoc = true
+  s.author = "Luc Castera"
+  s.email = "luc.castera@gmail.com"
+  s.homepage = "http://github.com/dambalah/openaim"
+  s.require_path = "lib"
+  s.add_dependency('xml-simple', '>= 1.0.11')
+ 
+  s.files = [
+    "README",
+    "lib/openaim.rb",
+    "lib/openaim/presence.rb",
+    "openaim.gemspec"
+  ]
+end

metadata

@@ -0,0 +1,65 @@
+--- !ruby/object:Gem::Specification 
+name: dambalah-openaim
+version: !ruby/object:Gem::Version 
+  version: 2009.03.24
+platform: ruby
+authors: 
+- Luc Castera
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-03-21 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: xml-simple
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.0.11
+    version: 
+description: Ruby library for openaim - only Presence API implemented so far.
+email: luc.castera@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- README
+- lib/openaim.rb
+- lib/openaim/presence.rb
+- openaim.gemspec
+has_rdoc: true
+homepage: http://github.com/dambalah/openaim
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: OpenAIM is a simple ruby library for OpenAIM API.
+test_files: []
+