gibbon 2.2.1 → 2.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: a4ade9615ee9a69d1ce2d1d560ce14ec92430dd2
-  data.tar.gz: a82c3dea034eead23703265b805607a0c311e14f
+  metadata.gz: 610778f055df0af1212f58dbdafd6e9979c40cc2
+  data.tar.gz: 3b4f5b4760b3509c381e3c346170673c9bdc4bf3
 SHA512:
-  metadata.gz: 6dd1f3f444a7e6e0852f70705676cff464e67c3455a3be06c16bbd6597e7c33678e392c47184821b8c97c77c3b4bbe834620dbf2430c56da3e7176d2e0fa7d25
-  data.tar.gz: 99e997b80b822cfa08d93fa4004ccd2395aa0a699ba9e37bfb0360b891194e5e861b6f32dfe1e0f5ebcb5e42f0a8d96eab0ee76a9ff1bcbbfd47670f4affe431
+  metadata.gz: 0d979629f9140b4359b1bcd08fb029a4760828db9fd759579e99de13a8d60bfc0ba1de87244accce091c36b583b936fdd7ba2741e7bf2990f9b73992153d35d8
+  data.tar.gz: 0a6cd276fcb3f7db9cf879444b96cb5de84b4d5f9b0d40e089e7ca14029b0188eb85e6fce2b1bf8c78f57666805c47d113b96fa4844478c34b1e8b60ba9d64e0

data/CHANGELOG.md

@@ -1,5 +1,8 @@
 ## [Unreleased][unreleased]
 
+## [2.2.2] - 2016-03-15
+- Update dependencies
+
 ## [2.2.1] - 2016-01-01
 - Improve MailChimpError logging
 

data/Gemfile

@@ -1,7 +1,7 @@
 source "https://rubygems.org"
 
 platforms :rbx do
-  gem 'rubysl', '~> 2.1.0'
+  gem 'rubysl', '~> 2.2.0'
   gem 'rubinius-developer_tools'
 end
 

data/README.markdown

@@ -99,6 +99,18 @@ Get all subscribers for a list:
 gibbon.lists(list_id).members.retrieve
 ```
 
+By default the Mailchimp API returns 10 results. To set the count to 50:
+
+```ruby
+gibbon.lists(list_id).members.retrieve(params: {"count": "50"})
+```
+
+And to retrieve the next 50 members:
+
+```ruby
+gibbon.lists(list_id).members.retrieve(params: {"count": "50", "offset: "50"})
+```
+
 Subscribe a member to a list:
 
 ```ruby
@@ -114,7 +126,21 @@ gibbon.lists(list_id).members(lower_case_md5_hashed_email_address).upsert(body:
 You can also unsubscribe a member from a list:
 
 ```ruby
-gibbon.lists(list_id).members(member_id).update(body: { status: "unsubscribed" })
+gibbon.lists(list_id).members(lower_case_md5_hashed_email_address).update(body: { status: "unsubscribed" })
+```
+
+### Fields
+
+Only retrieve ids and names for fetched lists:
+
+```ruby
+gibbon.lists.retrieve(params: {"fields": "lists.id,lists.name"})
+```
+
+Only retrieve emails for fetched lists:
+
+```ruby
+gibbon.lists(list_id).members.retrieve(params: {"fields": "members.email_address"})
 ```
 
 ### Campaigns
@@ -235,8 +261,16 @@ That response gives the interest data, including the ID for the interests themse
 
 Gibbon raises an error when the API returns an error.
 
-Gibbon::MailChimpError has the following attributes: `title`, `detail`, `body`, `raw_body`, `status_code`. Some or all of these may not be
-available depending on the nature of the error.
+`Gibbon::MailChimpError` has the following attributes: `title`, `detail`, `body`, `raw_body`, `status_code`. Some or all of these may not be
+available depending on the nature of the error. For example:
+
+```ruby
+begin
+  gibbon.lists(list_id)members.create(body: body)
+rescue Gibbon::MailChimpError => e
+  puts "Houston, we have a problem: #{e.message} - #{e.raw_body}"
+end
+```
 
 ### Other
 
@@ -270,7 +304,7 @@ Gibbon 1.x:
 ```ruby
 gibbon = Gibbon::API.new("your_api_key")
 ```
-    
+
 Gibbon 2.x:
 
 ```ruby
@@ -286,7 +320,7 @@ Gibbon 1.x:
 ```ruby
 gibbon.lists.list
 ```
-    
+
 Gibbon 2.x:
 
 ```ruby
@@ -300,7 +334,7 @@ Gibbon 1.x:
 ```ruby
 gibbon.lists.members({:id => list_id})
 ```
-    
+
 Gibbon 2.x:
 
 ```ruby
@@ -314,7 +348,7 @@ Gibbon 1.x:
 ```ruby
 gibbon.lists.subscribe({:id => list_id, :email => {:email => "foo@bar.com"}, :merge_vars => {:FNAME => "Bob", :LNAME => "Smith"}})
 ```
-    
+
 Gibbon 2.x:
 
 ```ruby

data/lib/gibbon/version.rb

@@ -1,3 +1,3 @@
 module Gibbon
-  VERSION = "2.2.1"
+  VERSION = "2.2.2"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: gibbon
 version: !ruby/object:Gem::Version
-  version: 2.2.1
+  version: 2.2.2
 platform: ruby
 authors:
 - Amro Mousa
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-01-01 00:00:00.000000000 Z
+date: 2016-03-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday