jstewart-yammer4r 0.1.2

data/README

@@ -0,0 +1,16 @@
+= Yammer4R
+
+== Developers
+* {Jim Patterson} <jimp79 at gmail dot com>
+
+== Description
+Yammer4R provides an object based API to query or update your Yammer account via pure Ruby.  It hides the ugly HTTP/REST code from your code.
+
+== External Dependencies
+* Ruby 1.8 (tested with 1.8.7)
+* JSON gem (tested with versions: 1.1.3)
+* OAuth gem (tested with versions: 0.2.7)
+* RSpec gem (tested with versions: 1.1.11)
+
+== Usage Examples
+Coming soon...

data/example.rb

@@ -0,0 +1,17 @@
+require 'yammer'
+
+# Create a new Yammer Client
+yammer = Yammer::Client.new
+
+# Get all messages
+messages = yammer.messages
+puts messages.size
+puts messages.last.inspect
+
+# Print out all the users
+yammer.users.each do |u|
+  puts "#{u.name} - #{u.me?}"
+end
+
+
+

data/lib/ext/core_ext.rb

@@ -0,0 +1,30 @@
+class String
+  def to_boolean
+    case self
+    when 'true'
+      true
+    when 'false'
+      false
+    else
+      nil
+    end
+  end
+end
+
+class Hash
+  def symbolize_keys
+    inject({}) do |options, (key, value)|
+      options[(key.to_sym rescue key) || key] = value
+      options
+    end
+  end
+
+  def symbolize_keys!
+    self.replace(self.symbolize_keys)
+  end
+
+  def assert_has_keys(*valid_keys)
+    missing_keys = [valid_keys].flatten - keys
+    raise(ArgumentError, "Missing Option(s): #{missing_keys.join(", ")}") unless missing_keys.empty?
+  end
+end

data/lib/yammer/client.rb

@@ -0,0 +1,96 @@
+module Yammer
+  class Client
+    def initialize(options={})
+      options.assert_has_keys(:consumer, :access) unless options.has_key?(:config)
+      
+      yammer_url = options.delete(:yammer_host) || "https://yammer.com"
+      @api_path   = "/api/v1/"
+
+      if options[:config]
+        config              = YAML.load(open(options[:config]))
+        options[:consumer]  = config['consumer'].symbolize_keys
+        options[:access]    = config['access'].symbolize_keys
+      end
+
+      consumer = OAuth::Consumer.new(options[:consumer][:key], options[:consumer][:secret], :site => yammer_url)
+      @access_token = OAuth::AccessToken.new(consumer, options[:access][:token], options[:access][:secret])
+    end
+
+
+    # TODO: modularize message and user handling 
+    def messages(action = :all, params = {})
+      params.merge!(:resource => :messages)
+      params.merge!(:action => action) unless action == :all
+
+      parsed_response = JSON.parse(yammer_request(:get, params).body)
+      older_available = parsed_response['meta']['older_available']
+
+      ml = parsed_response['messages'].map do |m|
+         Yammer::Message.new(m)
+      end
+        Yammer::MessageList.new(ml, older_available, self)
+    end
+
+    # POST or DELETE a message
+    def message(action, params)
+      params.merge!(:resource => :messages)
+      yammer_request(action, params)
+    end
+
+    def users
+      JSON.parse(yammer_request(:get, {:resource => :users}).body).map do |u|
+        Yammer::User.new(u, self)
+      end
+    end
+
+    def user(id)
+      u = JSON.parse(yammer_request(:get, {:resource => :users, :id => id}).body)
+      Yammer::User.new(u, self)
+    end
+
+    def current_user
+      u = JSON.parse(yammer_request(:get, {:resource => :users, :action => :current}).body)
+      Yammer::User.new(u, self)
+    end
+    alias_method :me, :current_user
+
+    private
+
+    def yammer_request(http_method, options)
+      request_uri = @api_path + options.delete(:resource).to_s
+      [:action, :id].each {|k| request_uri += "/#{options.delete(k)}" if options.has_key?(k) }
+      request_uri += ".json"
+
+      if options.any?
+        request_uri += "?#{create_query_string(options)}" unless http_method == :post
+      end
+
+      if http_method == :post
+        handle_response(@access_token.send(http_method, request_uri, options))
+      else
+        handle_response(@access_token.send(http_method, request_uri))
+      end
+    end
+
+    def create_query_string(options)
+      options.map {|k, v| "#{OAuth::Helper.escape(k)}=#{OAuth::Helper.escape(v)}"}.join('&')
+    end
+
+    def handle_response(response)
+      # TODO: Write classes for exceptions
+      case response.code.to_i
+        when 200..201
+          response
+        when 400
+          raise "400 Bad request"
+        when 401
+          raise  "Authentication failed. Check your username and password"
+        when 503
+          raise "503: Service Unavailable"
+        else
+          raise "Error. HTTP Response #{response.code}"
+        end   
+    end
+
+  end
+end

data/lib/yammer/message.rb

@@ -0,0 +1,26 @@
+class Yammer::Message
+  
+  attr_reader :id, :url, :web_url, :replied_to_id, :thread_id,
+              :body_plain, :body_parsed, :message_type, :client_type,
+              :sender_id, :sender_type
+  
+  def initialize(m)
+    @id = m['id']
+    @url = m['url']
+    @web_url = m['web_url']
+    @replied_to_id = m['replied_to_id']
+    @thread_id = m['thread_id']
+    @body_plain = m['body']['plain']
+    @body_parsed = m['body']['parsed']
+    @message_type = m['message_type']
+    @client_type = m['client_type']
+    @sender_id = m['sender_id']
+    @sender_type = m['sender_type']
+    begin
+      @created_at = m['created_at']
+    rescue ArgumentError => e
+      @created_at = nil
+    end
+  end
+  
+end

data/lib/yammer/message_list.rb

@@ -0,0 +1,20 @@
+class Yammer::MessageList < Array
+  
+  attr_reader :older_available, :ids
+  
+  def initialize(a, oa, c)
+    super(a)
+    @older_available = oa
+    @client = c
+    @ids = a.map {|m| m.id}.sort
+  end
+  
+  def first
+    self[0]
+  end
+  
+  def last
+    self[self.size - 1]
+  end
+  
+end

data/lib/yammer/user.rb

@@ -0,0 +1,72 @@
+class Yammer::User
+  
+  attr_reader :id, :url, :web_url, :name, :full_name, :mugshot_url, 
+              :job_title, :location, :stats, :contact,
+              :hire_date, :birth_date, :network_name, :full_user
+ 
+  def initialize(u, c)
+    @client = c
+    @id = u['id']
+    @url = u['url']
+    @web_url = u['web_url']
+    @name = u['name']
+    @full_name = u['full_name']
+    @mugshot_url = u['mugshot_url']
+    @job_title = u['job_title']
+    # These attributes will be nil when User is a reference
+    @network_id = u['network_id']
+    @location = u['location']
+    @stats = u['stats']
+    @contact = u['contact']
+    @hire_date = u['hire_date']
+    @birth_date = u['birth_date']
+    @network_name = u['network_name']
+  end
+  
+  def network_id
+    get_full_user unless @network_id
+    @network_id
+  end
+  
+  def location
+    get_full_user unless @location
+    @location
+  end
+  
+  def stats
+    get_full_user unless @stats
+    @stats
+  end
+  
+  def contact
+    get_full_user unless @contact
+    @contact
+  end
+  
+  def hire_date
+    get_full_user unless @hire_date
+    @hire_date
+  end
+  
+  def birth_date
+    get_full_user unless @birth_date
+    @birth_date
+  end
+  
+  def network_name
+    get_full_user unless @network_name
+    @network_name
+  end
+  
+  def me?
+    @id == @client.me.id
+  end
+  
+  private
+  def get_full_user
+    response = @client.access_token.get "/api/v1/users/#{id}.json"
+    u = JSON.parse(response.body)
+    initialize(u, @client)
+  end
+  
+end

data/lib/yammer4r.rb

@@ -0,0 +1,13 @@
+require('rubygems')
+require('date')
+require('yaml')
+require('open-uri')
+require('json')
+require('oauth')
+
+$:.unshift(File.dirname(__FILE__))
+require('ext/core_ext')
+require('yammer/client')
+require('yammer/message')
+require('yammer/message_list')
+require('yammer/user')

data/oauth.yml.template

@@ -0,0 +1,7 @@
+consumer:
+  key: CLIENT_KEY
+  secret: CLIENT_SECRET
+  
+access:
+  token: CONSUMER_TOKEN
+  secret: CONSUMER_SECRET

metadata

@@ -0,0 +1,81 @@
+--- !ruby/object:Gem::Specification 
+name: jstewart-yammer4r
+version: !ruby/object:Gem::Version 
+  version: 0.1.2
+platform: ruby
+authors: 
+- Jim Patterson
+- Jason Stewart
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-02-18 00:00:00 -08:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: json
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.1.3
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: oauth
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.2.7
+    version: 
+description: Yammer4R provides an object based API to query or update your Yammer account via pure Ruby.  It hides the ugly HTTP/REST code from your code.
+email: jimp79@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- README
+- example.rb
+- oauth.yml.template
+- lib/yammer4r.rb
+- lib/yammer/client.rb
+- lib/yammer/message.rb
+- lib/yammer/message_list.rb
+- lib/yammer/user.rb
+- lib/ext/core_ext.rb
+has_rdoc: false
+homepage: http://github.com/jpatterson/yammer4r
+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: Yammer access for ruby
+test_files: []
+