mc 0.0.4 → 0.0.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 4bd1c554cd8c091423285cbf144266f33c0a7de0
-  data.tar.gz: 0286850e7e743ad88f8110826db32c6afc409e2d
+  metadata.gz: 1d79a45dcaa36faa47ceedc159a03ae01730318f
+  data.tar.gz: 99326eed6d7cc453b5d83e7b828ff6a7baab9b1a
 SHA512:
-  metadata.gz: 67d67a25c42f884348459c71137266625e8391d1ccec6c1a8e20fb94c3e198850cf225b1ba5d8ed00f616e970806ce36d36b2260655b5c825fce00a3a5b9ba5f
-  data.tar.gz: 61e68457d561413a6d54d73569840c17908ba7993ef02d46c814a3b0e9e431f3825c7b3797a2e5ca889e398f6746eb164ebf67157b2d0d852c9635be7d36527b
+  metadata.gz: 5dc376cf666cf740fa86a19001fe17bb682b5a2d866825b0db37a3dd871682b8d1aad4ebee53ba5b3210b0032cafe551593435dc83d56bc397fcc3b4f9612734
+  data.tar.gz: 6bcd1ca4fdd3587c552ca0dc609a81129f8cdcc6dd4b9eea9aa81614edb3185bc3bf08daf24d986eb2e98069fdc859a98bfecd3dcd20fe5f5c7e6f9be78bffbb

data/lib/mc/commands.rb

@@ -6,6 +6,7 @@ program_desc 'Command line interface to MailChimp. Eep eep!'
 version MC::VERSION
 
 config_file '.mailchimp'
+subcommand_option_handling :normal
 
 desc 'Turn on debugging'
 switch [:debug], :negatable => false
@@ -21,7 +22,7 @@ desc 'List to use'
 arg_name 'listID'
 flag [:list]
 
-desc 'formatted, raw, or awesome'
+desc 'table, formatted, raw, or hash'
 arg_name 'format'
 flag [:output,:o]
 

data/lib/mc/commands/campaigns.rb

@@ -82,7 +82,7 @@ command :campaigns do |c|
       type = options[:type]
 
       standard_opts = {
-        :list_id => options[:id],
+        :list_id => required_option(:id, options[:id], global[:list]),
         :subject => required_option(:subject, options[:subject]),
         :from_email => required_option('from-email', options['from-email']),
         :from_name => required_option('from-name', options['from-name']),
@@ -124,14 +124,21 @@ command :campaigns do |c|
 
   c.desc 'Send Campaign Now'
   c.command :send do |s|
+    s.desc 'Campaign ID'
+    s.flag :cid
+
     s.action do |global,options,args|
-      campaign_id = required_argument("Need to supply a campaign id", args.first)
-      puts @mailchimp.campaigns_send :cid => campaign_id
+      cid = required_argument("Need to supply a campaign id", options[:cid])
+      print "Sending campaign #{cid}... "
+      @mailchimp.campaigns_send(:cid => cid)["complete"] ? puts("done!") : puts("ut oh, no can do!")
     end
   end
 
   c.desc 'Schedule Campaign'
   c.command :schedule do |s|
+    s.desc 'Campaign ID'
+    s.flag :cid
+
     s.desc 'Date to schedule campaign in YYYY-MM-DD format'
     s.flag :date, :default_value => (Time.now + 86400).strftime("%Y-%m-%d")
 
@@ -139,29 +146,34 @@ command :campaigns do |c|
     s.flag :time, :default_value => '08:00:00'
 
     s.action do |global,options,args|
-      campaign_id = options[:cid]
-      puts @mailchimp.campaigns_schedule(:cid => campaign_id, :schedule_time => options[:date] + ' ' + options[:time])
+      cid = required_argument("Need to supply a campaign id", options[:cid])
+      puts @mailchimp.campaigns_schedule(:cid => cid, :schedule_time => options[:date] + ' ' + options[:time])
     end
   end
 
   c.desc 'Send Test Campaign'
-  c.command :sendtest do |s|
+  c.command 'send-test' do |s|
+    s.desc 'Campaign ID'
+    s.flag :cid
+
     s.action do |global,options,args|
-      campaign_id = required_argument("Need to supply a campaign id", args.first)
+      cid = required_argument("Need to supply a campaign id", options[:cid])
+      emails = required_argument("Need to supply at least one email to send test campaign to.", args)
 
-      puts "Sending test for campaign #{campaign_id}..."
-      puts @mailchimp.campaign_send_test(:cid=> campaign_id, :test_emails => ["kale.davis@gmail.com", "kale@simplerise.com"])
+      print "Sending test for campaign #{cid}... "
+      @mailchimp.campaigns_send_test(:cid=> cid, :test_emails => emails)["complete"] ? puts("done!") : puts("ut oh, no can do!")
     end
   end
 
   c.desc 'Delete Campaign'
   c.command :delete do |s|
-    s.action do |global,options,args|
-      campaign_id = options[:cid] || @mailchimp.cache.get(:campaign_id)
-      throw "Need a valid Campaign ID." if campaign_id.nil?
+    s.desc 'Campaign ID'
+    s.flag :cid
 
-      campaign_delete(:cid=> campaign_id)
-      puts "Deleted campaign #{campaign_id}."
+    s.action do |global,options,args|
+      cid = required_argument("Need to supply a campaign id", options[:cid])
+      print "Deleting campaign #{cid}... "
+      @mailchimp.campaigns_send_test(:cid=> cid)["complete"] ? puts("done!") : puts("ut oh, no can do!")
     end
   end
 
@@ -179,25 +191,33 @@ command :campaigns do |c|
 
   c.desc 'Check to see if campaign is ready to send'
   c.command :ready do |s|
+    s.desc 'Campaign ID'
+    s.flag :cid
+
     s.action do |global,options,args|
       cid = options[:cid] || get_last_campaign_id
 
-      puts cid
       @output.standard @mailchimp_cached.campaigns_ready(:cid=> cid)
     end
   end
 
   c.command "segment-test" do |s|
+    s.desc 'List ID'
+    s.flag :id
+
     s.desc "Use either 'any' or 'all'"
     s.flag :match, :default_value => 'all'
 
     s.desc 'Condition in the format field,op,value'
     s.flag :condition
+
     s.action do |global,options,args|
-      id = get_required_argument(:id, options[:id], global[:default_list])
+      id = required_option(:id, options[:id], global[:list])
+      match = required_option(:match, options[:match])
+      condition = required_option(:condition, options[:condition])
 
       segment = {}
-      segment['match'] = options[:match]
+      segment['match'] = match
       field, op, value = options[:condition].split(',')
       segment['conditions'] = [{:field => field, :op => op, :value => value}]
 

data/lib/mc/commands/ecomm.rb

@@ -16,14 +16,15 @@ command :ecomm do |c|
 
     s.action do |global,options,args|
       order = {}
-      order[:id] = options[:order_id]
+      order[:id] = required_option(:order_id, options[:order_id])
+      order[:campaign_id] = options[:campaign_id]
       order[:email_id] = options[:email_id]
       order[:email] = options[:email]
       order[:total] = options[:total]
       order[:order_date] = options[:order_date]
       order[:shipping] = options[:shipping]
       order[:tax] = options[:tax]
-      order[:store_id] = options[:store_id]
+      order[:store_id] = required_option(:store_id, options[:store_id])
       order[:store_name] = options[:store_name]
       order[:items] = [{:product_id => 500, :product_name => "Freddie Doll", :category_id => 1, :category_name => "Toys"}]
 
@@ -34,4 +35,25 @@ command :ecomm do |c|
       end
     end
   end
+
+  c.desc 'Delete Ecommerce Order Information used for segmentation'
+  c.command :delete do |s|
+    s.flag :store_id
+    s.flag :order_id
+
+    s.action do |global,options,args|
+      if @mailchimp.ecomm_order_del(:store_id => required_option(:store_id, options[:store_id]), :order_id => required_option(:order_id, options[:order_id]))
+        puts "Order deleted!"
+      else
+        puts "Order not deleted. :("
+      end
+    end
+  end
+
+  c.desc 'Retrieve the Ecommerce Orders for an account'
+  c.command :orders do |s|
+    s.action do |global,options,args|
+      @output.standard @mailchimp_cached.ecomm_orders['data'], :fields => [:store_id, :store_name, :order_id, :campaign_id, :email, :order_total, :order_date]
+    end
+  end
 end

data/lib/mc/commands/export.rb

@@ -15,7 +15,7 @@ command :export do |c|
     c.flag :condition
 
     s.action do |global,options,args|
-      id = get_required_argument(:id, options[:id], global[:default_list])
+      id = required_option(:id, options[:id], global[:list])
 
       if options[:condition]
         segment = {}
@@ -26,10 +26,6 @@ command :export do |c|
 
       status = options[:status]
 
-      # segment = {}
-      # segment["match"] = "all"
-      # segment["conditions"] = [{:field => 'aim', :op => 'open', :value => 'b55303410e'}]
-
       @mailchimp.export_list(:id => id, :status => status, :segment => segment).each do |subscriber|
         puts subscriber
       end
@@ -66,4 +62,3 @@ command :export do |c|
     end
   end
 end
-

data/lib/mc/commands/helper.rb

@@ -1,12 +1,34 @@
 desc 'Basic admin funtions'
 command :helper do |c|
   c.desc 'View API key currently configured'
-  c.command :apikey do |apikey|
-    apikey.action do |global,options,args|
+  c.command :apikey do |s|
+    s.action do |global,options,args|
       puts global[:apikey]
     end
   end
 
+  c.desc 'View user_id of account'
+  c.command :userid do |s|
+    s.action do |global,options,args|
+      puts @mailchimp_cached.helper_account_details['user_id']
+    end
+  end
+
+  c.desc 'View default list if set in config file'
+  c.command 'default-list' do |s|
+    s.action do |global,options,args|
+      global[:list].nil? ? puts('No default list set.') : puts(global[:list])
+    end
+  end
+
+  c.desc 'Quickly see the last campaign sent'
+  c.command 'last-campaign' do |s|
+    s.action do |global,options,args|
+      result = @mailchimp.campaigns_list(:limit => 1)['data'].first
+      puts "#{result['id']}: #{result['title']}"
+    end
+  end
+
   # === Actual MailChimp API Calls below ===
 
   # helper/account-details (string apikey, array exclude)

data/lib/mc/commands/lists-group.rb

@@ -0,0 +1,105 @@
+command :lists do |lists|
+  lists.desc 'Manage groups'
+  lists.command :group do |c|
+    # lists/interest-group-add (string apikey, string id, string group_name, int grouping_id)
+    c.desc 'Add a single Interest Group'
+    c.command :add do |s|
+      s.desc 'list id'
+      s.flag :id
+      s.flag 'grouping-id'
+
+      s.action do |global,options,args|
+        id = required_argument(:id, options[:id], global[:list])
+        group_name = required_argument("Need to provide a group name.", args).first
+
+        @output.standard @mailchimp.lists_interest_group_add(:id => id, :group_name => group_name, :grouping_id => options['grouping-id'])
+      end
+    end
+
+    # lists/interest-group-del (string apikey, string id, string group_name, int grouping_id)
+    c.desc 'Delete a single Interest Group'
+    c.command :delete do |s|
+      s.desc 'list id'
+      s.flag :id
+      s.flag 'grouping-id'
+
+      s.action do |global,options,args|
+        id = required_argument(:id, options[:id], global[:list])
+        group_name = required_argument("Need to provide a group name.", args).first
+        @output.standard @mailchimp.lists_interest_group_delete(:id => id, :group_name => group_name, :grouping_id => options['grouping-id'])
+      end
+    end
+
+    # lists/interest-group-update (string apikey, string id, string old_name, string new_name, int grouping_id)
+    c.desc 'Change the name of an Interest Group'
+    c.command :update do |s|
+      s.desc 'list id'
+      s.flag :id
+      s.flag :old
+      s.flag :new
+      s.flag 'grouping-id'
+
+      s.action do |global,options,args|
+        id = required_argument(:id, options[:id], global[:list])
+        @output.standard @mailchimp.lists_interest_group_delete(:id => id, :old_name => options[:old], :new_name => options[:new], :grouping_id => options['grouping-id'])
+      end
+    end
+  end
+
+  lists.desc 'Manage groupings'
+  lists.command :grouping do |c|
+    # lists/interest-grouping-add (string apikey, string id, string name, string type, array groups)
+    c.desc 'Add a new Interest Grouping'
+    c.arg_name 'groups'
+    c.command :add do |s|
+      s.desc 'list id'
+      s.flag :id
+
+      s.action do |global,options,args|
+        id = required_argument(:id, options[:id], global[:list])
+        @output.standard @mailchimp_cached.lists_grouping_add(:id => id, :name => options[:name], :type => options[:type])
+      end
+    end
+
+    # lists/interest-grouping-del (string apikey, int grouping_id)
+    c.desc 'Delete an existing Interest Grouping'
+    c.command :delete do |s|
+      s.desc 'list id'
+      s.flag :id
+
+      s.action do |global,options,args|
+        id = required_argument(:id, options[:id], global[:list])
+        emails = create_email_struct(required_argument("Need to provide one or more email addresses.", args))
+        @output.standard @mailchimp_cached.lists_
+      end
+    end
+
+    # lists/interest-grouping-update (string apikey, int grouping_id, string name, string value)
+    c.desc 'Update an existing Interest Grouping'
+    c.command :update do |s|
+      s.flag :grouping_id
+      s.flag :name
+      s.flag :value
+
+      s.action do |global,options,args|
+        id = required_argument(:id, options[:id], global[:list])
+        @output.standard @mailchimp_cached.lists_interest_grouping_update(:grouping_id => options[:grouping_id], :name => options[:name], :value => options[:value])
+      end
+    end
+
+    # lists/interest-groupings (string apikey, string id, bool counts)
+    c.desc 'Get the list of interest groupings for a given list, including the label, form information, and included groups for each'
+    c.command :list do |s|
+      s.desc 'list id'
+      s.flag :id
+      s.switch :counts, :default_value => false
+
+      s.action do |global,options,args|
+        id = required_argument(:id, options[:id], global[:list])
+        @output.standard @mailchimp_cached.lists_interest_groupings(:id => id, :counts => options[:counts])
+      end
+    end
+
+    c.default_command :list
+  end
+end

data/lib/mc/commands/lists-merge-var.rb

@@ -0,0 +1,56 @@
+command :lists do |lists|
+  lists.desc 'Manage merge tags'
+  lists.command 'merge-vars' do |c|
+    # # lists/merge-var-add (string apikey, string id, string tag, string name, struct options)
+    # c.desc 'Add a new merge tag to a given list'
+    # c.command :add do |s|
+    #   s.action do |global,options,args|
+    #   end
+    # end
+
+    # # lists/merge-var-del (string apikey, string id, string tag)
+    # c.desc 'Delete a merge tag from a given list and all its members'
+    # c.long_desc <<EOS
+    # Seriously - the data is removed from all members as well! Note that on large lists this method may seem a bit slower than calls you typically make.
+# EOS
+    # c.command :delete do |s|
+    #   s.action do |global,options,args|
+    #   end
+    # end
+
+    # # lists/merge-var-reset (string apikey, string id, string tag)
+    # c.desc 'Completely resets all data stored in a merge var on a list.'
+    # c.command :reset do |s|
+    #   s.action do |global,options,args|
+    #   end
+    # end
+
+    # # lists/merge-var-set (string apikey, string id, string tag, string value)
+    # c.desc 'Completely resets all data stored in a merge var on a list.'
+    # c.command :reset do |s|
+    #   s.action do |global,options,args|
+    #   end
+    # end
+
+    # # lists/merge-var-update (string apikey, string id, string tag, struct options)
+    # c.desc 'Completely resets all data stored in a merge var on a list.'
+    # c.command :reset do |s|
+    #   s.action do |global,options,args|
+    #   end
+    # end
+
+    # lists/merge-vars (string apikey, array id)
+    c.desc 'Get the list of merge tags for a given list, including their name, tag, and required setting'
+    c.command :list do |s|
+      s.desc 'List ID'
+      s.flag :id
+
+      s.action do |global,options,args|
+        id = required_option(:id, options[:id], global[:list])
+        @output.standard @mailchimp_cached.lists_merge_vars(:id => [id])['data'].first['merge_vars']
+      end
+    end
+
+    c.default_command :list
+  end
+end

data/lib/mc/commands/lists-webhook.rb

@@ -0,0 +1,44 @@
+command :lists do |lists|
+  lists.desc 'Manage webhooks for a given lists'
+  lists.command :webhook do |c|
+    #lists/webhook-add (string apikey, string id, string url, struct actions, struct sources)
+    c.desc 'Add a new Webhook URL for the given list'
+    c.command :add do |s|
+      s.desc 'list id'
+      s.flag :id
+
+      s.action do |global,options,args|
+        s.flag :url
+        id = required_argument(:id, options[:id], global[:list])
+        @output.standard @mailchimp.lists_webhook_add(:id => id, :url => options[:url])
+      end
+    end
+
+    #lists/webhook-del (string apikey, string id, string url)
+    c.desc 'Delete an existing Webhook URL from a given list'
+    c.command :delete do |s|
+      s.desc 'list id'
+      s.flag :id
+
+      s.action do |global,options,args|
+        s.flag :url
+        id = required_argument(:id, options[:id], global[:list])
+        @output.standard @mailchimp.lists_webhook_del(:id => id, :url => options[:url])
+      end
+    end
+
+    #lists/webhooks (string apikey, string id)
+    c.desc 'Return the Webhooks configured for the given list'
+    c.command :list do |s|
+      s.desc 'list id'
+      s.flag :id
+
+      s.action do |global,options,args|
+        id = required_argument(:id, options[:id], global[:list])
+        @output.standard @mailchimp_cached.lists_webhooks(:id => id)
+      end
+    end
+
+    c.default_command :list
+  end
+end

data/lib/mc/commands/lists.rb

@@ -1,36 +1,35 @@
 desc 'View information about lists and subscribers'
-arg_name 'Describe arguments to lists here'
-
 command :lists do |c|
-  c.desc 'List ID'
-  c.flag :id
-
-  c.desc 'Email Adress'
-  c.flag :email
-
-  c.desc 'Page number to start at'
-  c.flag :start, :default_value => 0
+  c.desc 'Get all email addresses that complained about a campaign sent to a list'
+  c.command 'abuse-reports' do |s|
+    s.desc 'list id'
+    s.flag :id
 
-  c.desc 'Retrieve all of the lists defined for your user account.'
-  c.command :list do |s|
-    s.action do |global,options,args|
-      stats_column = lambda{|l| "#{l['stats']['member_count']} / #{na(l['stats']['open_rate'])} / #{na(l['stats']['click_rate'])}"}
-      @output.standard @mailchimp_cached.lists_list['data'], :fields => [:id, :name, {"count / open % / click %" => stats_column}]
-    end
-  end
-
-  c.desc 'Access up to the previous 180 days of daily detailed aggregated activity stats for a given list.'
-  c.command :activity do |s|
     s.action do |global,options,args|
       id = required_argument(:id, options[:id], global[:list])
       @output.standard @mailchimp_cached.lists_activity(:id => id)
     end
   end
 
+  # c.desc 'Subscribe a batch of email addresses to a list at once.'
+  # c.command 'batch-subscribe' do |s|
+  #   s.action do |global,options,args|
+  #   end
+  # end
+
+  # c.desc 'Unsubscribe a batch of email addresses from a list.'
+  # c.command 'batch-unsubscribe' do |s|
+  #   s.action do |global,options,args|
+  #   end
+  # end
+
   c.desc "Retrieve the clients that the list's subscribers have been tagged as being used based on user agents seen."
   c.command :clients do |s|
+    s.desc 'list id'
+    s.flag :id
+
     s.action do |global,options,args|
-      id = get_required_argument(:id, options[:id], global[:list])
+      id = required_option(:id, options[:id], global[:list])
 
       results = @mailchimp_cached.lists_clients(:id => id)
       if global[:output]
@@ -45,50 +44,128 @@ command :lists do |c|
     end
   end
 
-  c.desc 'Get all of the merge variables for a list.'
-  c.command 'merge-vars' do |s|
+  c.desc 'Access the Growth History by Month for a given list.'
+  c.command :growth do |s|
+    s.desc 'list id'
+    s.flag :id
+
     s.action do |global,options,args|
-      id = get_required_argument(:id, options[:id], global[:list])
-      @output.standard @mailchimp_cached.lists_merge_vars(:id => [id])['data'].first['merge_vars']
+      id = required_option(:id, options[:id], global[:list])
+      @output.standard @mailchimp_cached.lists_growth_history(:id => id)
     end
   end
 
-  c.desc 'Get all of the list members for a list that are of a particular status.'
-  c.command :members do |s|
-    s.flag :limit, :default_value => 25
+  c.desc 'Retrieve all of the lists defined for your user account.'
+  c.command :list do |s|
+    s.action do |global,options,args|
+      stats_column = lambda{|l| "#{l['stats']['member_count']} / #{na(l['stats']['open_rate'])} / #{na(l['stats']['click_rate'])}"}
+      @output.standard @mailchimp_cached.lists_list['data'], :fields => [:id, :name, {"count / open % / click %" => stats_column}]
+    end
+  end
+
+  c.desc 'Retrieve the locations (countries) that the list\'s subscribers have been tagged to based on geocoding their IP address.'
+  c.command :locations do |s|
+    s.desc 'list id'
+    s.flag :id
+    s.flag :num, :default_value => 25
+
+    s.action do |global,options,args|
+      id = required_option(:id, options[:id], global[:list])
+      @output.standard @mailchimp_cached.lists_locations(:id => id)[0..options[:num].to_i]
+    end
+  end
+
+  c.desc 'Get the most recent 100 activities for particular list members.'
+  c.arg_name 'emails'
+  c.command 'member-activity' do |s|
+    s.desc 'list id'
+    s.flag :id
 
     s.action do |global,options,args|
-      id = get_required_argument(:id, options[:id], global[:list])
-      @output.standard @mailchimp_cached.lists_members(:id => id, :limit => limit)['data'], :fields => [:email, :member_rating, :status, :is_gmonkey]
+      id = required_option(:id, options[:id], global[:list])
+      emails = create_email_struct(required_argument("Need to provide one or more email addresses.", args))
+
+      @output.standard @mailchimp_cached.lists_member_activity(:id => id, :emails => emails)['data'].first['activity'], :fields => [:action, :timestamp, :title, :url]
     end
   end
 
   c.desc 'Get information about one particular member.'
+  c.arg_name 'emails'
   c.command 'member-info' do |s|
+    s.desc 'list id'
+    s.flag :id
+
     s.action do |global,options,args|
-      id = get_required_argument(:id, options[:id], global[:list])
+      id = required_option(:id, options[:id], global[:list])
       emails = create_email_struct(required_argument("Need to provide one or more email addresses.", args))
 
       @output.as_hash @mailchimp_cached.lists_member_info(:id => id, :emails => emails)
     end
   end
 
-  c.desc 'Retrieve the locations (countries) that the list\'s subscribers have been tagged to based on geocoding their IP address.'
-  c.command :locations do |s|
-    s.flag :num, :default_value => 25
+  c.desc 'Get all of the list members for a list that are of a particular status.'
+  c.command :members do |s|
+    s.desc 'list id'
+    s.flag :id
+    s.flag :limit, :default_value => 25
 
     s.action do |global,options,args|
-      id = get_required_argument(:id, options[:id], global[:list])
-      @output.standard @mailchimp_cached.lists_locations(:id => id)[0..options[:num].to_i]
+      id = required_option(:id, options[:id], global[:list])
+      @output.standard @mailchimp_cached.lists_members(:id => id, :limit => options[:limit])['data'], :fields => [:email, :member_rating, :status, :is_gmonkey]
     end
   end
 
-  c.desc 'Access the Growth History by Month for a given list.'
-  c.command :growth do |s|
+  c.desc 'Subscribe the provided email to a list. By default this sends a confirmation email.'
+  c.arg_name 'emails'
+  c.command :subscribe do |s|
+    s.desc 'list id'
+    s.flag :id
+
     s.action do |global,options,args|
-      id = get_required_argument(:id, options[:id], global[:list])
-      # @output.standard @mailchimp_cached.lists_growth_history(:id => id), :fields => [:month, :existing, :optins]
-      @output.standard @mailchimp_cached.lists_growth_history(:id => id)
+      #TODO: add support for merge fields
+      #TODO: add support for location
+      s.flag 'new-email'
+      s.flag 'group-id'
+      s.flag 'group-name'
+      s.flag :groups
+      s.flag 'optin-ip'
+      s.flag 'optin-time'
+      s.flag :language
+      s.flag :note
+      s.flag 'note-id'
+      s.flag 'note-action'
+
+      s.flag 'email-type'
+      s.switch 'double-optin'
+      s.switch 'update-existing'
+      s.switch 'replace-interests'
+      s.switch 'send-welcome'
+
+      id = required_argument(:id, options[:id], global[:list])
+      emails = create_email_struct(required_argument("Need to provide one or more email addresses.", args))
+      @output.as_hash @mailchimp.lists_subscribe(:id => id, :email => emails.first, :merge_vars => {:groupings => [{:id => 4493, :groups => ['Group1']}]})
+    end
+  end
+
+  c.desc 'Retrieve all of the Static Segments for a list.'
+  c.command 'static-segments' do |s|
+    s.desc 'list id'
+    s.flag :id
+
+    s.action do |global,options,args|
+      id = required_option(:id, options[:id], global[:list])
+      @output.as_hash @mailchimp_cached.lists_static_segments(:id => id)
+    end
+  end
+
+  c.desc 'Retrieve all of the Static Segments for a list.'
+  c.command 'segments' do |s|
+    s.desc 'list id'
+    s.flag :id
+
+    s.action do |global,options,args|
+      id = required_option(:id, options[:id], global[:list])
+      @output.as_hash @mailchimp_cached.lists_segments(:id => id)
     end
   end
 end

data/lib/mc/commands/reports.rb

@@ -1,20 +1,26 @@
 desc 'Reports'
 command :reports do |c|
-
   # reports/abuse (string apikey, string cid, struct opts)
   c.desc 'Get all email addresses that complained about a given campaign'
   c.command :abuse do |s|
+    s.arg_name 'campaign id'
+    s.flag :cid
+
     s.action do |global,options,args|
-      not_implemented
+      cid = options[:cid] || get_last_campaign_id
+      member_column = lambda{|l| "#{l['member']['email']}"}
+      @output.standard @mailchimp_cached.reports_abuse(:cid => cid)['data'], :fields => [:member => {:display_method => member_column}]
     end
   end
 
   # reports/advice (string apikey, string cid)
   c.desc 'Retrieve the text presented in our app for how a campaign performed and any advice we may have for you'
   c.command :advice do |s|
+    s.arg_name 'campaign id'
+    s.flag :cid
+
     s.action do |global,options,args|
       cid = options[:cid] || get_last_campaign_id
-      #cid = @mailchimp.campaigns_list(:limit => 1, :sort_field => "send_time")["data"].first["id"]
       @output.as_hash @mailchimp_cached.reports_advice :cid => cid
     end
   end
@@ -22,14 +28,22 @@ command :reports do |c|
   # reports/bounce-message (string apikey, string cid, struct email)
   c.desc 'Retrieve the most recent full bounce message for a specific email address on the given campaign. Messages over 30 days old are subject to being removed'
   c.command :bounce do |s|
+    s.arg_name 'campaign id'
+    s.flag :cid
+
     s.action do |global,options,args|
-      not_implemented
+      cid = options[:cid] || get_last_campaign_id
+      email = create_email_struct(required_argument("Need to provide an email address.", args))
+      puts @mailchimp_cached.reports_bounce_message(:cid => cid, :email => email.first)['message']
     end
   end
 
   # reports/bounce-messages (string apikey, string cid, struct opts)
-  c.desc 'Retrieve the full bounce messages for the given campaign. Note that this can return very large amounts of data depending on how large the campaign was and how much cruft the bounce provider returned. Also, messages over 30 days old are subject to being removed'
+  c.desc 'Retrieve the full bounce messages for the given campaign. Messages over 30 days old are subject to being removed'
   c.command :bounces do |s|
+    s.arg_name 'campaign id'
+    s.flag :cid
+
     s.action do |global,options,args|
       cid = options[:cid] || get_last_campaign_id
 
@@ -55,24 +69,37 @@ command :reports do |c|
 
   # reports/click-detail (string apikey, string cid, int tid, struct opts)
   c.desc 'Return the list of email addresses that clicked on a given url, and how many times they clicked'
-  c.command :clicked do |s|
+  c.command 'clicked-url' do |s|
+    s.arg_name 'campaign id'
+    s.flag :cid
+    s.flag :tid
+
     s.action do |global,options,args|
-      not_implemented
+      cid = options[:cid] || get_last_campaign_id
+      tid = options[:tid]
+      member_column = lambda{|l| "#{l['member']['email']}"}
+      @output.standard @mailchimp_cached.reports_click_detail(:cid => cid, :tid => tid)['data'], :fields => [:clicks, {:member => {:display_method => member_column}}]
     end
   end
 
   # reports/clicks (string apikey, string cid)
   c.desc 'The urls tracked and their click counts for a given campaign.'
   c.command :clicks do |s|
+    s.arg_name 'campaign id'
+    s.flag :cid
+
     s.action do |global,options,args|
       cid = options[:cid] || get_last_campaign_id
-      @output.standard @mailchimp_cached.reports_clicks(:cid => cid)['total'], :fields => [{:url => {:width => 80}}, :clicks, :unique]
+      @output.standard @mailchimp_cached.reports_clicks(:cid => cid)['total'], :fields => [:tid, {:url => {:width => 80}}, :clicks, :unique]
     end
   end
 
   # reports/domain-performance (string apikey, string cid)
   c.desc 'Get the top 5 performing email domains for this campaign.'
   c.command :domains do |s|
+    s.arg_name 'campaign id'
+    s.flag :cid
+
     s.action do |global,options,args|
       cid = options[:cid] || get_last_campaign_id
       @output.standard @mailchimp_cached.reports_domain_performance :cid => cid
@@ -82,32 +109,45 @@ command :reports do |c|
   # reports/ecomm-orders (string apikey, string cid, struct opts)
   c.desc 'Retrieve the Ecommerce Orders tracked by campaignEcommOrderAdd()'
   c.command :ecomm do |s|
+    s.arg_name 'campaign id'
+    s.flag :cid
+
     s.action do |global,options,args|
-      not_implemented
+      cid = options[:cid] || get_last_campaign_id
+      @output.standard @mailchimp_cached.reports_ecomm_orders(:cid => cid)['data']
     end
   end
 
   # reports/eepurl (string apikey, string cid)
   c.desc 'Retrieve the eepurl stats from the web/Twitter mentions for this campaign'
   c.command :eepurl do |s|
+    s.arg_name 'campaign id'
+    s.flag :cid
+
     s.action do |global,options,args|
       cid = options[:cid] || get_last_campaign_id
-      @output.standard @mailchimp_cached.reports_eepurl :cid => cid
+      @output.as_hash @mailchimp_cached.reports_eepurl(:cid => cid)
     end
   end
 
   # reports/geo-opens (string apikey, string cid)
   c.desc 'Retrieve the countries/regions and number of opens tracked for each. Email address are not returned.'
   c.command :geo do |s|
+    s.arg_name 'campaign id'
+    s.flag :cid
+
     s.action do |global,options,args|
       cid = options[:cid] || get_last_campaign_id
-      @output.standard @mailchimp_cached.reports_geo_opens :cid => cid
+      @output.standard @mailchimp_cached.reports_geo_opens(:cid => cid), :fields => [:code, :name, :opens]
     end
   end
 
   # reports/google-analytics (string apikey, string cid)
   c.desc 'Retrieve the Google Analytics data we have collected for this campaign.'
   c.command :ga do |s|
+    s.arg_name 'campaign id'
+    s.flag :cid
+
     s.action do |global,options,args|
       cid = options[:cid] || get_last_campaign_id
       @output.standard @mailchimp_cached.reports_google_analytics :cid => cid
@@ -116,39 +156,81 @@ command :reports do |c|
 
   # reports/member-activity (string apikey, string cid, array emails)
   c.desc 'Given a campaign and email address, return the entire click and open history with timestamps, ordered by time.'
-  c.command :member_activity do |s|
+  c.command 'member-activity' do |s|
+    s.arg_name 'campaign id'
+    s.flag :cid
+
     s.action do |global,options,args|
-      not_implemented
+      cid = options[:cid] || get_last_campaign_id
+      email = create_email_struct(required_argument("Need to provide an email address.", args))
+      results = @mailchimp_cached.reports_member_activity(:cid => cid, :emails => email)['data']
+
+      results.each do |result|
+        puts result['email']['email']
+        puts "#{'='*result['email']['email'].size}"
+        @output.as_table result['activity']
+        puts "\n"
+      end
     end
   end
 
   # reports/not-opened (string apikey, string cid, struct opts)
   c.desc 'Retrieve the list of email addresses that did not open a given campaign'
-  c.command :not_opened do |s|
+  c.command 'not-opened' do |s|
+    s.arg_name 'campaign id'
+    s.flag :cid
+    s.flag :start, :default_value => 0
+    s.flag :limit, :default_value => 50
+
     s.action do |global,options,args|
-      not_implemented
+      cid = options[:cid] || get_last_campaign_id
+      opts = {:start => options['start'], :limit => options['limit']}
+      @output.standard @mailchimp_cached.reports_not_opened(:cid => cid, :opts => opts)['data'], :fields => [:email]
     end
   end
 
   # reports/opened (string apikey, string cid, struct opts)
   c.desc 'Retrieve the list of email addresses that opened a given campaign with how many times they opened'
   c.command :opened do |s|
+    s.arg_name 'campaign id'
+    s.flag :cid
+    s.flag :start, :default_value => 0
+    s.flag :limit, :default_value => 50
+    s.flag 'sort-field', :default_value => "opened"
+    s.flag 'sort-dir', :default_value => "asc"
+
     s.action do |global,options,args|
-      not_implemented
+      cid = options[:cid] || get_last_campaign_id
+      opts = {:start => options['start'], :limit => options['limit'], :sort_field => options['sort-field'], :sort_dir => options['sort-dir']}
+      member_column = lambda{|l| "#{l['member']['email']}"}
+
+      @output.standard @mailchimp_cached.reports_opened(:cid => cid, :opts => opts)['data'], :fields => [:opens, {:member => {:display_method => member_column}}]
     end
   end
 
   # reports/sent-to (string apikey, string cid, struct opts)
   c.desc 'Get email addresses the campaign was sent to'
-  c.command :sent_to do |s|
+  c.command 'sent-to' do |s|
+    s.arg_name 'campaign id'
+    s.flag :cid
+    s.flag :status
+    s.flag :start, :default_value => 0
+    s.flag :limit, :default_value => 50
+
     s.action do |global,options,args|
-      not_implemented
+      cid = options[:cid] || get_last_campaign_id
+      opts = {:status => options['status'], :start => options['start'], :limit => options['limit']}
+      member_column = lambda{|l| "#{l['member']['email']}"}
+      @output.standard @mailchimp_cached.reports_sent_to(:cid => cid, :opts => opts)['data'], :fields => [:member => {:display_method => member_column}]
     end
   end
 
   # reports/share (string apikey, string cid, array opts)
   c.desc 'Get the URL to a customized VIP Report for the specified campaign and optionally send an email to someone with links to it.'
   c.command :share do |s|
+    s.arg_name 'campaign id'
+    s.flag :cid
+
     s.action do |global,options,args|
       cid = options[:cid] || get_last_campaign_id
 
@@ -168,16 +250,28 @@ command :reports do |c|
   # reports/summary (string apikey, string cid)
   c.desc 'Retrieve relevant aggregate campaign statistics (opens, bounces, clicks, etc.)'
   c.command :summary do |s|
+    s.desc 'Campaign ID'
+    s.flag :cid
+
     s.action do |global,options,args|
-      not_implemented
+      ap options
+      cid = options[:cid] || get_last_campaign_id
+      @output.as_hash @mailchimp_cached.reports_summary(:cid => cid)
     end
   end
 
   # reports/unsubscribes (string apikey, string cid, struct opts)
   c.desc 'Get all unsubscribed email addresses for a given campaign'
   c.command :unsubscribes do |s|
+    s.arg_name 'campaign id'
+    s.flag :cid
+    s.flag :start, :default_value => 0
+    s.flag :limit, :default_value => 50
+
     s.action do |global,options,args|
-      not_implemented
+      cid = options[:cid] || get_last_campaign_id
+      opts = {:start => options['start'], :limit => options['limit']}
+      @output.standard @mailchimp_cached.reports_unsubscribes(:cid => cid, :opts => opts)['data'], :fields => [:email]
     end
   end
 end

data/lib/mc/commands/search.rb

@@ -4,8 +4,8 @@ command :search do |c|
   c.desc 'Search all campaigns for the specified query terms'
   c.command :campaigns do |s|
     s.action do |global,options,args|
-      campaigns = required_argument("You need to include a search argument: mc search campaigns <query terms>", args.join(' '))
-      @output.search @mailchimp_cached.helper_search_members(:query => query)
+      query = required_argument("You need to include a search argument: mc search campaigns <query terms>", args.join(' '))
+      @output.campaign_search @mailchimp_cached.helper_search_campaigns(:query => query)
     end
   end
 
@@ -14,7 +14,7 @@ command :search do |c|
   c.command :members do |s|
     s.action do |global,options,args|
       query = required_argument("You need to include a search argument: mc search members <query terms>", args.join(' '))
-      @output.search @mailchimp_cached.helper_search_members(:query => query)
+      @output.member_search @mailchimp_cached.helper_search_members(:query => query)
     end
   end
 end

data/lib/mc/commands/users.rb

@@ -3,19 +3,66 @@ command :users do |c|
   # users/invite (string apikey, string email, string role, string msg)
   c.desc 'Invite a user to your account'
   c.command :invite do |s|
+    s.flag :role
+    s.flag :msg
+
+    s.action do |global,options,args|
+      email = required_argument("Need to provide an email address.", args)
+      role  = options[:role]
+      msg   = options[:msg]
+
+      @output.standard @mailchimp.users_invites(:email => email, :role => role, :msg => msg)
+    end
+  end
+
+  # users/invite-resend (string apikey, string email)
+  c.desc 'Resend an invite a user to your account.'
+  c.command 'invite-revoke' do |s|
     s.action do |global,options,args|
-      emails = create_email_struct(options[:email])
+      email = required_argument("Need to provide email address.", args)
+      @output.standard @mailchimp.users_login_revoke(:email => email)
+    end
+  end
 
-      status = @mailchimp.vip_add(:id => id, :emails => emails)
-      puts status
+  # users/invite-revoke (string apikey, string email)
+  c.desc 'Revoke an invitation sent to a user to your account.'
+  c.command 'invite-revoke' do |s|
+    s.action do |global,options,args|
+      email = required_argument("Need to provide email address.", args)
+      @output.standard @mailchimp.users_login_revoke(:email => email)
     end
   end
 
-  # useres/logins (string apikey)
+  # users/invites (string apikey)
+  c.desc 'Retrieve the list of pending users invitations have been sent for.'
+  c.command :invites do |s|
+    s.action do
+      @output.standard @mailchimp_cached.users_invites
+    end
+  end
+
+  # users/login-revoke (string apikey, string username)
+  c.desc 'Revoke access for a specified login.'
+  c.command 'login-revoke' do |s|
+    s.action do |global,options,args|
+      username = required_argument("Need to provide login username.", args)
+      @output.standard @mailchimp.users_login_revoke(:username => username)
+    end
+  end
+
+  # users/logins (string apikey)
   c.desc 'Retrieve the list of active logins.'
   c.command :logins do |s|
-    s.action do
-      puts @mailchimp_cached.users_logins
+    s.action do |global,options,args|
+      @output.standard @mailchimp_cached.users_logins
+    end
+  end
+
+  # users/profile (string apikey)
+  c.desc 'Retrieve the profile for the login owning the provided API Key.'
+  c.command :profile do |s|
+    s.action do |global,options,args|
+      @output.standard @mailchimp_cached.users_profile
     end
   end
 end

data/lib/mc/commands/vip.rb

@@ -1,8 +1,5 @@
 desc 'VIPs'
 command :vip do |c|
-  c.desc 'List ID'
-  c.flag :id
-
   # vip/activity (string apikey)
   c.desc 'Show all Activity (opens/clicks) for VIPs over the past 10 days'
   c.command :activity do |s|
@@ -14,16 +11,17 @@ command :vip do |c|
   # vip/add (string apikey, string id, array emails)
   c.desc 'Add VIP(s)'
   c.command :add do |s|
+    s.desc 'List ID'
+    s.flag :id
+
     s.action do |global,options,args|
-      id = get_required_argument(:id, options[:id], global[:default_list])
+      id = required_option(:id, options[:id], global[:list])
       emails = create_email_struct(required_argument("Need to provide an email address.", args))
 
       status = @mailchimp.vip_add(:id => id, :emails => emails)
-      if emails.count == status['success_count']
-        puts "Successfully added email(s)!"
-      else
-        @output.errors status
-      end
+
+      puts "Added #{status['success_count']} subscriber(s) as VIPs." if successful? status
+      show_errors status
     end
   end
 
@@ -31,13 +29,13 @@ command :vip do |c|
   c.desc 'Remove VIP(s)'
   c.command :remove do |s|
     s.action do |global,options,args|
-      id = get_required_argument(:id, options[:id], global[:default_list])
+      id = required_option(:id, options[:id], global[:list])
       emails = create_email_struct(required_argument("Need to provide an email address.", args))
 
       status = @mailchimp.vip_del(:id => id, :emails => emails)
-      #TODO: create helper method to display success
-      puts status
-      #status["success"] > 0 ? "#{options[:email]} removed!" : "Oops!"
+
+      puts "Removed #{status['success_count']} subscriber(s) as VIPs." if successful? status
+      show_errors status
     end
   end
 

data/lib/mc/helper.rb

@@ -9,12 +9,6 @@ module Helper
     end
   end
 
-  def get_required_argument(name, option, global)
-    return option unless option.nil?
-    return global unless global.nil?
-    help_now!("--#{name.to_s} is required")
-  end
-
   def required_option(name, *options)
     options.each {|o| return o unless o.nil? or o.empty?}
     exit_now!("Error: --#{name.to_s} is required")
@@ -51,6 +45,20 @@ module Helper
     end
   end
 
+  def successful? status
+    status['success_count'] > 0
+  end
+
+  def show_errors status
+    if status['error_count'] > 0
+      puts "Oops, had #{status['error_count']} error(s):"
+      status['errors'].each do |error|
+        # remove periods just to make the error look nicer
+        puts "  #{error['error'].gsub('.','')} - #{error['email']['email']}"
+      end
+    end
+  end
+
   private
 
   def pad(num, total)

data/lib/mc/mailchimp.rb

@@ -15,7 +15,7 @@ class MailChimp
     category = method_name.to_s.split('_').first
     method   = method_name.to_s.split('_')[1..-1].join('_')
     if category == "export"
-      @exporter.send(method, *args)
+      @exporter.__send__(method, *args)
     else
       if method == 'send'
         # handle wonk case of 'send' method

data/lib/mc/mailchimp_cached.rb

@@ -33,7 +33,8 @@ class MailChimpCached < MailChimp
       category = method_name.to_s.split('_').first
       method   = method_name.to_s.split('_')[1..-1].join('_')
 
-      throw "error: don't support caching send" if method == 'send'
+      throw "error: don't support caching export" if category == "export"
+      throw "error: don't support caching send" if method == "send"
 
       result = @api.send(category).method_missing(method, *args)
       @cache.set(cache_key, result)

data/lib/mc/version.rb

@@ -1,4 +1,4 @@
 module MC
   # have to check const defined for 1.8.7 to avoid warnings
-  VERSION = '0.0.4' unless const_defined?(:VERSION)
+  VERSION = '0.0.5' unless const_defined?(:VERSION)
 end

data/lib/mc/writer.rb

@@ -29,6 +29,10 @@ class ConsoleWriter
     tp results, options[:fields]
   end
 
+  def as_raw(results)
+    puts results
+  end
+
   def errors(results)
     puts "Error count: #{results['error_count']}"
     results['errors'].each do |error|
@@ -113,30 +117,42 @@ class ConsoleWriter
     end
   end
 
-  def search(results)
+  def campaign_search(results)
+    if results['total'].to_i == 0
+      exit_now!("No matches found.")
+    end
+
+    results['results'].each_with_index do |result, index|
+      puts "#{'-'*15} [#{index+1}] #{'-'*15}"
+      puts result['snippet'].strip.gsub(/\n/, ' ')
+      puts "From campaign \"#{result['campaign']['title']}\" (#{result['campaign']['id']}) that was sent on #{result['campaign']['send_time'].split.first}"
+      puts "\n"
+    end
+  end
+
+  def member_search(results)
     redirect_output?(results)
 
-    i = results
-    if i['exact_matches']['total'].to_i == 0 and i['full_search']['total'].to_i == 0
+    if results['exact_matches']['total'].to_i == 0 and results['full_search']['total'].to_i == 0
       exit_now!("No matches found.")
     end
 
     members = []
 
-    if i['exact_matches']['total'].to_i > 0
-      puts "#{'='*20} Exact Matches (#{i['exact_matches']['total']}) #{'='*20}"
+    if results['exact_matches']['total'].to_i > 0
+      puts "#{'='*20} Exact Matches (#{results['exact_matches']['total']}) #{'='*20}"
 
-      i['exact_matches']['members'].each do |member|
+      results['exact_matches']['members'].each do |member|
         members << member
       end
-    elsif i['full_search']['total'].to_i > 0
-      puts "#{'='*26} Matches (#{i['full_search']['total']}) #{'='*26}"
-      i['full_search']['members'].each do |member|
+    elsif results['full_search']['total'].to_i > 0
+      puts "#{'='*26} Matches (#{results['full_search']['total']}) #{'='*26}"
+      results['full_search']['members'].each do |member|
         members << member
       end
     end
 
-    tp members, :email, :id, :member_rating, :status, "VIP?" => {:display_method => :is_gmonkey}
+    tp members, :email, :id, :list_name, :member_rating, :status, "VIP?" => {:display_method => :is_gmonkey}
   end
 
   private
@@ -163,7 +179,7 @@ class ConsoleWriter
         as_formatted results, options
         exit_now!('')
       when :raw
-        puts results
+        as_raw results
         exit_now!('')
       when :awesome, :hash
         ap results

data/test/mc_test.rb

@@ -11,11 +11,11 @@ describe "MailChimp" do
   end
 
   it "should be able to ping MailChimp" do
-    @mailchimp.ping.must_equal "Everything's Chimpy!"
+    @mailchimp.helper_ping['msg'].must_equal "Everything's Chimpy!"
   end
 
   it "should pass to method_missing" do
-  	@mailchimp.lists_list.count.must_be :>, 0
+    @mailchimp.lists_list.count.must_be :>, 0
   end
 
   it "should see updated results" do
@@ -73,7 +73,7 @@ describe "MailChimpCached" do
     @mailchimp_cached.lists_subscribe(:id => @test_list_id, :email => {:email => email}, :double_optin => false)
     new_count = @mailchimp_cached.lists_members(:id => @test_list_id)["total"].to_i
     new_count.must_equal count
-    
+
     clear_cached_dir
 
     new_count = @mailchimp_cached.lists_members(:id => @test_list_id)["total"].to_i

data/test/test_helper.rb

@@ -2,10 +2,9 @@ def config
   config_file = ENV['HOME']+'/.mailchimp'
   raise "Need config file to pull API key from." unless File.exists?(config_file)
   config_hash = YAML.load(File.open(config_file))
-  config_hash[:test_list_id] = "ef4227fc80"
 
-  raise "Need API key for testing." unless config_hash.has_key? :apikey
-  raise "Need to define test list in test_helper.rb" unless config_hash.has_key? :test_list_id
+  raise "Need to set :test_api_key in config file" unless config_hash.has_key? :test_api_key
+  raise "Need to set :test_list_id in config file" unless config_hash.has_key? :test_list_id
 
   return config_hash
 end
@@ -20,5 +19,5 @@ def clear_cached_dir
 end
 
 def get_random_email_address
-  "test+#{rand(1000..9999)}@kaledavis.com"
+  "test+#{rand(1000..9999)}@gmail.com"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: mc
 version: !ruby/object:Gem::Version
-  version: 0.0.4
+  version: 0.0.5
 platform: ruby
 authors:
 - Kale Davis
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-10-02 00:00:00.000000000 Z
+date: 2013-11-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -145,6 +145,9 @@ files:
 - lib/mc/commands/export.rb
 - lib/mc/commands/gallery.rb
 - lib/mc/commands/helper.rb
+- lib/mc/commands/lists-group.rb
+- lib/mc/commands/lists-merge-var.rb
+- lib/mc/commands/lists-webhook.rb
 - lib/mc/commands/lists.rb
 - lib/mc/commands/reports.rb
 - lib/mc/commands/search.rb