hominid 3.0.2 → 3.0.4

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format d

data/.travis.yml

@@ -0,0 +1 @@
+rvm: 1.9.2

data/Gemfile

@@ -1,13 +1,10 @@
 source "http://rubygems.org"
-# Add dependencies required to use your gem here.
-#gem "json"
 
-# Add dependencies to develop your gem here.
-# Include everything needed to run rake, tests, features, etc.
 group :development do
-	gem "bundler", "~> 1.0.0"
-  gem "jeweler", "~> 1.5.2"
-	gem "mocha", ">= 0.9.10"
-  gem "rcov", ">= 0.9.9"
-	gem "shoulda", ">= 2.11.3"
+	gem 'bundler', '~> 1.0.0'
+	gem 'fakeweb'
+	gem 'guard-rspec'
+	gem 'jeweler', '~> 1.6.4'
+	gem 'simplecov'
+  gem 'rspec'
 end

data/Guardfile

@@ -0,0 +1,21 @@
+# A sample Guardfile
+# More info at https://github.com/guard/guard#readme
+
+guard 'rspec', :version => 2 do
+  watch(%r{^spec/.+_spec\.rb$})
+  watch(%r{^lib/(.+)\.rb$})     { |m| "spec/lib/#{m[1]}_spec.rb" }
+  watch('spec/spec_helper.rb')  { "spec" }
+
+  # Rails example
+  watch(%r{^spec/.+_spec\.rb$})
+  watch(%r{^app/(.+)\.rb$})                           { |m| "spec/#{m[1]}_spec.rb" }
+  watch(%r{^lib/(.+)\.rb$})                           { |m| "spec/lib/#{m[1]}_spec.rb" }
+  watch(%r{^app/controllers/(.+)_(controller)\.rb$})  { |m| ["spec/routing/#{m[1]}_routing_spec.rb", "spec/#{m[2]}s/#{m[1]}_#{m[2]}_spec.rb", "spec/acceptance/#{m[1]}_spec.rb"] }
+  watch(%r{^spec/support/(.+)\.rb$})                  { "spec" }
+  watch('spec/spec_helper.rb')                        { "spec" }
+  watch('config/routes.rb')                           { "spec/routing" }
+  watch('app/controllers/application_controller.rb')  { "spec/controllers" }
+  # Capybara request specs
+  watch(%r{^app/views/(.+)/.*\.(erb|haml)$})          { |m| "spec/requests/#{m[1]}_spec.rb" }
+end
+

data/README.rdoc

@@ -1,10 +1,10 @@
 = Hominid
 
-Hominid is a Ruby gem that provides a wrapper for interacting with the Mailchimp[http://eepurl.com/ew8J] API.
+Hominid is a Ruby gem that provides a wrapper for interacting with {Mailchimp's}[http://eepurl.com/ew8J] MC, STS and Export API's.
 
 == Requirements
 
-You will need a {Mailchimp}[http://eepurl.com/ew8J] account. Once you have your Mailchimp account set up, you will need to {generate an API key}[http://admin.mailchimp.com/account/api/] in order to get started using Hominid.
+You will need a {Mailchimp}[http://eepurl.com/ew8J] account. Once you have your Mailchimp account set up, you will need to {generate an API key}[http://admin.mailchimp.com/account/api/] in order to get started using Hominid (or you can use OAuth2 as well).
 
 == Installation
 
@@ -12,7 +12,9 @@ You will need a {Mailchimp}[http://eepurl.com/ew8J] account. Once you have your
 
 == Usage
 
-Please refer to the {Mailchimp API Documentation}[http://www.mailchimp.com/api/1.3/] for information about what methods are available, the arguments that can be passed to each method, and the output that the API will return. Start by creating a Hominid object:
+=== MCAPI
+
+Please refer to the {Mailchimp API Documentation}[http://apidocs.mailchimp.com/api/1.3/] for information about what methods are available, the arguments that can be passed to each method, and the output that the API will return. Start by creating a Hominid object:
 
   h = Hominid::API.new('your_api_key')
 
@@ -24,26 +26,32 @@ Finally, and we're not sure why you would want to, but you can use the older ver
 
   h = Hominid::API.new('your_api_key', {:api_version => '1.2'})
 
-You can then run any of the methods that you find in the {Mailchimp API Documentation}[http://www.mailchimp.com/api/1.3/] against it. Simply convert the names to the more Ruby-like underscored versions. You do not need to pass your api_key to each method, as that is done automatically for you:
+You can then run any of the methods that you find in the {Mailchimp API Documentation}[http://apidocs.mailchimp.com/api/1.3/] against it. Simply convert the names to the more Ruby-like underscored versions (e.g. listUpdateMember becomes list_update_member).
+
+MailChimp's API documentation states that several API methods (e.g. listUpdateMember, list_subscribe) require 'array' parameters. Hominid requires many (all?) of these parameters to be passed as **hashes**, not arrays -- the examples below should all work as-is.
+
+You do not need to pass your api_key to each method, as that is done automatically for you:
 
+  # list_id is a short hex string used internally by MailChimp to identify your lists (e.g. 'eceeae8b22')
+  # it's returned as the "id" member of the structure returned by the 'lists' call.
   h.get_account_details
+  # Get all lists associated with this API key
   h.lists
-  h.list_subscribe('XXXXXXXXXX', 'joe@public.com', [], 'html', false, true, true, false)
-  h.list_batch_subscribe('XXXXXXXXXX', [{:EMAIL => 'joe@public.com', :EMAIL_TYPE => 'html'}, {:EMAIL => 'jane@doe.com', :EMAIL_TYPE => 'html'}])
-  h.campaign_create('regular', {:list_id => 'XXXXXXXXXX', ...}, {:html => 'Campaign HTML content', ...})
+  # Subscribe 'joe@public.com', with merge variables 'FNAME' and 'LNAME', to the list identified by list_id
+  h.list_subscribe(list_id, 'joe@public.com', {'FNAME' => 'Joe', 'LNAME' => 'Public'}, 'html', false, true, true, false)
+  h.list_batch_subscribe(list_id, [{:EMAIL => 'joe@public.com', :EMAIL_TYPE => 'html'}, {:EMAIL => 'jane@doe.com', :EMAIL_TYPE => 'html'}])
+  h.campaign_create('regular', {:list_id => list_id, ...}, {:html => 'Campaign HTML content', ...})
   h.template_add('template_name', 'Template HTML Code')
-  h.list_interest_grouping_add('XXXXXXXXXX', 'Grouping Title', 'hidden', ['First Group', 'Second Group', 'Third Group'])
+  h.list_interest_grouping_add(list_id, 'Grouping Title', 'hidden', ['First Group', 'Second Group', 'Third Group'])
   h.list_static_segment_add('Sample Static Segment')
 	
-The {Mailchimp API}[http://www.mailchimp.com/api/1.3/] now supports pagination for some methods, so certain methods will have the following response:
+The {Mailchimp API}[http://apidocs.mailchimp.com/api/1.3/] supports pagination for some methods, so certain methods will have the following response:
 
   h.lists['total']        => 4
   h.lists['data']         => outputs an array of your mailing lists
   h.lists['data'].first   => {"id" => "XXXXXXX", "web_id" => 1234567, "name" => "My Mailing List", ...}
 
-Please note that as of version 3.0.0 Hominid no longer includes support for the {Mailchimp Export API}[http://www.mailchimp.com/api/export/].
-
-== Examples
+==== Finder Methods
 
 Hominid includes some finder methods for campaigns (see Hominid::Campaign) and lists (see Hominid::List) to help with finding each of these resources:
 
@@ -51,7 +59,41 @@ Hominid includes some finder methods for campaigns (see Hominid::Campaign) and l
   h.find_list_id_by_name('my_mailing_list')
   h.find_campaigns_by_list_name('my_mailing_list')
 
-== Contributing to hominid
+=== STS API
+
+Please refer to the {Mailchimp STS API Documentation}[http://apidocs.mailchimp.com/sts/1.0/] for information about what methods are available, the arguments that can be passed to each method, and the output that the API will return. Start by creating a Hominid object:
+
+  s = Hominid::STS.new('your_api_key', {:secure => true})
+
+You can then run any of the methods that you find in the {Mailchimp STS API Documentation}[http://apidocs.mailchimp.com/sts/1.0/] against it. Simply convert the names to the more Ruby-like underscored versions (e.g. listVerifiedEmailAddresses becomes list_verified_email_addresses).
+
+  s.list_verified_email_addresses
+  s.verify_email_address('joe@public.com')
+  s.send_email({:to_email => ['joe@public.com'], :text => 'Hello World!'}, false, true)
+  s.get_send_quota
+
+Note that MailChimp will return an error if you attempt to make STS API calls on an account without Amazon SES integration.
+
+=== Export API
+
+Please refer to the {Mailchimp Export API Documentation}[http://apidocs.mailchimp.com/export/1.0/] for information about what methods are available, the arguments that can be passed to each method, and the output that the API will return. Start by creating a Hominid object:
+
+  e = Hominid::Export.new('your_api_key', {:secure => true})
+
+You can then run the following methods:
+
+  e.list('list_id')
+  e.campaign_subscriber_activit('campaign_id')
+
+== Submitting an Issue
+
+We use the {GitHub issue tracker}[https://github.com/terra-firma/hominid/issues] to track bugs and features. Before submitting a bug report or feature request, check to make sure it hasn't already been submitted. You can indicate support for an existing issue by voting it up. When submitting a bug report, please include a Gist that includes a stack trace and any details that may be necessary to reproduce the bug, including your gem version, Ruby version, and operating system. Ideally, a bug report should include a pull request with failing specs.
+
+== Travis Build Status
+
+{<img src="http://travis-ci.org/terra-firma/hominid.png" />}[http://travis-ci.org/terra-firma/hominid]
+
+== Contributing to Hominid
  
 * Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
 * Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it

data/Rakefile

@@ -1,5 +1,7 @@
+# encoding: utf-8
 require 'rubygems'
 require 'bundler'
+
 begin
   Bundler.setup(:default, :development)
 rescue Bundler::BundlerError => e
@@ -15,10 +17,11 @@ Jeweler::Tasks.new do |gem|
   gem.name = "hominid"
   gem.homepage = "http://github.com/terra-firma/hominid"
   gem.license = "MIT"
-  gem.summary = %Q{Hominid is a Ruby wrapper for the Mailchimp API}
-  gem.description = %Q{Hominid is a Ruby gem that provides a wrapper for interacting with the Mailchimp email marketing service API.}
+  gem.summary = %Q{Ruby gem for interacting with the Mailchimp API's.}
+  gem.description = %Q{Hominid is a Ruby gem that provides a wrapper for interacting with the Mailchimp email marketing service MC, STS and Export API's.}
   gem.email = "brian@terra-firma-design.com"
   gem.authors = ["Brian Getting"]
+  # dependencies defined in Gemfile
 end
 Jeweler::RubygemsDotOrgTasks.new
 
@@ -29,21 +32,13 @@ Rake::TestTask.new(:test) do |test|
   test.verbose = true
 end
 
-require 'rcov/rcovtask'
-Rcov::RcovTask.new do |test|
-  test.libs << 'test'
-  test.pattern = 'test/**/test_*.rb'
-  test.verbose = true
-end
-
 task :default => :test
 
-require 'rake/rdoctask'
+require 'rdoc/task'
 Rake::RDocTask.new do |rdoc|
   version = File.exist?('VERSION') ? File.read('VERSION') : ""
-
   rdoc.rdoc_dir = 'rdoc'
   rdoc.title = "hominid #{version}"
   rdoc.rdoc_files.include('README*')
   rdoc.rdoc_files.include('lib/**/*.rb')
-end
+end

data/VERSION

@@ -1 +1 @@
-3.0.2
+3.0.4

data/lib/hominid.rb

@@ -1,65 +1,11 @@
-# TODO: Write tests (include mocks for API calls)
+require 'net/http'
+require 'net/https'
 require 'openssl'
 require 'xmlrpc/client'
 
 require 'hominid/campaign'
 require 'hominid/list'
 require 'hominid/security'
-
-module Hominid
-  class API
-    # Blank Slate
-    instance_methods.each do |m|
-      undef_method m unless m.to_s =~ /^__|object_id|method_missing|respond_to?|to_s|inspect/
-    end
-    
-    include Hominid::Campaign
-    include Hominid::List
-    include Hominid::Security
-    
-    # MailChimp API Documentation: http://www.mailchimp.com/api/1.3/
-    MAILCHIMP_API_VERSION = "1.3"
-
-    # Initialize with an API key and config options
-    def initialize(api_key, config = {})
-      raise ArgumentError.new('Your Mailchimp API key appears to be malformed') unless api_key.include?('-')
-      dc = api_key.split('-').last
-      defaults = {
-        :api_version        => MAILCHIMP_API_VERSION,
-        :secure             => false,
-        :timeout            => nil
-      }
-      @config = defaults.merge(config).freeze
-      protocol = @config[:secure] ? 'https' : 'http'
-      @api_key = api_key
-      @chimpApi = XMLRPC::Client.new2("#{protocol}://#{dc}.api.mailchimp.com/#{@config[:api_version]}/", nil, @config[:timeout])
-    end
-
-    def method_missing(api_method, *args) # :nodoc:
-      @chimpApi.call(api_method.to_s.camelize_api_method_name, @api_key, *args)
-    rescue XMLRPC::FaultException => error
-      super if error.faultCode == -32601
-      raise APIError.new(error)
-    end
-    
-    def respond_to?(api_method)
-      @chimpApi.call(api_method, @api_key)
-    rescue XMLRPC::FaultException => error
-      error.faultCode == -32601 ? false : true 
-    end
-
-  end
-  
-  class APIError < StandardError
-    def initialize(error)
-      super("<#{error.faultCode}> #{error.message}")
-    end
-  end
-
-end
-
-class String
-  def camelize_api_method_name
-    self.to_s[0].chr.downcase + self.gsub(/(?:^|_)(.)/) { $1.upcase }[1..self.size]
-  end
-end
+require 'hominid/api'
+require 'hominid/export'
+require 'hominid/sts'

data/lib/hominid/api.rb

@@ -0,0 +1,59 @@
+module Hominid
+  class API
+    # Blank Slate
+    instance_methods.each do |m|
+      undef_method m unless m.to_s =~ /^__|object_id|method_missing|respond_to?|to_s|inspect|kind_of?|should|should_not/
+    end
+    
+    include Hominid::Campaign
+    include Hominid::List
+    include Hominid::Security
+    
+    # MailChimp API Documentation: http://apidocs.mailchimp.com/api/1.3/
+    MAILCHIMP_API_VERSION = "1.3"
+
+    # Initialize with an API key and config options
+    def initialize(api_key, config = {})
+      raise ArgumentError.new('Your Mailchimp API key appears to be malformed.') unless api_key.include?('-')
+      dc = api_key.split('-').last
+      defaults = {
+        :api_version        => MAILCHIMP_API_VERSION,
+        :domain             => 'api.mailchimp.com',
+        :secure             => false,
+        :timeout            => nil
+      }
+      @config = defaults.merge(config).freeze
+      protocol = @config[:secure] ? 'https' : 'http'
+      @api_key = api_key
+      @chimpApi = XMLRPC::Client.new2("#{protocol}://#{dc}.#{@config[:domain]}/#{@config[:api_version]}/", nil, @config[:timeout])
+    end
+
+    def method_missing(api_method, *args) # :nodoc:
+      @chimpApi.call(camelize_api_method_name(api_method.to_s), @api_key, *args)
+    rescue XMLRPC::FaultException => error
+      super if error.faultCode == -32601
+      raise APIError.new(error)
+    end
+    
+    def respond_to?(api_method) # :nodoc:
+      @chimpApi.call(api_method, @api_key)
+    rescue XMLRPC::FaultException => error
+      error.faultCode == -32601 ? false : true 
+    end
+    
+    private
+
+    def camelize_api_method_name(str)
+      str.to_s[0].chr.downcase + str.gsub(/(?:^|_)(.)/) { $1.upcase }[1..str.size]
+    end
+  end
+  
+  class APIError < StandardError
+    attr_accessor :fault_code
+    def initialize(error)
+      self.fault_code = error.faultCode
+      super("<#{error.faultCode}> #{error.message}")
+    end
+  end
+
+end

data/lib/hominid/export.rb

@@ -0,0 +1,63 @@
+module Hominid
+  class Export
+    
+    # MailChimp Export API Documentation: http://apidocs.mailchimp.com/export/1.0/
+    MAILCHIMP_EXPORT_VERSION = "1.0"
+    
+    # Initialize with an API key and config options
+    def initialize(api_key, config = {})
+      raise ArgumentError.new('Your Mailchimp API key appears to be malformed.') unless api_key.include?('-')
+      dc = api_key.split('-').last
+      defaults = {
+        :api_version        => MAILCHIMP_EXPORT_VERSION,
+        :secure             => false
+      }
+      @config = defaults.merge(config).freeze
+      protocol = @config[:secure] ? 'https' : 'http'
+      @api_key = api_key
+      @api_base = "#{protocol}://#{dc}.api.mailchimp.com/export/#{@config[:api_version]}"
+    end
+    
+    # TODO: We'll have to see how this progresses with regard to Mailchimp
+    #       adding methods to the Export API. It would be nice to have this
+    #       model follow the "method_missing" style of the others, but it
+    #       would require passing arguments in as a hash:
+    #
+    #       hominid_export.list({:id => 123, :status => 'unsubscribed'})
+    #
+    #       It's the only way to get the *args to map over to the params hash
+    #       if we use the "method_missing" approach. For now, this way seems
+    #       more intuitive to the end user.
+    
+    def list(id, status = 'subscribed', segment = [], since = '1900-01-01 00:00:00')
+      post_data = {
+        :apikey => @api_key,
+        :id => id,
+        :status => status,
+        :since => since
+      }
+      call('list', post_data)
+    end
+    
+    def campaign_subscriber_activity(id, include_empty = false)
+      post_data = {
+        :apikey => @api_key,
+        :id => id,
+        :include_empty => include_empty,
+      }
+      call('campaignSubscriberActivity', post_data)
+    end
+    
+    private
+    
+    def call(list_method, post_data)
+      uri = URI.parse("#{@api_base}/#{list_method}/")
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = true if @config[:secure]
+      request = Net::HTTP::Post.new(uri.request_uri)
+      request.set_form_data(post_data)
+      response = http.request(request)
+      response.body
+    end
+  end
+end

data/lib/hominid/sts.rb

@@ -0,0 +1,19 @@
+module Hominid
+  class STS < API
+    
+    # MailChimp STS API Documentation: http://apidocs.mailchimp.com/sts/1.0/
+    MAILCHIMP_STS_VERSION = "1.0"
+    
+    # Initialize with an API key and config options
+    def initialize(api_key, config = {})
+      defaults = {
+        :api_version        => MAILCHIMP_STS_VERSION,
+        :domain             => 'sts.mailchimp.com',
+        :secure             => false,
+        :timeout            => nil
+      }
+      super(api_key, defaults.merge(config))
+    end
+    
+  end
+end

data/spec/hominid/hominid_spec.rb

@@ -0,0 +1,24 @@
+require 'spec_helper'
+
+module Hominid
+  describe API do
+    it "requires an API key" do
+      expect {Hominid::API.new}.should raise_error(ArgumentError)
+    end
+    
+    it "requires a valid API key" do
+      expect {Hominid::API.new(@invalid_api_key)}.should raise_error(ArgumentError)
+    end
+
+    it "also accepts config options" do
+      expect {Hominid::API.new(@valid_api_key, {:secure => true})}.should_not raise_error(ArgumentError)
+    end
+    # TODO: Need a way to mock XMLRPC requests.
+  end
+  
+  describe STS do
+    it "returns an instance of API" do
+      Hominid::STS.new(@valid_api_key).should be_kind_of(Hominid::API)
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,13 @@
+require 'rspec'
+require 'fakeweb'
+require 'hominid'
+
+FakeWeb.allow_net_connect = false
+
+RSpec.configure do |config|
+  config.before(:each) do
+    FakeWeb.clean_registry
+    @valid_api_key = 'XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX-us1'
+    @invalid_api_key = 'not_a_valid_api_key'
+  end
+end

metadata

@@ -1,153 +1,134 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: hominid
-version: !ruby/object:Gem::Version 
-  prerelease: false
-  segments: 
-  - 3
-  - 0
-  - 2
-  version: 3.0.2
+version: !ruby/object:Gem::Version
+  version: 3.0.4
+  prerelease: 
 platform: ruby
-authors: 
+authors:
 - Brian Getting
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2010-12-24 00:00:00 -08:00
-default_executable: 
-dependencies: 
-- !ruby/object:Gem::Dependency 
+date: 2012-02-01 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
   name: bundler
-  requirement: &id001 !ruby/object:Gem::Requirement 
+  requirement: &2153641620 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
+    requirements:
     - - ~>
-      - !ruby/object:Gem::Version 
-        segments: 
-        - 1
-        - 0
-        - 0
+      - !ruby/object:Gem::Version
         version: 1.0.0
   type: :development
   prerelease: false
-  version_requirements: *id001
-- !ruby/object:Gem::Dependency 
-  name: jeweler
-  requirement: &id002 !ruby/object:Gem::Requirement 
+  version_requirements: *2153641620
+- !ruby/object:Gem::Dependency
+  name: fakeweb
+  requirement: &2153641060 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ~>
-      - !ruby/object:Gem::Version 
-        segments: 
-        - 1
-        - 5
-        - 2
-        version: 1.5.2
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
   type: :development
   prerelease: false
-  version_requirements: *id002
-- !ruby/object:Gem::Dependency 
-  name: mocha
-  requirement: &id003 !ruby/object:Gem::Requirement 
+  version_requirements: *2153641060
+- !ruby/object:Gem::Dependency
+  name: guard-rspec
+  requirement: &2153640200 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        segments: 
-        - 0
-        - 9
-        - 10
-        version: 0.9.10
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
   type: :development
   prerelease: false
-  version_requirements: *id003
-- !ruby/object:Gem::Dependency 
-  name: rcov
-  requirement: &id004 !ruby/object:Gem::Requirement 
+  version_requirements: *2153640200
+- !ruby/object:Gem::Dependency
+  name: jeweler
+  requirement: &2153638460 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        segments: 
-        - 0
-        - 9
-        - 9
-        version: 0.9.9
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.6.4
   type: :development
   prerelease: false
-  version_requirements: *id004
-- !ruby/object:Gem::Dependency 
-  name: shoulda
-  requirement: &id005 !ruby/object:Gem::Requirement 
+  version_requirements: *2153638460
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: &2153634900 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        segments: 
-        - 2
-        - 11
-        - 3
-        version: 2.11.3
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
   type: :development
   prerelease: false
-  version_requirements: *id005
-description: Hominid is a Ruby gem that provides a wrapper for interacting with the Mailchimp email marketing service API.
+  version_requirements: *2153634900
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &2153633520 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *2153633520
+description: Hominid is a Ruby gem that provides a wrapper for interacting with the
+  Mailchimp email marketing service MC, STS and Export API's.
 email: brian@terra-firma-design.com
 executables: []
-
 extensions: []
-
-extra_rdoc_files: 
+extra_rdoc_files:
 - LICENSE.txt
 - README.rdoc
-files: 
+files:
+- .rspec
+- .travis.yml
 - Gemfile
-- Gemfile.lock
+- Guardfile
 - LICENSE.txt
 - README.rdoc
 - Rakefile
 - VERSION
-- hominid.gemspec
 - lib/hominid.rb
+- lib/hominid/api.rb
 - lib/hominid/campaign.rb
+- lib/hominid/export.rb
 - lib/hominid/list.rb
 - lib/hominid/security.rb
-- test/helper.rb
-- test/test_hominid.rb
-has_rdoc: true
+- lib/hominid/sts.rb
+- spec/hominid/hominid_spec.rb
+- spec/spec_helper.rb
 homepage: http://github.com/terra-firma/hominid
-licenses: 
+licenses:
 - MIT
 post_install_message: 
 rdoc_options: []
-
-require_paths: 
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
+required_ruby_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      hash: 1569519064116685422
-      segments: 
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
       - 0
-      version: "0"
-required_rubygems_version: !ruby/object:Gem::Requirement 
+      hash: 661678545776857612
+required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      segments: 
-      - 0
-      version: "0"
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
 requirements: []
-
 rubyforge_project: 
-rubygems_version: 1.3.7
+rubygems_version: 1.8.8
 signing_key: 
 specification_version: 3
-summary: Hominid is a Ruby wrapper for the Mailchimp API
-test_files: 
-- test/helper.rb
-- test/test_hominid.rb
+summary: Ruby gem for interacting with the Mailchimp API's.
+test_files: []

data/Gemfile.lock

@@ -1,23 +0,0 @@
-GEM
-  remote: http://rubygems.org/
-  specs:
-    git (1.2.5)
-    jeweler (1.5.2)
-      bundler (~> 1.0.0)
-      git (>= 1.2.5)
-      rake
-    mocha (0.9.10)
-      rake
-    rake (0.8.7)
-    rcov (0.9.9)
-    shoulda (2.11.3)
-
-PLATFORMS
-  ruby
-
-DEPENDENCIES
-  bundler (~> 1.0.0)
-  jeweler (~> 1.5.2)
-  mocha (>= 0.9.10)
-  rcov (>= 0.9.9)
-  shoulda (>= 2.11.3)

data/hominid.gemspec

@@ -1,69 +0,0 @@
-# Generated by jeweler
-# DO NOT EDIT THIS FILE DIRECTLY
-# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
-# -*- encoding: utf-8 -*-
-
-Gem::Specification.new do |s|
-  s.name = %q{hominid}
-  s.version = "3.0.2"
-
-  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
-  s.authors = ["Brian Getting"]
-  s.date = %q{2010-12-24}
-  s.description = %q{Hominid is a Ruby gem that provides a wrapper for interacting with the Mailchimp email marketing service API.}
-  s.email = %q{brian@terra-firma-design.com}
-  s.extra_rdoc_files = [
-    "LICENSE.txt",
-    "README.rdoc"
-  ]
-  s.files = [
-    "Gemfile",
-    "Gemfile.lock",
-    "LICENSE.txt",
-    "README.rdoc",
-    "Rakefile",
-    "VERSION",
-    "hominid.gemspec",
-    "lib/hominid.rb",
-    "lib/hominid/campaign.rb",
-    "lib/hominid/list.rb",
-    "lib/hominid/security.rb",
-    "test/helper.rb",
-    "test/test_hominid.rb"
-  ]
-  s.homepage = %q{http://github.com/terra-firma/hominid}
-  s.licenses = ["MIT"]
-  s.require_paths = ["lib"]
-  s.rubygems_version = %q{1.3.7}
-  s.summary = %q{Hominid is a Ruby wrapper for the Mailchimp API}
-  s.test_files = [
-    "test/helper.rb",
-    "test/test_hominid.rb"
-  ]
-
-  if s.respond_to? :specification_version then
-    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
-    s.specification_version = 3
-
-    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
-      s.add_development_dependency(%q<bundler>, ["~> 1.0.0"])
-      s.add_development_dependency(%q<jeweler>, ["~> 1.5.2"])
-      s.add_development_dependency(%q<mocha>, [">= 0.9.10"])
-      s.add_development_dependency(%q<rcov>, [">= 0.9.9"])
-      s.add_development_dependency(%q<shoulda>, [">= 2.11.3"])
-    else
-      s.add_dependency(%q<bundler>, ["~> 1.0.0"])
-      s.add_dependency(%q<jeweler>, ["~> 1.5.2"])
-      s.add_dependency(%q<mocha>, [">= 0.9.10"])
-      s.add_dependency(%q<rcov>, [">= 0.9.9"])
-      s.add_dependency(%q<shoulda>, [">= 2.11.3"])
-    end
-  else
-    s.add_dependency(%q<bundler>, ["~> 1.0.0"])
-    s.add_dependency(%q<jeweler>, ["~> 1.5.2"])
-    s.add_dependency(%q<mocha>, [">= 0.9.10"])
-    s.add_dependency(%q<rcov>, [">= 0.9.9"])
-    s.add_dependency(%q<shoulda>, [">= 2.11.3"])
-  end
-end
-

data/test/helper.rb

@@ -1,18 +0,0 @@
-require 'rubygems'
-require 'bundler'
-begin
-  Bundler.setup(:default, :development)
-rescue Bundler::BundlerError => e
-  $stderr.puts e.message
-  $stderr.puts "Run `bundle install` to install missing gems"
-  exit e.status_code
-end
-require 'test/unit'
-require 'shoulda'
-
-$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
-$LOAD_PATH.unshift(File.dirname(__FILE__))
-require 'hominid'
-
-class Test::Unit::TestCase
-end

data/test/test_hominid.rb

@@ -1,29 +0,0 @@
-require 'helper'
-
-class TestHominid < Test::Unit::TestCase
-  
-  VALID_API_KEY = 'XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX-us1'
-  INVALID_API_KEY = 'not_a_valid_api_key'
-  
-  should "not raise an error if the API key is valid" do
-    assert_nothing_raised do
-      Hominid::API.new(VALID_API_KEY)
-    end
-  end
-  
-  should "raise an error if the API key is not provided" do
-    assert_raise(ArgumentError) do
-      Hominid::API.new()
-    end
-  end
-  
-  should "raise an error if the API key is malformed" do
-    assert_raise(ArgumentError) do
-      Hominid::API.new(INVALID_API_KEY)
-    end
-  end
-  
-  # TODO: Tests that mock API calls so that it is not hitting the actual
-  #       Mailchimp API during testing.
-  
-end