buff 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: f3e891d111f7733cd52ef4cbd52b53cb2acabab6
+  data.tar.gz: 357899d36e7488127e46b03f36f7ad0a3eefa715
+SHA512:
+  metadata.gz: af4fd75e337c70021cd21a1fcf7a960d571ada956d9b8cd1a3e2ed184f4e79cd70476decfb4838fdd31a1dfb669e3fa9dcd3141f1927be046ae96a8e70b78b71
+  data.tar.gz: 31ff60c79b65e92510ff20245c45b6179ebdfb002ef83da36f852f8b4e2226bbcf0dabcb3cf861f8f0ccb9dbe677e06dcff749a9e20c8e0ffa83bd5266846d43

data/.gitignore

@@ -0,0 +1,21 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+notes.txt
+.DS_STORE
+spec/fixtures/
+utility.rb

data/.ruby-version

@@ -0,0 +1 @@
+ruby-2.0.0-p195

data/.travis.yml

@@ -0,0 +1,4 @@
+language: ruby
+rvm:
+  - 1.9.3
+  - 2.0.0

data/Gemfile

@@ -0,0 +1,5 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in buff.gemspec
+gem 'coveralls', require: false
+gemspec

data/Guardfile

@@ -0,0 +1,10 @@
+# A sample Guardfile
+# More info at https://github.com/guard/guard#readme
+
+guard :rspec do
+  watch(%r{^spec/.+_spec\.rb$})
+  watch(%r{^lib/(.+)\.rb$})     { |m| "spec/#{m[1]}_spec.rb" }
+  watch('spec/spec_helper.rb')  { "spec" }
+
+end
+

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 ZPH
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,62 @@
+# Buff
+
+Buff is a Buffer API Wrapper written in Ruby.  It provides more thorough API coverage than the existing gem.
+
+Since the gem is currently in ALPHA development, the interface is prone to change.  Please wait until v0.1.0 is released to become reliant on interface.
+
+## Installation
+
+[![Coverage Status](https://coveralls.io/repos/zph/buff/badge.png?branch=master)](https://coveralls.io/r/zph/buff?branch=master)
+
+Once Buff is released as a gem, the following instructions will work. For now please `git clone` the repo.
+
+#### Note: Fixtures are not currently public. They will be uploaded after sensitive info is sanitized.
+
+Add this line to your application's Gemfile:
+
+    gem 'buff', :git => 'zph/buff'
+
+And then execute:
+
+    $ bundle
+
+Once gem is pushed to RubyGems:
+> Or install it yourself as:
+
+>     $ gem install buff
+
+## Usage
+
+  * Note which API coverage exists and have fun!
+  * Authentication is not included in this gem (Try OAuth-buffer)
+
+## API Coverage
+
+#### Implemented
+
+* User
+* Profiles (:get)
+* Updates (:get)
+* Updates (:post, #create_update, #change_update_text, #destroy_update, #share_update, #shuffle_updates, #reorder_updates)
+* Links
+* Info
+* Error Codes
+
+#### Not Implemented
+
+* Profiles (:post, #set_schedules)
+* Caching
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request
+
+Issues, advice and refactoring is welcome.
+
+Also, this project is newcomer friendly!! We'd love to be your first Open Source Software contribution and would be happy to assist in that process.
+
+Reach out on Twitter [@_ZPH](http://twitter.com/_ZPH).

data/Rakefile

@@ -0,0 +1,26 @@
+require "bundler/gem_tasks"
+require 'rake'
+require 'rspec/core/rake_task'
+
+desc 'Default: run specs.'
+task :default => :spec
+
+desc "Run specs"
+RSpec::Core::RakeTask.new do |t|
+  t.pattern = "./spec/**/*_spec.rb" # don't need this, it's default.
+  # Put spec opts in a file named .rspec in root
+end
+
+desc "Generate code coverage"
+RSpec::Core::RakeTask.new(:coverage) do |t|
+  t.pattern = "./spec/**/*_spec.rb" # don't need this, it's default.
+  t.rcov = true
+  t.rcov_opts = ['--exclude', 'spec']
+end
+
+task :default  => :spec
+
+task :curl_dump, [ :url ] do |t, args|
+  access_token = `cat ~/.bufferapprc | head -3 | tail -1`.chomp
+  sh "curl -is #{args[:url]}?access_token=#{access_token}"
+end

data/buff.gemspec

@@ -0,0 +1,35 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'buff/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "buff"
+  gem.version       = Buff::VERSION
+  gem.authors       = ["ZPH"]
+  gem.email         = ["Zander@civet.ws"]
+  gem.description   = %q{Buff is an API Wrapper Gem for Bufferapp.com's API}
+  gem.summary       = %q{Buff is an API Wrapper Gem for Bufferapp.com's API}
+  gem.homepage      = "http://github.com/zph/buff"
+
+  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.add_development_dependency 'rspec'
+  gem.add_development_dependency 'webmock'
+  gem.add_development_dependency 'guard-rspec'
+  gem.add_development_dependency 'guard-bundler'
+  gem.add_development_dependency 'rb-fsevent'
+  gem.add_development_dependency 'growl'
+  gem.add_development_dependency 'pry-full'
+  gem.add_development_dependency 'rake'
+
+  gem.add_runtime_dependency 'multi_json'
+  gem.add_runtime_dependency 'yajl-ruby'
+  gem.add_runtime_dependency 'faraday'
+  gem.add_runtime_dependency 'faraday_middleware'
+  gem.add_runtime_dependency 'rash'
+  gem.add_runtime_dependency 'addressable'
+end

data/lib/buff/core.rb

@@ -0,0 +1,93 @@
+module Buff
+  class Client
+    module Core
+      API_VERSION = "1"
+
+      attr_reader :error_table
+
+      def get(path, options={})
+        options.merge!(auth_query)
+        response = @conn.get do |req|
+          req.url path.gsub(%r{^\/}, '')
+          req.params = options
+        end
+
+        interpret_response(response)
+      end
+
+      def post(path, post_data)
+        @conn.post do |req|
+          req.url path.gsub(%r{^\/}, '')
+          req.headers['Content-Type'] = "application/x-www-form-urlencoded"
+          req.body = post_data
+          req.params = auth_query
+        end
+      end
+
+      def basic_request(path, verb, options={})
+        response = self.class.send(verb.to_sym, path, options)
+        interpret_response(response)
+      end
+
+      def interpret_response(response)
+        case response.status
+        when 200
+          JSON.parse response.body
+        else
+          handle_response_code(response)
+        end
+      end
+
+      def handle_response_code(response)
+        error = Hashie::Mash.new( response.body )
+        if ERROR_TABLE[error.code]
+          error_explanation = "Buffer API Error Code: #{error.code}\n"
+          error_explanation += "HTTP Code: #{response.code}. Description: #{error.error}"
+        else
+          error_explanation = "Buffer API Unknown Error in Response"
+        end
+
+        raise Buff::APIError, error_explanation
+      end
+
+      def self.error_table
+        @error_table ||= ERROR_TABLE
+      end
+
+      ERROR_TABLE = {
+         "403"=>"Permission denied.",
+         "404"=>"Endpoint not found.",
+         "405"=>"Method not allowed.",
+         "1000"=>"An unknown error occurred.",
+         "1001"=>"Access token required.",
+         "1002"=>"Not within application scope.",
+         "1003"=>"Parameter not recognized.",
+         "1004"=>"Required parameter missing.",
+         "1005"=>"Unsupported response format.",
+         "1006"=>"Parameter value not within bounds.",
+         "1010"=>"Profile could not be found.",
+         "1011"=>"No authorization to access profile.",
+         "1012"=>"Profile did not save successfully.",
+         "1013"=>"Profile schedule limit reached.",
+         "1014"=>"Profile limit for user has been reached.",
+         "1015"=>"Profile could not be destroyed.",
+         "1020"=>"Update could not be found.",
+         "1021"=>"No authorization to access update.",
+         "1022"=>"Update did not save successfully.",
+         "1023"=>"Update limit for profile has been reached.",
+         "1024"=>"Update limit for team profile has been reached.",
+         "1025"=>"Update was recently posted, can't post duplicate content.",
+         "1026"=>"Update must be in error status to requeue.",
+         "1028"=>"Update soft limit for profile reached.",
+         "1029"=>"Event type not supported.",
+         "1030"=>"Media filetype not supported.",
+         "1031"=>"Media filesize out of acceptable range.",
+         "1032"=>"Unable to post image to LinkedIn group(s).",
+         "1042"=>"User did not save successfully.",
+         "1050"=>"Client could not be found.",
+         "1051"=>"No authorization to access client."
+      }
+
+    end
+  end
+end

data/lib/buff/encode.rb

@@ -0,0 +1,8 @@
+module Buff
+  class Encode
+    def self.encode(hash)
+      raise ArgumentError unless hash.is_a?(Hash)
+
+    end
+  end
+end

data/lib/buff/error.rb

@@ -0,0 +1,4 @@
+module Buff
+  module Error
+  end
+end

data/lib/buff/link.rb

@@ -0,0 +1,10 @@
+module Buff
+  class Client
+    module Link
+      def link(options)
+        response = get("/links/shares.json", options)
+        Buff::Link.new(response)
+      end
+    end
+  end
+end

data/lib/buff/profile.rb

@@ -0,0 +1,28 @@
+module Buff
+  class Client
+    module Profile
+      def profiles(options={})
+        response = get("/profiles.json", options)
+        response.map { |profile| Buff::Profile.new(profile) }
+      end
+
+      def profile_by_id(id, options={})
+        response = get("/profiles/#{id}.json")
+        Buff::Profile.new(response)
+      end
+
+      def profile_schedules_by_id(id, options={})
+        response = get("/profiles/#{id}/schedules.json")
+        response.map { |r| Buff::Schedule.new(r) }
+      end
+
+      # TODO massive bug
+      # currently deletes schedule due to malformed request
+      def set_schedules(id, options={})
+        # schedules = options.fetch(:schedules) { raise ArgumentError }
+        response = post("/profiles/#{id}/schedules/update.json", options )
+          Buff::Response.new(JSON.parse(response.body))
+      end
+    end
+  end
+end

data/lib/buff/update.rb

@@ -0,0 +1,84 @@
+module Buff
+  class Client
+    module Update
+      def update_by_id(id, options={})
+        check_id(id)
+        response = get("/updates/#{id}.json")
+        Buff::Update.new(response)
+      end
+
+      def updates_by_profile_id(id, options={})
+        optional_params = [ :page, :count, :since, :utc ]
+        status = options.fetch(:status) do
+          raise Buff::MissingStatus, "Include :pending or :sent in args"
+        end
+        options.delete(:status)
+        response = get("/profiles/#{id}/updates/#{status.to_s}.json", options )
+        updates = response['updates'].map { |r| Buff::Update.new(r) }
+        Buff::Updates.new (
+              { total: response['total'], updates: updates } )
+      end
+
+      def interactions_by_update_id(id, options={})
+        optional_params = [:page, :count, :event]
+        response = get("/updates/#{id}/interactions.json", options)
+        interactions = response['interactions'].map { |r| Buff::Interaction.new(r) }
+        Buff::Interactions.new(
+          { total: response['total'], interactions: interactions }
+        )
+      end
+
+      def reorder_updates(profile_id, options={})
+        # order, optional: offset, utc
+        order = options.fetch(:order) { raise ArgumentError }
+        response = post("/profiles/#{profile_id}/updates/reorder.json", options)
+      end
+
+      def shuffle_updates(profile_id, options={})
+        # optional count, utc
+        response = post("/profiles/#{profile_id}/updates/shuffle.json", options)
+      end
+
+        #TODO
+      def create_update(options={})
+
+        # POST Data
+        #     text=This%20is%20an%20example%20update&
+        #     profile_ids[]=4eb854340acb04e870000010&
+        #     profile_ids[]=4eb9276e0acb04bb81000067&
+        #     media[link]=http%3A%2F%2Fgoogle.com&
+        #     media[description]=The%20google%20homepage
+        # options = {
+        #   text: "bodytext",
+        #   profile_ids: ["230958239058", "23059u2350923"],
+        #   media: {
+        #     link: "http://example.com",
+        #     description: "That example page"
+        #   }
+        # }
+        response = post("/updates/create.json", options)
+        Hashie::Mash.new(JSON.parse response.body)
+      end
+
+      def modify_update_text(update_id, options={})
+        # text, (now, media, utc)
+        options.fetch(:text) { raise ArgumentError }
+        response = post("/updates/#{update_id}/update.json", options)
+        Hashie::Mash.new(JSON.parse response.body)
+      end
+
+      def share_update(update_id, options={})
+        response = post("/updates/#{update_id}/share.json", options)
+      end
+
+      def destroy_update(update_id, options={})
+        response = post("/updates/#{update_id}/destroy.json", options)
+      end
+
+      def check_id(id)
+        raise Buff::InvalidIdLength unless id.length == 24
+        raise Buff::InvalidIdContent unless id[/^[a-f0-9]+$/i]
+      end
+    end
+  end
+end

data/lib/buff/user.rb

@@ -0,0 +1,9 @@
+module Buff
+  class Client
+    module User
+      def user_info(options={})
+        Buff::UserInfo.new(get("/user.json"))
+      end
+    end
+  end
+end

data/lib/buff/version.rb

@@ -0,0 +1,3 @@
+module Buff
+  VERSION = "0.0.1"
+end

data/lib/buff.rb

@@ -0,0 +1,72 @@
+require "faraday"
+require "faraday_middleware"
+require "json"
+require "rash"
+
+require "buff/version"
+require "buff/core"
+require "buff/user"
+require "buff/profile"
+require "buff/update"
+require "buff/link"
+require "buff/error"
+require "buff/encode"
+
+module Buff
+
+  begin
+    ACCESS_TOKEN = File.open(File.expand_path("~/.bufferapprc")).readlines[2].chomp if File.exists?(File.expand_path("~/.bufferapprc"))
+  end
+
+  class UserInfo < Hashie::Mash; end
+  class Profile  < Hashie::Mash; end
+  class Response < Hashie::Mash; end
+  class Update   < Hashie::Mash; end
+  class Updates  < Hashie::Mash; end
+  class Interaction < Hashie::Mash; end
+  class Interactions < Hashie::Mash; end
+  class Link < Hashie::Mash; end
+  class Info < Hashie::Mash; end
+
+  class Schedule < Hashie::Mash; end
+  Schedules = Class.new(Array) do
+    def dump
+      { schedules: self }.to_json
+    end
+  end
+
+  InvalidIdLength = Class.new(ArgumentError)
+  InvalidIdContent = Class.new(ArgumentError)
+  MissingStatus = Class.new(ArgumentError)
+  APIError = Class.new(StandardError)
+  UnauthorizeRequest = Class.new(StandardError)
+
+  class Client
+    include Core
+    include User
+    include Profile
+    include Update
+    include Link
+    include Error
+
+    attr_accessor :access_token, :auth_query
+
+    def initialize(access_token)
+      @access_token = access_token
+      @conn = Faraday.new(:url => "https://api.bufferapp.com/1/") do |faraday|
+          faraday.request  :url_encoded             # form-encode POST params
+          faraday.adapter  Faraday.default_adapter  # make requests with Net::HTTP
+      end
+    end
+
+    def auth_query
+      { :access_token => @access_token }
+    end
+
+    def info
+      response = get("/info/configuration.json")
+      Buff::Info.new(response)
+    end
+  end
+end
+

data/spec/lib/buff/encode_spec.rb

@@ -0,0 +1,36 @@
+require "spec_helper"
+
+describe Buff::Encode do
+  describe "#encode" do
+
+    let(:uri) { Addressable::URI.new }
+    it "throws error unless input is a hash" do
+      lambda { Buff::Encode.encode([]) }.
+        should raise_error(ArgumentError)
+    end
+
+    it "should convert {:pony => 'pony' }" do
+      h = { pony: "pony"}
+      uri.query_values = h
+      uri.query.should eq("pony=pony")
+    end
+
+    it "should convert {:pony => ['pony', 'horse'] }" do
+      h = { pony: ["pony", "horse"]}
+      uri.query_values = h
+      uri.query.should eq("pony=pony&pony=horse")
+    end
+
+    it "should convert {:days => [mon, tues], :times => [....]}" do
+      h = { days: ["mon", "tue"], times: ["12:00", "13:00"]}
+      uri.query_values = h
+      uri.query.should eq("days=mon&days=tue&times=12%3A00&times=13%3A00")
+    end
+    xit "should convert {schedules => {:days => [mon, tues], :times => [....]}" do
+      # h = { :days => ["mon", "tue", "wed", "thu"], :times => ["12:00", "13:00"]}
+      h = {:a => "a", :bd => ["c", "d", "e"]}
+      uri.query_values = h
+      uri.query.should eq("days=mon&days=tue&times=12%3A00&times=13%3A00")
+    end
+  end
+end

data/spec/lib/buff/link_spec.rb

@@ -0,0 +1,22 @@
+require 'spec_helper'
+
+describe Buff::Client do
+  describe "#link" do
+    let(:client) { Buff::Client.new("some_token") }
+    let(:url) { %q{http://bufferapp.com} }
+
+    before do
+      stub_request(:get, "https://api.bufferapp.com/1/links/shares.json?access_token=some_token&url=http://bufferapp.com").
+        to_return(fixture('link.txt'))
+    end
+
+    it "connects to the correct endpoint" do
+      client.link({url: url})
+    end
+
+    it "parses the shares of a link" do
+      client.link({url: url}).shares.should eq(47348)
+    end
+
+  end
+end

data/spec/lib/buff/update_spec.rb

@@ -0,0 +1,132 @@
+require 'spec_helper'
+
+describe Buff::Client do
+  let(:client) { Buff::Client.new("some_token") }
+  let(:profile_id) { "4eb854340acb04e870000010" }
+  let(:id) { "4eb8565e0acb04bb82000004" }
+
+  describe "updates" do
+    describe "#update_by_id" do
+
+      before do
+        stub_request(:get, "https://api.bufferapp.com/1/updates/4eb8565e0acb04bb82000004.json?access_token=some_token").
+                 to_return(fixture("update_by_id.txt"))
+      end
+      it "fails without an id" do
+        lambda {
+          update = client.update_by_id}.
+          should raise_error(ArgumentError)
+      end
+
+      it "connects to the correct endpoint" do
+        client.update_by_id(id)
+      end
+
+      it "returns a well formed update rash" do
+        client.update_by_id(id).sent_at.should eq(1320744001)
+      end
+
+    end
+
+
+    describe "#updates_by_profile_id" do
+      it "requires an id arg" do
+        lambda { client.updates_by_profile_id }.
+          should raise_error(ArgumentError)
+      end
+
+      it "fails without a :status arg" do
+        lambda { client.updates_by_profile_id(profile_id)}.
+          should raise_error(Buff::MissingStatus)
+      end
+
+      it "connects to the correct endpoint" do
+        url = "https://api.bufferapp.com/1/profiles/4eb854340acb04e870000010/updates/pending.json?access_token=some_token"
+
+        stub_request(:get, url).
+          to_return(fixture('updates_by_profile_id_pending.txt'))
+        client.updates_by_profile_id(profile_id, status: :pending).
+          total.should eq(1)
+      end
+
+      it "utilizes the optional params" do
+        url = "https://api.bufferapp.com/1/profiles/4eb854340acb04e870000010/updates/pending.json?access_token=some_token&count=3&page=2"
+
+        stub_request(:get, url).
+          to_return(fixture('updates_by_profile_id_pending.txt'))
+        client.updates_by_profile_id(profile_id, status: :pending, page: 2, count: 3).
+          total.should eq(1)
+      end
+    end
+
+    describe "#interactions_by_update_id" do
+      xit "requires an id"
+      xit "connects to the correct endpoint"
+      xit "returns an object where total is accessible"
+      it "allows optional params" do
+        url = "https://api.bufferapp.com/1/updates/4ecda476542f7ee521000006/interactions.json?access_token=some_token&page=2"
+        id = "4ecda476542f7ee521000006"
+        stub_request(:get, url).
+          to_return(fixture("interactions_by_update_id.txt"))
+        client.interactions_by_update_id(id, page: 2)
+      end
+    end
+
+    describe "#check_id" do
+      it "fails if id is not 24 chars" do
+        stub_request(:get, "https://api.bufferapp.com/1/updates/4eb8565e0acb04bb82000004X.json?access_token=some_token").
+                 to_return(:status => 200, :body => "", :headers => {})
+        id = "4eb8565e0acb04bb82000004X"
+        lambda { client.update_by_id(id) }.
+          should raise_error(Buff::InvalidIdLength)
+      end
+
+      it "fails if id is not numbers and a-f" do
+        stub_request(:get, "https://api.bufferapp.com/1/updates/4eb8565e0acb04bb8200000X.json?access_token=some_token").
+                 to_return(:status => 200, :body => "", :headers => {})
+        id = "4eb8565e0acb04bb8200000X"
+        lambda { client.update_by_id(id) }.
+          should raise_error(Buff::InvalidIdContent)
+      end
+    end
+
+    describe "#reorder_updates" do
+      it "connects to appropriate endpoint" do
+        id_no = "4ecda256512f7ee521000001"
+        order_hash = { order: [id_no, id_no, id_no] }
+        stub_request(:post, %r{https://api\.bufferapp\.com/1/profiles/4ecda256512f7ee521000001/updates/reorder\.json\?access_token=.*}).
+                   with(:body => {"order"=>["4ecda256512f7ee521000001", "4ecda256512f7ee521000001", "4ecda256512f7ee521000001"]},
+                        :headers => {'Accept'=>'*/*', 'Accept-Encoding'=>'gzip;q=1.0,deflate;q=0.6,identity;q=0.3', 'Content-Type'=>'application/x-www-form-urlencoded', 'User-Agent'=>'Faraday v0.8.7'}).
+                   to_return(:status => 200, :body => "", :headers => {})
+        client.reorder_updates(id_no, order_hash)
+
+      end
+    end
+
+    describe "#shuffle_updates" do
+      it "connects to appropriate endpoint" do
+        id_no = "4ecda256512f7ee521000001"
+        stub_request(:post, %r{https://api\.bufferapp\.com/1/profiles/4ecda256512f7ee521000001/updates/shuffle\.json\?access_token=.*}).
+                 with(:body => {"count"=>"10"})
+        client.shuffle_updates(id_no, {count: 10})
+      end
+    end
+    describe "#share_update" do
+      it "should connect to correct endpoint" do
+        stub_request(:post, %r{https://api\.bufferapp\.com/1/updates/4ecda256512f7ee521000001/share\.json\?access_token=.*}).
+           to_return(:status => 200, :body => "{'success': true}", :headers => {})
+        update_id = "4ecda256512f7ee521000001"
+        client.share_update(update_id)
+      end
+    end
+
+    describe "#destroy_update" do
+      it "connects to correct endpoint" do
+        stub_request(:post, %r{https://api\.bufferapp\.com/1/updates/4ecda256512f7ee521000001/destroy\.json\?access_token=.*}).
+           to_return(fixture('destroy.txt'))
+             update_id = "4ecda256512f7ee521000001"
+        client.destroy_update(update_id)
+      end
+    end
+  end
+end

data/spec/lib/buff_spec.rb

@@ -0,0 +1,261 @@
+require 'spec_helper'
+
+
+describe Buff::Client do
+  let(:id) { "5160746d54f04a5e3a00000f" }
+
+  subject do
+    Buff::Client.new("some_token")
+  end
+
+  describe "#initialize" do
+    it "allows a token to be set and retrieved" do
+      subject.access_token.should eq("some_token")
+    end
+  end
+
+  describe "#user_info" do
+    let(:rash) { subject.user_info }
+
+    before(:each) do
+      stub_request(:get, 'https://api.bufferapp.com/1/user.json').
+        with(query: { 'access_token' => 'some_token'}).
+        to_return(fixture('user_authenticated.txt'))
+    end
+
+    it "returns a Rash object" do
+      rash.class.should eq(Buff::UserInfo)
+    end
+
+    it "provides an accessor for plan" do
+      rash.plan.should eq("free")
+    end
+  end
+
+  describe "#profiles" do
+    let(:rash) { Buff::Client.new("some_token").profiles }
+
+    before(:each) do
+      stub_request(:get, 'https://api.bufferapp.com/1/profiles.json').
+        with(query: { 'access_token' => 'some_token'}).
+        to_return(fixture('profile_authenticated.txt'))
+    end
+
+    it "makes the correct url request" do
+      subject.profiles
+    end
+
+    it "returns a Rash collection object" do
+      rash[0].class.should eq(Buff::Profile)
+    end
+
+    it "provides an accessor for plan" do
+      rash[0].service.should eq("twitter")
+    end
+  end
+
+  describe "#profile_by_id" do
+    let(:id) { "5160746d54f04a5e3a00000f" }
+    before(:each) do
+      stub_request(:get, "https://api.bufferapp.com/1/profiles/#{id}.json").
+        with(query: { 'access_token' => 'some_token'}).
+        to_return(fixture('profiles_by_id.txt'))
+    end
+
+    let(:rash) { Buff::Client.new("some_token").profile_by_id(id) }
+
+    it "returns a rash collection" do
+      rash.class.should eq(Buff::Profile)
+    end
+
+    it "accesses formatted service" do
+      rash.formatted_service.should eq("Twitter")
+    end
+  end
+
+  describe "#profile_schedules_by_id" do
+    before(:each) do
+      stub_request(:get, "https://api.bufferapp.com/1/profiles/#{id}/schedules.json").
+        with(query: { 'access_token' => 'some_token'}).
+        to_return(fixture('profile_schedules_by_id.txt'))
+    end
+
+    let(:rash) { Buff::Client.new("some_token").profile_schedules_by_id(id) }
+
+    it "returns a rash collection" do
+      rash[0].class.should eq(Buff::Schedule)
+    end
+
+    it "accesses days" do
+      expect(rash[0].days).to include("mon")
+    end
+
+    it "accesses times" do
+      expect(rash[0].times).to include("06:13")
+    end
+  end
+
+  describe "#set_schedules" do
+    #not yet implemented
+    xit "throw error if schedules is empty" do
+      lambda {
+        Buff::Client.new("some_token").set_schedules(id) }.
+      should raise_error(ArgumentError)
+
+    end
+  end
+
+  describe "#info" do
+    before do
+      stub_request(:get, "https://api.bufferapp.com/1/info/configuration.json?access_token=some_token").
+        to_return(fixture("info.txt"))
+    end
+
+    it "connects to the correct endpoint" do
+      subject.info
+    end
+
+    it "retrieves the correct name" do
+      subject.info.services.twitter.types.profile.name.should eq("Twitter")
+    end
+  end
+end
+
+describe Buff::Schedules do
+  before do
+    @schedule = JSON.parse <<EOF
+    {
+            "days" : [
+                "mon",
+                "tue",
+                "wed",
+                "thu",
+                "fri"
+            ],
+            "times" : [
+                "12:00",
+                "17:00",
+                "18:00"
+            ]
+        }
+EOF
+
+    @sample_schedules = JSON.parse <<EOF
+    { "schedules" : [{
+        "days" : [
+            "mon",
+            "tue",
+            "wed",
+            "thu",
+            "fri"
+        ],
+        "times" : [
+            "12:00",
+            "17:00",
+            "18:00"
+        ]
+    },
+    {
+            "days" : [
+                "mon",
+                "tue",
+                "wed",
+                "thu",
+                "fri"
+            ],
+            "times" : [
+                "12:00",
+                "17:00",
+                "18:00"
+            ]
+        }]
+    }
+EOF
+  end
+
+  it "accepts an array of days" do
+    lambda {
+      schedules = Buff::Schedules.new
+      schedules << Buff::Schedule.new
+    }.should_not raise_error
+  end
+
+  it "dumping a double schedule yields correct json" do
+    schedules = Buff::Schedules.new
+    schedules << @schedule
+    schedules << @schedule
+    @sample_schedules = @sample_schedules.to_json
+
+    schedules.dump.should eq(@sample_schedules)
+  end
+end
+
+describe Buff::Client::Core do
+
+  let(:client) { Buff::Client.new("some_token") }
+  describe "#get" do
+    it "delegates to #handle_response_code when code != 200" do
+       stub_request(:get, "https://api.bufferapp.com/1/info/configuration.json?access_token=some_token").
+         to_return(:status => 403, :body => "", :headers => {})
+       client.should_receive(:handle_response_code).once
+       client.info
+    end
+
+
+    it "does not delegate to #handle_response_code when code = 200" do
+       stub_request(:get, "https://api.bufferapp.com/1/info/configuration.json?access_token=some_token").
+         to_return(fixture("link.txt"))
+       client.should_not_receive(:handle_response_code)
+       client.info
+    end
+  end
+
+  describe "#post" do
+
+    it "connects to the correct endpoint" do
+
+#TODO improve test
+      response = %Q[{"success": true, "message": "Schedule saved successfully"}]
+      id = "4eb854340acb04e870000010"
+      stub_request(:post, %r{https://api\.bufferapp\.com/1/profiles/4eb854340acb04e870000010/schedules/update\.json\?access_token=.*}).
+               with(:body => {"schedules"=>{"days"=>["mon", "tue", "wed"], "times"=>["12:00", "17:00", "18:00"]}},
+                    :headers => {'Accept'=>'*/*', 'Content-Type'=>'application/x-www-form-urlencoded', 'User-Agent'=>'Faraday v0.8.7'}).
+               to_return(:status => 200, :body => response, :headers => {})
+       client.set_schedules(id, :schedules => sample_schedules).success.
+         should eq(true)
+    end
+
+    xit "does not delegate to #handle_response_code when code = 200" do
+       stub_request(:get, "https://api.bufferapp.com/1/info/configuration.json?access_token=some_token").
+         to_return(fixture("link.txt"))
+       client.should_not_receive(:handle_response_code)
+       client.info
+    end
+
+    xit "transforms sample_schedule into correct formatted url" do
+      u = Addressable::URI.new
+      u.query_values = {schedules: sample_schedules[0]}
+      u.query.should eq(post_data)
+    end
+  end
+
+  describe "#handle_response_code" do
+    context "fails gracefully with undocumented responses" do
+      it "responds to 401 unauthorized response" do
+        id = "4eb8565e0acb04bb82000004"
+        stub_request(:get, "https://api.bufferapp.com/1/updates/#{id}.json?access_token=some_token").
+          to_return(fixture("update_by_id_non_auth.txt"))
+
+        lambda { client.update_by_id(id) }.
+          should raise_error(Buff::APIError)
+      end
+    end
+  end
+
+  describe "error_table" do
+    it "should report 1001 as appropriate message" do
+      table = Buff::Client::Core.error_table
+      table['1001'].should eq("Access token required.")
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,66 @@
+require 'buff'
+require 'rspec'
+require 'webmock/rspec'
+require 'json'
+
+require 'coveralls'
+Coveralls.wear!
+
+def fixture_path
+  File.expand_path(File.join("..", "fixtures"), __FILE__)
+end
+
+def fixture(file)
+  File.new(File.join(fixture_path, file))
+end
+
+def post_data
+<<EOF
+schedules[0][days][]=mon&schedules[0][days][]=tue&schedules[0][days][]=wed&schedules[0][times][]=12:00&schedules[0][times][]=17:00&schedules[0][times][]=18:00&
+EOF
+end
+
+def sample_schedules2
+    [{ days: %w[mon tue wed],
+      times: %w[12:00 17:00 18:00]},
+      {days: %w[mon tue wed],
+      times: %w[12:00 17:00 18:00]},
+    ]
+end
+def sample_schedules
+  [
+    [{ days: %w[mon tue wed],
+      times: %w[12:00 17:00 18:00]}]
+  ]
+  # @sample_schedules = JSON.parse <<EOF
+  #   [{
+  #       "days" : [
+  #           "mon",
+  #           "tue",
+  #           "wed",
+  #           "thu",
+  #           "fri"
+  #       ],
+  #       "times" : [
+  #           "12:00",
+  #           "17:00",
+  #           "18:00"
+  #       ]
+  #   },
+  #   {
+  #           "days" : [
+  #               "mon",
+  #               "tue",
+  #               "wed",
+  #               "thu",
+  #               "fri"
+  #           ],
+  #           "times" : [
+  #               "12:00",
+  #               "17:00",
+  #               "18:00"
+  #           ]
+  #       }]
+# EOF
+end
+

metadata

@@ -0,0 +1,270 @@
+--- !ruby/object:Gem::Specification
+name: buff
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- ZPH
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-05-19 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: guard-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: guard-bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rb-fsevent
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: growl
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: pry-full
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: multi_json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: yajl-ruby
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: faraday_middleware
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rash
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: addressable
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Buff is an API Wrapper Gem for Bufferapp.com's API
+email:
+- Zander@civet.ws
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .ruby-version
+- .travis.yml
+- Gemfile
+- Guardfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- buff.gemspec
+- lib/buff.rb
+- lib/buff/core.rb
+- lib/buff/encode.rb
+- lib/buff/error.rb
+- lib/buff/link.rb
+- lib/buff/profile.rb
+- lib/buff/update.rb
+- lib/buff/user.rb
+- lib/buff/version.rb
+- spec/lib/buff/encode_spec.rb
+- spec/lib/buff/link_spec.rb
+- spec/lib/buff/update_spec.rb
+- spec/lib/buff_spec.rb
+- spec/lib/core_spec.rb
+- spec/spec_helper.rb
+homepage: http://github.com/zph/buff
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+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: 2.0.3
+signing_key: 
+specification_version: 4
+summary: Buff is an API Wrapper Gem for Bufferapp.com's API
+test_files:
+- spec/lib/buff/encode_spec.rb
+- spec/lib/buff/link_spec.rb
+- spec/lib/buff/update_spec.rb
+- spec/lib/buff_spec.rb
+- spec/lib/core_spec.rb
+- spec/spec_helper.rb
+has_rdoc: