ratebeer 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: c70ddcf6fcf1333ec57e5850602c692b568af608
+  data.tar.gz: 038beefda93b5cfef61bcb659612fe3cc6a77542
+SHA512:
+  metadata.gz: fa2c44b45bf4bd24122daf95a8fd51e77eec9e582ee39b3eac4704cc4e7bec40ce3f89eaa4d5bbe825fedab60f62c8cb721a6aad494c49b3769e549134a7383d
+  data.tar.gz: 9efcfd028583c5fbde0584098ddb551e99ab663854621f5a5d3c29b603da40cec8c3729ae4d190ce4bc8b66f4a3073d0129ba7eb8cd10da42d4ee5cd701360c4

data/Gemfile

@@ -0,0 +1,13 @@
+source "https://rubygems.org"
+ruby "2.2.1"
+
+gemspec
+
+gem "i18n"
+gem "nokogiri"
+
+group :test do
+  gem "rspec"
+  gem "rake"
+  gem "codeclimate-test-reporter"
+end

data/Gemfile.lock

@@ -0,0 +1,50 @@
+PATH
+  remote: .
+  specs:
+    ratebeer (0.0.1)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    codeclimate-test-reporter (0.4.8)
+      simplecov (>= 0.7.1, < 1.0.0)
+    diff-lcs (1.2.5)
+    docile (1.1.5)
+    i18n (0.7.0)
+    json (1.8.3)
+    mini_portile (0.6.2)
+    nokogiri (1.6.6.2)
+      mini_portile (~> 0.6.0)
+    rake (10.4.2)
+    rspec (3.3.0)
+      rspec-core (~> 3.3.0)
+      rspec-expectations (~> 3.3.0)
+      rspec-mocks (~> 3.3.0)
+    rspec-core (3.3.2)
+      rspec-support (~> 3.3.0)
+    rspec-expectations (3.3.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.3.0)
+    rspec-mocks (3.3.2)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.3.0)
+    rspec-support (3.3.0)
+    simplecov (0.10.0)
+      docile (~> 1.1.0)
+      json (~> 1.8)
+      simplecov-html (~> 0.10.0)
+    simplecov-html (0.10.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  codeclimate-test-reporter
+  i18n
+  nokogiri
+  rake
+  ratebeer!
+  rspec
+
+BUNDLED WITH
+   1.10.6

data/LICENSE

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Dan Meakin
+
+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,64 @@
+# RateBeer [![Build Status](https://travis-ci.org/DanMeakin/ratebeer.svg?branch=master)](https://travis-ci.org/DanMeakin/ratebeer) [![Code Climate](https://codeclimate.com/github/DanMeakin/ratebeer/badges/gpa.svg)](https://codeclimate.com/github/DanMeakin/ratebeer) [![Test Coverage](https://codeclimate.com/github/DanMeakin/ratebeer/badges/coverage.svg)](https://codeclimate.com/github/DanMeakin/ratebeer/coverage)
+A Ruby scraper for RateBeer.com
+
+## Introduction
+
+RateBeer is a scraper for RateBeer.com. At present, the library can be used to access data on beers, breweries, styles, countries and regions which are listed at RateBeer.com.
+
+This library has been influenced by the [great Python RateBeer scraper by ajila](https://github.com/alilja/ratebeer).
+
+## Usage
+
+The library provides access to a REPL which can be used to query RateBeer.com for the information accessible through this library. This is found at `/bin/ratebeer`. Alternatively, you can `require 'lib/ratebeer'` to use the library in your code.
+
+A number of classes are provided by the library:-
+
+  * Beer;
+  * Brewery;
+  * Style;
+  * Country;
+  * Region; and
+  * Search.
+
+The first five classes represent a details of that particular thing as provided by RateBeer.com. Each of these is lazy and will only retrieve data from the site when that data is requested (and where that data is not already present within the object - it is possible to pass known data to the constructor).
+
+The search class represents a search conducted at the site, and will return beers and breweries which are matched.
+
+## Example
+
+To conduct a search:-
+
+```ruby
+> s = RateBeer::Search.new("punk ipa")
+> s.beers
+ => [#<RateBeer::Beer #98939 - Berwick Atomic Punk IPA>,
+     #<RateBeer::Beer #72423 - BrewDog Punk IPA  (6%)>,
+     #<RateBeer::Beer #135361 - BrewDog Punk IPA (5.6%)>,
+     #<RateBeer::Beer #81110 - BrewDog Punk IPA Speyside>,
+     #<RateBeer::Beer #193916 - Flying Dog / Brewdog / Push Brewing Punk Bitch IPA>,
+     #<RateBeer::Beer #132795 - Founders Hop Spit Punk Rock IPA>,
+     #<RateBeer::Beer #309419 - Fuggles & Warlock Draft Punk Rye IPA>,
+     #<RateBeer::Beer #218936 - Pateros Creek Punk Rock IPA>,
+     #<RateBeer::Beer #191045 - Push Brewing Knob Creek Punk Bitch IPA>,
+     #<RateBeer::Beer #100638 - Berwick Atomic Punk IPL (India Pale Lager)>,
+     #<RateBeer::Beer #209258 - Dieselpunk India Pale Ale>]
+> s.breweries
+ => nil
+> s.query = "brewdog"
+> s.breweries
+ => [#<RateBeer::Brewery #8534 - BrewDog>]
+```
+
+To use a beer instance, you can obtain one from a search or create one from a known beer ID:-
+
+```ruby
+> b = RateBeer::Beer.new(72423)
+> b.name
+ => "BrewDog Punk IPA (6%)"
+> b.abv
+ => 6.0
+> b.brewery
+ => #<RateBeer::Brewery #8534 - BrewDog>
+```
+
+Accessible data keys can be found in the .data_keys method in each class.

data/Rakefile

@@ -0,0 +1,8 @@
+require 'rspec/core/rake_task'
+
+task :default => [:spec]
+
+desc "Run the specs."
+RSpec::Core::RakeTask.new do |t|
+  t.pattern = "spec/**/*_spec.rb"
+end

data/bin/ratebeer

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+require 'irb'
+require_relative '../lib/ratebeer'
+
+puts
+puts "########################"
+puts "### RateBeer console ###"
+puts "########################"
+puts
+puts "You can begin by looking-up a beer, brewery, or style by ID#, "\
+     "or by searching for a beer or brewery, using any of the 'beer', "\
+     "'brewery', 'style', or 'search' methods."
+puts
+
+include RateBeer
+IRB.start

data/lib/ratebeer.rb

@@ -0,0 +1,51 @@
+# RateBeer.com scraper
+#
+# Scrapes required information on beers, breweries, ratings, etc. from the 
+# RateBeer.com beer database.
+#
+Dir[File.expand_path("../ratebeer/*.rb", __FILE__)].each { |f| require f }
+
+module RateBeer
+
+  # Create new beer instance, using ID and name passed as arguments.
+  #
+  # @param [Integer, String] id ID# of beer to retrieve
+  # @param [String] name Name of the beer to which ID# relates if known
+  # @return [RateBeer::Beer] beer with passed ID#
+  #
+  def beer(id, name=nil)
+    Beer.new(id, name: name)
+  end
+
+  # Create new brewery instance, using ID and name passed as arguments.
+  #
+  # @param [Integer, String] id ID# of brewery to retrieve
+  # @param [String] name Name of the brewery to which ID# relates if known
+  # @return [RateBeer::Brewery] brewery with passed ID#
+  #
+  def brewery(id, name=nil)
+    Brewery.new(id, name: name)
+  end
+
+  # Create new style instance, using ID and name passed as arguments.
+  #
+  # @param [Integer, String] id ID# of style to retrieve
+  # @param [String] name Name of the style to which ID# relates if known
+  # @return [RateBeer::Style] style with passed ID#
+  #
+  def style(id, name=nil)
+    Style.new(id, name: name)
+  end
+
+  # Search for a particulary beer or brewery.
+  #
+  # @param [String] query Search parameters to use
+  # @return [Hash<Array>] Hash containing Arrays containing RateBeer::Beer and
+  #   RateBeer::Brewery instances matching search parameters
+  #
+  def search(query)
+    Search.search(query)
+  end
+
+  [:beer, :brewery, :style, :search].each { |f| module_function f }
+end

data/spec/lib/ratebeer/beer_spec.rb

@@ -0,0 +1,57 @@
+require 'spec_helper'
+
+describe RateBeer::Beer do
+  before :all do
+    @valid     = RateBeer::Beer.new(1411) # ID for Tennents Lager (sorry...)
+    @retired   = RateBeer::Beer.new(213225) # ID for BrewDog Vice Bier
+    @with_name = RateBeer::Beer.new(422, name: "Stone IPA")
+  end
+
+  describe "#new" do
+    it "creates a beer instance" do
+      expect(@valid).to be_a RateBeer::Beer
+    end
+
+    it "requires an ID# as parameter" do
+      expect { RateBeer::Beer.new }.to raise_error(ArgumentError)
+    end
+
+    it "accepts a name parameter" do
+      expect(@with_name).to be_a RateBeer::Beer
+    end
+  end
+
+  describe "#name" do
+    it "retrieves name details from RateBeer if not present" do
+      expect(@valid.name).to eq "Tennents Lager"
+    end
+
+    it "uses name details if passed as parameter" do
+      expect(@with_name.name).to eq "Stone IPA"
+    end
+  end
+
+  describe "#retired" do
+    it "states that beer is retired when this is the case" do
+      expect(@valid.retired).to be false
+      expect(@retired.retired).to be true
+    end
+  end
+
+  describe "#full_details" do
+    it "returns full information about the beer" do
+      expect(@valid.full_details).to include(:id,
+                                             :name,
+                                             :brewery,
+                                             :url,
+                                             :style,
+                                             :glassware,
+                                             :availability,
+                                             :abv,
+                                             :calories,
+                                             :description,
+                                             :retired,
+                                             :rating)
+    end
+  end
+end

data/spec/lib/ratebeer/brewery_spec.rb

@@ -0,0 +1,60 @@
+require 'spec_helper'
+
+describe RateBeer::Brewery do
+  before :all do
+    @valid     = RateBeer::Brewery.new(8534) # ID for BrewDog
+    @with_name = RateBeer::Brewery.new(1069, name: "Cantillon Brewery")
+  end
+
+  describe "#new" do
+    it "creates a brewery instance" do
+      expect(@valid).to be_a RateBeer::Brewery
+    end
+
+    it "requires an ID# as parameter" do
+      expect { RateBeer::Brewery.new }.to raise_error(ArgumentError)
+    end
+
+    it "accepts a name parameter" do
+      expect(@with_name).to be_a RateBeer::Brewery
+    end
+  end
+
+  describe "#name" do
+    it "retrieves name from RateBeer if not passed as parameter" do
+      expect(@valid.name).to eq "BrewDog"
+    end
+
+    it "uses name details if passed as parameter" do
+      expect(@with_name.name).to eq "Cantillon Brewery"
+    end
+  end
+
+  describe "#beers" do
+    it "returns a non-empty array of beers produced by the brewery" do
+      expect(@valid.beers).to_not be_empty
+    end
+
+    it "returns an array of beer instances" do
+      @valid.beers.each { |b| expect(b).to be_a RateBeer::Beer }
+    end
+
+    it "returns a list of beers produced by brewery" do
+      beers = [215065, 98242, 172237, 76701, 178585, 162521, 87321, 118987, 
+               119594].map { |id| RateBeer::Beer.new(id) }
+      expect(@valid.beers).to include(*beers)
+    end
+  end
+
+  describe "#full_details" do
+    it "returns full information about the brewery" do
+      expect(@valid.full_details).to include(:id,
+                                             :name,
+                                             :url,
+                                             :type,
+                                             :address,
+                                             :telephone,
+                                             :beers)
+    end
+  end
+end

data/spec/lib/ratebeer/country_spec.rb

@@ -0,0 +1,68 @@
+require 'spec_helper'
+
+describe RateBeer::Country do
+  before :all do
+    @country   = RateBeer::Country.new(241) # Scotland
+    @invalid   = RateBeer::Country.new(12345) # Invalid
+    @with_name = RateBeer::Country.new(14, name: "Oceania - Australia") # Australia
+  end
+
+  describe "#new" do
+    it "creates a new country instance" do
+      expect(@country).to be_a RateBeer::Country
+    end
+
+    it "requires an ID# as parameter" do
+      expect { RateBeer::Country.new }.to raise_error(ArgumentError)
+    end
+
+    it "accepts a name parameter" do
+      expect(@with_name).to be_a RateBeer::Country
+    end
+  end
+
+  describe "#name" do
+    it "retrives name from RateBeer if not passed as parameter" do
+      expect(@country.name).to eq "Scotland"
+    end
+
+    it "uses name details if passed as parameter" do
+      expect(@with_name.name).to eq "Oceania - Australia"
+    end
+  end
+
+  describe "#breweries" do
+    it "lists breweries within the country" do
+      expect(@country.breweries).to be_an Array
+    end
+
+    it "returns a series of RateBeer::Brewery instances" do
+      expected_breweries = [19163,
+                            2809,
+                            2878,
+                            11582,
+                            8031].map { |i| RateBeer::Brewery.new(i) }
+      expect(@country.breweries).to include(*expected_breweries)
+    end
+
+  end 
+
+  describe "#full_details" do
+    it "raises error when invalid ID# passed" do
+      expect { @invalid.full_details }.to raise_error(RateBeer::Scraping::PageNotFoundError)
+    end
+
+    it "returns full information about this country" do
+      expect(@country.full_details).to_not be_empty
+    end
+
+    it "returns a hash with specified keys" do
+      expect(@country.full_details).to include(:id,
+                                               :name,
+                                               :url,
+                                               :top_styles,
+                                               :num_breweries,
+                                               :breweries)
+    end
+  end
+end

data/spec/lib/ratebeer/region_spec.rb

@@ -0,0 +1,68 @@
+require 'spec_helper'
+
+describe RateBeer::Region do
+  before :all do
+    @region    = RateBeer::Region.new(5) # California
+    @invalid   = RateBeer::Region.new(12345) # Invalid
+    @with_name = RateBeer::Region.new(79, name: "London") # Greater London
+  end
+
+  describe "#new" do
+    it "creates a new region instance" do
+      expect(@region).to be_a RateBeer::Region
+    end
+
+    it "requires an ID# as parameter" do
+      expect { RateBeer::Region.new }.to raise_error(ArgumentError)
+    end
+
+    it "accepts a name parameter" do
+      expect(@with_name).to be_a RateBeer::Region
+    end
+  end
+
+  describe "#name" do
+    it "retrives name from RateBeer if not passed as parameter" do
+      expect(@region.name).to eq "California"
+    end
+
+    it "uses name details if passed as parameter" do
+      expect(@with_name.name).to eq "London"
+    end
+  end
+
+  describe "#breweries" do
+    it "lists breweries within the region" do
+      expect(@region.breweries).to be_an Array
+    end
+
+    it "returns a series of RateBeer::Brewery instances" do
+      expected_breweries = [15430, 
+                            108, 
+                            19927, 
+                            11855, 
+                            8889].map { |i| RateBeer::Brewery.new(i) }
+      expect(@region.breweries).to include(*expected_breweries)
+    end
+
+  end 
+
+  describe "#full_details" do
+    it "raises error when invalid ID# passed" do
+      expect { @invalid.full_details }.to raise_error(RateBeer::Scraping::PageNotFoundError)
+    end
+
+    it "returns full information about this region" do
+      expect(@region.full_details).to_not be_empty
+    end
+
+    it "returns a hash with specified keys" do
+      expect(@region.full_details).to include(:id,
+                                              :name,
+                                              :url,
+                                              :top_styles,
+                                              :num_breweries,
+                                              :breweries)
+    end
+  end
+end

data/spec/lib/ratebeer/review_spec.rb

@@ -0,0 +1,147 @@
+require 'spec_helper'
+
+describe RateBeer::Review do
+  before :all do
+    # Create Review instance with Beer instance
+    @beer = RateBeer::Beer.new(135361) # BrewDog Punk IPA
+    @constructed_params = { beer: @beer,
+                            reviewer: "Johnny Tester", 
+                            reviewer_rank: 1234,
+                            location: "The Moon",
+                            date: Date.today,
+                            rating: 4.00,
+                            rating_breakdown: { overall: Rational(20, 20),
+                                                aroma: Rational(7, 10),
+                                                appearance: Rational(4, 5),
+                                                taste: Rational(9, 10),
+                                                palate: Rational(3, 5) },
+                            comment: "Specimen review of this beer."}
+    @constructed = RateBeer::Review.new(@constructed_params)
+
+    # Create Review instance with beer ID#
+    @beer_id = 53
+    @params_with_beer_id = @constructed_params.dup.update(beer: @beer_id)
+    @constructed_with_beer_id = RateBeer::Review.new(@params_with_beer_id)
+  end
+
+  describe ".retrieve" do
+    before :all do
+
+      @retrieved     = RateBeer::Review.retrieve(@beer)
+      @reviews_by_id = RateBeer::Review.retrieve(@beer_id)
+      # Test ordering
+      @recent        = RateBeer::Review.retrieve(@beer, order: :most_recent)
+      @top_raters    = RateBeer::Review.retrieve(@beer, order: :top_raters)
+      @highest_score = RateBeer::Review.retrieve(@beer, order: :highest_score)
+      # Test limit
+      @single_review = RateBeer::Review.retrieve(@beer, limit: 1)
+      @many_reviews  = RateBeer::Review.retrieve(@beer, limit: 100)
+    end
+
+    it "retrieves reviews for the specified beer" do
+      @retrieved.each { |r| expect(r).to be_a RateBeer::Review }
+    end
+
+    it "recognises a beer specified by ID#" do
+      expect(@reviews_by_id.first.beer).to eq RateBeer::Beer.new(@beer_id)
+    end
+
+    it "retrieves reviews for beer specified by ID#" do
+      @reviews_by_id.each { |r| expect(r).to be_a RateBeer::Review }
+    end
+
+    it "retrieves ten reviews by default" do
+      expect(@retrieved.length).to eq 10
+    end
+
+    it "retrieves the most recent reviews by default" do
+      expect(@retrieved).to match_array @recent
+    end
+
+    it "retrieves the most recent reviews on request" do
+      @recent.each_cons(2).each { |r1, r2|
+        expect(r1.date).to be >= r2.date
+      }
+    end
+
+    it "retrieves reviews by the top raters on request" do
+      @top_raters.each_cons(2).each { |r1, r2| 
+        expect(r1.reviewer_rank).to be >= r2.reviewer_rank 
+      }
+    end
+
+    it "retrieves the highest rated reviews on request" do
+      @highest_score.each_cons(2).each { |r1, r2|
+        expect(r1.rating).to be >= r2.rating
+      }
+    end
+  end
+
+  describe ".url_suffix" do
+    it "returns a numerical suffix for valid ordering methods" do
+      { most_recent:        "1",
+        top_raters:         "2",
+        highest_score:      "3" }.each { |k, v|
+          expect(RateBeer::Review.url_suffix(k)).to eq v
+        }
+    end
+
+    it "raises error when passed an invalid ordering method" do
+      invalid = :my_favourites
+      expect { RateBeer::Review.url_suffix(invalid) }.to raise_error(ArgumentError)
+    end
+  end
+
+  describe "#new" do
+    it "creates a review instance" do
+      expect(@constructed).to be_a RateBeer::Review
+    end
+
+    it "creates a review instance when passed a beer ID#" do
+      expect(@constructed_with_beer_id).to be_a RateBeer::Review
+    end
+
+    it "requires a full set of parameters" do
+      params = { beer: @beer, 
+                 reviewer: "Johnny Tester",
+                 date: Date.today } # Rating & comment missing
+      expect { RateBeer::Review.new(params) }.to raise_error(ArgumentError)
+    end
+  end
+
+  describe "#reviewer" do
+    it "returns the name of the reviewer of the beer" do
+      expect(@constructed.reviewer).to eq @constructed_params[:reviewer]
+    end
+  end
+
+  describe "#beer" do
+    it "returns the beer reviewed" do
+      expect(@constructed.beer).to eq @constructed_params[:beer]
+    end
+  end
+
+  describe "#date" do
+    it "returns the date of the review" do
+      expect(@constructed.date).to eq @constructed_params[:date]
+    end
+  end
+
+  describe "#rating" do
+    it "returns the rating of the beer" do
+      expect(@constructed.rating).to eq @constructed_params[:rating]
+    end
+  end
+
+  describe "#rating_breakdown" do
+    it "returns the broken-down rating of the beer" do
+      expect(@constructed.rating_breakdown).to eq @constructed_params[:rating_breakdown]
+    end
+  end
+
+  describe "#comment" do
+    it "returns the comment attached to the review" do
+      expect(@constructed.comment).to eq @constructed_params[:comment]
+    end
+  end
+end

data/spec/lib/ratebeer/search_spec.rb

@@ -0,0 +1,67 @@
+require 'spec_helper'
+
+describe RateBeer::Search do
+  describe "#new" do
+    before :all do
+      @search = RateBeer::Search.new("Testing Brewers Co Ltd")
+    end
+
+    it "creates a search instance" do
+      expect(@search).to be_a RateBeer::Search
+    end
+
+    it "removes generic terms from query parameter" do
+      expect(@search.query).to_not include("Brewers")
+    end
+  end
+
+  describe "#run_search" do
+    before :all do
+      @failed_search     = RateBeer::Search.new("random parameter 1234").run_search
+      @successful_search = RateBeer::Search.new("heineken").run_search
+    end
+
+    it "executes a search using specified query parameter" do
+      expect(@failed_search).to_not be_nil
+      expect(@successful_search).to_not be_nil
+    end
+
+    it "returns nil for beers for non-matching query" do
+      expect(@failed_search.beers).to be_nil
+    end
+
+    it "returns nil for breweries for non-matching query" do
+      expect(@failed_search.breweries).to be_nil
+    end
+
+    it "returns a list of beers matching query parameter" do
+      expect(@successful_search.beers.count).to be > 0
+    end
+
+    it "returns a list of breweries matching query parameter" do
+      expect(@successful_search.breweries.count).to be > 0
+    end
+
+    it "returns a list of specific beers matching the query parameter" do
+      beers = @successful_search.beers
+      names = beers.map(&:name)
+      expect(names).to include("Heineken",
+                               "Heineken Beer",
+                               "Heineken Golden Fire Strong",
+                               "Heineken Kylian",
+                               "Heineken Oud Bruin",
+                               "Heineken Tarwebok")
+
+    end
+
+    it "returns a list of specific breweries matching the query parameter" do
+      breweries = @successful_search.breweries
+      names     = breweries.map(&:name)
+      expect(names).to include("Heineken UK",
+                               "Heineken Italia",
+                               "Al Ahram (Heineken)",
+                               "Pivovar Corgon (Heineken)",
+                               "Bralima (Heineken)")
+    end
+  end
+end

data/spec/lib/ratebeer/style_spec.rb

@@ -0,0 +1,58 @@
+require 'spec_helper'
+
+describe RateBeer::Style do
+  before :all do
+    @valid   = RateBeer::Style.new(80)
+    @invalid = RateBeer::Style.new(12345)
+    @with_name = RateBeer::Style.new(11, name: "Barleywine")
+    @all_styles = RateBeer::Style.all_styles
+  end
+
+  describe ".all_styles" do
+    it "lists all styles" do
+      expect(@all_styles).to be_an Array
+    end
+
+    it "creates a list containing RateBeer::Style instances" do
+      @all_styles.each { |s| expect(s).to be_a RateBeer::Style }
+    end
+  end
+
+  describe "#new" do
+    it "creates a style instance" do
+      expect(@valid).to be_a RateBeer::Style
+    end
+
+    it "requires an ID# as parameter" do
+      expect { RateBeer::Style.new }.to raise_error(ArgumentError)
+    end
+
+    it "accepts a name parameter" do
+      expect(@with_name).to be_a RateBeer::Style
+    end
+  end
+
+  describe "#name" do
+    it "retrieves name from RateBeer if not passed as parameter" do
+      expect(@valid.name).to eq "Abt/Quadrupel"
+    end
+
+    it "uses name details if passed as parameter" do
+      expect(@with_name.name).to eq "Barleywine"
+    end
+  end
+
+  describe "#full_details" do
+    it "returns full information about the style" do
+      expect(@valid.full_details).to include(:id,
+                                             :name,
+                                             :description,
+                                             :glassware,
+                                             :beers)
+    end
+
+    it "raises error when invalid ID# passed" do
+      expect { @invalid.full_details }.to raise_error(RateBeer::Scraping::PageNotFoundError)
+    end
+  end
+end

data/spec/lib/ratebeer_spec.rb

@@ -0,0 +1,31 @@
+require 'spec_helper'
+
+describe RateBeer do
+  describe ".beer" do
+    it "creates a new beer" do
+      beer = RateBeer.beer(1234, "Magic Lager")
+      expect(beer).to eq RateBeer::Beer.new(1234, name: "Magic Lager")
+    end
+  end
+
+  describe ".brewery" do
+    it "creates a new brewery" do
+      brewery = RateBeer.brewery(456, "Magic BrewCo")
+      expect(brewery).to eq RateBeer::Brewery.new(456, name: "Magic BrewCo")
+    end
+  end
+
+  describe ".style" do
+    it "creates a new style" do 
+      style = RateBeer.style(99, "Butter Beer")
+      expect(style).to eq RateBeer::Style.new(99, name: "Butter Beer")
+    end
+  end
+
+  describe ".search" do 
+    it "runs a new search query" do
+      search = RateBeer.search("pabst blue ribbon")
+      expect(search).to eq RateBeer::Search.search("pabst blue ribbon")
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,5 @@
+require 'rspec'
+require 'codeclimate-test-reporter'
+CodeClimate::TestReporter.start
+
+require_relative '../lib/ratebeer'

metadata

@@ -0,0 +1,58 @@
+--- !ruby/object:Gem::Specification
+name: ratebeer
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Dan Meakin
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-09-03 00:00:00.000000000 Z
+dependencies: []
+description: RateBeer provides a way to access beer & brewery data from RateBeer.com.
+email: dan@danmeakin.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.md
+- Rakefile
+- bin/ratebeer
+- lib/ratebeer.rb
+- spec/lib/ratebeer/beer_spec.rb
+- spec/lib/ratebeer/brewery_spec.rb
+- spec/lib/ratebeer/country_spec.rb
+- spec/lib/ratebeer/region_spec.rb
+- spec/lib/ratebeer/review_spec.rb
+- spec/lib/ratebeer/search_spec.rb
+- spec/lib/ratebeer/style_spec.rb
+- spec/lib/ratebeer_spec.rb
+- spec/spec_helper.rb
+homepage: 
+licenses: []
+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.4.8
+signing_key: 
+specification_version: 4
+summary: Unofficial RateBeer API
+test_files: []