tankard 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 15d6c67b39b0fbce1ddce69adcdbca40366f1281
+  data.tar.gz: e7db9eff7e9a74a9e4794bb509f1a7d73d4980a7
+SHA512:
+  metadata.gz: 48d66cb484f2726da1caa59f15905f46a1494742793d16a00083c1fb5ae21472f776d0997029f7c77362183eca5e4db79b32463466c9df456fdbd65387efdd2b
+  data.tar.gz: f06bb814da4bb553a938dd77584cdbd0a41fa8bce2ef4aca962bf5e5b615a280be51ad7d78175ba78c1db074511fc0a30cea8b3d13ffc581d531986cfe183c47

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/.rspec

@@ -0,0 +1 @@
+--color

data/.travis.yml

@@ -0,0 +1,33 @@
+language: ruby
+rvm:
+  - jruby-19mode
+  - rbx-19mode
+  - 1.9.3
+  - 2.0.0
+  - ruby-head
+  - jruby-head
+jdk:
+  - openjdk6
+  - openjdk7
+  - oraclejdk7
+matrix:
+  allow_failures:
+    - rvm: ruby-head
+    - rvm: jruby-head
+  exclude:
+    - rvm: 1.9.3
+      jdk: openjdk7
+    - rvm: 1.9.3
+      jdk: oraclejdk7
+    - rvm: 2.0.0
+      jdk: openjdk7
+    - rvm: 2.0.0
+      jdk: oraclejdk7
+    - rvm: ruby-head
+      jdk: openjdk7
+    - rvm: ruby-head
+      jdk: oraclejdk7
+    - rvm: rbx-19mode
+      jdk: openjdk7
+    - rvm: rbx-19mode
+      jdk: oraclejdk7

data/CHANGELOG.md

@@ -0,0 +1,3 @@
+## v0.0.1
+* Support for querying a beer
+* Support for querying a list of beers

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in tankard.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Matthew Shafer
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,55 @@
+# Tankard
+[![Build Status](https://travis-ci.org/matthewshafer/tankard.png?branch=master)](https://travis-ci.org/matthewshafer/tankard)
+[![Dependency Status](https://gemnasium.com/matthewshafer/tankard.png)](https://gemnasium.com/matthewshafer/tankard)
+[![Code Climate](https://codeclimate.com/github/matthewshafer/tankard.png)](https://codeclimate.com/github/matthewshafer/tankard)
+[![Coverage Status](https://coveralls.io/repos/matthewshafer/tankard/badge.png?branch=master)](https://coveralls.io/r/matthewshafer/tankard)
+
+Allows easy quering of the BreweryDB Api
+
+## About
+
+I decided to make Tankard for a personal project and then figured why not put it on github as I am working on it.
+Tankard is very immature at the moment.  I plan on adding support for all of the get routes to the BreweryDB Api.
+I've also been pretty interested in Jruby as of late and wanted to make Tankard thread safe.
+
+## Installation
+
+Soon...
+
+## Documentation
+
+Soon...
+
+## Usage
+
+If you happen to be using Rails you can do the configuration in an initializer, something like:
+
+```ruby
+require 'tankard'
+
+Tankard.configure do |config|
+  config.api_key = "YOUR_API_KEY"
+end
+```
+
+After being configured this is a sample of ways to use Tankard:
+
+### Beer
+
+```ruby
+Tankard.beer.id("some_id").breweries.each { |x| p x}
+
+beer = Tankard.beer.find(["first_id", "second_id"])
+```
+
+## Contributing
+
+### Issues
+
+Issues can be reported right here on the git repo.
+Everyone is encouraged to write an issue if they encounter a bug or have a feature request.
+
+### Pull Requests
+
+I will be accepting pull requests once I get most of the endpoints implemented.
+Check back soon for more details.

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec

data/lib/tankard/api/beer.rb

@@ -0,0 +1,88 @@
+require 'hashie'
+require 'tankard/api/request/get'
+
+module Tankard
+  module Api
+    class Beer
+      include ::Enumerable
+      include Tankard::Api::Request::Get
+
+      def initialize(request, options={})
+        @request = request
+        @options = Hashie::Mash.new(options)
+      end
+
+      def each(&block)
+        find_on_single_page(block)
+      end
+
+      def find(beer_id, options={})
+        @options.merge!(options)
+
+        if beer_id.is_a?(Array)
+          beer_id.map { |beer| request_data_with_nil_on_http_error(@request, "beer/#{beer}", @options) }.compact
+        else
+          request_data_with_nil_on_http_error(@request, "beer/#{beer_id}", @options)
+        end
+      end
+
+      def id(beer_id)
+        @options.id = beer_id
+        self
+      end
+
+      def breweries
+        @options.endpoint = "breweries"
+        self
+      end
+
+      def events
+        @options.endpoint = "events"
+        self
+      end
+
+      def ingredients
+        @options.endpoint = "ingredients"
+        self
+      end
+
+      def social_accounts
+        @options.endpoint = "socialaccounts"
+        self
+      end
+
+      def variations
+        @options.endpoint = "variations"
+        self
+      end
+
+      private
+
+        def request_data_from_options
+          endpoint = "beer/#{raise_if_no_id_in_options}"
+
+          if @options.endpoint?
+            endpoint += "/#{@options.delete(:endpoint)}"
+          end
+
+          request_data(@request, endpoint, @options)
+        end
+
+        def raise_if_no_id_in_options
+          raise Tankard::Error::NoBeerId unless @options.id?
+          @options.delete(:id)
+        end
+
+        def find_on_single_page(block)
+          data = request_data_from_options
+          raise Tankard::Error::InvalidResponse unless data
+
+          if data.is_a?(Hash)
+            block.call(data)
+          else
+            data.each { |beer| block.call(beer) }
+          end
+        end
+    end
+  end
+end

data/lib/tankard/api/beers.rb

@@ -0,0 +1,65 @@
+require 'hashie'
+require 'tankard/api/request/get'
+
+module Tankard
+  module Api
+    class Beers
+      include ::Enumerable
+      include Tankard::Api::Request::Get
+
+      def initialize(request, options={})
+        @request = request
+        @options = Hashie::Mash.new(options)
+      end
+
+      def each(&block)
+        if options_have_page_set
+          find_on_single_page(block)
+        else
+          find_on_all_pages(block)
+        end
+      end
+
+      def name(beer_name)
+        @options[:name] = beer_name
+        self
+      end
+
+      def page(number)
+        @options[:p] = number
+        self
+      end
+
+      private
+
+        def options_have_page_set
+          @options.has_key?(:p)
+        end
+
+        def find_on_all_pages(block)
+          page = 0
+          options = @options.clone
+          begin
+            page += 1
+            options[:p] = page
+            response = get_request(@request, "beers", options)
+            total_pages = response["numberOfPages"].to_i
+            data = response["data"]
+            raise Tankard::Error::InvalidResponse unless data
+            data.each { |beer| block.call(beer) }
+          end while page < total_pages
+        end
+
+        def find_on_single_page(block)
+          data = request_data(@request, "beers", @options)
+          raise Tankard::Error::InvalidResponse unless data
+          
+          if data.is_a?(Hash)
+            block.call(data)
+          else
+            data.each { |beer| block.call(beer) }
+          end
+        end
+    end
+  end
+end

data/lib/tankard/api/request/get.rb

@@ -0,0 +1,27 @@
+module Tankard
+  module Api
+    module Request
+      module Get
+
+        private
+
+          def request_data_with_nil_on_http_error(request_object, uri, options)
+            begin
+              request_data(request_object, uri, options)
+            rescue Tankard::Error::HttpError
+              nil
+            end
+          end
+
+          # break up the request methods into smaller pieces
+          def request_data(request_object, uri, options)
+            get_request(request_object, uri, options)["data"]
+          end
+
+          def get_request(request_object, uri, options)
+            request_object.get(uri, options)
+          end
+      end
+    end
+  end
+end

data/lib/tankard/client.rb

@@ -0,0 +1,24 @@
+require 'tankard/request'
+require 'tankard/api/beer'
+require 'tankard/api/beers'
+
+module Tankard
+  class Client
+
+    def initialize(options={})
+      Tankard::Configuration::KEYS.each do |key|
+        instance_variable_set(:"@#{key}", options[key])
+      end
+
+      @tankard_request = Tankard::Request.new(@api_key)
+    end
+
+    def beer(options={})
+      Tankard::Api::Beer.new(@tankard_request, options)
+    end
+
+    def beers(options={})
+      Tankard::Api::Beers.new(@tankard_request, options)
+    end
+  end
+end

data/lib/tankard/configuration.rb

@@ -0,0 +1,34 @@
+module Tankard
+  module Configuration
+    attr_writer :api_key
+
+    KEYS = [:api_key]
+    BREWERYDB_URL = "http://api.brewerydb.com/v2/"
+
+    def configure
+      yield self
+      validate_api_key!
+      self
+    end
+
+    def reset!
+      Tankard::Configuration::KEYS.each do |key|
+        instance_variable_set(:"@{key}", nil)
+      end
+    end
+
+    private
+
+      def credentials
+        {
+          api_key: @api_key
+        }
+      end
+
+      def validate_api_key!
+        unless @api_key.is_a?(String)
+          raise Tankard::Error::ConfigurationError, "api_key is not a string"
+        end
+      end
+  end
+end

data/lib/tankard/error.rb

@@ -0,0 +1,10 @@
+module Tankard
+  module Error
+    ConfigurationError = Class.new(::StandardError)
+    NoBeerId = Class.new(::StandardError)
+    HttpError = Class.new(::StandardError)
+    LoadError = Class.new(::StandardError)
+    InvalidResponse = Class.new(::StandardError)
+    ApiKeyUnauthorized = Class.new(::StandardError)
+  end
+end

data/lib/tankard/request.rb

@@ -0,0 +1,45 @@
+require 'multi_json'
+require 'httpclient'
+require 'tankard/error'
+
+module Tankard
+  class Request
+
+    def initialize(api_key)
+      @http = HTTPClient.new
+      @api_key = api_key
+    end
+
+    def get(route, params={})
+      params[:key] = @api_key
+      request = @http.get(build_request_url(route), params)
+      raise_if_status_not_ok(request.status)
+      load_json(request.body)
+    end
+
+    private
+
+      def raise_if_status_not_ok(status)
+        case status
+        when 200
+          true
+        when 401
+          raise Tankard::Error::ApiKeyUnauthorized
+        else
+          raise Tankard::Error::HttpError
+        end
+      end
+
+      def build_request_url(route)
+        Tankard::Configuration::BREWERYDB_URL + route
+      end
+
+      def load_json(json_data)
+        begin
+          MultiJson.load(json_data)
+        rescue MultiJson::LoadError
+          raise Tankard::Error::LoadError
+        end
+      end
+  end
+end

data/lib/tankard/version.rb

@@ -0,0 +1,3 @@
+module Tankard
+  VERSION = "0.0.1"
+end

data/lib/tankard.rb

@@ -0,0 +1,29 @@
+require "tankard/version"
+require "tankard/configuration"
+require "tankard/error"
+require "tankard/client"
+require "atomic"
+
+module Tankard
+  @client = ::Atomic.new
+
+  class << self
+    include Configuration
+
+    def client
+      @client.compare_and_swap(nil, Tankard::Client.new(credentials)) unless @client.value
+      @client.value
+    end
+
+    def respond_to?(method)
+      return client.respond_to?(method)
+    end
+
+    private
+
+      def method_missing(method_name, *args, &block)
+        return super unless client.respond_to?(method_name)
+        client.send(method_name, *args, &block)
+      end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,20 @@
+require 'simplecov'
+require 'coveralls'
+
+SimpleCov.formatter = SimpleCov::Formatter::MultiFormatter[
+  SimpleCov::Formatter::HTMLFormatter,
+  Coveralls::SimpleCov::Formatter
+]
+SimpleCov.start do
+  add_filter '/spec/'
+end
+
+require 'tankard'
+require 'rspec'
+require 'webmock/rspec'
+
+WebMock.disable_net_connect!(allow: 'coveralls.io')
+
+def stub_get(path)
+  stub_request(:get, "http://api.brewerydb.com/v2/" + path)
+end

data/spec/tankard/api/beer_spec.rb

@@ -0,0 +1,184 @@
+require 'spec_helper'
+
+describe Tankard::Api::Beer do
+
+  let(:beer) { Tankard::Api::Beer.new(@request) }
+
+  before do
+    @request = mock("request")
+  end
+
+  describe "#find" do
+
+    before do
+      @valid_beers = ["valid1", "valid2"]
+      @invalid_beers = ["invalid1", "invalid2"]
+      @request.stub(:get).with("beer/valid1", {}).and_return({ "data" => "valid1_found"})
+      @request.stub(:get).with("beer/valid2", {}).and_return({ "data" => "valid2_found"})
+      @request.stub(:get).with("beer/invalid1", {}).and_raise(Tankard::Error::HttpError)
+      @request.stub(:get).with("beer/invalid2", {}).and_raise(Tankard::Error::HttpError)
+    end
+
+    context "when looking up a valid beer" do
+
+      it "returns data on that specific beer" do
+        expect(beer.find(@valid_beers.first)).to eql("valid1_found")
+      end
+    end
+
+    context "when looking up an invalid beer" do
+
+      it "returns nil when not found" do
+        expect(beer.find(@invalid_beers.first)).to eql(nil)
+      end
+    end
+
+    context "when looking up multiple valid beers" do
+
+      it "returns an array of data with each beer" do
+        expect(beer.find(@valid_beers)).to eql(["valid1_found", "valid2_found"])
+      end
+    end
+
+    context "when looking up multiple beers and one is invalid" do
+
+      it "returns an array with only the valid beers" do
+        beer_request = @valid_beers + @invalid_beers
+        expect(beer.find(beer_request)).to eql(["valid1_found", "valid2_found"])
+      end
+    end
+  end
+
+  describe "#id" do
+
+    it "sets the options[:id] to the beer id passed in" do
+      beer.id("port")
+      beer_options = beer.instance_variable_get(:"@options")
+      expect(beer_options[:id]).to eql("port")
+    end
+
+    it "returns itself" do
+      expect(beer.object_id).to eql(beer.id("port").object_id)
+    end
+  end
+
+  describe "#breweries" do
+
+    it "sets the options[:endpoint] to breweries" do
+      beer.breweries
+      beer_options = beer.instance_variable_get(:"@options")
+      expect(beer_options[:endpoint]).to eql("breweries")
+    end
+
+    it "returns itself" do
+      expect(beer.object_id).to eql(beer.breweries.object_id)
+    end
+  end
+
+  describe "#events" do
+
+    it "sets the options[:endpoint] to events" do
+      beer.events
+      beer_options = beer.instance_variable_get(:"@options")
+      expect(beer_options[:endpoint]).to eql("events")
+    end
+
+    it "returns itself" do
+      expect(beer.object_id).to eql(beer.events.object_id)
+    end
+  end
+
+  describe "#ingredients" do
+
+    it "sets the options[:endpoint] to ingredients" do
+      beer.ingredients
+      beer_options = beer.instance_variable_get(:"@options")
+      expect(beer_options[:endpoint]).to eql("ingredients")
+    end
+
+    it "returns itself" do
+      expect(beer.object_id).to eql(beer.ingredients.object_id)
+    end
+  end
+
+  describe "#social_accounts" do
+
+    it "sets the options[:endpoint] to socialaccounts" do
+      beer.social_accounts
+      beer_options = beer.instance_variable_get(:"@options")
+      expect(beer_options[:endpoint]).to eql("socialaccounts")
+    end
+
+    it "returns itself" do
+      expect(beer.object_id).to eql(beer.social_accounts.object_id)
+    end
+  end
+
+  describe "#variations" do
+
+    it "sets teh options[:endpoint] to variations" do
+      beer.variations
+      beer_options = beer.instance_variable_get(:"@options")
+      expect(beer_options[:endpoint]).to eql("variations")
+    end
+
+    it "returns itself" do
+      expect(beer.object_id).to eql(beer.variations.object_id)
+    end
+  end
+
+  describe "when making a request" do
+
+    context "the id for a beer is not set" do
+
+      it "raises a Tankard::Error::NoBeerId error" do
+        expect { beer.each { |b| p b } }.to raise_error(Tankard::Error::NoBeerId)
+      end
+    end
+
+    context "the id for a beer is set" do
+
+      before do
+        @request.stub(:get).with("beer/valid1", {}).and_return({ "data" => { "valid1_found" => "beer", "valid1_found_more" => "more_details" }})
+      end
+
+      it "uses the beer id in the uri" do
+        expect(beer.id("valid1").collect { |x| x }).to eql([{"valid1_found" => "beer", "valid1_found_more" => "more_details" }])
+      end
+    end
+
+    context "the endpoint is set" do
+
+      before do
+        @request.stub(:get).with("beer/valid1/breweries", {}).and_return({ "data" => ["valid1_found"]})
+      end
+
+      it "adds the endpoint to the request" do
+        expect(beer.id("valid1").breweries.collect { |x| x }).to eql(["valid1_found"])
+      end
+    end
+
+    context "additional options are set" do
+
+      before do
+        @beer_with_options = Tankard::Api::Beer.new(@request, test: "123", id: "valid1")
+        @request.stub(:get).with("beer/valid1", Hashie::Mash.new(test: "123")).and_return({ "data" => ["valid1_found"]})
+      end
+
+      it "passes them to the request" do
+        expect(@beer_with_options.collect { |x| x }).to eql(["valid1_found"])
+      end
+    end
+
+    context "no data is returned" do
+
+      before do
+        @request.stub(:get).with("beer/valid1", {}).and_return({})
+      end
+
+      it "gracefully fails" do
+        expect { beer.id("valid1").collect { |x| x} }.to raise_error(Tankard::Error::InvalidResponse)
+      end
+    end
+  end
+end

data/spec/tankard/api/beers_spec.rb

@@ -0,0 +1,116 @@
+require 'spec_helper'
+
+describe Tankard::Api::Beers do
+  let(:beers) { Tankard::Api::Beers.new(@request) }
+
+  before do
+    @request = mock("request")
+  end
+
+  describe "#name" do
+
+    it "sets the options[:name] of a beer" do
+      beers.name("stone")
+      beers_options = beers.instance_variable_get(:"@options")
+      expect(beers_options[:name]).to eql("stone")
+    end
+
+    it "returns self" do
+      expect(beers.object_id).to eql(beers.name("stone").object_id)
+    end
+  end
+
+  describe "#page" do
+
+    it "sets the options[:p] for the page number" do
+      beers.page(1)
+      beers_options = beers.instance_variable_get(:"@options")
+      expect(beers_options[:p]).to eql(1)
+    end
+
+    it "returns self" do
+      expect(beers.object_id).to eql(beers.page(1).object_id)
+    end
+  end
+
+  describe "when making a request" do
+
+    context "and a page is set" do
+
+      it "only queries a single page" do
+        beers.should_receive(:find_on_single_page)
+        beers.page(1).each { |x| x }
+      end
+    end
+
+    context "and a page is not set" do
+
+      it "queries multiple pages" do
+        beers.should_receive(:find_on_all_pages)
+        beers.each { |x| x }
+      end
+    end
+
+    context "and additional options are set without a page" do
+
+      before do
+        @beers_with_options = Tankard::Api::Beers.new(@request, test: "123")
+        @request.stub(:get).with("beers", Hashie::Mash.new(test: "123", p: 1)).and_return({ "data" => ["beers"]})
+      end
+
+      it "passes them to the request" do
+        expect(@beers_with_options.collect { |x| x }).to eql(["beers"])
+      end
+    end
+
+    context "and additional options are set with a page" do
+
+      before do
+        @beers_with_options = Tankard::Api::Beers.new(@request, test: "123", p: 2)
+        @request.stub(:get).with("beers", Hashie::Mash.new(test: "123", p: 2)).and_return({ "data" => ["beers"]})
+      end
+
+      it "passes them to the request" do
+        expect(@beers_with_options.collect { |x| x }).to eql(["beers"])
+      end
+    end
+
+    context "and no data is returned on a single page request" do
+
+      before do
+        @beers = Tankard::Api::Beers.new(@request, p: 1)
+        @request.stub(:get).with("beers", Hashie::Mash.new(p: 1)).and_return({})
+      end
+
+      it "raises a Tankard::Error::InvalidResponse error" do
+        expect { @beers.collect { |x| x} }.to raise_error(Tankard::Error::InvalidResponse)
+      end
+    end
+
+    context "and no data is returned on a page in a multi page request" do
+
+      before do
+        @beers = Tankard::Api::Beers.new(@request)
+        @request.stub(:get).with("beers", Hashie::Mash.new(p: 1)).and_return({"numberOfPages" => 2, "data" => ["test1", "test2"]})
+        @request.stub(:get).with("beers", Hashie::Mash.new(p: 2)).and_return({})
+      end
+
+      it "raises a Tankard::Error::InvalidResponse error" do
+        expect { @beers.collect { |x| x} }.to raise_error(Tankard::Error::InvalidResponse)
+      end
+    end
+
+    context "and a page is not specified" do
+
+      before do
+        @beers = Tankard::Api::Beers.new(@request)
+        @request.stub(:get).with("beers", Hashie::Mash.new(p: 1)).and_return({"numberOfPages" => 2, "data" => ["test1", "test2"]})
+        @request.stub(:get).with("beers", Hashie::Mash.new(p: 2)).and_return({"numberOfPages" => 2, "data" => ["test3", "test4"]})
+      end
+
+      it "runs through all of the pages returned by brewerydb" do
+        expect(@beers.collect { |x| x}).to eql(["test1", "test2", "test3", "test4"])
+      end
+    end
+  end
+end

data/spec/tankard/client_spec.rb

@@ -0,0 +1,54 @@
+require 'spec_helper'
+
+describe Tankard::Client do
+
+  let(:client) { Tankard::Client.new({api_key: "abc123"}) }
+
+  describe "#beer" do
+
+    context "when called" do
+
+      it "does not reuse an existing beer object" do
+        first_beer = client.beer
+        expect(first_beer.object_id != client.beer.object_id).to be_true
+      end
+    end
+
+    context "when passed a hash of options" do
+
+      before do
+        @request = mock("request")
+        Tankard::Request.stub!(:new).and_return(@request)
+      end
+
+      it "passes the options to the beer object" do
+        Tankard::Api::Beer.should_receive(:new).with(@request, {test: 123})
+        client.beer({test: 123})
+      end
+    end
+  end
+
+  describe "#beers" do
+
+    context "when called" do
+
+      it "does not reuse an existing beer object" do
+        beers = client.beers
+        expect(beers.object_id != client.beers.object_id).to be_true
+      end
+    end
+
+    context "when passed a hash of options" do
+
+      before do 
+        @request = mock("request")
+        Tankard::Request.stub!(:new).and_return(@request)
+      end
+
+      it "passes the options to the beer object" do
+        Tankard::Api::Beers.should_receive(:new).with(@request, {test: 123})
+        client.beers({test: 123})
+      end
+    end
+  end
+end

data/spec/tankard/request_spec.rb

@@ -0,0 +1,49 @@
+require 'spec_helper'
+
+describe Tankard::Request do
+  
+  let(:request) { Tankard::Request.new("abc123") }
+
+  describe "#get" do
+
+    context "request status is not 200 or 401" do
+
+      it "raises a Tankard::Error::HttpError" do
+        stub_get("test?key=abc123").to_return(status: [404, "Not Found"])
+        expect { request.get("test") }.to raise_error(Tankard::Error::HttpError)
+      end
+    end
+
+    context "request status is 401" do
+
+      it "raises a Tankard::Error::ApiKeyUnauthorized error" do
+        stub_get("test?key=abc123").to_return(status: [401, "Unauthorized"])
+        expect { request.get("test") }.to raise_error(Tankard::Error::ApiKeyUnauthorized)
+      end
+    end
+
+    context "request status is 200" do
+
+      it "does not raise a Tankard::Error::HttpError" do
+        stub_get("test?key=abc123").to_return(status: 200)
+        expect { request.get("test") }.not_to raise_error(Tankard::Error::HttpError)
+      end
+    end
+
+    context "valid json response" do
+
+      it "returns the json decoded body" do
+        stub_get("test?key=abc123").to_return(body: '{ "beer_name": "Smoked Porter" }')
+        expect(request.get("test")["beer_name"]).to eql("Smoked Porter")
+      end
+    end
+
+    context "invalid json response" do
+
+      it "raises an error" do
+        stub_get("test?key=abc123").to_return(body: '{')
+        expect { request.get("test") }.to raise_error(Tankard::Error::LoadError)
+      end
+    end
+  end
+end

data/spec/tankard_spec.rb

@@ -0,0 +1,61 @@
+require 'spec_helper'
+
+describe Tankard do
+
+  context "when delegating to a client" do
+
+    before do
+      Tankard::Client.any_instance.stub(:test).and_return("testing")
+    end
+
+    it "delegates to Tankard::Client" do
+      expect(Tankard.test).to eql("testing")
+    end
+
+    describe ".respond_to?" do
+
+      it "delegates to Tankard::Client" do
+        expect(Tankard.respond_to?(:test)).to be_true
+      end
+    end
+
+    describe ".client" do
+
+      it "returns a Tankard::Client" do
+        expect(Tankard.client).to be_kind_of(Tankard::Client)
+      end
+
+      it "does not create a new Tankard::Client when one is already created" do
+        client = Tankard.client
+        expect(Tankard.client).to eql(client)
+      end
+    end
+  end
+
+  describe ".configuration" do
+
+    context "when invalid configuration data is provided" do
+
+      it "raises a configuration error" do
+        expect {
+          Tankard.configure do |config|
+            config.api_key = 1234
+          end
+        }.to raise_error(Tankard::Error::ConfigurationError)
+      end
+    end
+
+    context "when valid configuration data is provided" do
+
+      before do
+        Tankard.configure do |config|
+          config.api_key = "abc123"
+        end
+      end
+
+      it "sets the api_key" do
+        expect(Tankard.instance_variable_get(:"@api_key")).to eql("abc123")
+      end
+    end
+  end
+end

data/tankard.gemspec

@@ -0,0 +1,33 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'tankard/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "tankard"
+  spec.version       = Tankard::VERSION
+  spec.authors       = ["Matthew Shafer"]
+  spec.email         = ["matthewshafer@mac.com"]
+  spec.description   = %q{Connector to the BreweryDB api}
+  spec.summary       = %q{Allows easy quering to the breweryDB api}
+  spec.homepage      = ""
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "rspec", "~> 2.13.0"
+  spec.add_development_dependency "webmock", "~> 1.11.0"
+  spec.add_development_dependency "simplecov", "~> 0.7.1"
+  spec.add_development_dependency "coveralls", "~> 0.6.4"
+  spec.add_development_dependency "pry", "~> 0.9.12"
+
+  spec.add_dependency "atomic", "~> 1.1.0"
+  spec.add_dependency "httpclient", "~> 2.3.3"
+  spec.add_dependency "multi_json", "~> 1.7.2"
+  spec.add_dependency "hashie", "~> 2.0.3"
+end

metadata

@@ -0,0 +1,228 @@
+--- !ruby/object:Gem::Specification
+name: tankard
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Matthew Shafer
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-05-03 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.13.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.13.0
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.11.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.11.0
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.7.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.7.1
+- !ruby/object:Gem::Dependency
+  name: coveralls
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.6.4
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.6.4
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.12
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.12
+- !ruby/object:Gem::Dependency
+  name: atomic
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.1.0
+- !ruby/object:Gem::Dependency
+  name: httpclient
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.3.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.3.3
+- !ruby/object:Gem::Dependency
+  name: multi_json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.7.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.7.2
+- !ruby/object:Gem::Dependency
+  name: hashie
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.0.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.0.3
+description: Connector to the BreweryDB api
+email:
+- matthewshafer@mac.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- .travis.yml
+- CHANGELOG.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/tankard.rb
+- lib/tankard/api/beer.rb
+- lib/tankard/api/beers.rb
+- lib/tankard/api/request/get.rb
+- lib/tankard/client.rb
+- lib/tankard/configuration.rb
+- lib/tankard/error.rb
+- lib/tankard/request.rb
+- lib/tankard/version.rb
+- spec/spec_helper.rb
+- spec/tankard/api/beer_spec.rb
+- spec/tankard/api/beers_spec.rb
+- spec/tankard/client_spec.rb
+- spec/tankard/request_spec.rb
+- spec/tankard_spec.rb
+- tankard.gemspec
+homepage: ''
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.0
+signing_key: 
+specification_version: 4
+summary: Allows easy quering to the breweryDB api
+test_files:
+- spec/spec_helper.rb
+- spec/tankard/api/beer_spec.rb
+- spec/tankard/api/beers_spec.rb
+- spec/tankard/client_spec.rb
+- spec/tankard/request_spec.rb
+- spec/tankard_spec.rb