context-io 0.0.1

data/spec/contextio_spec.rb

@@ -0,0 +1,45 @@
+require 'spec_helper'
+
+describe ContextIO do
+  after do
+    ContextIO.reset
+  end
+
+  describe '.adapter' do
+    it 'should return the default adapter' do
+      ContextIO.adapter.should == ContextIO::Config::DEFAULT_ADAPTER
+    end
+  end
+
+  describe '.adapter=' do
+    it 'should set the adapter' do
+      ContextIO.adapter = :typhoeus
+      ContextIO.adapter.should == :typhoeus
+    end
+  end
+
+  describe '.user_agent' do
+    it 'should return the default user agent' do
+      ContextIO.user_agent.should == ContextIO::Config::DEFAULT_USER_AGENT
+    end
+  end
+
+  describe '.user_agent=' do
+    it 'should set the user agent' do
+      ContextIO.user_agent = 'Custom User Agent'
+      ContextIO.user_agent.should == 'Custom User Agent'
+    end
+  end
+
+  describe '.configure' do
+    ContextIO::Config::VALID_OPTIONS_KEYS.each do |key|
+      it "should set the #{key}" do
+        ContextIO.configure do |config|
+          config.send("#{key}=", key)
+          ContextIO.send(key).should == key
+        end
+      end
+    end
+  end
+end
+

data/spec/file_spec.rb

@@ -0,0 +1,101 @@
+require 'spec_helper'
+
+describe ContextIO::File do
+  before(:each) do
+    @fixtures_path = File.expand_path(File.join(File.dirname(__FILE__), 'fixtures'))
+    account_id = 'abcdef1234567890'
+    @account = ContextIO::Account.new
+    @account.instance_eval do
+      # TODO: Tests shouldn't rely on internal state...
+      @id = account_id
+    end
+    @files_url = "https://api.context.io/2.0/accounts/#{account_id}/files"
+  end
+
+  describe '.all' do
+    before(:each) do
+      json_files = File.read(File.join(@fixtures_path, 'files.json'))
+      @request = stub_request(:get, @files_url).to_return(:body => json_files)
+    end
+
+    it 'returns an array of File objects' do
+      ContextIO::File.all(@account).first.should be_a(ContextIO::File)
+    end
+
+    it 'calls the API request' do
+      ContextIO::File.all(@account)
+
+      @request.should have_been_requested
+    end
+
+    it 'sends a query if one is given' do
+      @request.with(:query => { :email => 'me@example.com'})
+
+      ContextIO::File.all(@account, :email => 'me@example.com')
+
+      @request.should have_been_requested
+    end
+
+    it 'supports searching for a filename with a regexp' do
+      @request.with(:query => { :file_name => '/\.pdf$/'})
+
+      ContextIO::File.all(@account, :file_name => /\.pdf$/)
+
+      @request.should have_been_requested
+    end
+
+    it 'converts Time objects to integer timestamps' do
+      time = Time.now
+      @request.with(:query => { :date_before => time.to_i.to_s })
+
+      ContextIO::File.all(@account, :date_before => time)
+
+      @request.should have_been_requested
+    end
+
+    context 'group_by_revisions' do
+      before(:each) do
+        json_files = File.read(File.join(@fixtures_path, 'files_group.json'))
+        @request = stub_request(:get, @files_url).
+          with(:query => { :group_by_revisions => '1' }).
+          to_return(:body => json_files)
+      end
+
+      it 'converts occurences to File objects' do
+        files = ContextIO::File.all(@account, :group_by_revisions => true)
+        files.first[:occurences].first.should be_a(ContextIO::File)
+      end
+
+      it 'converts latest_date to a Time object' do
+        files = ContextIO::File.all(@account, :group_by_revisions => true)
+        files.first[:latest_date].should be_a(Time)
+      end
+    end
+  end
+
+  describe '#content' do
+    before(:each) do
+      json_files = MultiJson.decode(File.read(File.join(@fixtures_path, 'files.json')))
+      file = json_files.first
+      @file_url = "#@files_url/#{file['file_id']}"
+      @request = stub_request(:get, @file_url).to_return(:body => MultiJson.encode(file))
+      @file = ContextIO::File.from_json(@account.id, file)
+    end
+
+    it 'calls the API request' do
+      request = stub_request(:get, "#@file_url/content")
+
+      @file.content
+
+      request.should have_been_requested
+    end
+
+    it 'does not parse the response' do
+      content = '{ "foo": "bar" }'
+      request = stub_request(:get, "#@file_url/content").
+        to_return(:body => content)
+
+      @file.content.should == content
+    end
+  end
+end

data/spec/fixtures/accounts.json

@@ -0,0 +1,21 @@
+[{"id": "abcdef0123456789",
+  "username": "me.example.com_1234567890abcdef",
+  "created": 1234567890,
+  "suspended": 0,
+  "email_addresses": [ "me@example.com" ],
+  "first_name": "John",
+  "last_name": "Doe",
+  "password_expired": 0,
+  "sources": [{
+      "server": "mail.example.com",
+      "label": "me::mail.example.com",
+      "username": "me",
+      "port": 993,
+      "authentication_type": "password",
+      "use_ssl": true,
+      "sync_period": "1d",
+      "status": "OK",
+      "service_level": "pro",
+      "type": "imap"
+  }]
+ }]

data/spec/fixtures/files.json

@@ -0,0 +1,41 @@
+[
+  {
+    "size": 123456,
+    "type": "application/octet-stream",
+    "subject": "A subject",
+    "date": 1234567890,
+    "addresses": {
+      "from": {
+        "email": "you@example.com"
+      },
+      "to": [{
+        "email": "me@example.com"
+      }]
+    },
+    "file_name": "a_file.pdf",
+    "body_section": 3,
+    "file_id": "0987654321abcdef",
+    "supports_preview": true,
+    "message_id": "0987654321fedcba",
+    "date_indexed": 1234567900,
+    "email_message_id": "<0192837465ABCDEFABCDEF@ABCDEFGHIJK>",
+    "person_info": {
+      "you@example.com": {
+        "thumbnail": "http://example.com/you.png"
+      },
+      "me@example.com": {
+        "thumbnail": "http://example.com/me.com"
+      }
+    },
+    "file_name_structure": [
+      [
+        "a_file",
+        "main"
+      ],
+      [
+        ".pdf",
+        "ext"
+      ]
+    ]
+  }
+]

data/spec/fixtures/files_group.json

@@ -0,0 +1,47 @@
+[
+  {
+    "occurences": [
+      {
+        "size": 123456,
+        "type": "application/octet-stream",
+        "subject": "A subject",
+        "date": 1234567890,
+        "addresses": {
+          "from": {
+            "email": "you@example.com"
+          },
+          "to": [{
+            "email": "me@example.com"
+          }]
+        },
+        "file_name": "a_file.pdf",
+        "body_section": 3,
+        "file_id": "0987654321abcdef",
+        "supports_preview": true,
+        "message_id": "0987654321fedcba",
+        "date_indexed": 1234567900,
+        "email_message_id": "<0192837465ABCDEFABCDEF@ABCDEFGHIJK>",
+        "person_info": {
+          "you@example.com": {
+            "thumbnail": "http://example.com/you.png"
+          },
+          "me@example.com": {
+            "thumbnail": "http://example.com/me.com"
+          }
+        },
+        "file_name_structure": [
+          [
+            "a_file",
+            "main"
+          ],
+          [
+            ".pdf",
+            "ext"
+          ]
+        ]
+      }
+    ],
+    "file_name": "a_file.pdf",
+    "latest_date": 1234567890
+  }
+]

data/spec/fixtures/folders.json

@@ -0,0 +1 @@
+[{"name":"Follow up","nb_messages":"0","attributes":{"Noinferiors":false,"Marked":false,"HasChildren":false,"Noselect":false,"HasNoChildren":true},"delim":"/"},{"name":"INBOX","nb_messages":"15","attributes":{"Noinferiors":false,"Marked":false,"HasChildren":false,"Noselect":false,"HasNoChildren":true},"delim":"/"},{"name":"Misc","nb_messages":"0","attributes":{"Noinferiors":false,"Marked":false,"HasChildren":false,"Noselect":false,"HasNoChildren":true},"delim":"/"},{"name":"Priority","nb_messages":"0","attributes":{"Noinferiors":false,"Marked":false,"HasChildren":false,"Noselect":false,"HasNoChildren":true},"delim":"/"},{"name":"[Gmail]/All Mail","nb_messages":20,"delim":"/","symbolic_name":"\\AllMail","included_in_sync":true},{"name":"[Gmail]/Drafts","nb_messages":"0","attributes":{"Noinferiors":false,"Marked":false,"HasChildren":false,"Noselect":false,"HasNoChildren":true},"delim":"/","symbolic_name":"\\Drafts"},{"name":"[Gmail]/Important","nb_messages":"3","attributes":{"Noinferiors":false,"Marked":false,"HasChildren":false,"Noselect":false,"HasNoChildren":true},"delim":"/","symbolic_name":"\\Important"},{"name":"[Gmail]/Sent Mail","nb_messages":"1","attributes":{"Noinferiors":false,"Marked":false,"HasChildren":false,"Noselect":false,"HasNoChildren":true},"delim":"/","symbolic_name":"\\Sent"},{"name":"[Gmail]/Starred","nb_messages":"0","attributes":{"Noinferiors":false,"Marked":false,"HasChildren":false,"Noselect":false,"HasNoChildren":true},"delim":"/","symbolic_name":"\\Starred"},{"name":"[Gmail]/Trash","nb_messages":"1","attributes":{"Noinferiors":false,"Marked":false,"HasChildren":true,"Noselect":false,"HasNoChildren":true},"delim":"/","symbolic_name":"\\Trash"}]

data/spec/fixtures/messages.json

@@ -0,0 +1 @@
+[{"date_indexed":1326390355,"person_info":{"james@example.com":{"thumbnail":"https://secure.gravatar.com/avatar/da027b7f882991709b63a08e7e300221?s=50&d=https%3A%2F%2Fapp.dokdok.com%2Findex.php%3Fdo%3Dusrgetimg%26id%3D-1"},"mail-noreply@google.com":{"thumbnail":"https://secure.gravatar.com/avatar/eee980fd43816c612e888a1b63907aef?s=50&d=https%3A%2F%2Fapp.dokdok.com%2Findex.php%3Fdo%3Dusrgetimg%26id%3D-1"}},"gmail_message_id":"1339e889bae8fff8","email_message_id":"<CA+him2-bVdNrrugkU7rkDtj-Wn-gk2d=bPiBBWk+iagtVV1csQ@mail.gmail.com>","addresses":{"from":{"name":"Gmail Team","email":"mail-noreply@google.com"},"to":[{"name":"James Dean","email":"james@example.com"}]},"subject":"Get Gmail on your mobile phone","date":1321214712,"gmail_thread_id":"1339e889bae8fff8","sources":[{"label":"james@example.com::imap.googlemail.com","resource_url":"https://api.context.io/2.0/accounts/4f0f1c4f3f757edc3b000002/sources/james%40example.com%3A%3Aimap.googlemail.com"}],"folders":["\\Inbox","INBOX"],"message_id":"4f0f1c533f757e0f3c00000b"},{"date_indexed":1326390355,"person_info":{"james@example.com":{"thumbnail":"https://secure.gravatar.com/avatar/da027b7f882991709b63a08e7e300221?s=50&d=https%3A%2F%2Fapp.dokdok.com%2Findex.php%3Fdo%3Dusrgetimg%26id%3D-1"},"mail-noreply@google.com":{"thumbnail":"https://secure.gravatar.com/avatar/eee980fd43816c612e888a1b63907aef?s=50&d=https%3A%2F%2Fapp.dokdok.com%2Findex.php%3Fdo%3Dusrgetimg%26id%3D-1"}},"gmail_message_id":"1339e889bcda5676","email_message_id":"<CA+him2_6bjYfmDmM9ai5N3bDovACCKUwb5XWCc1XRn=7LdTsQA@mail.gmail.com>","addresses":{"from":{"name":"Gmail Team","email":"mail-noreply@google.com"},"to":[{"name":"James Dean","email":"james@example.com"}]},"subject":"Customize Gmail with colors and themes","date":1321214712,"gmail_thread_id":"1339e889bcda5676","sources":[{"label":"james@example.com::imap.googlemail.com","resource_url":"https://api.context.io/2.0/accounts/4f0f1c4f3f757edc3b000002/sources/james%40example.com%3A%3Aimap.googlemail.com"}],"folders":["\\Inbox","INBOX"],"message_id":"4f0f1c533f757e0f3c00000c"}]

data/spec/fixtures/oauth_providers.json

@@ -0,0 +1,12 @@
+[
+  {
+    "type": "GMAIL",
+    "provider_consumer_key": "1qa2ws3ed",
+    "provider_consumer_secret": "aq1sw2de3fr4gt5"
+  },
+  {
+    "type": "GOOGLEAPPSMARKETPLACE",
+    "provider_consumer_key": "qazwsxedc",
+    "provider_consumer_secret": "zaqxswcdevfrbgt"
+  }
+]

data/spec/fixtures/sources.json

@@ -0,0 +1 @@
+[{"label":"bi@example.com::imap.example.com","authentication_type":"oauth","port":993,"service_level":"pro","username":"bi@example.com","server":"imap.example.com","type":"imap","sync_period":"1d","use_ssl":true,"status":"OK"}]

data/spec/folder_spec.rb

@@ -0,0 +1,48 @@
+require 'spec_helper'
+
+describe ContextIO::Folder do
+  before(:each) do
+    @fixtures_path = File.expand_path(File.join(File.dirname(__FILE__), 'fixtures'))
+    account_id = 'abcdef1234567890'
+    @account = ContextIO::Account.new
+    @account.instance_eval do
+      @id = account_id
+    end
+    source_label = 'me@example.com::imap.example.com'
+    @source = ContextIO::Source.new(account_id)
+    @source.instance_eval { @label = source_label }
+
+    @folders_url = "https://api.context.io/2.0/accounts/#{account_id}/sources/#{source_label}/folders"
+  end
+
+  describe '.all' do
+    before(:each) do
+      json_folders = File.read(File.join(@fixtures_path, 'folders.json'))
+      @response = stub_request(:get, @folders_url).
+        to_return(:body => json_folders)
+    end
+
+    it 'accepts a Source object as an argument' do
+      expect { ContextIO::Folder.all(@source) }.to_not raise_error
+    end
+
+    it 'accepts an account ID and a source label as arguments' do
+      expect { ContextIO::Folder.all(@account.id, @source.label) }.to_not raise_error
+    end
+
+    it 'returns an array of Folder objects' do
+      folders = ContextIO::Folder.all(@source)
+      folders.first.should be_a(ContextIO::Folder)
+    end
+
+    it 'calls the API method' do
+      ContextIO::Folder.all(@source)
+      @response.should have_been_requested
+    end
+
+    it 'sets the name of Folder object' do
+      folder = ContextIO::Folder.all(@source).first
+      folder.name.should == 'Follow up'
+    end
+  end
+end

data/spec/message_spec.rb

@@ -0,0 +1,294 @@
+require 'spec_helper'
+
+describe ContextIO::Message do
+  before(:each) do
+    @fixtures_path = File.expand_path(File.join(File.dirname(__FILE__), 'fixtures'))
+    account_id = 'abcdef1234567890'
+    @account = ContextIO::Account.new
+    @account.instance_eval do
+      @id = account_id
+    end
+    @messages_url = "https://api.context.io/2.0/accounts/#{account_id}/messages"
+
+  end
+
+  describe '.all' do
+    before(:each) do
+      json_messages = File.read(File.join(@fixtures_path, 'messages.json'))
+      @response = stub_request(:get, @messages_url).
+        to_return(:body => json_messages)
+    end
+
+    it 'returns an array of Message objects for given account ID' do
+      messages = ContextIO::Message.all(@account.id)
+      messages.should be_a(Array)
+      messages.first.should be_a(ContextIO::Message)
+    end
+
+    it 'returns an array of Message objects for given Account object' do
+      messages = ContextIO::Message.all(@account)
+      messages.should be_a(Array)
+      messages.first.should be_a(ContextIO::Message)
+    end
+
+    it 'returns empty array when no account is given' do
+      messages = ContextIO::Message.all(nil)
+      messages.should be_a(Array)
+      messages.length.should == 0
+    end
+
+    it 'calls the API method' do
+      ContextIO::Message.all(@account)
+      @response.should have_been_requested
+    end
+
+    it 'sets attributes of Message object' do
+      msg = ContextIO::Message.all(@account).first
+      msg.message_id.should == '4f0f1c533f757e0f3c00000b'
+      msg.subject.should == 'Get Gmail on your mobile phone'
+      msg.from['name'].should == 'Gmail Team'
+      msg.to.length.should == 1
+    end
+
+    it 'sends query' do
+      q = {
+        :subject => 'Some subject',
+        :email => 'james@example.net',
+        :to => 'james@example.com',
+        :limit => '30',
+        :offset => '30'
+      }
+
+      @response = @response.with(:query => q)
+
+      ContextIO::Message.all(@account, q)
+      @response.should have_been_requested
+    end
+  end
+
+  describe 'message flags' do
+    before(:each) do
+      @msg_id = '4f0f1c533f757e0f3c00000b'
+      json_messages = File.read(File.join(@fixtures_path, 'messages.json'))
+      @response = stub_request(:get, @messages_url).
+        to_return(:body => json_messages)
+    end
+
+    it 'retrieves flags' do
+      flags_response = stub_request(:get, "#{@messages_url}/#{@msg_id}/flags").
+        to_return(:body => '{"answered":false,"draft":false,"deleted":false,"seen":true,"flagged":false}')
+      flags = ContextIO::Message.all(@account).first.flags
+      flags.should be_a(Hash)
+      flags['seen'].should == true
+    end
+
+    it 'sets read flag' do
+      flags_response = stub_request(:post, "#{@messages_url}/#{@msg_id}/flags").
+        with(:body => { "seen" => "true" }).
+        to_return(:body => '{"success":true}')
+      ContextIO::Message.all(@account).first.read!.should be_true
+    end
+
+    it 'resets read flag' do
+      flags_response = stub_request(:post, "#{@messages_url}/#{@msg_id}/flags").
+        with(:body => { "seen" => "false" }).
+        to_return(:body => '{"success":true}')
+      ContextIO::Message.all(@account).first.unread!.should be_true
+    end
+
+    it 'sets flagged flag' do
+      flags_response = stub_request(:post, "#{@messages_url}/#{@msg_id}/flags").
+        with(:body => { "flagged" => "true" }).
+        to_return(:body => '{"success":true}')
+      ContextIO::Message.all(@account).first.flagged!.should be_true
+    end
+
+    it 'resets flagged flag' do
+      flags_response = stub_request(:post, "#{@messages_url}/#{@msg_id}/flags").
+        with(:body => { "flagged" => "false" }).
+        to_return(:body => '{"success":true}')
+      ContextIO::Message.all(@account).first.unflagged!.should be_true
+    end
+
+    it 'sets answered flag' do
+      flags_response = stub_request(:post, "#{@messages_url}/#{@msg_id}/flags").
+        with(:body => { "answered" => "true" }).
+        to_return(:body => '{"success":true}')
+      ContextIO::Message.all(@account).first.answered!.should be_true
+    end
+
+    it 'resets answered flag' do
+      flags_response = stub_request(:post, "#{@messages_url}/#{@msg_id}/flags").
+        with(:body => { "answered" => "false" }).
+        to_return(:body => '{"success":true}')
+      ContextIO::Message.all(@account).first.unanswered!.should be_true
+    end
+
+    it 'sets draft flag' do
+      flags_response = stub_request(:post, "#{@messages_url}/#{@msg_id}/flags").
+        with(:body => { "draft" => "true" }).
+        to_return(:body => '{"success":true}')
+      ContextIO::Message.all(@account).first.draft!.should be_true
+    end
+
+    it 'resets draft flag' do
+      flags_response = stub_request(:post, "#{@messages_url}/#{@msg_id}/flags").
+        with(:body => { "draft" => "false" }).
+        to_return(:body => '{"success":true}')
+      ContextIO::Message.all(@account).first.undraft!.should be_true
+    end
+
+    it 'sets deleted flag' do
+      flags_response = stub_request(:post, "#{@messages_url}/#{@msg_id}/flags").
+        with(:body => { "deleted" => "true" }).
+        to_return(:body => '{"success":true}')
+      ContextIO::Message.all(@account).first.delete!.should be_true
+    end
+
+    it 'resets deleted flag' do
+      flags_response = stub_request(:post, "#{@messages_url}/#{@msg_id}/flags").
+        with(:body => { "deleted" => "false" }).
+        to_return(:body => '{"success":true}')
+      ContextIO::Message.all(@account).first.undelete!.should be_true
+    end
+  end
+
+  describe 'thread' do
+    before(:each) do
+      json_messages = File.read(File.join(@fixtures_path, 'messages.json'))
+      thread_messages = "{\"messages\": #{json_messages}}"
+      stub_request(:get, @messages_url).to_return(:body => json_messages)
+      msg_id = '4f0f1c533f757e0f3c00000b'
+      @response = stub_request(:get, "#{@messages_url}/#{msg_id}/thread").
+        to_return(:body => thread_messages)
+    end
+
+    it 'returns array of Message objects' do
+      thread = ContextIO::Message.all(@account).first.thread
+      thread.should be_a(Array)
+      thread.first.should be_a(ContextIO::Message)
+    end
+
+    it 'calls API method' do
+      ContextIO::Message.all(@account).first.thread
+      @response.should have_been_requested
+    end
+  end
+
+  describe 'body and headers lazy loading' do
+    before(:each) do
+      msg_id = '4f0f1c533f757e0f3c00000b'
+      body = '[
+        {
+          "type": "text/plain",
+          "content":"Just a message"
+        },
+        {
+          "type": "text/html",
+          "content": "<html><p>Just a message</p></html>"
+        }]'
+      headers = '{"Received":"by 10.10.1.1"}'
+      json_messages = File.read(File.join(@fixtures_path, 'messages.json'))
+      stub_request(:get, @messages_url).
+        to_return(:body => json_messages)
+      @body_resp = stub_request(:get, "#{@messages_url}/#{msg_id}/body").
+        to_return(:body => body)
+      @headers_resp = stub_request(:get, "#{@messages_url}/#{msg_id}/headers").
+        to_return(:body => headers)
+    end
+
+    it 'requests body on first access' do
+      msg = ContextIO::Message.all(@account).first
+      msg.body.should == 'Just a message'
+      msg.body('html').start_with?('<html>').should be_true
+      @body_resp.should have_been_requested
+    end
+
+    it 'does not request body on second request' do
+      msg = ContextIO::Message.all(@account).first
+      msg.body
+      msg.body
+      @body_resp.should have_been_made.once
+    end
+
+    it 'requests headers' do
+      msg = ContextIO::Message.all(@account).first
+      msg.headers.should be_a(Hash)
+      msg.headers['Received'].should == 'by 10.10.1.1'
+      @headers_resp.should have_been_requested
+    end
+
+    it 'does not request headers on second request' do
+      msg = ContextIO::Message.all(@account).first
+      msg.headers
+      msg.headers
+      @headers_resp.should have_been_made.once
+    end
+  end
+
+  describe "copy" do
+    before(:each) do
+      msgs = MultiJson.decode(File.read(File.join(@fixtures_path, 'messages.json')))
+      @message = ContextIO::Message.from_json(@account.id, msgs.first)
+      copy_options = {:dst_folder => "Important", :move => '0'}
+      copy_to_source = {:dst_folder => "Important", :dst_source => "Other Source", :move => '0'}
+      @copy_response = stub_request(:post, "#{@messages_url}/#{@message.message_id}").
+        with(:body => copy_options)
+      @copy_to_source_response = stub_request(:post, "#{@messages_url}/#{@message.message_id}").
+        with(:body => copy_to_source)
+    end
+
+    it 'raises ArgumentError for empty target folder' do
+      lambda { @message.copy(nil) }.should raise_error ArgumentError
+    end
+
+    it "copy calls API method with copy options" do
+      @message.copy("Important")
+      @copy_response.should have_been_requested
+    end
+
+    it "copy to source calls API method with source in post arguments" do
+      @message.copy("Important", "Other Source")
+      @copy_to_source_response.should have_been_requested
+    end
+  end
+
+  describe "move" do
+    before(:each) do
+      msgs = MultiJson.decode(File.read(File.join(@fixtures_path, 'messages.json')))
+      @message = ContextIO::Message.from_json(@account.id, msgs.first)
+      move_options = {:dst_folder => "Important", :move => '1'}
+      @move_response = stub_request(:post, "#{@messages_url}/#{@message.message_id}").
+        with(:body => move_options)
+    end
+
+    it 'raises ArgumentError for empty target folder' do
+      lambda { @message.move(nil) }.should raise_error ArgumentError
+    end
+
+    it "move calls API method with move options" do
+      @message.move("Important")
+      @move_response.should have_been_requested
+    end
+  end
+  
+  describe '.find' do
+    before(:each) do
+      @messages = MultiJson.decode(File.read(File.join(@fixtures_path, 'messages.json')))
+      @find_url = "#{@messages_url}/#{@messages.first['message_id']}"
+      @response = stub_request(:get, @find_url).
+        to_return(:body => MultiJson.encode(@messages.first))
+    end
+
+    it 'calls API method' do
+      ContextIO::Message.find(@account, @messages.first['message_id'])
+      @response.should have_been_requested
+    end
+
+    it 'returns single message for given ID' do
+      msg = ContextIO::Message.find(@account, @messages.first['message_id'])
+      msg.should be_a(ContextIO::Message)
+      msg.message_id.should == @messages.first['message_id']
+    end
+  end
+end