hominid 1.2.1 → 2.0.0

data/.gitignore

@@ -0,0 +1,4 @@
+.DS_Store
+pkg/*
+pkg/*.*
+.svn

data/{MIT-LICENSE → LICENSE}

@@ -1,4 +1,4 @@
-Copyright (c) 2009 [Brian Getting]
+Copyright (c) 2009 Brian Getting
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/README.textile

@@ -1,76 +1,161 @@
 h1. Hominid
 
-Hominid is a Ruby gem for interacting with the "Mailchimp API":http://www.mailchimp.com/api/1.2/.
+Hominid is a Ruby gem that provides a wrapper for interacting with the "Mailchimp":http://www.mailchimp.com email marketing service API ("version 1.2":http://www.mailchimp.com/api/1.2/).
 
 h2. Installation
 
-Install the gem:
+<pre><code>sudo gem install hominid, :version => '>= 2.0.0', :source => "http://gemcutter.org"</code></pre>
 
-<pre><code>sudo gem install hominid</code></pre>
+Hominid is hosted at "Gemcutter":http://gemcutter.org. Be sure that you have the Gemcutter gem installed if you are having trouble installing Hominid:
 
-In your @environment.rb@ file:
+<pre><code>sudo gem install gemcutter
+gem tumble</code></pre>
 
-<pre><code>config.gem "hominid"</code></pre>
+h2. Configuration
 
-You can also install Hominid as a Rails plugin:
+You will need to create a "Mailchimp":http://www.mailchimp.com/signup account and get your API key (available at http://admin.mailchimp.com/account/api/) in order to get started.
 
-<pre><code>script/plugin install git://github.com/bgetting/hominid.git</code></pre>
+If you are using Hominid inside a Rails application, you can create a config file at @/config/hominid.yml@ with your Mailchimp account information and basic configuration options:
 
-h2. Setup
+<pre><code>development:
+ username: USERNAME
+ password: PASSWORD
+ api_key: API KEY
+ send_goodbye: false
+ send_notify: false
+ double_opt: false
 
-Hominid expects to find a config file at @/config/hominid.yml@ in a Rails application, but you can also pass a hash of config options when creating a new Hominid object (thanks to "ron":http://github.com/ron).
+...</code></pre>
 
-You will also need to create a Mailchimp account to get your API key (available at "http://admin.mailchimp.com/account/api/":http://admin.mailchimp.com/account/api/) to configure a Hominid object. 
+Run @rake hominid:config@ from within a Rails app to create an empty config file.
+Note: You will need to <pre><code>require 'hominid'</code></pre> in your @Rakefile@ to make this rake task available to your application.
 
-h2. Example
+h2. Usage
 
-To interact with the Mailchimp API, simply create a new Hominid object:
+Not all API methods are supported (yet). Currently there are classes for working with lists (_Hominid::List_), campaigns (_Hominid::Campaign_) and accessing the helper methods (_Hominid::Helper_).
 
-<pre><code>@hominid = Hominid.new</code></pre>
+h3. Working with Lists
 
-_or_
+The _Hominid::List_ class is available for working finding lists and working with particular lists. See _Hominid::List_ for more information.
 
-<pre><code>@hominid = Hominid.new({:username => 'USERNAME', :password => 'PASSWORD', :api_key => 'API_KEY', :send_goodbye => false, :send_notify => false, :double_opt => false})</code></pre>
+h4. List Finder Methods
 
-You will need to have the @list ID@ of the mailing list you want to work with. You can find the @list ID@ of a list by:
+There are finder methods for working with lists. Refer to _Hominid::List_ to see the other finders availables.
 
-<pre><code>
-def find_list_id(list_name)
-  mailing_lists = @hominid.lists
-  unless mailing_lists.nil?
-    @list_id = mailing_lists.find {|list| list["name"] == list_name}["id"]
-  end
-end
-</code></pre>
+<pre><code>lists = Hominid::List.all</code></pre>
 
-To subscribe:
+<pre><code>list = Hominid::List.find_by_name("List Name")</code></pre>
 
-<pre><code>@hominid.subscribe(@list_id, "email@example.com", :user_info => {:FNAME => 'Bob', :LNAME => 'Smith'}, :email_type => 'html')</code></pre>
+<pre><code>list = Hominid::List.find(id_or_web_id)</code></pre>
 
-To unsubscribe:
+h4. Subscribing
 
-<pre><code>@hominid.unsubscribe(@list_id, "email@example.com")</code></pre>
+To subscribe a person or persons to a Mailchimp list:
 
-To update a member:
+<pre><code>list.subscribe("sample@emailaddress.com")</code></pre>
 
-<pre><code>@hominid.subscribe(@list_id, "email@example.com", :user_info => {:FNAME => 'Robert', :EMAIL => 'another@example.com'}, :email_type => 'html', :update_existing => true)</code></pre>
+<pre><code>list.subscribe_many([{:EMAIL => 'sample@emailaddress.com', :EMAIL_TYPE => 'html'}, {:EMAIL => 'another@emailaddress.com', :EMAIL_TYPE => 'html'}])</code></pre>
 
-_or_
+h4. Unsubscribing
 
-<pre><code>@hominid.update_member(@list_id, "email@example.com", {:FNAME => 'Robert', :EMAIL => 'another@example.com'})</code></pre>
+To unsubscribe a person or persons from a Mailchimp list:
 
-Campaign methods are also supported. You can get all the campaigns for a particular list by:
+<pre><code>list.unsubscribe("sample@emailaddress.com")</code></pre>
 
-<pre><code>@hominid.campaigns(@list_id)</code></pre>
+<pre><code>list.unsubscribe_many(['sample@emailaddress.com', 'another@emailaddress.com'])</code></pre>
 
-Leave the @@list_id@ out and it will return all the campaigns for your Mailchimp account.
+h4. Updating
 
-h2. Other Stuff
+In the following example, we will be changing a person's email address on the Mailchimp list from @sample@ to @another@:
 
-For the most part, this whole thing was an attempt to optimize the acts_as_mailchimp plugin, and incorporates all the great work from "C.G. Brown":http://www.projectlocker.com/ and "Kelly Mahan":http://digimedia.com/, as well as "Matthew Carlson":http://mandarinsoda.com/, whose plugin inspired nearly all of this work. Recently, "ron":http://github.com/ron and "netguru":http://github.com/netguru have also provided useful changes as well.
+<pre><code>list.update_member('sample@emailaddress.com', {:EMAIL => 'another@emailaddress.com'}, 'html')</code></pre>
 
-I encourage anyone using this gem to please fork it, improve it, and send me a pull request. I typically only use this gem in a minimal capacity, primarily for just managing whether or not a user is signed up for a mailing list. I do not intend to continue maintaining the "Acts As Mailchimp":http://github.com/bgetting/acts_as_mailchimp in the future, since I personally prefer to just use the Hominid gem.
+You can also updated other attributes by including the MERGE_VARS that you want to change, such as @EMAIL@, @FNAME@, @LNAME@ and @INTERESTS@. Get a list of merge tags for a particular list by running @list.merge_tags@.
 
-So please, help us to improve this gem!
+h3. Working with Campaigns
+
+The _Hominid::Campaign_ class provides methods for working with a campaigns.
+
+h4. Campaign Finder Methods
+
+There are finder methods for campaigns as well. Refer to _Hominid::Campaign_ to see the other finders available.
+
+<pre><code>campaigns = Hominid::Campaign.all</code></pre>
+
+<pre><code>campaigns = Hominid::Campaign.find_by_list_name("List Name")</code></pre>
+
+h4. Creating a Campaign
+
+You can create new campaigns using Hominid as well. Please refer to the documentation in _Hominid::Base_ for more information about the options available when creating a new campaign.
+
+<pre><code>new_campaign = Hominid::Campaign.create('regular', options, content, segment_opts, type_opts)</code></pre>
+
+h4. Schedule a Campaign
+
+As an example of how to work with a particular campaign, use the _Hominid::Campaign_ class. Extending from the previous example, since the _#create_campaign_ method returns the ID of the created campaign, we can use it to instantiate the _Hominid::Campaign_ class and schedule our new campaign to go be delivered 2 days from now:
+
+<pre><code>campaign = Hominid::Campaign.new(:id => new_campaign)</code></pre>
+
+<pre><code>campaign.schedule_campaign(2.days.from_now)</code></pre>
+
+h3. Helper Methods
+
+The _Hominid::Helper_ class provides a way to access the helper methods for the Mailchimp API. For example, to create a new folder for filing campaigns:
+
+<pre><code>folder = Hominid::Helper.create_folder("Folder Name")</code></pre>
+
+h2. Syncing Your Application
+
+If you are integrating an application with Mailchimp, Hominid will provide a way for your app to connect with your Mailchimp account. However, it does not provide a way for Mailchimp to connect to your application, which is why Mailchimp has implemented "web hooks":http://www.mailchimp.com/api/webhooks/.
+
+The _Hominid::Webhook class helps with receiving <tt>POST</tt> data from a Mailchimp webhook:
+
+<pre><code>hook = Hominid::Webhook.new(params)
+case hook.event
+when "subscribe"
+  user = User.find_by_email(hook.email)
+  user.opted_in = true
+  user.save
+when "unsubscribe"
+  user = User.find_by_email(hook.email)
+  user.opted_in = false
+  user.save
+when "profile"
+  user = User.find_by_email(hook.email)
+  user.first_name = hook.first_name
+  user.last_name = hook.last_name
+  user.email_type = hook.email_type
+  user.save
+when "upemail"
+  user = User.find_by_email(hook.old_email)
+  user.email = hook.new_email
+  user.save
+end</code></pre>
+
+h2. Contributors
+
+Hominid is maintained by "Brian Getting":http://terra-firma-design.com. A very special thank-you to "Michael Strüder":http://github.com/mikezter for all of his hard work. Also, Hominid wouldn't be anywhere near as awesome as it is today without fantastic contributions and inspiration from:
+
+* "Alan Harper":http://github.com/aussiegeek
+* "Will":http://github.com/willinfront
+* "Ben Woosley":http://github.com/Empact
+* "banker":http://github.com/banker
+* "Kristoffer Renholm":http://github.com/renholm
+* "Wiktor Schmidt":http://github.com/netguru
+* "ron":http://github.com/ron
+* "Matthew Carlson":http://mandarinsoda.com/
+* "Kelly Mahan":http://digimedia.com/
+* "C.G. Brown":http://www.projectlocker.com/
+
+h2. Note on Patches/Pull Requests
+
+# Fork the project.
+# Make your feature addition or bug fix.
+# Add tests for it. This is important so I don't break it in a future version unintentionally.
+# Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
+# Send me a pull request. Bonus points for topic branches.
+
+h2. Copyright
+
+Copyright (c) 2009 Brian Getting. See LICENSE for details.
 
-Copyright (c) 2009 Brian Getting, released under the MIT license.

data/Rakefile

@@ -1,28 +1,57 @@
+require 'rubygems'
 require 'rake'
-require 'rake/rdoctask'
 
 begin
   require 'jeweler'
-  Jeweler::Tasks.new do |s|
-    s.name = "hominid"
-    s.summary = "Hominid is a Ruby gem for interacting with the Mailchimp API."
-    s.email = "brian@terra-firma-design.com"
-    s.homepage = "http://terra-firma-design.com"
-    s.description = "Use the hominid gem to easily integrate with the Mailchimp email marketing service API."
-    s.authors = ["Brian Getting"]
+  Jeweler::Tasks.new do |gem|
+    gem.name = "hominid"
+    gem.summary = %Q{Hominid is a Ruby gem for interacting with 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.email = "brian@terra-firma-design.com"
+    gem.homepage = "http://github.com/bgetting/hominid"
+    gem.authors = ["Brian Getting", "Michael Strüder"]
+    gem.add_development_dependency "shoulda"
   end
-  
   Jeweler::GemcutterTasks.new
-  
 rescue LoadError
-  puts "Jeweler not available. Install it with: sudo gem install technicalpickles-jeweler -s http://gems.github.com"
+  puts "Jeweler (or a dependency) not available. Install it with: sudo gem install jeweler"
+end
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/*_test.rb'
+  test.verbose = true
 end
 
-desc 'Generate documentation for the hominid plugin.'
-Rake::RDocTask.new(:rdoc) do |rdoc|
+begin
+  require 'rcov/rcovtask'
+  Rcov::RcovTask.new do |test|
+    test.libs << 'test'
+    test.pattern = 'test/**/*_test.rb'
+    test.verbose = true
+  end
+rescue LoadError
+  task :rcov do
+    abort "RCov is not available. In order to run rcov, you must: sudo gem install spicycode-rcov"
+  end
+end
+
+task :test => :check_dependencies
+
+task :default => :test
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  if File.exist?('VERSION')
+    version = File.read('VERSION')
+  else
+    version = ""
+  end
+
   rdoc.rdoc_dir = 'rdoc'
-  rdoc.title    = 'Hominid'
-  rdoc.options << '--line-numbers' << '--inline-source'
-  rdoc.rdoc_files.include('README')
+  rdoc.title = "hominid #{version}"
+  rdoc.rdoc_files.include('README*')
   rdoc.rdoc_files.include('lib/**/*.rb')
 end
+

data/VERSION

@@ -0,0 +1 @@
+2.0.0

data/hominid.gemspec

@@ -1,44 +1,47 @@
 # Generated by jeweler
-# DO NOT EDIT THIS FILE
-# Instead, edit Jeweler::Tasks in Rakefile, and run `rake gemspec`
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
 # -*- encoding: utf-8 -*-
 
 Gem::Specification.new do |s|
   s.name = %q{hominid}
-  s.version = "1.2.1"
+  s.version = "2.0.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
-  s.authors = ["Brian Getting"]
-  s.date = %q{2009-10-13}
-  s.description = %q{Use the hominid gem to easily integrate with the Mailchimp email marketing service API.}
+  s.authors = ["Brian Getting", "Michael Str\303\274der"]
+  s.date = %q{2009-10-30}
+  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 = [
-    "README.textile"
+    "LICENSE",
+     "README.textile"
   ]
   s.files = [
-    "MIT-LICENSE",
+    ".gitignore",
+     "LICENSE",
      "README.textile",
      "Rakefile",
-     "VERSION.yml",
+     "VERSION",
      "hominid.gemspec",
      "hominid.yml.tpl",
-     "init.rb",
-     "install.rb",
      "lib/hominid.rb",
-     "pkg/hominid-1.2.1.gem",
-     "rails/init.rb",
-     "spec/hominid_spec.rb",
-     "spec/spec_helper.rb",
-     "uninstall.rb"
+     "lib/hominid/base.rb",
+     "lib/hominid/campaign.rb",
+     "lib/hominid/helper.rb",
+     "lib/hominid/list.rb",
+     "lib/hominid/webhook.rb",
+     "tasks/rails/hominid.rake",
+     "test/hominid_test.rb",
+     "test/test_helper.rb"
   ]
-  s.homepage = %q{http://terra-firma-design.com}
+  s.homepage = %q{http://github.com/bgetting/hominid}
   s.rdoc_options = ["--charset=UTF-8"]
   s.require_paths = ["lib"]
   s.rubygems_version = %q{1.3.5}
   s.summary = %q{Hominid is a Ruby gem for interacting with the Mailchimp API.}
   s.test_files = [
-    "spec/hominid_spec.rb",
-     "spec/spec_helper.rb"
+    "test/hominid_test.rb",
+     "test/test_helper.rb"
   ]
 
   if s.respond_to? :specification_version then
@@ -46,8 +49,12 @@ Gem::Specification.new do |s|
     s.specification_version = 3
 
     if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<shoulda>, [">= 0"])
     else
+      s.add_dependency(%q<shoulda>, [">= 0"])
     end
   else
+    s.add_dependency(%q<shoulda>, [">= 0"])
   end
 end
+

data/hominid.yml.tpl

@@ -1,4 +1,5 @@
 # Get your API key at http://admin.mailchimp.com/account/api/
+
 development:
   username:
   password: 

data/lib/hominid.rb

@@ -1,265 +1,54 @@
 require 'xmlrpc/client'
+require 'ostruct'
 
-class HominidError < RuntimeError
-  def initialize(message)
-    super(message)
-  end
-end
+module Hominid
 
-class HominidCommunicationError < HominidError
-  def initialize(message)
-    super(message)
+  class StandardError < ::StandardError
   end
-end
 
-class Hominid
-  
-  # MailChimp API Documentation: http://www.mailchimp.com/api/1.2/
-  MAILCHIMP_API = "http://api.mailchimp.com/1.2/"
-
-  def initialize(config = {})
-    if defined?(RAILS_ROOT) && (!config || config.empty?)
-      config = YAML.load(File.open("#{RAILS_ROOT}/config/hominid.yml"))[RAILS_ENV].symbolize_keys
+  class APIError < StandardError
+    def initialize(error)
+      super("<#{error.faultCode}> #{error.message}")
     end
-    config.merge(:username => config[:username].to_s, :password => config[:password].to_s)
-    defaults = {:send_welcome => false, :double_opt_in => false, :update_existing => true, :replace_interests => true, :user_info => {}}
-    @config = defaults.merge(config).freeze
-    @chimpApi = XMLRPC::Client.new2(MAILCHIMP_API)
   end
 
-  ## Security related methods
-  
-  def add_api_key
-    @chimpApi.call("apikeyAdd", *@config.values_at(:username, :password, :api_key))
-  end
-  
-  def expire_api_key
-    @chimpApi.call("apikeyExpire", *@config.values_at(:username, :password, :api_key))
-  end
-  
-  def api_keys(include_expired = false)
-    username, password = *@config.values_at(:username, :password)
-    @chimpApi.call("apikeys", username, password, include_expired)
-  end
-  
-  ## Campaign related methods
-  
-  def campaign_stats(campaign_id)
-    # Get the stats of a campaign
-    call("campaignStats", campaign_id)
-  end
-  
-  def campaign_content(campaign_id, for_archive = true)
-    # Get the content of a campaign
-    #
-    # for_archive controls whether we return the Archive version (true) or the Raw version (false), defaults to true
-    call("campaignContent", campaign_id, for_archive)
-  end
-  
-  def campaigns(filters = {}, start = 0, limit = 50)
-    # Get the campaigns for this account
-    # API Version 1.2 requires that filters be sent as a hash
-    # Available options for the filters hash are:
-    #
-    #   :campaign_id    = (string)  The ID of the campaign you wish to return. 
-    #   :list_id        = (string)  Show only campaigns with this list_id. 
-    #   :folder_id      = (integer) Show only campaigns from this folder.
-    #   :from_name      = (string)  Show only campaigns with this from_name.
-    #   :from_email     = (string)  Show only campaigns with this from_email.
-    #   :title          = (string)  Show only campaigns with this title.
-    #   :subject        = (string)  Show only campaigns with this subject.
-    #   :sedtime_start  = (string)  Show campaigns sent after YYYY-MM-DD HH:mm:ss.
-    #   :sendtime_end   = (string)  Show campaigns sent before YYYY-MM-DD HH:mm:ss.
-    #   :subject        = (boolean) Filter by exact values, or search within content for filter values.
-    call("campaigns", filters, start, limit)
+  class ListError < APIError
   end
 
-  # Attach Ecommerce Order Information to a Campaign.
-  # The order hash should be structured as follows: 
-  #
-  #   :id             = (string)  the order id 
-  #   :campaign_id    = (string)  the campaign id to track the order (mc_cid query string). 
-  #   :email_id       = (string)  email id of the subscriber (mc_eid query string)
-  #   :total          = (double)  Show only campaigns with this from_name.
-  #   :shipping       = (string)  *optional - the total paid for shipping fees.
-  #   :tax            = (string)  *optional - the total tax paid.
-  #   :store_id       = (string)  a unique id for the store sending the order in
-  #   :store_name     = (string)  *optional - A readable name for the store, typicaly the hostname.
-  #   :plugin_id      = (string)  the MailChimp-assigned Plugin Id. Using 1214 for the moment. 
-  #   :items          = (array)   the individual line items for an order, using the following keys:
-  #     
-  #     :line_num      = (integer) *optional - line number of the item on the order
-  #     :product_id    = (integer) internal product id
-  #     :product_name  = (string)  the name for the product_id associated with the item
-  #     :category_id   = (integer) internal id for the (main) category associated with product
-  #     :category_name = (string)  the category name for the category id
-  #     :qty           = (double)  the quantity of items ordered
-  #     :cost          = (double)  the cost of a single item (i.e., not the extended cost of the line)
-  def campaign_ecomm_add_order(order)
-    call("campaignEcommAddOrder", order)
+  class ListEmailError < ListError
   end
 
-  def create_campaign(type = 'regular', options = {}, content = {}, segment_options = {}, type_opts = {})
-    # Create a new campaign
-    call("campaignCreate", type, options, content, segment_options, type_opts)
-  end
-  
-  def delete_campaign(campaign_id)
-    # Delete a campaign
-    call("campaignDelete", campaign_id)
-  end
-  
-  def replicate_campaign(campaign_id)
-    # Replicate a campaign (returns ID of new campaign)
-    call("campaignReplicate", campaign_id)
-  end
-  
-  def schedule_campaign(campaign_id, time = "#{1.day.from_now}")
-    # Schedule a campaign
-    ## TODO: Add support for A/B Split scheduling
-    call("campaignSchedule", campaign_id, time)
-  end
-  
-  def send_now(campaign_id)
-    # Send a campaign
-    call("campaignSendNow", campaign_id)
-  end
-  
-  def send_test(campaign_id, emails = {})
-    # Send a test of a campaign
-    call("campaignSendTest", campaign_id, emails)
-  end
-  
-  def templates
-    # Get the templates
-    call("campaignTemplates")
-  end
-  
-  def update_campaign(campaign_id, name, value)
-    # Update a campaign
-    call("campaignUpdate", campaign_id, name, value)
-  end
-  
-  def unschedule_campaign(campaign_id)
-    # Unschedule a campaign
-    call("campaignUnschedule", campaign_id)
-  end
-  
-  ## Helper methods
-  
-  def html_to_text(content)
-    # Convert HTML content to text
-    call("generateText", 'html', content)
-  end
-  
-  def convert_css_to_inline(html, strip_css = false)
-    # Convert CSS styles to inline styles and (optionally) remove original styles
-    call("inlineCss", html, strip_css)
+  class ListMergeError < ListError
   end
-  
-  ## List related methods
-  
-  def lists
-    # Get all of the lists for this mailchimp account
-    call("lists")
-  end
-  
-  def create_group(list_id, group)
-    # Add an interest group to a list
-    call("listInterestGroupAdd", list_id, group)
-  end
-  
-  def create_tag(list_id, tag, name, required = false)
-    # Add a merge tag to a list
-    call("listMergeVarAdd", list_id, tag, name, required)
-  end
-  
-  def delete_group(list_id, group)
-    # Delete an interest group for a list
-    call("listInterestGroupDel", list_id, group)
-  end
-  
-  def delete_tag(list_id, tag)
-    # Delete a merge tag and all its members
-    call("listMergeVarDel", list_id, tag)
-  end
-  
-  def groups(list_id)
-    # Get the interest groups for a list
-    call("listInterestGroups", list_id)
-  end
-  
-  def member(list_id, email)
-    # Get a member of a list
-    call("listMemberInfo", list_id, email)
-  end
-  
-  def members(list_id, status = "subscribed", since = "2000-01-01 00:00:00", start = 0, limit = 100)
-    # Get members of a list based on status
-    # Select members based on one of the following statuses:
-    #   'subscribed'
-    #   'unsubscribed'
-    #   'cleaned'
-    #   'updated'
-    #
-    # Select members that have updated their status or profile by providing
-    # a "since" date in the format of YYYY-MM-DD HH:MM:SS
-    # 
-    call("listMembers", list_id, status, since, start, limit)
-  end
-  
-  def merge_tags(list_id)
-    # Get the merge tags for a list
-    call("listMergeVars", list_id)
-  end
-  
-  def subscribe(list_id, email, options = {})
-    options = apply_defaults_to({:email_type => "html"}.merge(options))
-    # Subscribe a member
-    call("listSubscribe", list_id, email, *options.values_at(:user_info, :email_type, :double_opt_in, :update_existing, :replace_interests, :send_welcome))
-  end
-  
-  def subscribe_many(list_id, subscribers, options = {})
-    options = apply_defaults_to({:update_existing => true}.merge(options))
-    # Subscribe a batch of members
-    # subscribers = {:EMAIL => 'example@email.com', :EMAIL_TYPE => 'html'} 
-    call("listBatchSubscribe", list_id, subscribers, *options.values_at(:double_opt_in, :update_existing, :replace_interests))
+
+  class AlreadySubscribed < ListEmailError
   end
-  
-  # Unsubscribe a user from a list
-  #
-  # Options
-  # :delete_member    Delete user form list instead of marking them as unsubscribed
-  # :send_goodbye     Send goodbye e-mail to user
-  # :send_notify      Send unsubscribe email to email in list settings
-  def unsubscribe(list_id, current_email, options = {})
-    options = apply_defaults_to({:delete_member => true}.merge(options))
-    # Unsubscribe a list member
-    call("listUnsubscribe", list_id, current_email, *options.values_at(:delete_member, :send_goodbye, :send_notify))
+
+  class AlreadyUnsubscribed < ListEmailError
   end
-  
-  def unsubscribe_many(list_id, emails, options = {})
-    options = apply_defaults_to({:delete_member => true}.merge(options))
-    # Unsubscribe an array of email addresses
-    # emails = ['first@email.com', 'second@email.com'] 
-    call("listBatchUnsubscribe", list_id, emails, *options.values_at(:delete_member, :send_goodbye, :send_notify))
+
+  class NotExists < ListEmailError
   end
-  
-  def update_member(list_id, current_email, user_info = {}, email_type = "")
-    # Update a member of this list
-    call("listUpdateMember", list_id, current_email, user_info, email_type, true)
+
+  class NotSubscribed < ListEmailError
   end
-  
-  protected
-  def apply_defaults_to(options)
-    @config.merge(options)
+
+  class CommunicationError < StandardError
+    def initialize(message)
+      super(message)
+    end
   end
+end
 
-  def call(method, *args)
-    @chimpApi.call(method, @config[:api_key], *args)
-  rescue XMLRPC::FaultException => error
-    raise HominidError.new(error.message)
-  rescue Exception => error
-    raise HominidCommunicationError.new(error.message)
+begin
+  # include the provided rake task
+  require 'rake'
+  unless Rake::Task.task_defined? "hominid:config"
+    load File.join(File.dirname(__FILE__), '..', 'tasks', 'rails', 'hominid.rake')
   end
+rescue LoadError
+  # silently skip rake task inclusion unless the rake gem is installed
 end
+
+require 'hominid/base'
+