pew_pew 0.0.1

data/spec/fixtures/stats.yml

@@ -0,0 +1,61 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://api.mailgun.net/v2/<%= domain %>/stats
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      User-Agent:
+      - PewPew Ruby Gem 0.0.1
+      Authorization:
+      - Basic <%= basic_auth %>
+  response:
+    status:
+      code: 200
+      message: 
+    headers:
+      server:
+      - nginx/1.0.14
+      date:
+      - Fri, 01 Jun 2012 20:01:54 GMT
+      content-type:
+      - application/json
+      connection:
+      - close
+      content-length:
+      - '1817'
+      content-disposition:
+      - inline
+    body:
+      encoding: US-ASCII
+      string: ! "{\n  \"total_count\": 10, \n  \"items\": [\n    {\n      \"total_count\":
+        11, \n      \"created_at\": \"Fri, 01 Jun 2012 00:00:00 GMT\", \n      \"tags\":
+        {}, \n      \"id\": \"4fc837558393c1618263d76c\", \n      \"event\": \"sent\"\n
+        \   }, \n    {\n      \"total_count\": 11, \n      \"created_at\": \"Fri,
+        01 Jun 2012 00:00:00 GMT\", \n      \"tags\": {}, \n      \"id\": \"4fc837568393c1618263d76d\",
+        \n      \"event\": \"delivered\"\n    }, \n    {\n      \"total_count\": 6,
+        \n      \"created_at\": \"Tue, 29 May 2012 00:00:00 GMT\", \n      \"tags\":
+        {}, \n      \"id\": \"4fc55a2e8393c161826132b5\", \n      \"event\": \"sent\"\n
+        \   }, \n    {\n      \"total_count\": 6, \n      \"created_at\": \"Tue, 29
+        May 2012 00:00:00 GMT\", \n      \"tags\": {}, \n      \"id\": \"4fc55a2f8393c161826132b7\",
+        \n      \"event\": \"delivered\"\n    }, \n    {\n      \"total_count\": 5,
+        \n      \"created_at\": \"Sat, 26 May 2012 00:00:00 GMT\", \n      \"tags\":
+        {}, \n      \"id\": \"4fc01d548393c161825f53a7\", \n      \"event\": \"sent\"\n
+        \   }, \n    {\n      \"total_count\": 5, \n      \"created_at\": \"Sat, 26
+        May 2012 00:00:00 GMT\", \n      \"tags\": {}, \n      \"id\": \"4fc01d558393c161825f53aa\",
+        \n      \"event\": \"delivered\"\n    }, \n    {\n      \"total_count\": 4,
+        \n      \"created_at\": \"Fri, 25 May 2012 00:00:00 GMT\", \n      \"tags\":
+        {}, \n      \"id\": \"4fc01c7c8393c161825f5233\", \n      \"event\": \"sent\"\n
+        \   }, \n    {\n      \"total_count\": 4, \n      \"created_at\": \"Fri, 25
+        May 2012 00:00:00 GMT\", \n      \"tags\": {}, \n      \"id\": \"4fc01c7d8393c161825f5235\",
+        \n      \"event\": \"delivered\"\n    }, \n    {\n      \"total_count\": 1,
+        \n      \"created_at\": \"Thu, 24 May 2012 00:00:00 GMT\", \n      \"tags\":
+        {}, \n      \"id\": \"4fbdeaac8393c161825e5f99\", \n      \"event\": \"sent\"\n
+        \   }, \n    {\n      \"total_count\": 1, \n      \"created_at\": \"Thu, 24
+        May 2012 00:00:00 GMT\", \n      \"tags\": {}, \n      \"id\": \"4fbdeaad8393c161825e5f9a\",
+        \n      \"event\": \"delivered\"\n    }\n  ]\n}"
+    http_version: 
+  recorded_at: Fri, 01 Jun 2012 20:01:54 GMT
+recorded_with: VCR 2.2.0

data/spec/fixtures/unsubscribes.yml

@@ -0,0 +1,219 @@
+---
+http_interactions:
+- request:
+    method: post
+    uri: https://api.mailgun.net/v2/<%= domain %>/unsubscribes
+    body:
+      encoding: US-ASCII
+      string: address=test%40example.com&tag=newsletter
+    headers:
+      User-Agent:
+      - PewPew Ruby Gem 0.0.1
+      Authorization:
+      - Basic <%= basic_auth %>
+      Content-Type:
+      - application/x-www-form-urlencoded
+  response:
+    status:
+      code: 200
+      message: 
+    headers:
+      server:
+      - nginx/1.0.14
+      date:
+      - Sat, 02 Jun 2012 02:53:29 GMT
+      content-type:
+      - application/json
+      connection:
+      - close
+      content-length:
+      - '101'
+      content-disposition:
+      - inline
+    body:
+      encoding: US-ASCII
+      string: ! "{\n  \"message\": \"Address has been added to the unsubscribes table\",
+        \n  \"address\": \"test@example.com\"\n}"
+    http_version: 
+  recorded_at: Sat, 02 Jun 2012 02:53:29 GMT
+- request:
+    method: post
+    uri: https://api.mailgun.net/v2/<%= domain %>/unsubscribes
+    body:
+      encoding: US-ASCII
+      string: address=test%40example.com&tag=%2A
+    headers:
+      User-Agent:
+      - PewPew Ruby Gem 0.0.1
+      Authorization:
+      - Basic <%= basic_auth %>
+      Content-Type:
+      - application/x-www-form-urlencoded
+  response:
+    status:
+      code: 200
+      message: 
+    headers:
+      server:
+      - nginx/1.0.14
+      date:
+      - Sat, 02 Jun 2012 02:54:37 GMT
+      content-type:
+      - application/json
+      connection:
+      - close
+      content-length:
+      - '100'
+      content-disposition:
+      - inline
+    body:
+      encoding: US-ASCII
+      string: ! "{\n  \"message\": \"Address has been added to the unsubscribes table\",\n
+        \ \"address\": \"test@example.com\"\n}"
+    http_version: 
+  recorded_at: Sat, 02 Jun 2012 02:54:37 GMT
+- request:
+    method: get
+    uri: https://api.mailgun.net/v2/<%= domain %>/unsubscribes/test@example.com
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      User-Agent:
+      - PewPew Ruby Gem 0.0.1
+      Authorization:
+      - Basic <%= basic_auth %>
+  response:
+    status:
+      code: 200
+      message: 
+    headers:
+      server:
+      - nginx/1.0.14
+      date:
+      - Sat, 02 Jun 2012 02:55:33 GMT
+      content-type:
+      - application/json
+      connection:
+      - close
+      content-length:
+      - '368'
+      content-disposition:
+      - inline
+    body:
+      encoding: US-ASCII
+      string: ! "{\n  \"total_count\": 2,\n  \"items\": [\n    {\n      \"created_at\":
+        \"Sat, 02 Jun 2012 02:54:37 GMT\",\n      \"tag\": \"*\",\n      \"id\": \"4fc9806d8393c1618264c360\",\n
+        \     \"address\": \"test@example.com\"\n    },\n    {\n      \"created_at\":
+        \"Sat, 02 Jun 2012 02:53:29 GMT\",\n      \"tag\": \"newsletter\",\n      \"id\":
+        \"4fc980298393c1618264c34d\",\n      \"address\": \"test@example.com\"\n    }\n
+        \ ]\n}"
+    http_version: 
+  recorded_at: Sat, 02 Jun 2012 02:55:33 GMT
+- request:
+    method: get
+    uri: https://api.mailgun.net/v2/<%= domain %>/unsubscribes
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      User-Agent:
+      - PewPew Ruby Gem 0.0.1
+      Authorization:
+      - Basic <%= basic_auth %>
+  response:
+    status:
+      code: 200
+      message: 
+    headers:
+      server:
+      - nginx/1.0.14
+      date:
+      - Sat, 02 Jun 2012 02:58:24 GMT
+      content-type:
+      - application/json
+      connection:
+      - close
+      content-length:
+      - '376'
+      content-disposition:
+      - inline
+    body:
+      encoding: US-ASCII
+      string: ! "{\n  \"total_count\": 2, \n  \"items\": [\n    {\n      \"created_at\":
+        \"Sat, 02 Jun 2012 02:54:37 GMT\", \n      \"tag\": \"*\", \n      \"id\":
+        \"4fc9806d8393c1618264c360\", \n      \"address\": \"test@example.com\"\n
+        \   }, \n    {\n      \"created_at\": \"Sat, 02 Jun 2012 02:53:29 GMT\", \n
+        \     \"tag\": \"newsletter\", \n      \"id\": \"4fc980298393c1618264c34d\",
+        \n      \"address\": \"test@example.com\"\n    }\n  ]\n}"
+    http_version: 
+  recorded_at: Sat, 02 Jun 2012 02:58:24 GMT
+- request:
+    method: delete
+    uri: https://api.mailgun.net/v2/<%= domain %>/unsubscribes/4fc9806d8393c1618264c360
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      User-Agent:
+      - PewPew Ruby Gem 0.0.1
+      Authorization:
+      - Basic <%= basic_auth %>
+  response:
+    status:
+      code: 200
+      message: 
+    headers:
+      server:
+      - nginx/1.0.14
+      date:
+      - Sat, 02 Jun 2012 02:59:33 GMT
+      content-type:
+      - application/json
+      connection:
+      - close
+      content-length:
+      - '94'
+      content-disposition:
+      - inline
+    body:
+      encoding: US-ASCII
+      string: ! "{\n  \"message\": \"Unsubscribe event has been removed\",\n  \"address\":
+        \"4fc9806d8393c1618264c360\"\n}"
+    http_version: 
+  recorded_at: Sat, 02 Jun 2012 02:59:33 GMT
+- request:
+    method: delete
+    uri: https://api.mailgun.net/v2/<%= domain %>/unsubscribes/test@example.com
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      User-Agent:
+      - PewPew Ruby Gem 0.0.1
+      Authorization:
+      - Basic <%= basic_auth %>
+  response:
+    status:
+      code: 200
+      message: 
+    headers:
+      server:
+      - nginx/1.0.14
+      date:
+      - Sat, 02 Jun 2012 02:59:52 GMT
+      content-type:
+      - application/json
+      connection:
+      - close
+      content-length:
+      - '86'
+      content-disposition:
+      - inline
+    body:
+      encoding: US-ASCII
+      string: ! "{\n  \"message\": \"Unsubscribe event has been removed\",\n  \"address\":
+        \"test@example.com\"\n}"
+    http_version: 
+  recorded_at: Sat, 02 Jun 2012 02:59:52 GMT
+recorded_with: VCR 2.2.0

data/spec/pew_pew/client_spec.rb

@@ -0,0 +1,51 @@
+require 'spec_helper'
+
+describe PewPew::Client do
+  context '#config' do
+    subject { described_class.new.config }
+
+    its(:adapter) { should == Faraday.default_adapter }
+    its(:base_uri) { should == PewPew::Config::BASE_URI }
+    its(:user_agent) { should == PewPew::Config::USER_AGENT }
+
+    its(:api_key) { should be_nil }
+    its(:domain) { should be_nil }
+  end
+
+  context '#configure' do
+    subject do
+      described_class.new.configure do |config|
+        config.adapter = :typhoeus
+        config.base_uri = 'https://api.mailgun.com/v2'
+        config.user_agent = 'A PewPew Application'
+
+        config.api_key = 'key-02n9f3ijl9sm9u97-8p7r-d7-15q-ui1'
+        config.domain = 'pewpew.mailgun.org'
+      end
+    end
+
+    its(:adapter) { should == :typhoeus }
+    its(:base_uri) { should == 'https://api.mailgun.com/v2' }
+    its(:user_agent) { should == 'A PewPew Application' }
+
+    its(:api_key) { should == 'key-02n9f3ijl9sm9u97-8p7r-d7-15q-ui1' }
+    its(:domain) { should == 'pewpew.mailgun.org' }
+  end
+
+  {
+    bounces: PewPew::Resources::Bounces,
+    campaigns: PewPew::Resources::Campaigns,
+    complaints: PewPew::Resources::Complaints,
+    lists: PewPew::Resources::Lists,
+    logs: PewPew::Resources::Logs,
+    mailboxes: PewPew::Resources::Mailboxes,
+    messages: PewPew::Resources::Messages,
+    routes: PewPew::Resources::Routes,
+    stats: PewPew::Resources::Stats,
+    unsubscribes: PewPew::Resources::Unsubscribes,
+  }.each do |method, resource_class|
+    context "##{method}" do
+      specify { subject.send(method).should be_a(resource_class) }
+    end
+  end
+end

data/spec/pew_pew/config_spec.rb

@@ -0,0 +1,38 @@
+require 'spec_helper'
+
+describe PewPew::Config do
+  {
+    BASE_URI: 'https://api.mailgun.net/v2',
+    USER_AGENT: "PewPew Ruby Gem #{PewPew::VERSION}",
+    USERNAME: 'api'
+  }.each do |constant, value|
+    context constant do
+      subject { described_class.const_get(constant) }
+
+      it { should == value }
+    end
+  end
+
+  subject { Class.new { include PewPew::Config }.new }
+
+  context 'defaults' do
+    its(:api_key) { should be_nil }
+    its(:domain) { should be_nil }
+  end
+
+  context '#api_key=' do
+    specify do
+      expect {
+        subject.api_key = 'key-02n9f3ijl9sm9u97-8p7r-d7-15q-ui1'
+      }.to change(subject, :api_key).to('key-02n9f3ijl9sm9u97-8p7r-d7-15q-ui1')
+    end
+  end
+
+  context '#domain=' do
+    specify do
+      expect {
+        subject.domain = 'pewpew.mailgun.org'
+      }.to change(subject, :domain).to('pewpew.mailgun.org')
+    end
+  end
+end

data/spec/pew_pew/resource_spec.rb

@@ -0,0 +1,46 @@
+require 'spec_helper'
+
+describe PewPew::Resource do
+  let(:client) { PewPew::Client.new }
+  let(:resource) { Class.new { include PewPew::Resource }.new(client) }
+
+  context '#connection' do
+    subject { resource.send(:connection) }
+
+    context 'middleware' do
+      let(:handlers) { subject.builder.handlers }
+
+      [
+        PewPew::Resource::ResponseDecorator,
+        FaradayMiddleware::Mashify,
+        FaradayMiddleware::ParseJson,
+        Faraday::Request::Multipart,
+        Faraday::Request::UrlEncoded,
+        Faraday::Adapter::NetHttp
+      ].each.with_index do |middleware, index|
+        it "uses #{middleware}" do
+          handlers.index(middleware).should == index
+        end
+      end
+    end
+  end
+end
+
+describe PewPew::Resource::ResponseDecorator do
+  it { should be_a(Faraday::Response::Middleware) }
+
+  it 'converts an array response into a mash' do
+    env = { body: [:response] }
+    subject.on_complete(env)
+    env[:body].total_count.should == 1
+    env[:body].items.should == [:response]
+  end
+
+  it 'stores the request status on the response body' do
+    env = { body: PewPew::Response.new, status: 200 }
+
+    expect {
+      subject.on_complete(env)
+    }.to change(env[:body], :status).from(nil).to(200)
+  end
+end

data/spec/pew_pew/resources/bounces_spec.rb

@@ -0,0 +1,78 @@
+require 'spec_helper'
+
+describe PewPew::Resources::Bounces, :resource, :domain do
+  let(:resource) { described_class.new(client) }
+
+  context '#all' do
+    let(:response) { resource.all }
+
+    subject { response }
+
+    specify { should be_success }
+
+    its(:status) { should == 200 }
+    its(:total_count) { should == 1 }
+
+    context 'item' do
+      subject { response.items.first }
+
+      its(:address) { should == 'test@example.com' }
+      its(:code) { should == '554' }
+      its(:error) { should == 'Relay access denied' }
+      its(:created_at) { should == 'Sat, 02 Jun 2012 07:24:08 GMT' }
+    end
+  end
+
+  context '#find' do
+    let(:response) { resource.find('test@example.com') }
+
+    subject { response }
+
+    specify { should be_success }
+
+    its(:status) { should == 200 }
+
+    context 'bounce' do
+      subject { response.bounce }
+
+      its(:address) { should == 'test@example.com' }
+      its(:code) { should == '554' }
+      its(:error) { should == 'Relay access denied' }
+      its(:created_at) { should == 'Sat, 02 Jun 2012 07:24:08 GMT' }
+    end
+  end
+
+  context '#create' do
+    let(:params) do
+      {
+        address: 'test@example.com',
+        code: 554,
+        error: 'Relay access denied',
+      }
+    end
+
+    let(:response) { resource.create(params) }
+
+    subject { response }
+
+    specify { should be_success }
+
+    its(:status) { should == 200 }
+    its(:message) { should == 'Address has been added to the bounces table' }
+
+    its(:address) { should == 'test@example.com' }
+  end
+
+  context '#remove' do
+    subject { response }
+
+    let(:response) { resource.remove('test@example.com') }
+
+    specify { should be_success }
+
+    its(:status) { should == 200 }
+    its(:message) { should == 'Bounced address has been removed' }
+
+    its(:address) { should == 'test@example.com' }
+  end
+end