yam 1.0.0 → 1.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: dfcfc553032f8390dc3e9152712c014c2e2121e3
+  data.tar.gz: 542b4d2bc6af453b05f4be934e4cb30616562354
+SHA512:
+  metadata.gz: c067db8b3bb4ccd6b0841826218620127c5b806771589dc446415960be20cc999cfee10c51750653cda64034fd70a527394eb111ae0103629bbf01c0d76421f0
+  data.tar.gz: 450d9ec398c7f513cdd1d8b612f63ee06ac6327a1dafd2d4efb239b5c0dcf16489f7d064224d4c741c3b0aefe0a95897c5caf11e03a485bb1e28c43e0b0e6ac2

checksums.yaml.gz.sig

@@ -0,0 +1 @@
+��<c2im��I/Ȳ&���3�(��L6��q׷�?I���E�;� �"�������cC�q��k�QKx/

data/.travis.yml

@@ -5,7 +5,6 @@ rvm:
   - 1.9.2
   - 1.8.7
   - ree
-  - rbx-19mode
 branches:
   only:
     - master

data/README.md

@@ -1,14 +1,13 @@
 Yam
 =============
+
 [![Gem Version](https://badge.fury.io/rb/yam.png)](http://badge.fury.io/rb/yam)
-[![Build Status](https://travis-ci.org/yammer/yam.png?branch=master)][travis]
+[![Build Status](https://travis-ci.org/yammer/yam.png?branch=master)](https://travis-ci.org/yammer/yam)
 [![Coverage Status](https://coveralls.io/repos/yammer/yam/badge.png)](https://coveralls.io/r/yammer/yam)
+[![Code Climate](https://codeclimate.com/github/yammer/yam.png)](https://codeclimate.com/github/yammer/yam)
 
-[gemversion]: (http://badge.fury.io/rb/yam)
-[travis]: (https://travis-ci.org/yammer/yam)
-[coveralls]: (https://coveralls.io/r/yammer/yam)
 
-A Yammer Ruby gem
+The Yammer Ruby gem
 
 ## Documentation
 
@@ -45,7 +44,7 @@ The Yammer API requires authentication for access to certain endpoints. Below ar
 
 ### Register your application
 
-Setup a Yammer client application as described in [Build your first Yammer App](https://developer.yammer.com/introduction/)
+Setup a Yammer client application as described on the [Yammer Developer site](https://developer.yammer.com/introduction/)
 
 ### Obtaining an access token
 
@@ -59,23 +58,11 @@ Setup a Yammer client application as described in [Build your first Yammer App](
 
 5. The authorization server will respond with an access token
 
-```
+```ruby
 "access_token": {
-  "view_subscriptions": true,
-  "expires_at": null,
-  authorized_at": "2011/04/06 16:25:46 +0000",
-  "modify_subscriptions": true,
-  "modify_messages": true,
-  "network_permalink": "yammer-inc.com",
-  "view_members": true,
-  "view_tags": true,
-  "network_id": 155465488,
-  "user_id": 1014216,
-  "view_groups": true,
-  "token": "abcdefghijklmn",
-  "network_name": "Yammer",
-  "view_messages": true,
-  "created_at": "2011/04/06 16:25:46 +0000"
+  ...
+  "token": "abcxyz12345",
+  ...
 }
 ```
 
@@ -96,102 +83,149 @@ You may change this configuration by using the `configure` method
 Yammer.configure do |c|
   c.client_id = '[client_id]'
   c.client_secret = '[client_secret]'
-  c.token = '[access_token]'
 end
 #> Yammer 
 ```
 
-At this point, your new settings will take effect
+At this point, your new settings will take effect.
 
 ```ruby
 Yammer.options
-#> {:site_url=>"https://www.yammer.com", :client_id=>'[client_id]', :client_secret=>'[client_secret]', :access_token=>'[access_token]', :http_adapter=>Yammer::Connection, :connection_options=>{ :max_redirects=>5, :use_ssl=>true }} 
+#> {:site_url=>"https://www.yammer.com", :client_id=>'[client_id]', :client_secret=>'[client_secret]', :access_token=>nil, :http_adapter=>Yammer::Connection, :connection_options=>{ :max_redirects=>5, :use_ssl=>true }} 
 ```
+Take note of the fact that the `access_token` is nil. This will need to be set and, in the next section, we will see how to do this.
 
 ## Usage
 
- `yammer-client` provides two ways to access Yammer's API. One of these ways is by using HTTP helper methods on and instance of `Yammer::Client`. The other 
- way is using methods on the object models that come bundled with this gem.
+- This gem offers three ways to interact Yammer's API:
+  - Calling methods on the Yammer i.e `Yammer`
+  - Calling methods on an instance of `Yammer::Client`.
+  - Calling methods on the custom object models (Experimental)
 
-### Using the client
+### Calling methods on the Yammer module 
+In order for this to work, you will need to set up your access_token. This assumes that you already configured the client with your default options as was described above.
 
-1. Create an instance of the Yammer client
+ ```ruby
+# set up your access token
+Yammer.configure do |c|
+  c.access_token = '[access_token]'
+end
+#=> <Yammer: {:http_adapter=>Yammer::HttpAdapter, :client_secret=>"[client_secret]", :access_token=>"[access_token]", :site_url=>"https://www.yammer.com", :connection_options=>{:max_redirects=>5, :verify_ssl=>true}, :default_headers=>{"Accept"=>"application/json", "User-Agent"=>"Yammer Ruby Gem 0.1.8"}, :client_id=>"[client_id]"}>
 
-```ruby
-yamr = Yammer::Client.new(
-        :client_id     => 'vAbMcg9qjgKsp4jjpm1pw',
-        :client_secret => 'Wn0kp7Lu0TCY4GtZWkmSsqGErg10DmMADyjWkf2U',
-        :access_token  => 'HqsKG3ka9Uls2DxahNi78A'
-      )
+# get the current user
+Yammer.current_user
 ```
 
-2. Call methods on the instance:
+### Calling methods on an instance of Yammer::Client
+NOTE: Use this if you wish to create multiple client instances with diffrent client_id, client_secret and access token.
+If your application uses a signle pair of client_id and client_secret credentials, you ONLY need to sepecify the access token 
 
-**User**
-
-*find a user by email*
+- Create an instance of the Yammer client
 
 ```ruby
-yamr.get_user_by_email('user@example.com')
-#<Yammer::ApiResponse:0x007fb949434ec8 @headers=#<Net::HTTPOK 200 OK readbody=true>, @body="[JSON Response]", @code=200>
-```
+# create a client instance using the access token: HqsKG3ka9Uls2DxahNi78A
+yamr = Yammer::Client.new(:access_token  => 'HqsKG3ka9Uls2DxahNi78A')
 
-*find a user by user id*
 
-```ruby
-yamr.get_user('1588')
-#<Yammer::ApiResponse:0x007fb949434ec8 @headers=#<Net::HTTPOK 200 OK readbody=true>, @body="[JSON Response]", @code=200>
-```
+# create multiple clients, each using a different access token
+client1 = Yammer::Client.new(:access_token  => 'fG4mhFDf2GUUptztU0Qo9g')
 
-*get the current user*
+client2 = Yammer::Client.new(:access_token  => 'ruZy4vFYyTWqnx7adO9ow')
 
-```ruby
-yamr.current_user
-#<Yammer::ApiResponse:0x007fb949434ec8 @headers=#<Net::HTTPOK 200 OK readbody=true>, @body="[JSON Response]", @code=200>
 ```
 
+- Call methods on the instance:
 
-**Message**
+  - **User**
 
-*post a update as the current user*
+    - *find a user by email*
 
-```ruby
-yamr.create_message('status update')
-#<Yammer::ApiResponse:0x007fb949434ec8 @headers=#<Net::HTTPOK 200 OK readbody=true>, @body="[JSON Response]", @code=200>
-```
+    ```ruby
+    yamr.get_user_by_email('user@example.com')
+    #<Yammer::ApiResponse:0x007fb949434ec8 @headers=#<Net::HTTPOK 200 OK readbody=true>, @body="[JSON Response]", @code=200>
+    ```
 
-*send a private message to another Yammer user*
+    - *find a user by user id*
 
-```ruby
-yamr.create_message('private message', :direct_to_id => 24)
-#<Yammer::ApiResponse:0x007fb949434ec8 @headers=#<Net::HTTPOK 200 OK readbody=true>, @body="[JSON Response]", @code=200>
-```
+    ```ruby
+    yamr.get_user('1588')
+    #<Yammer::ApiResponse:0x007fb949434ec8 @headers=#<Net::HTTPOK 200 OK readbody=true>, @body="[JSON Response]", @code=200>
+    ```
 
-*send a message with an Open Graph Object as an attachment*
+    - *get the current user*
 
-```ruby
-yamr.create_message('here is my open graph object', :og_url => "https://www.yammer.com/example/graph/31415926")
-#<Yammer::ApiResponse:0x007fb949434ec8 @headers=#<Net::HTTPOK 200 OK readbody=true>, @body="[JSON Response]", @code=200>
-```
+    ```ruby
+    yamr.current_user
+    #<Yammer::ApiResponse:0x007fb949434ec8 @headers=#<Net::HTTPOK 200 OK readbody=true>, @body="[JSON Response]", @code=200>
+    ```
 
+  - **Message**
 
-**Search**
+    - *post a update as the current user*
 
-*search for a term within the context of current user*
+    ```ruby
+    yamr.create_message('status update')
+    #<Yammer::ApiResponse:0x007fb949434ec8 @headers=#<Net::HTTPOK 200 OK readbody=true>, @body="[JSON Response]", @code=200>
+    ```
 
-```ruby
-yamr.search(:search => 'thekev', :model_types => 'users;groups')
-#<Yammer::ApiResponse:0x007fb949434ec8 @headers=#<Net::HTTPOK 200 OK readbody=true>, @body="[JSON Response]", @code=200>
-```
+    - *send a private message to another Yammer user*
 
-**Thread**
+    ```ruby
+    yamr.create_message('private message', :direct_to_id => 24)
+    #<Yammer::ApiResponse:0x007fb949434ec8 @headers=#<Net::HTTPOK 200 OK readbody=true>, @body="[JSON Response]", @code=200>
+    ```
 
-*fetch a thread with a given id*
+    - *send a message with an Open Graph Object as an attachment*
 
-```ruby
-yamr.get_thread(42)
-#<Yammer::ApiResponse:0x007fb949434ec8 @headers=#<Net::HTTPOK 200 OK readbody=true>, @body="[JSON Response]", @code=200>
-```
+    ```ruby
+    yamr.create_message('here is my open graph object', :og_url => "https://www.yammer.com/example/graph/31415926")
+    #<Yammer::ApiResponse:0x007fb949434ec8 @headers=#<Net::HTTPOK 200 OK readbody=true>, @body="[JSON Response]", @code=200>
+    ```
+
+
+  - **Search**
+
+    - *search for a term within the context of current user*
+
+    ```ruby
+    yamr.search(:search => 'thekev', :model_types => 'users;groups')
+    #<Yammer::ApiResponse:0x007fb949434ec8 @headers=#<Net::HTTPOK 200 OK readbody=true>, @body="[JSON Response]", @code=200>
+    ```
+
+  - **Thread**
+
+    - *fetch a thread with a given id*
+
+    ```ruby
+    yamr.get_thread(42)
+    #<Yammer::ApiResponse:0x007fb949434ec8 @headers=#<Net::HTTPOK 200 OK readbody=true>, @body="[JSON Response]", @code=200>
+    ```
+
+  - **Activity**
+
+    - *create and post an activity*
+
+    ```ruby
+    yamr.create_activity(
+      activity: {
+        actor: {
+          name: 'John Doe',
+          email: 'jdoe@yammer-inc.com'
+        },
+        action: 'create',
+        object: {
+          url: 'www.example.com',
+          title: 'Example event name',
+        },
+        message: 'Posting activity',
+        users: [{
+          name: 'Example Invitee',
+          email: 'example@yammer-inc.com'
+        }]
+      }
+    )
+    #<Yammer::ApiResponse:0x007fb949434ec8 @headers=#<Net::HTTPOK 200 OK readbody=true>, @body="[JSON Response]", @code=200>
+    ```
 
 
 ### Using the object models (Experimental)
@@ -199,56 +233,56 @@ yamr.get_thread(42)
 The object model is an abstraction that makes it easy to manipulate the JSON data return when accessing Yammer's API. Each model has accessor methods for all keys contained in the JSON response for a given model type. 
 
 
-**User**
+  - **User**
 
-*get the current user*
+    - *get the current user*
 
 
-```ruby
-u = Yammer::User.current
-#> <Yammer::User:0x007f9f4b0c39c8>
+    ```ruby
+    u = Yammer::User.current
+    #> <Yammer::User:0x007f9f4b0c39c8>
 
-u.full_name
-#> 'Kevin Mutyaba'
+    u.full_name
+    #> 'Kevin Mutyaba'
 
-u.update!(:job_title => 'k0dR')
-```
+    u.update!(:job_title => 'k0dR')
+    ```
 
 
-**Thread**
+  - **Thread**
 
-*fetch a thread with a given id*
+    - *fetch a thread with a given id*
 
-```ruby
-t = Yammer::Thread.get(3)
-```
+    ```ruby
+    t = Yammer::Thread.get(3)
+    ```
 
-View the participants in the thread
+    View the participants in the thread
 
-```ruby
-parts = t.participants
-#> [{:type=>"user", :id=>18}, {:type=>"user", :id=>64}]
-```
+    ```ruby
+    parts = t.participants
+    #> [{:type=>"user", :id=>18}, {:type=>"user", :id=>64}]
+    ```
 
-View the participants in the thread as user object models
+    View the participants in the thread as user object models
 
-```ruby
-peepl = t.people
-#> [#<Yammer::User:0x007f9f4c086630 @modified_attributes={}, @attrs={}, @new_record=false, @id=18>, #<Yammer::User:0x007f9f4c086568 @modified_attributes={}, @attrs={}, @new_record=false, @id=64>] 
-```
+    ```ruby
+    peepl = t.people
+    #> [#<Yammer::User:0x007f9f4c086630 @modified_attributes={}, @attrs={}, @new_record=false, @id=18>, #<Yammer::User:0x007f9f4c086568 @modified_attributes={}, @attrs={}, @new_record=false, @id=64>] 
+    ```
 
-Object models are lazyly loaded. Calling an accessor on a model will hydrate it
+    Object models are lazyly loaded. Calling an accessor on a model will hydrate it
 
-```ruby
-peepl[0]
-#> #<Yammer::User:0x007f9f4c086568 @modified_attributes={}, @attrs={}, @new_record=false, @id=18> 
+    ```ruby
+    peepl[0]
+    #> #<Yammer::User:0x007f9f4c086568 @modified_attributes={}, @attrs={}, @new_record=false, @id=18> 
 
-peepl[0].permalink
-#> 'thekev'
+    peepl[0].permalink
+    #> 'thekev'
 
-peepl[0]
-#=> #<Yammer::User:0x007f9f4c086568 @modified_attributes={}, @attrs={:last_name=>"Mutyaba", :network_id=>1, :first_name=>"Kevin", :id => 18,  :permalink=>"thekev" }, @network_id=1, @first_name="Kev", @full_name="Tiaba", @permalink="thekev", @id=18 > 
-```
+    peepl[0]
+    #=> #<Yammer::User:0x007f9f4c086568 @modified_attributes={}, @attrs={:last_name=>"Mutyaba", :network_id=>1, :first_name=>"Kevin", :id => 18,  :permalink=>"thekev" }, @network_id=1, @first_name="Kev", @full_name="Tiaba", @permalink="thekev", @id=18 > 
+    ```
 
 ## Supported Ruby Versions
 This library aims to support and is [tested against][travis] the following Ruby

data/lib/yammer/api/activity.rb

@@ -0,0 +1,61 @@
+# Copyright (c) Microsoft Corporation
+# All rights reserved.
+# Licensed under the Apache License, Version 2.0 (the "License"); 
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 
+#
+# THIS CODE IS PROVIDED *AS IS* BASIS, WITHOUT WARRANTIES OR 
+# CONDITIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING 
+# WITHOUT LIMITATION ANY IMPLIED WARRANTIES OR CONDITIONS OF TITLE,
+# FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABLITY OR NON-INFRINGEMENT. 
+
+# See the Apache Version 2.0 License for specific language governing
+# permissions and limitations under the License.
+
+module Yammer
+  module Api
+    module Activity
+
+      # @see https://developer.yammer.com/opengraph
+      # @rate_limited Yes
+      # @authentication Requires user context
+      # @raise  [Yammer::Error::Unauthorized] Error raised when supplied user credentials are not valid.
+      # @return [Yammer::ApiResponse]
+      # @param [Hash] opts the opts to post the activity with
+      # @option opts [Hash] actor The user performing the action
+      # @option actor [String] :email
+      # @option actor [String] :name
+      # @option opts [Hash] object The object on which the action is being performed
+      # @option object [String] :url
+      # @option object [String] :title
+      # @option opts [String] :action
+      # @option opts [Array<Hash>] :users
+      # @option users [String] :name
+      # @option users [String] :email
+      # @option opts [Boolean] :private
+      # @option opts [String] :message
+      # @example Create a new public group
+      #   Yammer.create_activity(
+      #     activity: {
+      #        actor: {
+      #        name: 'John Doe',
+      #        email: 'jdoe@yammer-inc.com'
+      #        },
+      #      action: 'create',
+      #        object: {
+      #          url: 'www.example.com',
+      #          title: 'Example name',
+      #        }
+      #      },
+      #      message: 'Posting activity',
+      #      users: [{
+      #        name: 'Example Invitee',
+      #        email: 'example@yammer-inc.com'
+      #      }]
+      #    }
+      def create_activity(opts = {})
+        post('/api/v1/activity', opts)
+      end
+    end
+  end
+end

data/lib/yammer/api/message.rb

@@ -195,6 +195,32 @@ module Yammer
         get("/api/v1/messages/liked_by/#{id}", opts)
       end
 
+      # @see https://developer.yammer.com/restapi/#rest-messages
+      # @api_path /api/v1/messages/liked_by/current.json?message_id=[:id]
+      # @rate_limited Yes
+      # @authentication Requires user context
+      # @raise  [Yammer::Error::Unauthorized] Error raised when supplied user credentials are not valid.
+      # @return [Yammer::ApiResponse]
+      # @param id [Integer] the ID of the message for which you want the current user to mark as liked
+      # @example Marks the specified message as liked by the current user
+      #   msgs = Yammer.like_message(10)
+      def like_message(id)
+        post("/api/v1/messages/liked_by/current.json?message_id=#{id}", {})
+      end
+
+      # @see https://developer.yammer.com/restapi/#rest-messages
+      # @api_path /api/v1/messages/liked_by/current.json?message_id=[:id]
+      # @rate_limited Yes
+      # @authentication Requires user context
+      # @raise  [Yammer::Error::Unauthorized] Error raised when supplied user credentials are not valid.
+      # @return [Yammer::ApiResponse]
+      # @param id [Integer] the ID of the message for which you want the current user to remove the like mark
+      # @example Removes the like mark on the specified message for the current user
+      #   msgs = Yammer.like_message(10)
+      def unlike_message(id)
+        delete("/api/v1/messages/liked_by/current.json?message_id=#{id}", {})
+      end
+
       # @see https://developer.yammer.com/restapi/#rest-messages
       # @api_path /api/v1/messages
       # @rate_limited Yes

data/lib/yammer/api.rb

@@ -12,6 +12,7 @@
 # See the Apache Version 2.0 License for specific language governing
 # permissions and limitations under the License.
 
+require 'yammer/api/activity'
 require 'yammer/api/user'
 require 'yammer/api/group'
 require 'yammer/api/group_membership'
@@ -26,4 +27,4 @@ require 'yammer/api/notification'
 require 'yammer/api/pending_attachment'
 require 'yammer/api/invitation'
 require 'yammer/api/subscription'
-require 'yammer/api/open_graph_object'
+require 'yammer/api/open_graph_object'

data/lib/yammer/client.rb

@@ -35,6 +35,7 @@ module Yammer
     include Yammer::Api::PendingAttachment
     include Yammer::Api::Subscription
     include Yammer::Api::OpenGraphObject
+    include Yammer::Api::Activity
 
     attr_reader :site_url, :default_headers, :connection_options
 

data/lib/yammer/group.rb

@@ -1,13 +1,13 @@
 # Copyright (c) Microsoft Corporation
 # All rights reserved.
-# Licensed under the Apache License, Version 2.0 (the "License"); 
+# Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 
+# You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
 #
-# THIS CODE IS PROVIDED *AS IS* BASIS, WITHOUT WARRANTIES OR 
-# CONDITIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING 
+# THIS CODE IS PROVIDED *AS IS* BASIS, WITHOUT WARRANTIES OR
+# CONDITIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING
 # WITHOUT LIMITATION ANY IMPLIED WARRANTIES OR CONDITIONS OF TITLE,
-# FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABLITY OR NON-INFRINGEMENT. 
+# FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABLITY OR NON-INFRINGEMENT.
 
 # See the Apache Version 2.0 License for specific language governing
 # permissions and limitations under the License.
@@ -15,13 +15,13 @@
 module Yammer
   class Group < Yammer::Base
 
-    attr_accessor_deffered :show_in_directory, :privacy, :description, :creator_type, 
-    :creator_id, :mugshot_id, :stats, :state, :web_url, :name, :created_at, :type, 
+    attr_accessor_deffered :show_in_directory, :privacy, :description, :creator_type,
+    :creator_id, :mugshot_id, :stats, :state, :web_url, :name, :created_at, :type,
     :mugshot_url, :url, :full_name, :mugshot_url_template, :description
 
     # @!scope class
     def self.create(params={})
-      result = api_handler.create_group(params)
+      api_handler.create_group(params)
     end
   end
-end
+end

data/lib/yammer/version.rb

@@ -15,7 +15,7 @@
 module Yammer
   class Version
     MAJOR = 1 unless defined? Yammer::MAJOR
-    MINOR = 0 unless defined? Yammer::MINOR
+    MINOR = 1 unless defined? Yammer::MINOR
     PATCH = 0 unless defined? Yammer::PATCH
     PRE = nil unless defined? Yammer::PRE
 

data/lib/yammer.rb

@@ -44,4 +44,7 @@ module Yammer
     end
   end
 end
+
+Yam = Yammer
+
 Yammer.reset!

data/spec/api/activity_spec.rb

@@ -0,0 +1,60 @@
+# -*- encoding: utf-8 -*-
+
+# Copyright (c) Microsoft Corporation
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# THIS CODE IS PROVIDED *AS IS* BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
+# ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION ANY
+# IMPLIED WARRANTIES OR CONDITIONS OF TITLE, FITNESS FOR A PARTICULAR
+# PURPOSE, MERCHANTABLITY OR NON-INFRINGEMENT.
+#
+# See the Apache Version 2.0 License for specific language governing
+# permissions and limitations under the License.
+
+require File.expand_path('../../spec_helper', __FILE__)
+require 'ostruct'
+
+describe Yammer::Api::Activity do
+
+  before :all do
+    @client = Yammer::Client.new(
+      :site_url     => 'https://yammer.com',
+      :client_id     => 'PRbTcg9qjgKsp4jjpm1pw',
+      :client_secret => 'Xn7kp7Ly0TCY4GtZWkmSsqGEPg10DmMADyjWkf2U',
+      :access_token  => 'TolNOFka9Uls2DxahNi78A'
+    )
+  end
+
+  subject { @client }
+
+  describe '#create_activity' do
+    it 'should post activity' do
+      params = {
+        activity: {
+          actor: {
+          name: 'John Doe',
+          email: 'jdoe@yammer-inc.com'
+          },
+        action: 'create',
+          object: {
+            url: 'www.example.com',
+            title: 'Example event name',
+          }
+        },
+        message: 'Posting activity',
+        users: [{
+          name: 'Example Invitee',
+          email: 'example@yammer-inc.com'
+        }]
+      }
+      subject.should_receive(:post).with('/api/v1/activity', params)
+      @client.create_activity(params)
+    end
+  end
+end

data/spec/api/message_spec.rb

@@ -127,6 +127,20 @@ describe Yammer::Api::Message do
     end
   end
 
+  describe '#like_message' do
+    it 'should like the message as a the specified user' do
+      subject.should_receive(:post).with('/api/v1/messages/liked_by/current.json?message_id=97', {})
+      subject.like_message(97)
+    end
+  end
+
+  describe '#unlike_message' do
+    it 'should unlike the message as a the specified user' do
+      subject.should_receive(:delete).with('/api/v1/messages/liked_by/current.json?message_id=97', {})
+      subject.unlike_message(97)
+    end
+  end
+
   describe '#messages_in_thread' do
     it 'should fetch messages in thread' do
       subject.should_receive(:get).with('/api/v1/messages/in_thread/97', {})

data/spec/api/user_spec.rb

@@ -25,38 +25,38 @@ describe Yammer::Api::User do
   before :all do
     @client = Yammer::Client.new(
       :site_url     => 'https://yammer.com',
-      :client_id     => "PRbTcg9qjgKsp4jjpm1pw",
-      :client_secret => "Xn7kp7Ly0TCY4GtZWkmSsqGEPg10DmMADyjWkf2U",
-      :access_token  => "TolNOFka9Uls2DxahNi78A"
+      :client_id     => 'PRbTcg9qjgKsp4jjpm1pw',
+      :client_secret => 'Xn7kp7Ly0TCY4GtZWkmSsqGEPg10DmMADyjWkf2U',
+      :access_token  => 'TolNOFka9Uls2DxahNi78A'
     )
   end
 
   subject { @client }
 
-  describe "users" do
-    it "makes an http request" do
+  describe 'all_users' do
+    it 'makes an http request' do
       @client.should_receive(:get).with('/api/v1/users', { :page => 1, :letter => 'm' })
       @client.all_users({:page => 1, :letter => 'm'})
     end
   end
 
-  describe "create_user" do
-    it "makes an http request" do
+  describe 'create_user' do
+    it 'makes an http request' do
       params = {:first_name => 'john', :last_name => 'doe', :email => 'jdoe@yammer-inc.com'}
       @client.should_receive(:post).with('/api/v1/users', params)
       @client.create_user(params)
     end
   end
 
-  describe "get_user" do
-    it "makes an http request" do
+  describe 'get_user' do
+    it 'makes an http request' do
       @client.should_receive(:get).with('/api/v1/users/1')
       @client.get_user(1)
     end
   end
 
-  describe "update_user" do
-    it "makes an http request" do
+  describe 'update_user' do
+    it 'makes an http request' do
       params = {:first_name => 'jane', :last_name => 'smith'}
       @client.should_receive(:put).with('/api/v1/users/1', params)
       @client.update_user(1, params)
@@ -71,38 +71,38 @@ describe Yammer::Api::User do
     end
   end
 
-  describe "delete_user" do
-    it "makes an http request" do
+  describe 'delete_user' do
+    it 'makes an http request' do
       @client.should_receive(:delete).with('/api/v1/users/1')
       @client.delete_user(1)
     end
   end
 
-  describe "user_by_email" do
-    it "makes an http request" do
+  describe 'get_user_by_email' do
+    it 'makes an http request' do
       @client.should_receive(:get).with('/api/v1/users/by_email', :email => 'bob@yammer-inc.com')
       @client.get_user_by_email('bob@yammer-inc.com')
     end
   end
 
-  describe "current_user" do
-    it "makes an http request" do
+  describe 'current_user' do
+    it 'makes an http request' do
       @client.should_receive(:get).with('/api/v1/users/current')
       @client.current_user
     end
   end
 
-  describe "users_following" do
-    it "makes an http request" do
+  describe 'users_following' do
+    it 'makes an http request' do
       @client.should_receive(:get).with('/api/v1/users/following/3')
       @client.users_following(3)
     end
   end
 
-  describe "users_followed_by" do
-    it "makes an http request" do
+  describe 'users_followed_by' do
+    it 'makes an http request' do
       @client.should_receive(:get).with('/api/v1/users/followed_by/4')
       @client.users_followed_by(4)
     end
   end
-end
+end

data/yam.gemspec

@@ -25,10 +25,11 @@ Gem::Specification.new do |s|
   s.name             = 'yam'
   s.version          = Yammer::Version
 
-  s.date             = %q{2013-06-18}
+  s.date             = %q{2013-11-26}
   s.summary          = "Yammer API Client"
+
   s.description      = "A Ruby wrapper for accessing Yammer's REST API"
-  s.authors          = ["Kevin Mutyaba"]
+  s.authors          = ["Kevin Mutyaba", "Jessie A. Young", "Jason Nochlin"]
   s.email            = %q{kmutyaba@yammer-inc.com}
   s.homepage         = 'http://yammer.github.io/yam'
   s.rubygems_version = Yammer::Version

metadata

@@ -1,19 +1,15 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: yam
-version: !ruby/object:Gem::Version 
-  hash: 23
-  prerelease: 
-  segments: 
-  - 1
-  - 0
-  - 0
-  version: 1.0.0
+version: !ruby/object:Gem::Version
+  version: 1.1.0
 platform: ruby
-authors: 
+authors:
 - Kevin Mutyaba
+- Jessie A. Young
+- Jason Nochlin
 autorequire: 
 bindir: bin
-cert_chain: 
+cert_chain:
 - |
   -----BEGIN CERTIFICATE-----
   MIIDMjCCAhqgAwIBAgIBADANBgkqhkiG9w0BAQUFADA/MREwDwYDVQQDDAh0aWFi
@@ -35,141 +31,126 @@ cert_chain:
   B+kZ9/4dAvmKkr2NPSoxBQtO7Rz0HDNLtjMxkXbQUWMDsGnB6Kk1WUBb/w3kQ9Ah
   JgIHF4cG
   -----END CERTIFICATE-----
-
-date: 2013-06-18 00:00:00 Z
-dependencies: 
-- !ruby/object:Gem::Dependency 
+date: 2013-11-26 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
   name: oj
-  prerelease: false
-  requirement: &id001 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
     - - ~>
-      - !ruby/object:Gem::Version 
-        hash: 27
-        segments: 
-        - 2
-        - 0
-        - 10
+      - !ruby/object:Gem::Version
         version: 2.0.10
   type: :runtime
-  version_requirements: *id001
-- !ruby/object:Gem::Dependency 
-  name: multi_json
   prerelease: false
-  requirement: &id002 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
     - - ~>
-      - !ruby/object:Gem::Version 
-        hash: 9
-        segments: 
-        - 1
-        - 3
-        version: "1.3"
+      - !ruby/object:Gem::Version
+        version: 2.0.10
+- !ruby/object:Gem::Dependency
+  name: multi_json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
   type: :runtime
-  version_requirements: *id002
-- !ruby/object:Gem::Dependency 
-  name: rest-client
   prerelease: false
-  requirement: &id003 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
     - - ~>
-      - !ruby/object:Gem::Version 
-        hash: 1
-        segments: 
-        - 1
-        - 6
-        - 7
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rest-client
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
         version: 1.6.7
   type: :runtime
-  version_requirements: *id003
-- !ruby/object:Gem::Dependency 
-  name: addressable
   prerelease: false
-  requirement: &id004 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.6.7
+- !ruby/object:Gem::Dependency
+  name: addressable
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
     - - ~>
-      - !ruby/object:Gem::Version 
-        hash: 5
-        segments: 
-        - 2
-        - 3
-        - 3
+      - !ruby/object:Gem::Version
         version: 2.3.3
   type: :runtime
-  version_requirements: *id004
-- !ruby/object:Gem::Dependency 
-  name: rake
   prerelease: false
-  requirement: &id005 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        hash: 3
-        segments: 
-        - 0
-        version: "0"
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.3.3
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
   type: :development
-  version_requirements: *id005
-- !ruby/object:Gem::Dependency 
-  name: rspec
   prerelease: false
-  requirement: &id006 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        hash: 3
-        segments: 
-        - 0
-        version: "0"
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
   type: :development
-  version_requirements: *id006
-- !ruby/object:Gem::Dependency 
-  name: simplecov
   prerelease: false
-  requirement: &id007 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        hash: 1
-        segments: 
-        - 0
-        - 7
-        - 1
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
         version: 0.7.1
   type: :development
-  version_requirements: *id007
-- !ruby/object:Gem::Dependency 
-  name: webmock
   prerelease: false
-  requirement: &id008 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        hash: 51
-        segments: 
-        - 1
-        - 9
-        - 0
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 0.7.1
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
         version: 1.9.0
   type: :development
-  version_requirements: *id008
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 1.9.0
 description: A Ruby wrapper for accessing Yammer's REST API
 email: kmutyaba@yammer-inc.com
 executables: []
-
 extensions: []
-
 extra_rdoc_files: []
-
-files: 
+files:
 - .gitignore
 - .travis.yml
 - .yardopts
@@ -183,6 +164,7 @@ files:
 - certs/public.pem
 - lib/yammer.rb
 - lib/yammer/api.rb
+- lib/yammer/api/activity.rb
 - lib/yammer/api/autocomplete.rb
 - lib/yammer/api/group.rb
 - lib/yammer/api/group_membership.rb
@@ -214,6 +196,7 @@ files:
 - lib/yammer/thread.rb
 - lib/yammer/user.rb
 - lib/yammer/version.rb
+- spec/api/activity_spec.rb
 - spec/api/autocomplete_spec.rb
 - spec/api/group_membership_spec.rb
 - spec/api/group_spec.rb
@@ -253,39 +236,31 @@ files:
 - spec/spec_helper.rb
 - yam.gemspec
 homepage: http://yammer.github.io/yam
-licenses: 
+licenses:
 - MIT
-post_install_message: " Thanks for installing! For API help go to http://developer.yammer.com "
+metadata: {}
+post_install_message: ' Thanks for installing! For API help go to http://developer.yammer.com '
 rdoc_options: []
-
-require_paths: 
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
-  none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      hash: 3
-      segments: 
-      - 0
-      version: "0"
-required_rubygems_version: !ruby/object:Gem::Requirement 
-  none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      hash: 3
-      segments: 
-      - 0
-      version: "0"
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
 requirements: []
-
 rubyforge_project: 
-rubygems_version: 1.8.24
+rubygems_version: 2.1.10
 signing_key: 
-specification_version: 3
+specification_version: 4
 summary: Yammer API Client
-test_files: 
+test_files:
+- spec/api/activity_spec.rb
 - spec/api/autocomplete_spec.rb
 - spec/api/group_membership_spec.rb
 - spec/api/group_spec.rb
@@ -323,4 +298,3 @@ test_files:
 - spec/model/thread_spec.rb
 - spec/model/user_spec.rb
 - spec/spec_helper.rb
-has_rdoc: