yam 0.0.1 → 0.0.2

data/.gitignore

@@ -0,0 +1,18 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+vendor/bundle

data/.travis.yml

@@ -0,0 +1,6 @@
+language: ruby
+rvm:
+  - 1.9.3
+  - 1.9.2
+  - 1.8.7
+  - ree

data/CONTRIBUTING.md

@@ -0,0 +1,90 @@
+Contributing
+============
+
+
+Quick Overview
+--------------
+
+We love pull requests. Here's a quick overview of the process (detail below):
+
+1. Fork the repo.
+
+2. Run the tests. We only take pull requests with passing tests, so start with a clean slate.
+
+3. Add a test for your new code. Only refactoring and documentation changes require no new tests. If you are adding functionality or fixing a bug, we need a test!
+
+4. Make the test pass.
+
+5. Push to your fork and submit a pull request.
+
+At this point you're waiting on us. We may suggest some changes or improvements or alternatives. Once we approve, we will merge your branch in.
+
+Some things that will increase the chance that your pull request is accepted, taken straight from the Ruby on Rails guide:
+
+* Use Rails idioms and helpers
+* Include tests which fail without your code and pass with it
+* Update the documentation, the surrounding code, examples elsewhere, guides, whatever is affected by your contribution
+
+
+Requirements
+--------------
+
+Please remember this is open-source, so don't commit any passwords or API keys.
+Those should go in config variables like `ENV['API_KEY']`.
+
+
+Laptop setup
+------------
+
+Fork the repo and clone the app:
+
+    git clone git@github.com:[GIT_USERNAME]/yam.git
+
+
+Install Bundler 1.2.0.pre or higher:
+
+    gem install bundler --pre
+
+Set up the app:
+
+    cd yam
+    bundle --binstubs
+
+
+Running tests
+-------------
+
+Run the whole test suite with:
+
+    rake
+
+Run individual specs like:
+
+    rspec spec/yam_spec.rb
+
+Tab complete to make it even faster!
+
+When a spec file has many specs, you sometimes want to run just what you're
+working on. In that case, specify a line number:
+
+    rspec spec/yam_spec.rb:9
+
+
+Syntax
+------
+
+* Two spaces, no tabs.
+* No trailing whitespace. Blank lines should not have any spaces.
+* Prefer `&&/||` over `and/or`.
+* `MyClass.my_method(my_arg)` not `my_method( my_arg )` or `my_method my_arg`.
+* `a = b` and not `a=b`.
+* Follow the conventions you see used in the source already.
+
+And in case we didn't emphasize it enough: we love tests!
+
+
+Development process
+-------------------
+
+For details and screenshots of the feature branch code review process,
+read [this blog post](http://robots.thoughtbot.com/post/2831837714/feature-branch-code-reviews).

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in yam.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,16 @@
+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.

data/README.md

@@ -0,0 +1,144 @@
+Yam
+===
+
+The official Yammer Ruby gem.
+
+NOTE: Currently in alpha - use at your own risk
+
+Installation
+------------
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'yam'
+```
+
+And then execute:
+
+```sh
+$ bundle
+```
+
+Or install it yourself as:
+
+```sh
+$ gem install yam
+```
+
+General Configuration
+---------------------
+
+The Yammer API requires you to authenticate via OAuth, so you'll need to register your Yammer application. To register a new application, sign in to Yammer and then fill out the form at https://www.yammer.com/client_applications.
+
+If you already have your access token, you can skip this section.
+
+To retrieve your access token, follow these steps.
+
+1. Construct the following URL using the client_id you received after registering your app with Yammer: <https://www.yammer.com/dialog/oauth?client_id=[:client_id]>
+
+2. Follow the URL you constructed above. It will take you to a Yammer OAuth dialog. Click the "Allow" button.
+
+3. You will be redirected to a URL that looks something like this: <http://[:redirect_uri]?code=[:code]>
+
+4. Use the code from step 3 along with your client_id and client_secret (obtained when registering your app) to construct the following URL:
+<https://www.yammer.com/oauth2/access_token.json?client_id=[:client_id]&client_secret=[:client_secret]&code=[:code]>
+
+5. The authorization server will return an access token object as part of a broader response that includes user profile information.
+
+Sample access token (token is 'abcdefghijklmn' in this example) as part of response:
+
+```
+“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”
+}
+```
+
+Set the OAuth token on your app. Example:
+
+```ruby
+Yam.configure do |config|
+  config.oauth_token = your_oauth_token
+end
+```
+
+Rails Configuration
+-------------------
+
+Retrieve your access token using the steps outlined in the <a href="#general-configuration">general configuration</a> section above.
+
+Add the following to a `yammer.rb` file in your `config/initializers` directory:
+
+```ruby
+Yam.configure do |config|
+  config.oauth_token = oauth_token
+end
+```
+
+Set up Yammer OAuth 2.0
+-----------------------
+
+See Yammer's Developer Guide for step-by-step instructions on setting up OAuth 2.0: <http://developer.yammer.com/files/2012/10/PlatformDeveloperGuide.pdf>
+
+Usage Examples
+--------------
+
+All examples require an authenticated Yammer client. See the <a
+href="#general-configuration">general configuration</a> section for instructions for finding and setting your access token.
+
+For a list of all Yammer API endpoints, see the <a href="http://developer.yammer.com/restapi/">REST API documentation</a>.
+
+**Find a Yammer user by email**
+
+```ruby
+Yam.get('/users/by_email', email: 'user@example.com')
+```
+
+**Find a Yammer user by the Yammer user id**
+
+```ruby
+Yam.get('/users/123456')
+```
+
+**Post a status update from the current user**
+
+```ruby
+Yam.post('/messages', body: 'status update')
+```
+
+**Send a private message to another Yammer user**
+
+```ruby
+Yam.post('/messages', body: 'this is a private message', direct_to_id: 123456)
+```
+
+**Send a private message to a Yammer group**
+
+```ruby
+Yam.post('/messages', body: 'this is a group message', group_id: 987654)
+```
+
+**Send a message with an Open Graph Object as an attachment**
+
+```ruby
+Yam.post('/messages', :body: 'here is my open graph object', og_url: "https://www.yammer.com/example/graph/123456789")
+```
+
+Contributing
+------------
+
+To contribute to this project, see the [CONTRIBUTING.md](https://github.com/yammer/yam/blob/master/CONTRIBUTING.md) file.

data/Rakefile

@@ -0,0 +1,23 @@
+# 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 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/lib/yam.rb

@@ -1 +1,44 @@
+# 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 'yam/version'
+require 'yam/configuration'
+require 'yam/client'
+
+module Yam
+  extend Configuration
+
+  class << self
+    # Handler for the client instance
+    attr_accessor :api_client
+
+    # Alias for Yam::Client.new
+    def new(options = {}, &block)
+      @api_client = Yam::Client.new(options, &block)
+    end
+
+    # Delegate to Yam::Client
+    def method_missing(method, *args, &block)
+      return super unless new.respond_to?(method)
+      new.send(method, *args, &block)
+    end
+
+    def respond_to?(method, include_private = false)
+      new.respond_to?(method, include_private) || super(method, include_private)
+    end
+  end
+end

data/lib/yam/api.rb

@@ -0,0 +1,56 @@
+# 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.
+#
+
+# API setup and configuration
+require 'yam/request'
+require 'yam/connection'
+require 'yam/configuration'
+
+module Yam
+  class API
+    include Connection
+    include Request
+    attr_reader *Configuration::VALID_OPTIONS_KEYS
+
+    class_eval do
+      Configuration::VALID_OPTIONS_KEYS.each do |key|
+        define_method "#{key}=" do |arg|
+          self.instance_variable_set("@#{key}", arg)
+          Yam.send("#{key}=", arg)
+        end
+      end
+    end
+
+    def initialize(options={}, &block)
+      setup(options)
+    end
+
+    def setup(options={})
+      options = Yam.options.merge(options)
+      Configuration::VALID_OPTIONS_KEYS.each do |key|
+        send("#{key}=", options[key])
+      end
+    end
+
+    def method_missing(method, *args, &block)
+      if method.to_s.match /^(.*)\?$/
+        return !self.send($1.to_s).nil?
+      end
+    end
+  end
+end

data/lib/yam/client.rb

@@ -0,0 +1,23 @@
+# 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 'yam/api'
+
+module Yam
+  class Client < API
+  end
+end

data/lib/yam/configuration.rb

@@ -0,0 +1,59 @@
+# 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 Yam
+  module Configuration
+    VALID_OPTIONS_KEYS = [
+      :adapter,
+      :endpoint,
+      :oauth_token,
+      :user_agent,
+    ].freeze
+
+    DEFAULT_ADAPTER = :net_http
+
+    DEFAULT_ENDPOINT = 'https://www.yammer.com/api/v1'.freeze
+
+    DEFAULT_OAUTH_TOKEN = nil
+
+    DEFAULT_USER_AGENT = "Yam Ruby Gem #{Yam::VERSION}".freeze
+
+    attr_accessor *VALID_OPTIONS_KEYS
+
+    def configure
+      yield self
+    end
+
+    def self.extended(base)
+      base.set_defaults
+    end
+
+    def options
+      options = {}
+      VALID_OPTIONS_KEYS.each { |k| options[k] = send(k) }
+      options
+    end
+
+    def set_defaults
+      self.adapter = DEFAULT_ADAPTER
+      self.endpoint = DEFAULT_ENDPOINT
+      self.oauth_token = DEFAULT_OAUTH_TOKEN
+      self.user_agent = DEFAULT_USER_AGENT
+      self
+    end
+  end
+end

data/lib/yam/connection.rb

@@ -0,0 +1,62 @@
+# 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 'faraday'
+require 'yam/constants'
+require 'faraday_middleware/response/mashify'
+require 'faraday_middleware/response/parse_json'
+require 'faraday_middleware/request/oauth2'
+
+module Yam
+  module Connection
+    extend self
+    include Yam::Constants
+
+    def default_options(options={})
+      {
+        :headers => {
+          ACCEPT           => 'application/json',
+          ACCEPT_CHARSET   => 'utf-8',
+          USER_AGENT       => user_agent
+        },
+        :ssl => { :verify => true },
+        :url => options.fetch(:endpoint) { Yam.endpoint }
+      }.merge(options)
+    end
+
+    # Returns a Faraday::Connection object
+    #
+    def connection(options = {})
+      conn_options = default_options(options)
+      clear_cache unless options.empty?
+      puts "OPTIONS:#{conn_options.inspect}" if ENV['DEBUG']
+
+      @connection ||= Faraday.new(conn_options) do |conn|
+        conn.use Faraday::Response::Mashify
+        conn.use FaradayMiddleware::ParseJson
+        conn.response :raise_error
+
+        if oauth_token?
+          conn.use FaradayMiddleware::OAuth2, oauth_token
+        end
+
+        conn.request :url_encoded
+        conn.adapter adapter
+      end
+    end
+  end
+end

data/lib/yam/constants.rb

@@ -0,0 +1,28 @@
+# 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 Yam
+  module Constants
+    extend self
+
+    USER_AGENT = 'User-Agent'.freeze
+
+    ACCEPT = 'Accept'.freeze
+
+    ACCEPT_CHARSET = 'Accept-Charset'.freeze
+  end
+end

data/lib/yam/request.rb

@@ -0,0 +1,38 @@
+# 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.
+#
+
+# Defines HTTP verbs
+module Yam
+  module Request
+    def get(path, params={}, options={})
+      request(:get, path, params, options)
+    end
+
+    def post(path, params={}, options={})
+      request(:post, path, params, options)
+    end
+
+    def request(method, path, params, options)
+      conn = connection(options)
+      path = (conn.path_prefix + path).gsub(/\/\//,'/') if conn.path_prefix != '/'
+
+      response = conn.send(method,path,params)
+      response.body
+    end
+  end
+end

data/lib/yam/version.rb

@@ -1,4 +1,20 @@
+# 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 Yam
-  VERSION  = '0.0.1'
-  LOCATION = File.dirname __FILE__ # :nodoc:
+  VERSION = '0.0.2'
 end

data/spec/spec_helper.rb

@@ -0,0 +1,59 @@
+# 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 'simplecov'
+SimpleCov.start do
+  add_filter 'spec'
+end
+require 'rspec'
+require 'yam'
+require 'webmock/rspec'
+require 'bourne'
+
+RSpec.configure do |config|
+  config.mock_with :mocha
+  config.include WebMock::API
+  config.order = :rand
+  config.color_enabled = true
+  config.before(:each) do
+    Yam.set_defaults
+  end
+end
+
+def stub_post(path, endpoint = Yam.endpoint.to_s)
+  stub_request(:post, endpoint + path)
+end
+
+def stub_get(path, endpoint = Yam.endpoint.to_s)
+  stub_request(:get, endpoint + path)
+end
+
+def a_post(path, endpoint = Yam.endpoint.to_s)
+  a_request(:post, endpoint + path)
+end
+
+def a_get(path, endpoint = Yam.endpoint.to_s)
+  a_request(:get, endpoint + path)
+end
+
+def fixture_path
+  File.expand_path("../fixtures", __FILE__)
+end
+
+def fixture(file)
+  File.new(File.join(fixture_path, '/', file))
+end

data/spec/yam/client_spec.rb

@@ -0,0 +1,42 @@
+# 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 'spec_helper'
+
+describe Yam::Client, '#get' do
+  it 'makes requests' do
+    stub_get('/custom/get')
+    subject.get('/custom/get')
+    expect(a_get('/custom/get')).to have_been_made
+  end
+end
+
+describe Yam::Client, '#post' do
+  it 'makes requests' do
+    stub_post('/custom/post')
+    subject.post('/custom/post')
+    expect(a_post('/custom/post')).to have_been_made
+  end
+
+  it 'makes authorized requests' do
+    access_token = '123'
+    Yam.oauth_token = access_token
+    stub_post("/custom/post?access_token=#{access_token}")
+    subject.post('/custom/post')
+    expect(a_post("/custom/post?access_token=#{access_token}")).to have_been_made
+  end
+end

data/spec/yam_spec.rb

@@ -0,0 +1,100 @@
+# 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 'spec_helper'
+class TestClass
+end
+describe Yam do
+
+  after do
+    subject.set_defaults
+  end
+
+  it 'responds to \'new\' message' do
+    subject.should respond_to :new
+  end
+
+  it 'receives \'new\' and initialize subject::Client instance' do
+    subject.new.should be_a Yam::Client
+  end
+
+  it 'delegates to a Yam::Client instance' do
+    Yam::Client.any_instance.stubs(:stubbed_method)
+
+    Yam.stubbed_method
+
+    Yam::Client.any_instance.should have_received(:stubbed_method)
+  end
+
+  it 'responds to \'configure\' message' do
+    subject.should respond_to :configure
+  end
+
+  describe 'setting configuration options' do
+    it 'returns the default adapter' do
+      subject.adapter.should == Yam::Configuration::DEFAULT_ADAPTER
+    end
+
+    it 'allows setting the adapter' do
+      subject.adapter = :typhoeus
+      subject.adapter.should == :typhoeus
+    end
+
+    it 'returns the default end point' do
+      subject.endpoint.should == Yam::Configuration::DEFAULT_ENDPOINT
+    end
+
+    it 'allows setting the endpoint' do
+      subject.endpoint = 'http://www.example.com'
+      subject.endpoint.should == 'http://www.example.com'
+    end
+
+    it 'returns the default user agent' do
+      subject.user_agent.should == Yam::Configuration::DEFAULT_USER_AGENT
+    end
+
+    it 'allows setting the user agent' do
+      subject.user_agent = 'New User Agent'
+      subject.user_agent.should == 'New User Agent'
+    end
+
+    it 'does not set oauth token' do
+      subject.oauth_token.should be_nil
+    end
+
+    it 'does not allow setting the oauth token' do
+      subject.oauth_token = 'OT'
+      subject.oauth_token.should == 'OT'
+    end
+
+    it 'allows setting the current api client' do
+      subject.should respond_to :api_client=
+      subject.should respond_to :api_client
+    end
+  end
+
+  describe '.configure' do
+    Yam::Configuration::VALID_OPTIONS_KEYS.each do |key|
+      it "should set the #{key}" do
+        Yam.configure do |config|
+          config.send("#{key}=", key)
+          Yam.send(key).should == key
+        end
+      end
+    end
+  end
+end

data/yam.gemspec

@@ -1,22 +1,32 @@
-require 'lib/yam/version'
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 
-Gem::Specification.new do |gem|
-  gem.name    = 'yam'
-  gem.version = Yam::VERSION
+require 'yam/version'
 
-  gem.author, gem.email = 'Jordi Bunster', 'jbunster@yammer-inc.com'
+Gem::Specification.new do |gem|
+  gem.name          = 'yam'
+  gem.version       = Yam::VERSION
+  gem.authors       = ['Mason Fischer', 'Jessie A. Young']
+  gem.email         = ['mason@thoughtbot.com', 'jessie@apprentice.io']
+  gem.description   = %q{The official Yammer Ruby gem.}
+  gem.summary       = %q{A Ruby wrapper for the Yammer REST API}
+  gem.homepage      = %q{https://github.com/yammer/yam}
 
-  gem.summary     = "Placeholder for Yammer's Ruby API"
-  gem.description = "Placeholder for Yammer's Ruby API"
-  gem.required_ruby_version = '>= 1.8.7'
+  gem.files         = `git ls-files`.split($/)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ['lib']
 
-  gem.has_rdoc = false
+  gem.add_dependency 'hashie', '~> 1.2.0'
+  gem.add_dependency 'faraday', '~> 0.8.1'
+  gem.add_dependency 'faraday_middleware', '~> 0.9.0'
+  gem.add_dependency 'multi_json', '~> 1.3'
+  gem.add_dependency 'oauth2', '~> 0.8.0'
 
-  gem.files = %w[
-    lib
-    lib/yam
-    lib/yam/version.rb
-    lib/yam.rb
-    yam.gemspec
-  ]
+  gem.add_development_dependency 'rspec'
+  gem.add_development_dependency 'simplecov', '~> 0.7.1'
+  gem.add_development_dependency 'mocha', '~> 0.9.8'
+  gem.add_development_dependency 'bourne', '~> 1.0'
+  gem.add_development_dependency 'webmock', '~> 1.9.0'
 end

metadata

@@ -1,57 +1,229 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: yam
-version: !ruby/object:Gem::Version 
-  version: 0.0.1
+version: !ruby/object:Gem::Version
+  version: 0.0.2
+  prerelease: 
 platform: ruby
-authors: 
-- Jordi Bunster
+authors:
+- Mason Fischer
+- Jessie A. Young
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2011-07-15 00:00:00 -07:00
-default_executable: 
-dependencies: []
-
-description: Placeholder for Yammer's Ruby API
-email: jbunster@yammer-inc.com
+date: 2012-12-12 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: hashie
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.2.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.2.0
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.8.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.8.1
+- !ruby/object:Gem::Dependency
+  name: faraday_middleware
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.0
+- !ruby/object:Gem::Dependency
+  name: multi_json
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: oauth2
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.8.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.8.0
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.7.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.7.1
+- !ruby/object:Gem::Dependency
+  name: mocha
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.8
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.8
+- !ruby/object:Gem::Dependency
+  name: bourne
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.9.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.9.0
+description: The official Yammer Ruby gem.
+email:
+- mason@thoughtbot.com
+- jessie@apprentice.io
 executables: []
-
 extensions: []
-
 extra_rdoc_files: []
-
-files: 
-- lib/yam/version.rb
+files:
+- .gitignore
+- .travis.yml
+- CONTRIBUTING.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
 - lib/yam.rb
+- lib/yam/api.rb
+- lib/yam/client.rb
+- lib/yam/configuration.rb
+- lib/yam/connection.rb
+- lib/yam/constants.rb
+- lib/yam/request.rb
+- lib/yam/version.rb
+- spec/spec_helper.rb
+- spec/yam/client_spec.rb
+- spec/yam_spec.rb
 - yam.gemspec
-has_rdoc: true
-homepage: 
+homepage: https://github.com/yammer/yam
 licenses: []
-
 post_install_message: 
 rdoc_options: []
-
-require_paths: 
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      version: 1.8.7
-  version: 
-required_rubygems_version: !ruby/object:Gem::Requirement 
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      version: "0"
-  version: 
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
 requirements: []
-
 rubyforge_project: 
-rubygems_version: 1.3.5
+rubygems_version: 1.8.24
 signing_key: 
 specification_version: 3
-summary: Placeholder for Yammer's Ruby API
-test_files: []
-
+summary: A Ruby wrapper for the Yammer REST API
+test_files:
+- spec/spec_helper.rb
+- spec/yam/client_spec.rb
+- spec/yam_spec.rb