hashblue 0.0.1

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/.rspec

@@ -0,0 +1 @@
+-fn -c

data/Gemfile

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

data/MIT-LICENCE

@@ -0,0 +1,19 @@
+Copyright (C) 2011 by Go Free Range (http://gofreerange.com)
+
+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/Rakefile

@@ -0,0 +1,6 @@
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new
+
+task :default => :spec

data/hashblue.gemspec

@@ -0,0 +1,26 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "hashblue/version"
+
+Gem::Specification.new do |s|
+  s.name        = "hashblue"
+  s.version     = Hashblue::VERSION
+  s.authors     = ["Tom Ward"]
+  s.email       = ["tom@popdog.net"]
+  s.homepage    = "https://api.hashblue.com"
+  s.summary     = %q{A simple client for the hashblue api}
+  s.description = %q{A simple client for the hashblue api}
+
+  s.rubyforge_project = "hashblue"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_dependency 'httparty', '~>0.7.8'
+
+  s.add_development_dependency 'rake', '~>0.9.2'
+  s.add_development_dependency 'rspec', '~>2.6.0'
+  s.add_development_dependency 'mocha'
+end

data/lib/hashblue/account.rb

@@ -0,0 +1,21 @@
+module Hashblue
+  class Account < Model
+    attribute_methods :msisdn, :phone_number, :email
+
+    def messages(query = {})
+      client.load_messages(messages_uri, query)
+    end
+
+    def contacts(query = {})
+      client.load_contacts(contacts_uri, query)
+    end
+
+    def messages_uri
+      @attributes["messages"]
+    end
+
+    def contacts_uri
+      @attributes["contacts"]
+    end
+  end
+end

data/lib/hashblue/client.rb

@@ -0,0 +1,56 @@
+require 'httparty'
+
+module Hashblue
+  class Client
+    class RequestError < StandardError; end
+    
+    include HTTParty
+
+    base_uri "https://api.hashblue.com"
+
+    attr_reader :access_token, :refresh_token
+
+    def initialize(access_token, refresh_token = nil)
+      @access_token = access_token
+      @refresh_token = refresh_token
+    end
+
+    def account
+      @account ||= Account.new(self, get("/account")["account"])
+    end
+
+    def messages(query = {})
+      load_messages("/messages", query)
+    end
+
+    def contacts(query = {})
+      load_contacts("/contacts", query)
+    end
+
+    def load_messages(uri, query = {})
+      get(uri, query)["messages"].collect do |m|
+        Message.new(self, m)
+      end
+    end
+
+    def load_contacts(uri, query = {})
+      get(uri, query)["contacts"].collect do |m|
+        Contact.new(self, m)
+      end
+    end
+
+    def get(path, query = {})
+      response = self.class.get path, :query => query, :headers => request_headers
+      case response.headers["status"]
+      when "200" then response.to_hash
+      else raise RequestError, "request unsuccessful: #{response.to_hash.inspect}"
+      end
+    end
+
+    private
+
+    def request_headers
+      {"Authorization" => "OAuth #{access_token}", 'Accept' => 'application/json'}
+    end
+  end
+end

data/lib/hashblue/contact.rb

@@ -0,0 +1,13 @@
+module Hashblue
+  class Contact < Model
+    attribute_methods :name, :phone_number, :msisdn, :email
+
+    def messages(query = {})
+      client.load_messages(messages_uri, query)
+    end
+
+    def messages_uri
+      @attributes["messages"]
+    end
+  end
+end

data/lib/hashblue/message.rb

@@ -0,0 +1,17 @@
+module Hashblue
+  class Message < Model
+    attribute_methods :uri, :timestamp, :content
+
+    def sent?
+      @attributes["sent"]
+    end
+
+    def favourite?
+      @attributes["favourite"]
+    end
+
+    def contact
+      @contact ||= Contact.new(client, @attributes["contact"])
+    end
+  end
+end

data/lib/hashblue/model.rb

@@ -0,0 +1,26 @@
+module Hashblue
+  class Model
+    attr_accessor :client
+
+    def initialize(client, attributes)
+      @client = client
+      @attributes = attributes
+    end
+
+    def attributes
+      @attributes.dup
+    end
+
+    def eql?(m)
+      m.is_a?(self.class) && m.attributes.eql?(attributes)
+    end
+
+    def self.attribute_methods(*names)
+      names.each do |name|
+        define_method(name) do
+          @attributes[name.to_s]
+        end
+      end
+    end
+  end
+end

data/lib/hashblue/version.rb

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

data/lib/hashblue.rb

@@ -0,0 +1,11 @@
+require "hashblue/version"
+
+module Hashblue
+  autoload :Account, 'hashblue/account'
+  autoload :Client, 'hashblue/client'
+  autoload :Contact, 'hashblue/contact'
+  autoload :Message, 'hashblue/message'
+  autoload :Model, 'hashblue/model'
+  autoload :Version, 'hashblue/version'
+  # Your code goes here...
+end

data/spec/models/account_spec.rb

@@ -0,0 +1,28 @@
+require 'spec_helper'
+
+describe Hashblue::Account do
+  let :client do
+    Hashblue::Client.new('hashblue-access-token')
+  end
+
+  subject do
+    Hashblue::Account.new(client, {
+      'messages' => 'https://api.example.com/messages',
+      'contacts' => 'https://api.example.com/contacts'
+    })
+  end
+
+  describe '#messages' do
+    it "loads messages from its messages uri" do
+      client.expects(:load_messages).with('https://api.example.com/messages', {}).returns([:some_messages])
+      subject.messages.should eql([:some_messages])
+    end
+  end
+
+  describe '#contacts' do
+    it "loads contacts from its contacts uri" do
+      client.expects(:load_contacts).with('https://api.example.com/contacts', {}).returns([:some_contacts])
+      subject.contacts.should eql([:some_contacts])
+    end
+  end
+end

data/spec/models/client_spec.rb

@@ -0,0 +1,67 @@
+require 'spec_helper'
+
+describe Hashblue::Client do
+  subject do
+    Hashblue::Client.new('hashblue-access-token')
+  end
+
+  describe '#get' do
+    it "makes requests with Authorization and Accept headers and passed query" do
+      Hashblue::Client.expects(:get).with("/messages",
+        :headers => {
+          "Authorization" => "OAuth hashblue-access-token",
+          "Accept" => "application/json"
+        },
+        :query => {
+          :since => '2011-01-14T14:30Z'
+        }
+      ).returns(mock(:headers => {"status" => "200"}, :to_hash => {}))
+      subject.get "/messages", :since => '2011-01-14T14:30Z'
+    end
+
+    it "raises RequestError if response status isn't 200" do
+      Hashblue::Client.expects(:get).with("/messages",
+        :headers => {
+          "Authorization" => "OAuth hashblue-access-token",
+          "Accept" => "application/json"
+        },
+        :query => {}
+      ).returns(mock(:headers => {"status" => "401"}, :to_hash => {}))
+      lambda {subject.get "/messages"}.should raise_error(Hashblue::Client::RequestError)
+    end
+  end
+
+  describe '#account' do
+    it "returns Account model built with response from GET /account" do
+      attributes = {
+        "msisdn" => "4479001234567"
+      }
+      subject.stubs(:get).returns("account" => attributes)
+      subject.account.should eql(Hashblue::Account.new(subject, attributes))
+    end
+  end
+
+  describe '#messages(query = {})' do
+    it "loads messages from '/messages'" do
+      subject.expects(:load_messages).with('/messages', {}).returns([:some_messages])
+      subject.messages.should eql([:some_messages])
+    end
+
+    it "passes query through to load_messages" do
+      subject.expects(:load_messages).with('/messages', {:anything => :here})
+      subject.messages(:anything => :here)
+    end
+  end
+
+  describe '#contacts(query = {})' do
+    it "loads contacts from '/contacts'" do
+      subject.expects(:load_contacts).with('/contacts', {}).returns([:some_contacts])
+      subject.contacts.should eql([:some_contacts])
+    end
+
+    it "passes query through to load_contacts" do
+      subject.expects(:load_contacts).with('/contacts', {:anything => :here})
+      subject.contacts(:anything => :here)
+    end
+  end
+end

data/spec/models/contact_spec.rb

@@ -0,0 +1,20 @@
+require 'spec_helper'
+
+describe Hashblue::Contact do
+  let :client do
+    Hashblue::Client.new('hashblue-access-token')
+  end
+
+  subject do
+    Hashblue::Contact.new(client, {
+      'messages' => 'https://api.example.com/contact/1/messages',
+    })
+  end
+
+  describe '#messages' do
+    it "loads messages from its messages uri" do
+      client.expects(:load_messages).with('https://api.example.com/contact/1/messages', {}).returns([:some_messages])
+      subject.messages.should eql([:some_messages])
+    end
+  end
+end

data/spec/models/message_spec.rb

@@ -0,0 +1,25 @@
+require 'spec_helper'
+
+describe Hashblue::Message do
+  let :client do
+    Hashblue::Client.new('hashblue-access-token')
+  end
+
+  subject do
+    Hashblue::Message.new(client, {
+      'sent' => true,
+      'favourite' => false,
+      'contact' => {
+        'messages' => 'https://api.example.com/contacts/2/messages'
+      }
+    })
+  end
+
+  describe '#contact' do
+    it "returns Contact built with contact attributes" do
+      subject.contact.should eql(Hashblue::Contact.new(client, {
+        'messages' => 'https://api.example.com/contacts/2/messages'
+      }))
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,6 @@
+require 'bundler/setup'
+require 'hashblue'
+
+RSpec.configure do |config|
+  config.mock_with :mocha
+end

metadata

@@ -0,0 +1,148 @@
+--- !ruby/object:Gem::Specification 
+name: hashblue
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: 
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Tom Ward
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-06-21 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  type: :runtime
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 19
+        segments: 
+        - 0
+        - 7
+        - 8
+        version: 0.7.8
+  version_requirements: *id001
+  name: httparty
+  prerelease: false
+- !ruby/object:Gem::Dependency 
+  type: :development
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 63
+        segments: 
+        - 0
+        - 9
+        - 2
+        version: 0.9.2
+  version_requirements: *id002
+  name: rake
+  prerelease: false
+- !ruby/object:Gem::Dependency 
+  type: :development
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 23
+        segments: 
+        - 2
+        - 6
+        - 0
+        version: 2.6.0
+  version_requirements: *id003
+  name: rspec
+  prerelease: false
+- !ruby/object:Gem::Dependency 
+  type: :development
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  version_requirements: *id004
+  name: mocha
+  prerelease: false
+description: A simple client for the hashblue api
+email: 
+- tom@popdog.net
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- .rspec
+- Gemfile
+- MIT-LICENCE
+- Rakefile
+- hashblue.gemspec
+- lib/hashblue.rb
+- lib/hashblue/account.rb
+- lib/hashblue/client.rb
+- lib/hashblue/contact.rb
+- lib/hashblue/message.rb
+- lib/hashblue/model.rb
+- lib/hashblue/version.rb
+- spec/models/account_spec.rb
+- spec/models/client_spec.rb
+- spec/models/contact_spec.rb
+- spec/models/message_spec.rb
+- spec/spec_helper.rb
+homepage: https://api.hashblue.com
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+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"
+requirements: []
+
+rubyforge_project: hashblue
+rubygems_version: 1.8.5
+signing_key: 
+specification_version: 3
+summary: A simple client for the hashblue api
+test_files: 
+- spec/models/account_spec.rb
+- spec/models/client_spec.rb
+- spec/models/contact_spec.rb
+- spec/models/message_spec.rb
+- spec/spec_helper.rb