madmimi 1.0.16 → 1.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: be4672c1319bb8ab018016377765b23bf7dd99a5
+  data.tar.gz: edcb37c771c1c11a7ebe34342ebd8971d7d26285
+SHA512:
+  metadata.gz: e577ff522f35537b25bea05a7d8aa1a4bf9064b8678f510058413cef9fd94a671a4fa179b29b8f216cf5c160ec1400d065de66e5470c5cbc9067480c102f22bb
+  data.tar.gz: 26eac26ebec69e51f232b1913f4238d3a3f041bdb1559e2aacc9dc27e1768606961933026d0d8bf9e664e7b52c862bd264e55dc14536648efc0e4397e55668ae

data/.rspec

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

data/Gemfile

@@ -0,0 +1,12 @@
+source 'https://rubygems.org'
+
+gem "activesupport", ">3.0.0"
+gem "crack", ">0.1.7"
+gem "httparty", ">=0.13.1"
+
+group :development do
+  gem 'jeweler', '> 1.4'
+  gem 'rspec'
+  gem 'vcr'
+  gem 'webmock'
+end

data/Gemfile.lock

@@ -0,0 +1,93 @@
+GEM
+  remote: https://rubygems.org/
+  specs:
+    activesupport (4.1.5)
+      i18n (~> 0.6, >= 0.6.9)
+      json (~> 1.7, >= 1.7.7)
+      minitest (~> 5.1)
+      thread_safe (~> 0.1)
+      tzinfo (~> 1.1)
+    addressable (2.3.5)
+    builder (3.2.2)
+    crack (0.4.2)
+      safe_yaml (~> 1.0.0)
+    descendants_tracker (0.0.3)
+    diff-lcs (1.2.5)
+    faraday (0.9.0)
+      multipart-post (>= 1.2, < 3)
+    git (1.2.6)
+    github_api (0.11.2)
+      addressable (~> 2.3)
+      descendants_tracker (~> 0.0.1)
+      faraday (~> 0.8, < 0.10)
+      hashie (>= 1.2)
+      multi_json (>= 1.7.5, < 2.0)
+      nokogiri (~> 1.6.0)
+      oauth2
+    hashie (2.0.5)
+    highline (1.6.20)
+    httparty (0.13.1)
+      json (~> 1.8)
+      multi_xml (>= 0.5.2)
+    i18n (0.6.11)
+    jeweler (2.0.1)
+      builder
+      bundler (>= 1.0)
+      git (>= 1.2.5)
+      github_api
+      highline (>= 1.6.15)
+      nokogiri (>= 1.5.10)
+      rake
+      rdoc
+    json (1.8.1)
+    jwt (0.1.11)
+      multi_json (>= 1.5)
+    mini_portile (0.5.2)
+    minitest (5.4.0)
+    multi_json (1.8.4)
+    multi_xml (0.5.5)
+    multipart-post (2.0.0)
+    nokogiri (1.6.1)
+      mini_portile (~> 0.5.0)
+    oauth2 (0.9.3)
+      faraday (>= 0.8, < 0.10)
+      jwt (~> 0.1.8)
+      multi_json (~> 1.3)
+      multi_xml (~> 0.5)
+      rack (~> 1.2)
+    rack (1.5.2)
+    rake (10.1.1)
+    rdoc (4.1.1)
+      json (~> 1.4)
+    rspec (3.0.0)
+      rspec-core (~> 3.0.0)
+      rspec-expectations (~> 3.0.0)
+      rspec-mocks (~> 3.0.0)
+    rspec-core (3.0.3)
+      rspec-support (~> 3.0.0)
+    rspec-expectations (3.0.3)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.0.0)
+    rspec-mocks (3.0.3)
+      rspec-support (~> 3.0.0)
+    rspec-support (3.0.3)
+    safe_yaml (1.0.1)
+    thread_safe (0.3.4)
+    tzinfo (1.2.2)
+      thread_safe (~> 0.1)
+    vcr (2.9.2)
+    webmock (1.11.0)
+      addressable (>= 2.2.7)
+      crack (>= 0.3.2)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  activesupport (> 3.0.0)
+  crack (> 0.1.7)
+  httparty (>= 0.13.1)
+  jeweler (> 1.4)
+  rspec
+  vcr
+  webmock

data/README.rdoc

@@ -4,70 +4,124 @@ The power of Mad Mimi in your Ruby application. Deliver emails, track statistics
 
 == Installation
 
-gem install madmimi - or if you prefer to live on the edge, just clone this repository and build it from scratch.
+ $ gem install madmimi
+
+or if you prefer to live on the edge, just clone this repository and build it from scratch.
+
+== Dependencies
+
+* active_support (I intend to remove this in the not too distant future, and build my own implementation.)
 
 == Basic Usage
 
-Dependencies:
-active_support (I intend to remove this in the not too distant future, and build my own implementation.)
+ mimi = MadMimi.new('emailaddress', 'api_key')
+ mimi.lists # get all of your Mad Mimi lists returned as a hash
 
-mimi = MadMimi.new('emailaddress', 'api_key')
+You can pass +raise_exceptions+ to the initializer, if you wish to receive exceptions for failing requests:
 
-mimi.lists -> get all of your Mad Mimi lists returned as a hash
+ MadMimi.new('emailaddress', 'api_key', { :raise_exceptions => true })
+ mimi.lists # will raise an Exception if request fails
+
+You can set +verify_ssl+ to either true or false in initializer, if you wish verify SSL or not in requests:
+
+ MadMimi.new('emailaddress', 'api_key', { :verify_ssl => true })
 
 === Audience Members and Lists
 
-mimi.memberships('email') -> returns a hash of the lists that specific email address is subscribed to
+ mimi.memberships('email') # returns a hash of the lists that specific email address is subscribed to
+
+ mimi.new_list('New list name') # make a new list
+
+ mimi.delete_list('New list name') # delete the list I just created
+
+ mimi.csv_import("name,email\ndave,dave@example.com\n") # import from a csv string
+
+ mimi.add_user({ :email => 'dave@example.com', :first_name => 'Dave' }) # add new audience member
+
+ mimi.add_users([
+   { :email => 'dave@example.com',   :first_name => 'Dave' },
+   { :email => 'custom@example.com', :custom_field_1 => 'Dummy value' },
+   { :email => 'smith@example.com',  :last_name => 'Smith' }
+ ]) # add audience members in bulk
+
+ mimi.add_to_list('dave@example.com', 'Test List') # add this email address to a specific list
+ mimi.add_to_list('dave@example.com', 'Test List', {
+   :first_name   => 'Dave',
+   :last_name    => 'Example',
+   :custom_field => 'Custom value'
+ }) # add additional data with this email
 
-mimi.new_list('New list name') -> make a new list
+ mimi.remove_from_list('dave@example.com', 'Test List') # remove this email address from a specific list
 
-mimi.delete_list('New list name') -> delete the list I just created
+ mimi.remove_from_all_lists('dave@example.com') # remove this email address from all lists
 
-mimi.csv_import("name,email\ndave,dave@example.com\n") -> import from a csv string
+ # this API call needs advanced permissions (manually requested)
+ mimi.update_email('dave@example.com', 'john@example.com') # changes email address for user 'dave@example.com' to 'john@example.com'
 
-mimi.add_to_list('dave@example.com', 'Test List') -> add this email address to a specific list
+ mimi.members # get all audience members
 
-mimi.remove_from_list('dave@example.com', 'Test List') -> remove this email address from a specific list
+ mimi.list_members('Test List') # get audience members in specific list
 
-mimi.suppressed_since('unix timestamp') -> get a TXT of all addresses that were suppressed since this timestamp
+ mimi.suppressed?('dave@example.com') # check if audience member is suppressed
+
+ mimi.suppress_email('dave@example.com') # move email to suppressed list
+
+ mimi.unsuppress_email('dave@example.com') # move email from suppressed list
+
+ mimi.suppressed_since('unix timestamp') # get a TXT of all addresses that were suppressed since this timestamp
 
 === Promotions
 
-mimi.promotions -> returns a hash of your promotions
+ mimi.promotions # returns a hash of your promotions
 
-mimi.save_promotion('promotion_name', 'raw_html', 'plain_text') -> saves a promotion (creates the promotion if it does not exist)
+ mimi.save_promotion('promotion_name', 'raw_html', 'plain_text') # saves a promotion (creates the promotion if it does not exist)
 
-mimi.mailing_stats('promotion_id', 'mailing_id') -> get stats on a specific mailing
+ mimi.mailing_stats('promotion_id', 'mailing_id') # get stats on a specific mailing
 
 == Sending E-Mail (using the Mailer API)
 
 === Replacing keys in your email body text:
 
-options = { 'promotion_name' => 'Test Promotion', 'recipients' => 'Nicholas Young <nicholas@madmimi.com>', 'from' => 'MadMimi Ruby <rubygem@madmimi.com>', 'subject' => 'Test Subject' }
+ options = {
+   'promotion_name' => 'Test Promotion',
+   'recipients'     => 'Nicholas Young <nicholas@madmimi.com>',
+   'from'           => 'MadMimi Ruby <rubygem@madmimi.com>',
+   'subject'        => 'Test Subject'
+ }
+ yaml_body = {
+   'greeting' => 'Hello',
+   'name'     => 'Nicholas'
+ }
 
-yaml_body = { 'greeting' => 'Hello', 'name' => 'Nicholas' }
-
-mimi.send_mail(options, yaml_body)
+ mimi.send_mail(options, yaml_body)
 
 === Sending Raw HTML (presumably generated by your app)
 
-options = { 'promotion_name' => 'Test Promotion', 'recipients' => 'Nicholas Young <nicholas@madmimi.com>', 'from' => 'MadMimi Ruby <rubygem@madmimi.com>', 'subject' => 'Test Subject' }
-
-raw_html = "<html><head><title>My great promotion!</title></head><body>Body stuff[[tracking_beacon]]</body></html>"
+ options = {
+   'promotion_name' => 'Test Promotion',
+   'recipients'     => 'Nicholas Young <nicholas@madmimi.com>',
+   'from'           => 'MadMimi Ruby <rubygem@madmimi.com>',
+   'subject'        => 'Test Subject'
+ }
+ raw_html = "<html><head><title>My great promotion!</title></head><body>Body stuff[[tracking_beacon]]</body></html>"
 
-mimi.send_html(options, raw_html)
+ mimi.send_html(options, raw_html)
 
 === Sending Plain Text
 
-options = { 'promotion_name' => 'Test Promotion', 'recipients' => 'Nicholas Young <nicholas@madmimi.com>', 'from' => 'MadMimi Ruby <rubygem@madmimi.com>', 'subject' => 'Test Subject' }
+ options = {
+   'promotion_name' => 'Test Promotion',
+   'recipients'     => 'Nicholas Young <nicholas@madmimi.com>',
+   'from'           => 'MadMimi Ruby <rubygem@madmimi.com>',
+   'subject'        => 'Test Subject'
+ }
+ plain_text = "Plain text email contents [[unsubscribe]]"
 
-plain_text = "Plain text email contents [[unsubscribe]]"
-
-mimi.send_plaintext(options, plain_text)
+ mimi.send_plaintext(options, plain_text)
 
 === Getting the status of a transactional mailing
 
-mimi.status('transaction_id') -> get the status on a specific transactional mailing
+ mimi.status('transaction_id') # get the status on a specific transactional mailing
 
 === Return values
 
@@ -82,18 +136,14 @@ there is probably an error or uncompleted operation.
 
 === Specific options keys
 
-'raw_html': Must include at least one of the [[tracking_beacon]] or [[peek_image]] tags.
-
-'promotion_name': If a promotion doesn't exist under the given name, it will be created.
-If it exists and you specify raw_html, the promotion body will be replaced.
-
-'list_name': For all of the #send methods, if 'list_name' is provided, the recipients
+* 'raw_html': Must include at least one of the [[tracking_beacon]] or [[peek_image]] tags.
+* 'promotion_name': If a promotion doesn't exist under the given name, it will be created. If it exists and you specify raw_html, the promotion body will be replaced.
+* 'list_name': For all of the #send methods, if 'list_name' is provided, the recipients
 will be those for an already-existing "audience."
-
-'to_all': Set to true to send a promotion, plain_text or raw_html to all your audience members
+* 'to_all': Set to true to send a promotion, plain_text or raw_html to all your audience members
 
 == 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
@@ -105,6 +155,7 @@ will be those for an already-existing "audience."
 == Contributors
 tuker
 marcheiligers
+maximgladkov
 
 == Copyright
 

data/Rakefile

@@ -9,11 +9,7 @@ begin
     gem.description = %Q{Send emails, track statistics, and manage your subscriber base with ease.}
     gem.email = "nicholas@madmimi.com"
     gem.homepage = "http://github.com/madmimi/madmimi-gem"
-    gem.authors = ["Nicholas Young", "Marc Heiligers"]
-    gem.add_dependency "crack", ">0.1.7"
-    gem.add_development_dependency "jeweler", ">1.4"
-    gem.add_development_dependency "fakeweb", ">1.2"
-    gem.add_development_dependency "shoulda", ">2.10"
+    gem.authors = ["Nicholas Young", "Marc Heiligers", "Maxim Gladkov"]
     # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
   end
   Jeweler::GemcutterTasks.new
@@ -21,31 +17,7 @@ rescue LoadError
   puts "Jeweler (or a dependency) not available. Install it with: 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
-
-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'
+require 'rdoc/task'
 Rake::RDocTask.new do |rdoc|
   version = File.exist?('VERSION') ? File.read('VERSION') : ""
 

data/VERSION

@@ -1 +1 @@
-1.0.16
+1.1.0

data/config/paths.yml

@@ -0,0 +1,23 @@
+:create_list:           /audience_lists.json
+:remove_from_all_lists: /audience_lists/remove_all
+:destroy_list:          /audience_lists/%{list}
+:add_to_list:           /audience_lists/%{list}/add
+:remove_from_list:      /audience_lists/%{list}/remove
+:audience_lists:        /audience_lists/lists.xml
+:audience_list_members: /audience_lists/%{list}/members.xml
+:audience_members:      /audience_members
+:get_audience_members:  /audience_members.xml
+:search:                /audience_members/search.xml
+:memberships:           /audience_members/%{email}/lists.xml
+:is_suppressed:         /audience_members/%{email}/is_suppressed
+:update_user_email:     /audience_members/%{email}/update_email
+:suppressed_since:      /audience_members/suppressed_since/%{timestamp}.txt
+:suppress_user:         /suppressed_audience_members
+:unsuppress_user:       /suppressed_audience_members/%{email}
+:promotions:            /promotions.xml
+:promotion_save:        /promotions/save
+:mailing_stats:         /promotions/%{promotion_id}/mailings/%{mailing_id}.xml
+:mailer:                /mailer
+:mailer_to_list:        /mailer/to_list
+:mailer_to_all:         /mailer/to_all
+:mailer_status:         /mailers/status/%{transaction_id}

data/lib/madmimi.rb

@@ -14,7 +14,7 @@
 #   The above copyright notice and this permission notice shall be included in
 #   all copies or substantial portions of the Software.
 
-#   Except as contained in this notice, the name(s) of the above copyright holder(s) 
+#   Except as contained in this notice, the name(s) of the above copyright holder(s)
 #   shall not be used in advertising or otherwise to promote the sale, use or other
 #   dealings in this Software without prior written authorization.
 
@@ -26,38 +26,47 @@
 #   OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 #   THE SOFTWARE.
 
+require 'active_support/core_ext/string'
+require 'active_support/core_ext/hash'
 require 'uri'
-require 'net/http'
-require 'net/https'
-require 'crack'
+require 'rubygems'
+require 'httparty'
 require 'csv'
+require 'yaml'
+require 'crack'
 
 class MadMimi
 
-  class MadMimiError < StandardError; end
-
-  BASE_URL = 'api.madmimi.com'
-  
-  NEW_LISTS_PATH = '/audience_lists'
-  AUDIENCE_MEMBERS_PATH = '/audience_members'
-  AUDIENCE_LISTS_PATH = '/audience_lists/lists.xml'
-  MEMBERSHIPS_PATH = '/audience_members/%email%/lists.xml'
-  SUPPRESSED_SINCE_PATH = '/audience_members/suppressed_since/%timestamp%.txt'
-  SUPPRESS_USER_PATH = ' /audience_members/%email%/suppress_email'
-  SEARCH_PATH = '/audience_members/search.xml'
-  
-  PROMOTIONS_PATH = '/promotions.xml'
-  PROMOTION_SAVE_PATH = '/promotions/save'
-  
-  MAILING_STATS_PATH = '/promotions/%promotion_id%/mailings/%mailing_id%.xml'
-  
-  MAILER_PATH = '/mailer'
-  MAILER_TO_LIST_PATH = '/mailer/to_list'
-  MAILER_TO_ALL_PATH = '/mailer/to_all'
-  MAILER_STATUS_PATH = '/mailers/status'
-
-  def initialize(username, api_key)
-    @api_settings = { :username => username, :api_key => api_key }
+  MadMimiError = Class.new(StandardError)
+
+  include HTTParty
+
+  base_uri 'api.madmimi.com'
+
+  parser(
+    Proc.new do |body, format|
+      begin
+        case format
+        when :json
+          Crack::JSON.parse(body)
+        when :xml
+          Crack::XML.parse(body)
+        else
+          body
+        end
+      rescue Crack::ParseError, REXML::ParseException
+        body
+      end
+    end
+  )
+
+  def initialize(username, api_key, options = {})
+    @api_settings = options.reverse_merge({
+      :verify_ssl => true
+    }).merge({
+      :username   => username,
+      :api_key    => api_key
+    })
   end
 
   def username
@@ -68,95 +77,143 @@ class MadMimi
     @api_settings[:api_key]
   end
 
-  def default_opt
-    { :username => username, :api_key => api_key }
+  def raise_exceptions?
+    @api_settings[:raise_exceptions]
+  end
+
+  def raise_exceptions=(raise_exceptions)
+    @api_settings[:raise_exceptions] = raise_exceptions
+  end
+
+  def verify_ssl?
+    @api_settings[:verify_ssl]
+  end
+
+  def verify_ssl=(verify_ssl)
+    @api_settings[:verify_ssl] = verify_ssl
   end
 
   # Audience and lists
   def lists
-    request = do_request(AUDIENCE_LISTS_PATH, :get)
-    Crack::XML.parse(request)
+    wrap_with_array('lists', 'list') do
+      do_request(path(:audience_lists), :get, :format => :xml)
+    end
   end
 
   def memberships(email)
-    request = do_request(MEMBERSHIPS_PATH.gsub('%email%', email), :get)
-    Crack::XML.parse(request)
+    wrap_with_array('lists', 'list') do
+      do_request(path(:memberships, :email => email), :get)
+    end
   end
 
   def new_list(list_name)
-    do_request(NEW_LISTS_PATH, :post, :name => list_name)
+    do_request(path(:create_list), :post, :name => list_name)
   end
 
   def delete_list(list_name)
-    do_request("#{NEW_LISTS_PATH}/#{URI.escape(list_name)}", :post, :'_method' => 'delete')
+    do_request(path(:destroy_list, :list => list_name), :delete)
   end
 
   def csv_import(csv_string)
-    do_request(AUDIENCE_MEMBERS_PATH, :post, :csv_file => csv_string)
+    do_request(path(:audience_members), :post, :csv_file => csv_string)
   end
 
-  def add_user(options)
-    csv_data = build_csv(options)
-    do_request(AUDIENCE_MEMBERS_PATH, :post, :csv_file => csv_data)
+  def add_user(hash_or_array)
+    csv_import(build_csv(hash_or_array))
   end
 
-  def add_to_list(email, list_name)
-    do_request("#{NEW_LISTS_PATH}/#{URI.escape(list_name)}/add", :post, :email => email)
+  alias :add_users :add_user
+
+  def add_to_list(email, list_name, options={})
+    do_request(path(:add_to_list, :list => list_name), :post, options.merge(:email => email))
   end
 
   def remove_from_list(email, list_name)
-    do_request("#{NEW_LISTS_PATH}/#{URI.escape(list_name)}/remove", :post, :email => email)
+    do_request(path(:remove_from_list, :list => list_name), :post, :email => email)
   end
 
-  def suppressed_since(timestamp)
-    do_request(SUPPRESSED_SINCE_PATH.gsub('%timestamp%', timestamp), :get)
+  def remove_from_all_lists(email)
+    do_request(path(:remove_from_all_lists), :post, :email => email)
   end
-  
+
+  def update_email(existing_email, new_email)
+    do_request(path(:update_user_email, :email => existing_email), :post, :email => existing_email, :new_email => new_email)
+  end
+
+  def members
+    wrap_with_array('audience', 'member') do
+      do_request(path(:get_audience_members), :get)
+    end
+  end
+
+  def list_members(list_name)
+    wrap_with_array('audience', 'member') do
+      do_request(path(:audience_list_members, :list => list_name), :get)
+    end
+  end
+
+  def suppressed_since(timestamp, show_suppression_reason = false)
+    do_request(path(:suppressed_since, :timestamp => timestamp), :get, {
+      :show_suppression_reason => show_suppression_reason
+    })
+  end
+
   def suppress_email(email)
-    do_request(SUPPRESS_USER_PATH.gsub('%email%', email), :post)
+    return '' if suppressed?(email)
+
+    process_json_response do
+      do_request(path(:suppress_user), :post, :audience_member_id => email, :format => :json)
+    end
+  end
+
+  def unsuppress_email(email)
+    return '' unless suppressed?(email)
+
+    process_json_response do
+      do_request(path(:unsuppress_user, :email => email), :delete, :format => :json)
+    end
+  end
+
+  def suppressed?(email)
+    response = do_request(path(:is_suppressed, :email => email), :get)
+    response == 'true'
   end
 
   def audience_search(query_string, raw = false)
-    request = do_request(SEARCH_PATH, :get, :raw => raw, :query => query_string)
-    Crack::XML.parse(request)
+    do_request(path(:search), :get, :raw => raw, :query => query_string)
   end
 
-  # Not the most elegant, but it works for now. :)
   def add_users_to_list(list_name, arr)
-    arr.each do |a|
-      a[:add_list] = list_name
-      add_user(a)
-    end
+    add_users(arr.map{ |a| a[:add_list] = list_name; a })
   end
-  
+
   # Promotions
   def promotions
-    request = do_request(PROMOTIONS_PATH, :get)
-    Crack::XML.parse(request)
+    wrap_with_array('promotions', 'promotion') do
+      do_request(path(:promotions), :get)
+    end
   end
-  
+
   def save_promotion(promotion_name, raw_html, plain_text = nil)
     options = { :promotion_name => promotion_name }
-    
+
     unless raw_html.nil?
       check_for_tracking_beacon raw_html
       check_for_opt_out raw_html
       options[:raw_html] = raw_html
     end
-    
+
     unless plain_text.nil?
       check_for_opt_out plain_text
       options[:raw_plain_text] = plain_text
     end
-    
-    do_request PROMOTION_SAVE_PATH, :post, options
+
+    do_request(path(:promotion_save), :post, options)
   end
-  
+
   # Stats
   def mailing_stats(promotion_id, mailing_id)
-    path = MAILING_STATS_PATH.gsub('%promotion_id%', promotion_id).gsub('%mailing_id%', mailing_id)
-    request = do_request(path, :get)
-    Crack::XML.parse(request)
+    do_request(path(:mailing_stats, :promotion_id => promotion_id, :mailing_id => mailing_id), :get)
   end
 
   # Mailer API
@@ -164,12 +221,12 @@ class MadMimi
     options = opt.dup
     options[:body] = yaml_body.to_yaml
     if !options[:list_name].nil? || options[:to_all]
-      do_request(options[:to_all] ? MAILER_TO_ALL_PATH : MAILER_TO_LIST_PATH, :post, options, true)
+      do_request(path(options[:to_all] ? :mailer_to_all : :mailer_to_list), :post, options, true)
     else
-      do_request(MAILER_PATH, :post, options, true)
+      do_request(path(:mailer), :post, options, true)
     end
   end
-  
+
   def send_html(opt, html)
     options = opt.dup
     if html.include?('[[tracking_beacon]]') || html.include?('[[peek_image]]')
@@ -178,9 +235,9 @@ class MadMimi
         unless html.include?('[[unsubscribe]]') || html.include?('[[opt_out]]')
           raise MadMimiError, "When specifying list_name, include the [[unsubscribe]] or [[opt_out]] macro in your HTML before sending."
         end
-        do_request(options[:to_all] ? MAILER_TO_ALL_PATH : MAILER_TO_LIST_PATH, :post, options, true)
+        do_request(path(options[:to_all] ? :mailer_to_all : :mailer_to_list), :post, options, true)
       else
-        do_request(MAILER_PATH, :post, options, true)
+        do_request(path(:mailer), :post, options, true)
       end
     else
       raise MadMimiError, "You'll need to include either the [[tracking_beacon]] or [[peek_image]] macro in your HTML before sending."
@@ -192,89 +249,119 @@ class MadMimi
     options[:raw_plain_text] = plaintext
     if !options[:list_name].nil? || options[:to_all]
       if plaintext.include?('[[unsubscribe]]') || plaintext.include?('[[opt_out]]')
-        do_request(options[:to_all] ? MAILER_TO_ALL_PATH : MAILER_TO_LIST_PATH, :post, options, true)
+        do_request(path(options[:to_all] ? :mailer_to_all : :mailer_to_list), :post, options, true)
       else
         raise MadMimiError, "You'll need to include either the [[unsubscribe]] or [[opt_out]] macro in your text before sending."
       end
     else
-      do_request(MAILER_PATH, :post, options, true)
+      do_request(path(:mailer), :post, options, true)
     end
   end
-  
+
   def status(transaction_id)
-    do_request "#{MAILER_STATUS_PATH}/#{transaction_id}", :get, {}, true
+    do_request(path(:mailer_status, :transaction_id => transaction_id), :get, {}, true)
   end
 
   private
 
   # Refactor this method asap
-  def do_request(path, req_type = :get, options = {}, transactional = false)
-    options = options.merge(default_opt)
-    form_data = options.inject({}) { |m, (k, v)| m[k.to_s] = v; m }
-    resp = href = ""
-    
-    if transactional == true
-      http = Net::HTTP.new(BASE_URL, 443)
-      http.use_ssl = true
-      http.ssl_version = "SSLv3" if http.respond_to?(:ssl_version)
-      http.verify_mode = OpenSSL::SSL::VERIFY_NONE
-    else
-      http = Net::HTTP.new(BASE_URL, 80)
-    end
-    
-    case req_type
-    
-    when :get then
-      begin
-        http.start do |http|
-          req = Net::HTTP::Get.new(path)
-          req.set_form_data(form_data)
-          response = http.request(req)
-          resp = response.body.strip
-        end
-        resp
-      rescue SocketError
-        raise "Host unreachable."
-      end
-    when :post then
-      begin
-        http.start do |http|
-          req = Net::HTTP::Post.new(path)
-          req.set_form_data(form_data)
-          response = http.request(req)
-          resp = response.body.strip
-        end
-      rescue SocketError
-        raise "Host unreachable."
-      end
-    end
+  def do_request(path, method = :get, options = {}, transactional = false)
+    options = default_options.deep_merge({
+      :format => options.delete(:format) || extract_format(path),
+      :body => options
+    })
+
+    path = convert_to_secure(path) if transactional
+
+    response = self.class.send(method, path, options)
+
+    response.value if raise_exceptions?
+    response.parsed_response
   end
 
-  def build_csv(hash)
+  def build_csv(hash_or_array)
+    hashes  = Array.wrap(hash_or_array)
+    columns = hashes.map(&:keys).flatten.uniq
+
     if CSV.respond_to?(:generate_row)   # before Ruby 1.9
       buffer = ''
-      CSV.generate_row(hash.keys, hash.keys.size, buffer)
-      CSV.generate_row(hash.values, hash.values.size, buffer)
+      CSV.generate_row(columns, columns.size, buffer)
+      hashes.each do |hash|
+        values = columns.map{ |c| hash[c] }
+        CSV.generate_row(values, values.size, buffer)
+      end
       buffer
     else                               # Ruby 1.9 and after
       CSV.generate do |csv|
-        csv << hash.keys
-        csv << hash.values
+        csv << columns
+        hashes.each do |hash|
+          csv << columns.map{ |c| hash[c] }
+        end
       end
     end
   end
-  
+
   def check_for_tracking_beacon(content)
     unless content.include?('[[tracking_beacon]]') || content.include?('[[peek_image]]')
       raise MadMimiError, "You'll need to include either the [[tracking_beacon]] or [[peek_image]] macro in your HTML before sending."
     end
     true
   end
-  
+
   def check_for_opt_out(content)
     unless content.include?('[[opt_out]]') || content.include?('[[unsubscribe]]')
       raise MadMimiError, "When specifying list_name or sending to all, include the [[unsubscribe]] or [[opt_out]] macro in your HTML before sending."
     end
     true
   end
-end
+
+  def process_json_response
+    json_response = yield
+    begin
+      json_response["success"] ? '' : json_response["error"]
+    rescue JSON::ParserError
+      json_response
+    end
+  end
+
+  def default_options
+    {
+      :body => {
+        :username => username,
+        :api_key  => api_key
+      },
+      :verify => verify_ssl?
+    }
+  end
+
+  def extract_format(path)
+    File.extname(path)[1..-1].try(:to_sym)
+  end
+
+  def convert_to_secure(path)
+    "#{ self.class.base_uri.gsub('http://', 'https://') }#{ path }"
+  end
+
+  def path(key, arguments={})
+    escaped_arguments = arguments.inject({}){ |h, (k, v)| h[k] = URI.escape(v.to_s); h }
+    paths[key] % escaped_arguments
+  end
+
+  def paths
+    @paths ||= YAML.load(File.read(paths_config_file))
+  end
+
+  def paths_config_file
+    @paths_config_file ||= File.join(File.dirname(File.expand_path(__FILE__)), '../config/paths.yml')
+  end
+
+  def wrap_with_array(*args)
+    yield.tap do |response|
+      obj = args[0..-2].inject(response){ |r, arg| r.try(:[], arg) }
+
+      if obj && obj[args.last] && obj[args.last].is_a?(Hash)
+        obj[args.last] = Array.wrap(obj[args.last])
+      end
+    end
+  end
+end