brewery_db 0.2.2 → 0.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 9298ddaf41f0f4f466aa0be333e4d4cbbcc0e231
-  data.tar.gz: 6ac72bbc6c34bb82e6df2b0bc710180ba8f049cd
+  metadata.gz: c41d08cf80ce37ceecbd402e664ea0822d2fe19a
+  data.tar.gz: fd57ff883a8ad9ffb8cc2f51847bd6e5fc155c88
 SHA512:
-  metadata.gz: b0f49dab931d53362683a451a201403f5619c3f49b5d45d1bd9b9e5e01a2c774c40e245712846ab4e98ded354b1cd0017c78d94068aba1e707dd122b2a8dbb7b
-  data.tar.gz: 6a2de27e7f1578e3b07e39ec400772e598a46185f92f3fda6da0a01d0a0fb64144fec96bfcb44850ddb5330f811477fb80cdef2947d4a262da9049669249be83
+  metadata.gz: 507531603d79ced7a95b1f15dc1a8f6ce6423b3d975b71aae978151558171d3bc7a76b9ebdb66985476206f4ed893dbd82832ccb660cead06c9132ea84b9814a
+  data.tar.gz: 973b7b4c6fa87af1596b5a0601d34c94a15cef7d62cb8da7737168b042b7abdd551fbe0ba0ba47dc97a894a59585772411951ca7a10388f6eafda0afa5784865

data/.travis.yml

@@ -4,5 +4,6 @@ rvm:
   - 1.9.2
   - 1.9.3
   - 2.0.0
-  - jruby-19mode # JRuby 1.7.0
-  - rbx-19mode
+  - 2.1.0
+  - jruby-19mode
+  - rbx

data/CHANGELOG.md

@@ -1,13 +1,16 @@
 # Changelog
 
-## Unreleased
+## 0.2.3 (2014-02-21)
+
+  * Add support for `search/upc` endpoint. ([Matt Griffin][betamatt])
+  * Add support for request logging. ([Matt Griffin][betamatt])
 
 ## 0.2.2 (2013-08-05)
 
   * Add support for `fluidsizes`, `fluidsize/:id`, and `menu/beer-availability`
     endpoints. ([Steven Harman][stevenharman])
-  * Fix: Paginate `Hops`, `Fermentables`, and `Yeasts` ([Steven
-    Harman][stevenharman])
+  * Fix: Paginate `Hops`, `Fermentables`, and `Yeasts`
+    ([Steven Harman][stevenharman])
 
 ## 0.2.1 (2013-08-02)
 
@@ -16,14 +19,17 @@
 
 ## 0.2.0 (2013-06-26)
 
-  * Add support for `locations` and `location/:id` endpoints ([dbc-apprentice][dbc-apprentice])
-  * Add support for `subAttributeId` webhook parameter ([Steven Harman][stevenharman])
+  * Add support for `locations` and `location/:id` endpoints
+    ([dbc-apprentice][dbc-apprentice])
+  * Add support for `subAttributeId` webhook parameter
+    ([Steven Harman][stevenharman])
 
 ## 0.1.0 (2013-05-14)
 
   * Add support for handling webhook parameters ([Steven Harman][stevenharman])
   * Raise exceptions on unsuccessful responses ([Tyler Hunt][tylerhunt])
-  * Return the data directly on successful responses ([Steven Harman][stevenharman])
+  * Return the data directly on successful responses
+    ([Steven Harman][stevenharman])
   * Add support for `brewery/:id/beers` endpoint ([Steven Harman][stevenharman])
   * Require `faraday_middleware` ~> 0.8 ([Steven Harman][stevenharman])
 
@@ -32,6 +38,7 @@
   * Initial release ([Tyler Hunt][tylerhunt])
 
 [dbc-apprentice]: https://github.com/dbc-apprentice
+[betamatt]: http://github.com/betamatt
 [jtadeulopes]: https://github.com/jtadeulopes
 [stevenharman]: http://github.com/stevenharman
 [tylerhunt]: http://github.com/tylerhunt

data/README.md

@@ -21,11 +21,12 @@ Tested and known to work with the following Rubies:
 [jruby]: http://jruby.org/
 [rubinius]: http://rubini.us/
 
+
 ## Installation
 
-Add this line to your application's Gemfile:
+Add this line to your application’s `Gemfile`:
 
-``` ruby
+```ruby
 gem 'brewery_db'
 ```
 
@@ -40,25 +41,36 @@ Or install it yourself as:
 
 ## Configuration
 
-You must have a valid API key to use the BreweryDB API. If you don't yet have
+You must have a valid API key to use the BreweryDB API. If you don’t yet have
 one, you may [request one here][api-key].
 
 [api-key]: http://www.brewerydb.com/developers
 
 You can use the following method to configure your API key:
 
-``` ruby
+```ruby
 brewery_db = BreweryDB::Client.new do |config|
   config.api_key = API_KEY
 end
 ```
 
+### Logging
+
+Optionally, you can configure `BreweryDB` to use a logger for to help with
+request debugging.
+
+```ruby
+brewery_db = BreweryDB::Client.new do |config|
+  # ...
+  config.logger = Rails.logger
+end
+```
 
 ## Usage
 
 Once an API key has been set, resources can be called on the client instance.
 
-``` ruby
+```ruby
 brewery_db.beers.all(abv: '5.5')
 brewery_db.beers.find('vYlBZQ')
 
@@ -87,6 +99,7 @@ brewery_db.search.beers(q: 'IPA')
 brewery_db.search.breweries(q: 'IPA')
 brewery_db.search.guilds(q: 'IPA')
 brewery_db.search.events(q: 'IPA')
+brewery_db.search.upc(code: '030613000043')
 
 brewery_db.styles.all
 brewery_db.styles.find(1)
@@ -97,14 +110,13 @@ brewery_db.yeasts.all
 brewery_db.yeasts.find(1836)
 
 brewery_db.menu.beer_availability
-
 ```
 
 ### WebHooks
 
-The BreweryDB API also provides [WebHooks][webhooks] which can be use to:
+The BreweryDB API also provides [webhooks][], which can be used to:
 
-> keep your local data stores in sync with the main BreweryDB API.  Instead of
+> keep your local data stores in sync with the main BreweryDB API. Instead of
 > having to constantly query the API, webhooks will send you a message when
 > something changes.
 
@@ -119,25 +131,21 @@ webhook = BreweryDB::WebHook.new(webhook_params_hash)
 
 The `webhook_params_hash` should contain the `key`, `nonce`, `action`, etc.
 sent as the payload of the webhook. A `BreweryDB::WebHook` object can validate
-the posted data by SHA1 hashing your API key with the `nonce` value and
+the posted data by SHA-1 hashing your API key with the `nonce` value and
 comparing it to the `key` value (as per the [docs][webhooks]).
 
 ```ruby
-webhook.valid?(API_KEY) #=> true or false
+webhook.valid?(API_KEY) # => true or false
 ```
 
-#### Idiomatic wrapper over WebHook parameters
+#### Idiomatic Access to WebHook Parameters
 
-The `BreweryDB::WebHook` object also provides an idiomatic Ruby wrapper over
+The `BreweryDB::WebHook` object also provides an idiomatic Ruby interface to
 the parameters. For example, one of the parameters posted in a webhook is
-`attributeId`, which is the BreweryDB id for a brewery, beer, etc. This
-parameter is exposed by an instance of `BreweryDB::WebHook` via
-
-```ruby
-webhook.attribute_id #=> 'x6bRxw'
-```
+`attributeId`, which is the BreweryDB ID for a brewery, beer, etc. This
+parameter is exposed by an instance of `BreweryDB::WebHook` as `#attribute_id`.
 
-The full list of parameters available are:
+Here’s the full list of parameters:
 
 ```ruby
 webhook.action #=> 'insert'
@@ -152,6 +160,12 @@ webhook.timestamp #=> '1350573527'
 
 [webhooks]: http://www.brewerydb.com/developers/docs-webhooks
 
+
+### Examples
+
+Additional examples may be found in the `examples` directory.
+
+
 ## Contributing
 
 1. Fork it.
@@ -167,6 +181,8 @@ Thanks to the following people who have contributed patches or helpful
 suggestions:
 
   * [Steven Harman](https://github.com/stevenharman)
+  * [Jésus Lopes](https://github.com/jtadeulopes)
+  * [Matt Griffin](https://github.com/betamatt)
 
 
 ## Copyright

data/examples/kaminari.rb

@@ -0,0 +1,13 @@
+# Paginate beer search results using Kaminari.
+
+query = params[:query]
+page = params[:page] || 1
+per_page = BreweryDB::PaginatedCollection::BATCH_SIZE
+
+results = client.search.beers(q: query, p: page)
+count = results.count
+
+beers = Kaminari
+  .paginate_array(results.take(per_page), total_count: count)
+  .page(page)
+  .per(per_page)

data/examples/will_paginate.rb

@@ -0,0 +1,12 @@
+# Paginate beer search results using will_paginate.
+
+query = params[:query]
+page = params[:page] || 1
+per_page = BreweryDB::PaginatedCollection::BATCH_SIZE
+
+results = client.search.beers(q: query, p: page)
+count = results.count
+
+beers = WillPaginate::Collection.create(page, per_page, count) do |pager|
+  pager.replace results.take(per_page)
+end

data/lib/brewery_db.rb

@@ -11,6 +11,7 @@ module BreweryDB
   autoload :Collection, 'brewery_db/collection'
   autoload :Config, 'brewery_db/config'
   autoload :Mash, 'brewery_db/mash'
+  autoload :PaginatedCollection, 'brewery_db/paginated_collection'
   autoload :Request, 'brewery_db/request'
   autoload :Resource, 'brewery_db/resource'
   autoload :Response, 'brewery_db/response'

data/lib/brewery_db/collection.rb

@@ -2,8 +2,6 @@ module BreweryDB
   class Collection
     include Enumerable
 
-    BATCH_SIZE = 50
-
     attr_reader :size
     alias length size
 
@@ -11,32 +9,17 @@ module BreweryDB
       self.response = response
     end
 
-    def count(*args, &block)
-      # The Ruby documentation is wrong, and Enumerable#count no longer calls
-      # #size, so let's make sure it's used here when no arguments are given.
-      if args.empty? && !block_given?
-        size
-      else
-        super
-      end
-    end
-
     def each
       return to_enum unless block_given?
-
-      while @collection.any?
-        @collection.each { |element| yield(element) }
-        break if @collection.size < BATCH_SIZE
-        self.response = @response.next_page
-      end
+      @collection.each { |element| yield(element) }
     end
 
+  private
+
     def response=(response)
       @response = response
       @collection = Array(response.data) || []
-      @size = response.count || 0
-      @page_count = response.page_count
+      @size = @collection.length
     end
-    private :response=
   end
 end

data/lib/brewery_db/config.rb

@@ -9,6 +9,7 @@ module BreweryDB
     attr_accessor :adapter
     attr_accessor :api_key
     attr_accessor :base_uri
+    attr_accessor :logger
     attr_accessor :timeout
     attr_accessor :user_agent
 

data/lib/brewery_db/mash.rb

@@ -2,17 +2,17 @@ require 'hashie'
 
 module BreweryDB
   class Mash < Hashie::Mash
+  protected
+
     def convert_key(key)
       key = key.to_s.dup
       key.gsub!(/([A-Z]+)([A-Z][a-z])/, '\1_\2')
       key.gsub!(/([a-z\d])([A-Z])/, '\1_\2')
       key.tr('-', '_').downcase
     end
-    protected :convert_key
 
     def convert_value(value, duping=false)
       value.is_a?(String) ? super.gsub("\r\n", "\n") : super
     end
-    protected :convert_value
   end
 end

data/lib/brewery_db/middleware/error_handler.rb

@@ -11,18 +11,18 @@ module BreweryDB
         end
       end
 
+    private
+
       def rate_limit_exceeded_or_unauthorized(headers)
         rate_limit = headers.fetch('x-ratelimit-remaining') { :rate_limit_unknown }
 
         rate_limit == '0' ? RateLimitExceeded : Unauthorized
       end
-      private :rate_limit_exceeded_or_unauthorized
 
       def with(error_class, env)
         message = "Status => #{env[:status]}. Error message => #{env[:body].error_message}"
         error_class.new(message)
       end
-      private :with
     end
   end
 end

data/lib/brewery_db/paginated_collection.rb

@@ -0,0 +1,34 @@
+module BreweryDB
+  class PaginatedCollection < Collection
+    include Enumerable
+
+    BATCH_SIZE = 50
+
+    def count(*args, &block)
+      # The Ruby documentation is wrong, and Enumerable#count no longer calls
+      # #size, so let's make sure it's used here when no arguments are given.
+      if args.empty? && !block_given?
+        size
+      else
+        super
+      end
+    end
+
+    def each
+      return to_enum unless block_given?
+
+      while @collection.any?
+        @collection.each { |element| yield(element) }
+        break if @collection.size < BATCH_SIZE
+        self.response = @response.next_page
+      end
+    end
+
+  private
+
+    def response=(response)
+      super
+      @size = response.count || 0
+    end
+  end
+end

data/lib/brewery_db/request.rb

@@ -14,14 +14,14 @@ module BreweryDB
       self.class.new(@connection, @path, @params.merge(p: page_number + 1))
     end
 
+  private
+
     def response_body
       @connection.get(@path, @params).body
     end
-    private :response_body
 
     def page_number
       @params[:p] || 1
     end
-    private :page_number
   end
 end

data/lib/brewery_db/resource.rb

@@ -7,10 +7,11 @@ module BreweryDB
       @config = config
     end
 
+  private
+
     def get(path, params={})
       Request.new(connection, path, params).response
     end
-    private :get
 
     def connection
       Faraday.new(request: { timeout: @config.timeout }) do |builder|
@@ -18,6 +19,7 @@ module BreweryDB
         builder.headers[:user_agent] = @config.user_agent
         builder.params[:key] = @config.api_key
 
+        builder.response(:logger, @config.logger) if @config.logger
         builder.use(Middleware::ErrorHandler)
         builder.response(:mashify, mash_class: Mash)
         builder.response(:json, content_type: /\bjson$/)
@@ -25,6 +27,5 @@ module BreweryDB
         builder.adapter(@config.adapter)
       end
     end
-    private :connection
   end
 end

data/lib/brewery_db/resources/beers.rb

@@ -2,7 +2,7 @@ module BreweryDB
   module Resources
     class Beers < Resource
       def all(params={})
-        get('beers', params).collection
+        get('beers', params).paginated_collection
       end
 
       def find(id, params={})

data/lib/brewery_db/resources/breweries.rb

@@ -2,7 +2,7 @@ module BreweryDB
   module Resources
     class Breweries < Resource
       def all(params={})
-        get('breweries', params).collection
+        get('breweries', params).paginated_collection
       end
 
       def find(id, params={})

data/lib/brewery_db/resources/brewery.rb

@@ -9,7 +9,7 @@ module BreweryDB
       end
 
       def beers(params={})
-        get("brewery/#{id}/beers", params).data
+        get("brewery/#{id}/beers", params).collection
       end
     end
   end

data/lib/brewery_db/resources/categories.rb

@@ -2,7 +2,7 @@ module BreweryDB
   module Resources
     class Categories < Resource
       def all(params={})
-        get('categories', params).data
+        get('categories', params).collection
       end
 
       def find(id, params={})

data/lib/brewery_db/resources/fermentables.rb

@@ -2,7 +2,7 @@ module BreweryDB
   module Resources
     class Fermentables < Resource
       def all(params={})
-        get('fermentables', params).collection
+        get('fermentables', params).paginated_collection
       end
 
       def find(id, params={})

data/lib/brewery_db/resources/fluid_size.rb

@@ -2,7 +2,7 @@ module BreweryDB
   module Resources
     class FluidSize < Resource
       def all(params={})
-        get('fluidsizes', params).data
+        get('fluidsizes', params).collection
       end
 
       def find(id, params={})

data/lib/brewery_db/resources/glassware.rb

@@ -2,7 +2,7 @@ module BreweryDB
   module Resources
     class Glassware < Resource
       def all(params={})
-        get('glassware', params).data
+        get('glassware', params).collection
       end
 
       def find(id, params={})

data/lib/brewery_db/resources/hops.rb

@@ -2,7 +2,7 @@ module BreweryDB
   module Resources
     class Hops < Resource
       def all(params={})
-        get('hops', params).collection
+        get('hops', params).paginated_collection
       end
 
       def find(id, params={})

data/lib/brewery_db/resources/locations.rb

@@ -2,7 +2,7 @@ module BreweryDB
   module Resources
     class Locations < Resource
       def all(params={})
-        get('locations', params).collection
+        get('locations', params).paginated_collection
       end
 
       def find(id, params={})

data/lib/brewery_db/resources/menu.rb

@@ -2,14 +2,14 @@ module BreweryDB
   module Resources
     class Menu < Resource
       def beer_availability(params={})
-        get_menu('beer-availability', params).data
+        get_menu('beer-availability', params).collection
       end
 
+    private
+
       def get_menu(name, params)
         get("menu/#{name}", params)
       end
-      private :get_menu
     end
   end
 end
-

data/lib/brewery_db/resources/search.rb

@@ -2,7 +2,7 @@ module BreweryDB
   module Resources
     class Search < Resource
       def all(params={})
-        get('search', params).collection
+        get('search', params).paginated_collection
       end
 
       def beers(params={})
@@ -20,6 +20,10 @@ module BreweryDB
       def events(params={})
         all(params.merge(type: 'event'))
       end
+
+      def upc(params={})
+        get('search/upc', params).paginated_collection
+      end
     end
   end
 end

data/lib/brewery_db/resources/styles.rb

@@ -2,7 +2,7 @@ module BreweryDB
   module Resources
     class Styles < Resource
       def all(params={})
-        get('styles', params).data
+        get('styles', params).collection
       end
 
       def find(id, params={})

data/lib/brewery_db/resources/yeasts.rb

@@ -2,7 +2,7 @@ module BreweryDB
   module Resources
     class Yeasts < Resource
       def all(params={})
-        get('yeasts', params).collection
+        get('yeasts', params).paginated_collection
       end
 
       def find(id, params={})

data/lib/brewery_db/response.rb

@@ -13,6 +13,10 @@ module BreweryDB
       Collection.new(self)
     end
 
+    def paginated_collection
+      PaginatedCollection.new(self)
+    end
+
     def next_page
       @request.next_page.response
     end

data/lib/brewery_db/version.rb

@@ -1,3 +1,3 @@
 module BreweryDB
-  VERSION = '0.2.2'
+  VERSION = '0.2.3'
 end

data/lib/brewery_db/web_hook.rb

@@ -26,9 +26,10 @@ module BreweryDB
       hash(api_key) == key
     end
 
+  private
+
     def hash(api_key)
       Digest::SHA1.hexdigest("#{api_key}#{nonce}")
     end
-    private :hash
   end
 end

data/spec/brewery_db/resource_spec.rb

@@ -11,7 +11,7 @@ describe BreweryDB::Resource, :resource do
         end
 
         def list
-          get('breweries', established: 2006).collection
+          get('breweries', established: 2006).paginated_collection
         end
 
         def not_found

data/spec/brewery_db/resources/brewery_spec.rb

@@ -4,7 +4,7 @@ describe BreweryDB::Resources::Brewery do
   context '#beers' do
     let(:config) { double }
     let(:id) { 'KlSsWY' }
-    let(:response) { double(data: :some_beers) }
+    let(:response) { double(collection: :some_beers) }
 
     subject(:brewery) { described_class.new(config, id: id) }
 

data/spec/brewery_db/resources/search_spec.rb

@@ -27,4 +27,16 @@ describe BreweryDB::Resources::Search, :resource do
       end
     end
   end
+
+  context "#upc", :vcr do
+    subject(:search) { described_class.new(config) }
+
+    context "for an existing upc code" do
+      let(:upc) { '030613000043' }
+
+      it "returns a collection with the matched beer" do
+        expect(search.upc(code: upc).map(&:id)).to eq(['LVjHK1'])
+      end
+    end
+  end
 end

data/spec/fixtures/BreweryDB_Resources_Search/_upc/for_an_existing_upc_code/returns_a_collection_with_the_matched_beer.yml

@@ -0,0 +1,66 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: http://api.brewerydb.com/v2/search/upc?key=API_KEY&code=030613000043
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      User-Agent:
+      - BreweryDB Ruby Gem 0.2.2
+  response:
+    status:
+      code: 200
+      message: 
+    headers:
+      date:
+      - Fri, 04 Oct 2013 00:33:46 GMT
+      server:
+      - Apache/2.2.25 (Amazon)
+      x-powered-by:
+      - PHP/5.3.27
+      x-ratelimit-limit:
+      - Unlimited
+      x-ratelimit-remaining:
+      - Unlimited
+      vary:
+      - Accept-Encoding
+      content-length:
+      - '1342'
+      connection:
+      - close
+      content-type:
+      - application/json
+    body:
+      encoding: UTF-8
+      string: '{"currentPage":1,"numberOfPages":1,"totalResults":1,"data":[{"id":"LVjHK1","name":"Brooklyn
+        Brown Ale","description":"This is the award-winning original American brown
+        ale, first brewed as a holiday specialty, and now one of our most popular
+        beers year-round. Northern English brown ales tend to be strong and dry, while
+        southern English brown ales are milder and sweeter. Brooklyn Brown Ale combines
+        the best of those classic styles and then adds an American accent in the form
+        of a firm hop character and roasty palate. A blend of six malts, some of them
+        roasted, give this beer its deep russet-brown color and complex malt flavor,
+        fruity, smooth and rich, with a caramel, chocolate and coffee background.
+        Generous late hopping brings forward a nice hop aroma to complete the picture.
+        Brooklyn Brown Ale is full-flavored but retains a smoothness and easy drinkability
+        that has made it one of the most popular dark beers in the Northeast.","abv":"5.6","ibu":"30","glasswareId":5,"availableId":1,"styleId":37,"isOrganic":"N","labels":{"icon":"https:\/\/s3.amazonaws.com\/brewerydbapi\/beer\/LVjHK1\/upload_yxlhuf-icon.png","medium":"https:\/\/s3.amazonaws.com\/brewerydbapi\/beer\/LVjHK1\/upload_yxlhuf-medium.png","large":"https:\/\/s3.amazonaws.com\/brewerydbapi\/beer\/LVjHK1\/upload_yxlhuf-large.png"},"status":"verified","statusDisplay":"Verified","foodPairings":"Brooklyn
+        Brown Ale is particularly good with steaks, burgers, stews and barbecue, where
+        it can put its caramel flavors to work with the caramelized flavors in the
+        meat. It\u2019s also excellent with venison, ham and roasted pork, which engage
+        the depth of malt character. Well-aged cheddar and sheep\u2019s milk cheese
+        will pair up nicely.","originalGravity":"1.063","createDate":"2012-01-03 02:42:54","updateDate":"2013-08-13
+        15:55:57","glass":{"id":5,"name":"Pint","createDate":"2012-01-03 02:41:33"},"available":{"id":1,"name":"Year
+        Round","description":"Available year round as a staple beer."},"style":{"id":37,"categoryId":3,"category":{"id":3,"name":"North
+        American Origin Ales","createDate":"2012-03-21 20:06:45"},"name":"American-Style
+        Brown Ale","description":"American brown ales range from deep copper to brown
+        in color. Roasted malt caramel-like and chocolate-like characters should be
+        of medium intensity in both flavor and aroma. American brown ales have evident
+        low to medium hop flavor and aroma, medium to high hop bitterness, and a medium
+        body. Estery and fruity-ester characters should be subdued. Diacetyl should
+        not be perceived. Chill haze is allowable at cold temperatures.","ibuMin":"25","ibuMax":"45","abvMin":"4","abvMax":"6.4","srmMin":"15","srmMax":"26","ogMin":"1.04","fgMin":"1.01","fgMax":"1.018","createDate":"2012-03-21
+        20:06:46"},"fluidSize":{"id":9,"volume":"case","createDate":"2012-01-03 02:41:33"}}],"status":"success"}'
+    http_version: 
+  recorded_at: Fri, 04 Oct 2013 00:33:57 GMT
+recorded_with: VCR 2.6.0

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: brewery_db
 version: !ruby/object:Gem::Version
-  version: 0.2.2
+  version: 0.2.3
 platform: ruby
 authors:
 - Tyler Hunt
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-08-05 00:00:00.000000000 Z
+date: 2014-02-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -116,12 +116,15 @@ files:
 - README.md
 - Rakefile
 - brewery_db.gemspec
+- examples/kaminari.rb
+- examples/will_paginate.rb
 - lib/brewery_db.rb
 - lib/brewery_db/client.rb
 - lib/brewery_db/collection.rb
 - lib/brewery_db/config.rb
 - lib/brewery_db/mash.rb
 - lib/brewery_db/middleware/error_handler.rb
+- lib/brewery_db/paginated_collection.rb
 - lib/brewery_db/request.rb
 - lib/brewery_db/resource.rb
 - lib/brewery_db/resources/beers.rb
@@ -182,6 +185,7 @@ files:
 - spec/fixtures/BreweryDB_Resources_Locations/_find/fetches_only_the_location_asked_for.yml
 - spec/fixtures/BreweryDB_Resources_Menu/_beer_availability/fetches_all_of_the_beer_availabilities_at_once.yml
 - spec/fixtures/BreweryDB_Resources_Search/_all/fetches_all_of_the_search_results_at_once.yml
+- spec/fixtures/BreweryDB_Resources_Search/_upc/for_an_existing_upc_code/returns_a_collection_with_the_matched_beer.yml
 - spec/fixtures/BreweryDB_Resources_Styles/_all/fetches_all_of_the_styles_at_once.yml
 - spec/fixtures/BreweryDB_Resources_Styles/_find/fetches_only_the_style_asked_for.yml
 - spec/fixtures/BreweryDB_Resources_Yeasts/_all/fetches_all_of_the_yeasts_at_once.yml
@@ -209,7 +213,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.0.5
+rubygems_version: 2.0.14
 signing_key: 
 specification_version: 4
 summary: A Ruby library for using the BreweryDB API.
@@ -256,6 +260,7 @@ test_files:
 - spec/fixtures/BreweryDB_Resources_Locations/_find/fetches_only_the_location_asked_for.yml
 - spec/fixtures/BreweryDB_Resources_Menu/_beer_availability/fetches_all_of_the_beer_availabilities_at_once.yml
 - spec/fixtures/BreweryDB_Resources_Search/_all/fetches_all_of_the_search_results_at_once.yml
+- spec/fixtures/BreweryDB_Resources_Search/_upc/for_an_existing_upc_code/returns_a_collection_with_the_matched_beer.yml
 - spec/fixtures/BreweryDB_Resources_Styles/_all/fetches_all_of_the_styles_at_once.yml
 - spec/fixtures/BreweryDB_Resources_Styles/_find/fetches_only_the_style_asked_for.yml
 - spec/fixtures/BreweryDB_Resources_Yeasts/_all/fetches_all_of_the_yeasts_at_once.yml