gibbon 3.0.1 → 3.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 3cadf43e229868a253bae8af2b7e609db5ffd11b
-  data.tar.gz: 95049f9c9ce5f1d3b9cde18f4650d5be52b13947
+SHA256:
+  metadata.gz: 9948496f6f0ccccd5c2796b5d6ad2e1c656e3fd4db624bbb36a24e81d9161be7
+  data.tar.gz: 16ae83c4ec4af77425a9534b0c8c037fde234e694f21e77aa3572cad035867b4
 SHA512:
-  metadata.gz: 58ab02cdd0ebd1cff4c0211b3a6674484db6a50b52aa34dc7efc746e1c75792dca7a4dedd58e8efc7e38fef73fc285f4859c809bba1f1b5cf1d674bc89cca436
-  data.tar.gz: 15459d6835355d637505ffc34c3aecbac0a6232a271d1481952c60028f30bd7264c35bd5e922d12ec12717b36a83df59046c808f43b02c19dda60d9f60f2f33f
+  metadata.gz: 6e68e1c2b1e77f738e48a6a7256fb35c0904ae1d7f487daaeccd9b65cfc98ab57d3244f5f3fa1e699cd424fbaf36561ae83d3891f02029317595831c031c65d0
+  data.tar.gz: 443c2f49c096106061887b29d052d05064a23b508740da354aea4f49bbed3201366c9a548155da051664906fc40b39e4bf9611571707db82bcb542859e7402c2

data/.travis.yml

@@ -1,8 +1,11 @@
 language: ruby
 sudo: false
 cache: bundler
+before_install:
+  - gem install bundler # -v 1.7.14 if a specific version is needed
 rvm:
-  - 2.0.0
   - 2.1.5
   - 2.2.2
-  - 2.3.3
+  - 2.3.8
+  - 2.4.5
+  - 2.5.3

data/CHANGELOG.md

@@ -1,5 +1,25 @@
 ## [Unreleased][unreleased]
 
+## [3.2.1] - 2019-10-02
+- Fixed compatibility with Faraday 0.16.2+
+- Set minimum Ruby to 2.3.8
+
+## [3.2.1] - 2017-11-08
+- Set minimum Ruby to 2.1
+
+## [3.2.0] - 2017-11-08
+- Force TLS version 1.2
+
+## [3.1.1] - 2017-09-25
+- Fix MailChimpError initialization
+
+## [3.1.0] - 2017-07-27
+- Add back support for Export API until MailChimp stops supporting it
+- Implement `responds_to_missing`
+
+## [3.0.2] - 2017-05-08
+- Fix subtle bug in `symbolize_keys` when parsing error
+
 ## [3.0.1] - 2017-01-13
 - Gibbon::Request (API 3.0) now returns a `Gibbon::Response` object that exposes `headers` and the parsed response `body`
 - Remove Export API support (this is deprected after all)
@@ -66,7 +86,9 @@
 ## [1.1.4] - 2012-11-04
 - Fix JSON::ParserError on export calls that return blank results
 
-[unreleased]: https://github.com/amro/gibbon/compare/v3.0.1...HEAD
+[unreleased]: https://github.com/amro/gibbon/compare/v3.1.0...HEAD
+[3.1.0]: https://github.com/amro/gibbon/compare/v3.0.2...v3.1.0
+[3.0.2]: https://github.com/amro/gibbon/compare/v3.0.1...v3.0.2
 [3.0.1]: https://github.com/amro/gibbon/compare/v3.0.0...v3.0.1
 [3.0.0]: https://github.com/amro/gibbon/compare/v2.2.5...v3.0.0
 [2.2.5]: https://github.com/amro/gibbon/compare/v2.2.4...v2.2.5

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,76 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as
+contributors and maintainers pledge to making participation in our project and
+our community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, sex characteristics, gender identity and expression,
+level of experience, education, socio-economic status, nationality, personal
+appearance, race, religion, or sexual identity and orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment
+include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or
+ advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic
+ address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+ professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable
+behavior and are expected to take appropriate and fair corrective action in
+response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community. Examples of
+representing a project or community include using an official project e-mail
+address, posting via an official social media account, or acting as an appointed
+representative at an online or offline event. Representation of a project may be
+further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting the project team at amromousa@gmail.com. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. The project team is
+obligated to maintain confidentiality with regard to the reporter of an incident.
+Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good
+faith may face temporary or permanent repercussions as determined by other
+members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
+available at https://www.contributor-covenant.org/version/1/4/code-of-conduct.html
+
+[homepage]: https://www.contributor-covenant.org
+
+For answers to common questions about this code of conduct, see
+https://www.contributor-covenant.org/faq

data/LICENSE.txt

@@ -1,4 +1,4 @@
-Copyright (c) 2010-2015 Amro Mousa
+Copyright (c) 2010-2017 Amro Mousa
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/README.markdown

@@ -3,22 +3,22 @@
 Gibbon is an API wrapper for MailChimp's [API](http://kb.mailchimp.com/api/).
 
 [![Build Status](https://secure.travis-ci.org/amro/gibbon.svg)](http://travis-ci.org/amro/gibbon)
-[![Dependency Status](https://gemnasium.com/amro/gibbon.svg)](https://gemnasium.com/amro/gibbon)
-##Important Notes
+
+## Important Notes
 
 Please read MailChimp's [Getting Started Guide](http://kb.mailchimp.com/api/article/api-3-overview).
 
 Gibbon 3.0.0+ returns a `Gibbon::Response` instead of the response body directly. `Gibbon::Response` exposes the parsed response `body` and `headers`.
 
-##Installation
+## Installation
 
     $ gem install gibbon
 
-##Requirements
+## Requirements
 
 A MailChimp account and API key. You can see your API keys [here](http://admin.mailchimp.com/account/api).
 
-##Usage
+## Usage
 
 First, create a *one-time use instance* of `Gibbon::Request`:
 
@@ -26,7 +26,7 @@ First, create a *one-time use instance* of `Gibbon::Request`:
 gibbon = Gibbon::Request.new(api_key: "your_api_key")
 ```
 
-***Note*** Only reuse instances of Gibbon after terminating a call with a verb, which makes a request. Requests are light weight objects that update an internal path based on your call chain. When you terminate a call chain with a verb, a request instance makes a request an resets the path.
+***Note*** Only reuse instances of Gibbon after terminating a call with a verb, which makes a request. Requests are light weight objects that update an internal path based on your call chain. When you terminate a call chain with a verb, a request instance makes a request and resets the path.
 
 You can set an individual request's `timeout` and `open_timeout` like this:
 
@@ -84,7 +84,7 @@ gibbon = Gibbon::Request.new(api_key: "your_api_key", symbolize_keys: true)
 
 MailChimp's [resource documentation](http://kb.mailchimp.com/api/resources) is a list of available resources.
 
-##Debug Logging
+## Debug Logging
 
 Pass `debug: true` to enable debug logging to STDOUT.
 
@@ -110,7 +110,7 @@ Gibbon::Request.logger = MyLogger.new
 
 ### Lists
 
-Fetch all lists:
+Fetch first page of lists:
 
 ```ruby
 gibbon.lists.retrieve
@@ -130,7 +130,7 @@ gibbon.lists(list_id).members.retrieve
 
 ### Subscribers
 
-Get all subscribers for a list:
+Get first page of subscribers for a list:
 
 ```ruby
 gibbon.lists(list_id).members.retrieve
@@ -178,6 +178,21 @@ Get a specific member's information (open/click rates etc.) from MailChimp:
 gibbon.lists(list_id).members(lower_case_md5_hashed_email_address).retrieve
 ```
 
+### Tags
+
+[Tags](https://mailchimp.com/help/getting-started-tags/) are a flexible way to organize (slice and dice) your list: for example, you can send a campaign directly to one or more tags.
+
+Add tags to a subscriber:
+
+```ruby
+gibbon.lists(list_id).members(Digest::MD5.hexdigest(email)).tags.create(
+  body: {
+    tags: [{name:"referred-from-xyz", status:"active"},{name:"pro-plan",status:"active"}]
+  }
+)
+```
+
+
 ### Batch Operations
 
 Any API call that can be made directly can also be organized into batch operations. Performing batch operations requires you to generate a hash for each individual API call and pass them as an `Array` to the Batch endpoint.
@@ -236,7 +251,7 @@ gibbon.lists(list_id).members.retrieve(params: {"fields": "members.email_address
 
 ### Campaigns
 
-Get all campaigns:
+Get first page of campaigns:
 
 ```ruby
 campaigns = gibbon.campaigns.retrieve
@@ -457,6 +472,33 @@ Gibbon 2.x+:
 ```ruby
 gibbon.lists(list_id).members.create(body: {email_address: "foo@bar.com", status: "subscribed", merge_fields: {FNAME: "Bob", LNAME: "Smith"}})
 ```
+## Export API 1.0
+
+Gibbon 3.0.0+ supports MailChimp's [Export API 1.0](https://apidocs.mailchimp.com/export/1.0/). You can choose to handle the API response all at
+once or line by line by passing a block. To access the Export API with Gibbon, you must first create an instance of `Gibbon::Export`:
+
+```ruby
+export = Gibbon::Export.new(api_key: "your_api_key")
+```
+
+Next, call the method corresponding to the API endpoint you'd like to query:
+
+```ruby
+export.list(id: list_id)
+```
+
+This fetches and returns all of the results at once. Pass a block if you'd like to handle the response as individual lines:
+
+```ruby
+export = Gibbon::Export.new(api_key: "your_api_key", timeout: 1200)
+export.list(id: list_id) do |row|
+  puts row
+end
+```
+
+This is useful when handling large sets of data. Setting the `timeout` here is optional, but a high value is recommended given the nature of the Export API. The default timeout is 600 seconds.
+
+Gibbon supports all current Export API endpoints: `/list`, `/ecommOrders`, and `/campaignSubscriberActivity`. They're mapped onto Ruby methods with similar names: `list()`, `ecomm_orders()`, and `campaign_subscriber_activity()` respectively. Please see [MailChimp's API documentation](https://developer.mailchimp.com/documentation/mailchimp/guides/how-to-use-the-export-api/) for supported parameters.
 
 ## Thanks
 
@@ -464,5 +506,5 @@ Thanks to everyone who has [contributed](https://github.com/amro/gibbon/contribu
 
 ## Copyright
 
-* Copyright (c) 2010-2017 Amro Mousa. See LICENSE.txt for details.
-* MailChimp (c) 2001-2017 The Rocket Science Group.
+* Copyright (c) 2010-2018 Amro Mousa. See LICENSE.txt for details.
+* MailChimp (c) 2001-2018 The Rocket Science Group.

data/gibbon.gemspec

@@ -9,8 +9,8 @@ Gem::Specification.new do |s|
   s.email       = ["amromousa@gmail.com"]
   s.homepage    = "http://github.com/amro/gibbon"
 
-  s.summary     = %q{A wrapper for MailChimp API 3.0}
-  s.description = %q{A wrapper for MailChimp API 3.0}
+  s.summary     = %q{A wrapper for MailChimp API 3.0 and Export API}
+  s.description = %q{A wrapper for MailChimp API 3.0 and Export API}
   s.license     = "MIT"
 
   s.rubyforge_project = "gibbon"
@@ -19,7 +19,7 @@ Gem::Specification.new do |s|
   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.required_ruby_version = '>= 2.0.0'
+  s.required_ruby_version = '>= 2.3.8'
 
   s.add_dependency('faraday', '>= 0.9.1')
   s.add_dependency('multi_json', '>= 1.11.0')

data/lib/gibbon.rb

@@ -9,6 +9,7 @@ require 'gibbon/mailchimp_error'
 require 'gibbon/request'
 require 'gibbon/api_request'
 require 'gibbon/response'
+require 'gibbon/export'
 
 module Gibbon
 end

data/lib/gibbon/api_request.rb

@@ -102,14 +102,17 @@ module Gibbon
     def symbolize_keys
       @request_builder.symbolize_keys
     end
-    
+
     # Helpers
 
     def handle_error(error)
       error_params = {}
 
       begin
-        if error.is_a?(Faraday::Error::ClientError) && error.response
+        # Faraday::ClientError is used in Faraday 0.16.0+
+        # Faraday::Error::ClientError was used before 0.16.0
+        client_error = error.is_a?(Faraday::ClientError) || error.is_a?(Faraday::Error::ClientError)
+        if client_error && error.response
           error_params[:status_code] = error.response[:status]
           error_params[:raw_body] = error.response[:body]
 
@@ -117,8 +120,12 @@ module Gibbon
 
           if parsed_response
             error_params[:body] = parsed_response
-            error_params[:title] = parsed_response["title"] if parsed_response["title"]
-            error_params[:detail] = parsed_response["detail"] if parsed_response["detail"]
+
+            title_key = symbolize_keys ? :title : "title"
+            detail_key = symbolize_keys ? :detail : "detail"
+
+            error_params[:title] = parsed_response[title_key] if parsed_response[title_key]
+            error_params[:detail] = parsed_response[detail_key] if parsed_response[detail_key]
           end
 
         end
@@ -142,7 +149,7 @@ module Gibbon
     end
 
     def rest_client
-      client = Faraday.new(self.api_url, proxy: self.proxy) do |faraday|
+      client = Faraday.new(self.api_url, proxy: self.proxy, ssl: { version: "TLSv1_2" }) do |faraday|
         faraday.response :raise_error
         faraday.adapter adapter
         if @request_builder.debug
@@ -153,7 +160,7 @@ module Gibbon
       client
     end
 
-    def parse_response(response)      
+    def parse_response(response)
       parsed_response = nil
 
       if response.body && !response.body.empty?
@@ -162,9 +169,8 @@ module Gibbon
           body = MultiJson.load(response.body, symbolize_keys: symbolize_keys)
           parsed_response = Response.new(headers: headers, body: body)
         rescue MultiJson::ParseError
-          error = MailChimpError.new("Unparseable response: #{response.body}")
-          error.title = "UNPARSEABLE_RESPONSE"
-          error.status_code = 500
+          error_params = { title: "UNPARSEABLE_RESPONSE", status_code: 500 }
+          error = MailChimpError.new("Unparseable response: #{response.body}", error_params)
           raise error
         end
       end

data/lib/gibbon/export.rb

@@ -0,0 +1,93 @@
+require 'net/https'
+
+module Gibbon
+  class Export
+    include Helpers
+
+    attr_accessor :api_key, :timeout
+
+    def initialize(api_key: nil, timeout: nil)
+      @api_key = api_key || self.class.api_key
+      @timeout = timeout || self.class.timeout || 600
+    end
+
+    def list(params = {}, &block)
+      call("list", params, &block)
+    end
+
+    def ecomm_orders(params = {}, &block)
+      call("ecommOrders", params, &block)
+    end
+
+    def campaign_subscriber_activity(params = {}, &block)
+      call("campaignSubscriberActivity", params, &block)
+    end
+
+    protected
+
+    def export_api_url
+      "https://#{get_data_center_from_api_key(@api_key)}api.mailchimp.com/export/1.0/"
+    end
+
+    def call(method, params = {}, &block)
+      rows = []
+
+      api_url = export_api_url + method + "/"
+      params = params.merge({ apikey: @api_key })
+      block = Proc.new { |row| rows << row } unless block_given?
+
+      ensure_api_key(params)
+
+      url = URI.parse(api_url)
+      req = Net::HTTP::Post.new(url.path, initheader = {'Content-Type' => 'application/json'})
+      req.body = MultiJson.dump(params)
+      Net::HTTP.start(url.host, url.port, read_timeout: @timeout, use_ssl: true, ssl_version: :TLSv1_2) do |http|
+        # http://stackoverflow.com/questions/29598196/ruby-net-http-read-body-nethttpokread-body-called-twice-ioerror
+        http.request req do |response|
+          i = -1
+          last = ''
+          response.read_body do |chunk|
+            next if chunk.nil? or chunk.strip.empty?
+            infix = "\n" if last[-1, 1]==']'
+            lines, last = try_parse_line("#{last}#{infix}#{chunk}")
+            lines.each { |line| block.call(line, i += 1) }
+          end
+          block.call(parse_line(last), i += 1) unless last.nil? or last.empty?
+        end
+      end
+      rows unless block_given?
+    end
+
+    def try_parse_line(res)
+      lines = res.split("\n")
+      last = lines.pop || ''
+      lines.map! { |line| parse_line(line) }
+      [lines.compact, last]
+    rescue MultiJson::ParseError
+      [[], last]
+    end
+     
+     
+    def parse_line(line)
+      parsed_response = MultiJson.load(line)
+    rescue MultiJson::ParseError
+      return []
+    end
+
+    private
+
+    def ensure_api_key(params)
+      unless params[:apikey] && (get_data_center_from_api_key(params[:apikey]) != "")
+        raise Gibbon::GibbonError, "You must set an api_key prior to making a call"
+      end
+    end
+
+    class << self
+      attr_accessor :api_key, :timeout
+
+      def method_missing(sym, *args, &block)
+        new(api_key: self.api_key, timeout: self.timeout).send(sym, *args, &block)
+      end
+    end
+  end
+end

data/lib/gibbon/request.rb

@@ -27,6 +27,10 @@ module Gibbon
       self
     end
 
+    def respond_to_missing?(method_name, include_private = false)
+      true
+    end
+
     def send(*args)
       if args.length == 0
         method_missing(:send, args)
@@ -81,6 +85,10 @@ module Gibbon
       def method_missing(sym, *args, &block)
         new(api_key: self.api_key, api_endpoint: self.api_endpoint, timeout: self.timeout, open_timeout: self.open_timeout, faraday_adapter: self.faraday_adapter, symbolize_keys: self.symbolize_keys, debug: self.debug, proxy: self.proxy, logger: self.logger).send(sym, *args, &block)
       end
+
+      def respond_to_missing?(method_name, include_private = false)
+        true
+      end
     end
   end
 end

data/lib/gibbon/version.rb

@@ -1,3 +1,3 @@
 module Gibbon
-  VERSION = "3.0.1"
-end
+  VERSION = "3.3.0"
+end

data/spec/gibbon/api_request_spec.rb

@@ -9,38 +9,66 @@ describe Gibbon::APIRequest do
     @api_root = "https://apikey:#{api_key}@us1.api.mailchimp.com/3.0"
   end
 
-  it "surfaces client request exceptions as a Gibbon::MailChimpError" do
-    exception = Faraday::Error::ClientError.new("the server responded with status 503")
-    stub_request(:get, "#{@api_root}/lists").to_raise(exception)
-    expect { @gibbon.lists.retrieve }.to raise_error(Gibbon::MailChimpError)
-  end
+  shared_examples_for 'client error handling' do
+    it "surfaces client request exceptions as a Gibbon::MailChimpError" do
+      exception = error_class.new("the server responded with status 503")
+      stub_request(:get, "#{@api_root}/lists").to_raise(exception)
+      expect { @gibbon.lists.retrieve }.to raise_error(Gibbon::MailChimpError)
+    end
 
-  it "surfaces an unparseable client request exception as a Gibbon::MailChimpError" do
-    exception = Faraday::Error::ClientError.new(
-      "the server responded with status 503")
-    stub_request(:get, "#{@api_root}/lists").to_raise(exception)
-    expect { @gibbon.lists.retrieve }.to raise_error(Gibbon::MailChimpError)
-  end
+    it "surfaces an unparseable client request exception as a Gibbon::MailChimpError" do
+      exception = error_class.new(
+        "the server responded with status 503")
+      stub_request(:get, "#{@api_root}/lists").to_raise(exception)
+      expect { @gibbon.lists.retrieve }.to raise_error(Gibbon::MailChimpError)
+    end
 
-  it "surfaces an unparseable response body as a Gibbon::MailChimpError" do
-    response_values = {:status => 503, :headers => {}, :body => '[foo]'}
-    exception = Faraday::Error::ClientError.new("the server responded with status 503", response_values)
+    it "surfaces an unparseable response body as a Gibbon::MailChimpError" do
+      response_values = {:status => 503, :headers => {}, :body => '[foo]'}
+      exception = error_class.new("the server responded with status 503", response_values)
 
-    stub_request(:get, "#{@api_root}/lists").to_raise(exception)
-    expect { @gibbon.lists.retrieve }.to raise_error(Gibbon::MailChimpError)
-  end
+      stub_request(:get, "#{@api_root}/lists").to_raise(exception)
+      expect { @gibbon.lists.retrieve }.to raise_error(Gibbon::MailChimpError)
+    end
+
+    context "handle_error" do
+      it "includes status and raw body even when json can't be parsed" do
+        response_values = {:status => 503, :headers => {}, :body => 'A non JSON response'}
+        exception = error_class.new("the server responded with status 503", response_values)
+        api_request = Gibbon::APIRequest.new(builder: Gibbon::Request)
+        begin
+          api_request.send :handle_error, exception
+        rescue => boom
+          expect(boom.status_code).to eq 503
+          expect(boom.raw_body).to eq "A non JSON response"
+        end
+      end
 
-  context "handle_error" do
-    it "includes status and raw body even when json can't be parsed" do
-      response_values = {:status => 503, :headers => {}, :body => 'A non JSON response'}
-      exception = Faraday::Error::ClientError.new("the server responded with status 503", response_values)
-      api_request = Gibbon::APIRequest.new(builder: Gibbon::Request)
-      begin
-        api_request.send :handle_error, exception
-      rescue => boom
-        expect(boom.status_code).to eq 503
-        expect(boom.raw_body).to eq "A non JSON response"
+      context "when symbolize_keys is true" do
+        it "sets title and detail on the error params" do
+          response_values = {:status => 422, :headers => {}, :body => '{"title": "foo", "detail": "bar"}'}
+          exception = error_class.new("the server responded with status 422", response_values)
+          api_request = Gibbon::APIRequest.new(builder: Gibbon::Request.new(symbolize_keys: true))
+          begin
+            api_request.send :handle_error, exception
+          rescue => boom
+            expect(boom.title).to eq "foo"
+            expect(boom.detail).to eq "bar"
+          end
+        end
       end
     end
   end
+
+  context 'Faraday::Error::ClientError' do
+    let(:error_class) { Faraday::Error::ClientError }
+
+    include_examples 'client error handling'
+  end
+
+  context 'Faraday::ClientError' do
+    let(:error_class) { Faraday::ClientError }
+
+    include_examples 'client error handling'
+  end
 end

data/spec/gibbon/export_spec.rb

@@ -0,0 +1,32 @@
+require 'spec_helper'
+require 'webmock/rspec'
+
+describe Gibbon::Export do
+  before do
+    Gibbon::Export.send(:public, *Gibbon::Export.protected_instance_methods)
+    @export = Gibbon::Export.new
+  end
+
+  it "doesn't allow empty api key" do
+    expect {@export.list(id: "123456")}.to raise_error(Gibbon::GibbonError)
+  end
+
+  it "doesn't allow api key without data center" do
+    @api_key = "123"
+    @export.api_key = @api_key
+    expect {@export.list(id: "123456")}.to raise_error(Gibbon::GibbonError)
+  end
+
+  it "sets correct endpoint from api key" do
+    @api_key = "TESTKEY-us1"
+    @export.api_key = @api_key
+    expect(@export.export_api_url).to eq("https://us1.api.mailchimp.com/export/1.0/")
+  end
+
+  it "sets correct timeout" do
+    @api_key = "TESTKEY-us1"
+    @export.api_key = @api_key
+    @export.timeout = 9
+    expect(@export.timeout).to eq(9)
+  end
+end

data/spec/gibbon/gibbon_spec.rb

@@ -73,7 +73,7 @@ describe Gibbon do
       expect(@gibbon.proxy).to be_nil
     end
 
-    it "sets an proxy url key from the 'MAILCHIMP_PROXY_URL' ENV variable" do
+    it "sets a proxy url key from the 'MAILCHIMP_PROXY' ENV variable" do
       ENV['MAILCHIMP_PROXY'] = @proxy
       @gibbon = Gibbon::Request.new
       expect(@gibbon.proxy).to eq(@proxy)
@@ -222,4 +222,13 @@ describe Gibbon do
       expect(Gibbon::Request.new.logger).to eq(logger)
     end
   end
+
+  describe "missing methods" do
+    it "respond to .method call on class" do
+      expect(Gibbon::Request.method(:lists)).to be_a(Method)
+    end
+    it "respond to .method call on instance" do
+      expect(Gibbon::Request.new.method(:lists)).to be_a(Method)
+    end
+  end
 end

data/spec/gibbon/mailchimp_error_spec.rb

@@ -0,0 +1,49 @@
+require 'spec_helper'
+
+describe Gibbon::MailChimpError do
+  let(:message) { 'Foo' }
+  let(:params) do
+    {
+      title: 'error_title',
+      detail: 'error_detail',
+      body: 'error_body',
+      raw_body: 'error_raw_body',
+      status_code: 'error_status_code'
+    }
+  end
+
+  before do
+    @gibbon = Gibbon::MailChimpError.new(message, params)
+  end
+
+  it "adds the error params to the error message" do
+    expected_message = "Foo "                               \
+                       "@title=\"error_title\", "           \
+                       "@detail=\"error_detail\", "         \
+                       "@body=\"error_body\", "             \
+                       "@raw_body=\"error_raw_body\", "     \
+                       "@status_code=\"error_status_code\""
+
+    expect(@gibbon.message).to eq(expected_message)
+  end
+
+  it 'sets the title attribute' do
+    expect(@gibbon.title).to eq(params[:title])
+  end
+
+  it 'sets the detail attribute' do
+    expect(@gibbon.detail).to eq(params[:detail])
+  end
+
+  it 'sets the body attribute' do
+    expect(@gibbon.body).to eq(params[:body])
+  end
+
+  it 'sets the raw_body attribute' do
+    expect(@gibbon.raw_body).to eq(params[:raw_body])
+  end
+
+  it 'sets the status_code attribute' do
+    expect(@gibbon.status_code).to eq(params[:status_code])
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: gibbon
 version: !ruby/object:Gem::Version
-  version: 3.0.1
+  version: 3.3.0
 platform: ruby
 authors:
 - Amro Mousa
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-01-14 00:00:00.000000000 Z
+date: 2019-10-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -80,7 +80,7 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 1.21.0
-description: A wrapper for MailChimp API 3.0
+description: A wrapper for MailChimp API 3.0 and Export API
 email:
 - amromousa@gmail.com
 executables: []
@@ -91,6 +91,7 @@ files:
 - ".gitignore"
 - ".travis.yml"
 - CHANGELOG.md
+- CODE_OF_CONDUCT.md
 - Gemfile
 - LICENSE.txt
 - README.markdown
@@ -98,6 +99,7 @@ files:
 - gibbon.gemspec
 - lib/gibbon.rb
 - lib/gibbon/api_request.rb
+- lib/gibbon/export.rb
 - lib/gibbon/gibbon_error.rb
 - lib/gibbon/gibbon_helpers.rb
 - lib/gibbon/mailchimp_error.rb
@@ -105,7 +107,9 @@ files:
 - lib/gibbon/response.rb
 - lib/gibbon/version.rb
 - spec/gibbon/api_request_spec.rb
+- spec/gibbon/export_spec.rb
 - spec/gibbon/gibbon_spec.rb
+- spec/gibbon/mailchimp_error_spec.rb
 - spec/gibbon/upsert_spec.rb
 - spec/spec_helper.rb
 homepage: http://github.com/amro/gibbon
@@ -120,20 +124,21 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.0.0
+      version: 2.3.8
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: gibbon
-rubygems_version: 2.4.6
+rubygems_version: 3.0.6
 signing_key: 
 specification_version: 4
-summary: A wrapper for MailChimp API 3.0
+summary: A wrapper for MailChimp API 3.0 and Export API
 test_files:
 - spec/gibbon/api_request_spec.rb
+- spec/gibbon/export_spec.rb
 - spec/gibbon/gibbon_spec.rb
+- spec/gibbon/mailchimp_error_spec.rb
 - spec/gibbon/upsert_spec.rb
 - spec/spec_helper.rb