allrecipes 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: e3495f1afe0f65623bc263f180444a4ddfe556b8
+  data.tar.gz: 2926ce536d61bb64dc702877426cfcc8798fdc81
+SHA512:
+  metadata.gz: 97d5e36c2cabe1fb1199af8de21f9ab5286947465a61855e46a4b8b32b11f881714a7a3bb216ffac4755894f0eb552fdf06dde33a6b7a0f02b675d38ac5e3210
+  data.tar.gz: 17ee339ff6056235e139bc4907d9910032965ad39286a7f9c72738481b90a679049d04d762586ce47c54b28c7d75aef331aa3b597f11a03d9164f1228a147a74

data/.gitignore

@@ -0,0 +1,23 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log
+spec/fixtures/vcr_cassettes/*

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 shivamd
+
+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,148 @@
+# Allrecipes
+
+A Ruby interface to the Allrecipes API.
+Allrecipes doesn't have an API, the requests are done using mechanize.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'allrecipes'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install allrecipes
+
+## Usage
+
+**Initialize scraper**
+```ruby
+recipes = Allrecipes.new
+```
+
+**Get all recipes**
+```ruby
+recipes.all #default sorted by popularity, limit 20.
+```
+
+**Get recipes by course**
+```ruby
+recipes.course("breakfast") #default sorted by popularity, limit 20.
+```
+List of courses: 
+```ruby
+[ "appetizer", "bread", "breakfast", "dessert", "drink","fruit", "herbs", "main", "salad", "soup", "meat", "pasta", "seafood", "wholegrains"]
+```
+
+**Get recipes by region**
+```ruby
+recipes.region("european") #default sorted by popularity, limit 20.
+```
+
+Specific options available
+```ruby
+recipes.region("french") #default sorted by popularity, limit 20.
+```
+
+List of regions available: 
+```ruby
+[
+  "asian"
+    "chinese" 
+    "thai" 
+    "japanese" 
+    "filipino" 
+    "korean" 
+    "vietnamese" 
+    "malaysian" 
+    "pakistani" 
+    "indonesian" 
+    "iranian" 
+    "bangladeshi" 
+    "indian" 
+
+  "african"
+    "african_main"
+    "moroccan"
+    "south_african"
+    "egyptian"
+
+  "australian"
+
+  "canadian"
+    "vancouver" 
+    "toronto" 
+    "quebec" 
+
+  "european"
+    "italian"
+    "uk"
+    "french"
+    "greek"
+    "eastern_european"
+    "german"
+    "scandinavian"
+    "spanish"
+    "portuguese"
+    "dutch"
+    "austrian"
+    "swiss"
+    "belgian"
+
+  "latin_american"
+    "mexican" 
+    "caribbean" 
+    "south_american" 
+
+  "middle_eastern"
+    "lebanese" 
+    "turkish" 
+    "israeli" 
+]
+```
+
+**Get recipes by ingredient**
+```ruby
+recipes.ingredient("apples") #default sorted by relevance, limit 21.
+```
+
+**Sample response**
+```ruby
+[
+    {
+      :name => "Lasagna",
+      :image => "http://images.media-allrecipes.com/userphotos/250x250/00/03/24/32427.jpg",
+      :servings => 12,
+      :ingredients =>
+        [
+          {
+            "quantity" => 1.0,
+            "unit" => "pound", 
+            "name" => "ground beef"
+          }
+        ],
+     :directions => 
+       [
+         {
+           "Bring a large pot of lightly salted water to a boil"
+         }
+       ]
+    }
+]
+```
+
+## Todo
+
+1. Filters on search (offset, limit & sort_by)
+2. Complex search with queries such as multiple ingredients, course, time etc.
+3. Add prep time & cook time to results
+4. Add nutrional info to results.
+5. Add rating to results
+6. Add user photos for recipe to results
+7. Able to get popular recipes of the day.
+8. Able to insert recipe URL directly. 
+9. Able to add page URL directly.

data/Rakefile

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

data/allrecipes.gemspec

@@ -0,0 +1,26 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'allrecipes/version'
+
+Gem::Specification.new do |spec|
+  spec.add_dependency "mechanize"
+  spec.add_dependency "nokogiri"
+  spec.add_development_dependency "bundler", "~> 1.6"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "rspec"
+  spec.add_development_dependency "webmock"
+  spec.add_development_dependency "vcr"
+  spec.name          = "allrecipes"
+  spec.version       = Allrecipes::VERSION
+  spec.authors       = ["shivamd"]
+  spec.email         = ["daryananis@gmail.com"]
+  spec.summary       = %q{A Ruby wrapper for allrecipes.com}
+  spec.description   = %q{A Ruby wrapper for allrecipes.com. A simple interface to scrape recipes from allrecipes.com}
+  spec.homepage      = "https://github.com/shivamd/allrecipes"
+  spec.license       = "MIT"
+  spec.files         = `git ls-files -z`.split("\x0")
+  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"]
+end

data/lib/allrecipes.rb

@@ -0,0 +1,8 @@
+require "allrecipes/version"
+require "allrecipes/url_helper"
+require "allrecipes/main"
+require "allrecipes/page_parser"
+require "allrecipes/recipe_parser"
+require 'nokogiri'
+require 'mechanize'
+

data/lib/allrecipes/main.rb

@@ -0,0 +1,47 @@
+class Allrecipes
+  $URL= "http://allrecipes.com"
+  include URLHelper
+
+  def initialize
+    @agent = Mechanize.new
+  end
+
+  def all(options={})
+    page = @agent.get $URL + "/recipes" + "?page=#{options[:page]}&st=#{search_sort_parameter(options[:sort_by])}"
+    PageParser.new(page, options).recipes
+  end
+
+  def course(course_type, options={})
+    begin
+      course_url = get_course_url(course_type) + "?page=#{options[:page]}&st=#{search_sort_parameter(options[:sort_by])}"
+      page = @agent.get(course_url)
+      PageParser.new(page, options).recipes
+    rescue Exception
+      raise "Course type doesn't exist"
+    end
+  end
+
+  def region(region_type, options={})
+    begin
+      region_url = get_region_url(region_type) + "?page=#{options[:page]}&st=#{search_sort_parameter(options[:sort_by])}"
+      page = @agent.get(region_url)
+      PageParser.new(page, options).recipes
+    rescue Exception
+      raise "Region doesn't exist"
+    end
+  end
+
+  def ingredient(name, options={})
+    begin
+      url = $URL + "/search/?wt=#{name}&page=#{options[:page]}&sb=#{ingredient_sort_parameter(options[:sort_by])}"
+      page = @agent.get(url)
+      options = options.merge({type: "ingredient"})
+      PageParser.new(page, options).recipes
+    rescue Exception
+      raise "Could not find recipes that include this ingredient"
+    end
+  end
+
+
+end
+

data/lib/allrecipes/page_parser.rb

@@ -0,0 +1,54 @@
+class PageParser
+
+  def initialize(page, options={})
+    @page = page
+    @recipes = []
+    @options = options
+    @limit = options[:limit]
+    get_recipes
+  end
+
+  def recipe_info_class
+     ".recipe-info"
+  end
+
+  def title_class
+    ".title"
+  end
+
+  def recipe_info
+    if @options[:type] == "ingredient"
+      @page.search(recipe_info_class)
+    else
+      recipes_grid.search(recipe_info_class)
+    end
+  end
+
+  def filtered_recipes
+   @limit ? recipe_info.take(@limit) : recipe_info
+  end
+
+  def recipes_grid_class
+    ".grid-view"
+  end
+
+  def recipes_grid
+    @page.search(recipes_grid_class)[-1]
+  end
+
+  def recipe_link(info)
+    info.search(title_class)[0].attributes["href"].value
+  end
+
+  def get_recipes
+    filtered_recipes.each do |info|
+      recipe_link = recipe_link(info)
+      @recipes <<  RecipeParser.new(recipe_link).recipe
+    end
+  end
+
+  def recipes
+    @recipes
+  end
+
+end

data/lib/allrecipes/recipe_parser.rb

@@ -0,0 +1,103 @@
+class RecipeParser
+  $BASE_URL = "http://allrecipes.com"
+
+  def initialize(page)
+    @page = agent.get $BASE_URL + page
+    @directions = []
+    @ingredients = []
+    get_ingredients
+    get_directions
+  end
+
+  def agent
+    Mechanize.new
+  end
+
+  def name
+    @page.search(name_id).inner_text
+  end
+
+  def name_id
+    "#itemTitle"
+  end
+
+  def image
+    @page.search(image_id).first.attributes["src"].value
+  end
+
+  def image_id
+    "#imgPhoto"
+  end
+
+  def servings
+    @page.search(servings_id).inner_text.gsub(" servings", "").to_i
+  end
+
+  def servings_id
+    "#lblYield"
+  end
+
+  def directions_class
+    ".directions ol li span"
+  end
+
+  def directions_list
+    @page.search(directions_class)
+  end
+
+  def get_directions
+    directions_list.each do |direction|
+      @directions << direction.text
+    end
+  end
+
+  def ingredients_list
+    @page.search(ingredients_class)
+  end
+
+  def ingredients_class
+    ".fl-ing"
+  end
+
+  def get_ingredients
+    ingredients_list.each do |ingredient|
+      amount = amount(ingredient)
+      ingredient_name= ingredient_name(ingredient)
+      add_ingredient_to_list(amount, ingredient_name)
+    end
+  end
+
+  def add_ingredient_to_list(amount, ingredient_name)
+    if amount && ingredient_name #some recipes have empty ingredients
+      quantity,unit = amount.text.split(" ")
+      @ingredients << { "quantity" => quantity.to_f, "unit"=>unit, "name" => ingredient_name.text }
+    end
+  end
+
+  def amount(ingredient)
+    ingredient.search(ingredient_amount_class).children[0]
+  end
+
+  def ingredient_amount_class
+    ".ingredient-amount"
+  end
+
+  def ingredient_name(ingredient)
+    ingredient.search(ingredient_name_class).children[0]
+  end
+
+  def ingredient_name_class
+    ".ingredient-name"
+  end
+
+  def recipe
+    {
+      name: name,
+      image: image,
+      servings: servings,
+      ingredients: @ingredients,
+      directions: @directions
+    }
+  end
+
+end

data/lib/allrecipes/url_helper.rb

@@ -0,0 +1,114 @@
+module URLHelper
+
+  def get_course_url(course_type)
+    begin
+      "http://allrecipes.com/recipes/" + courses[course_type]
+    rescue Exception => e
+      puts e.message
+      puts e.backtrace.inspect
+    end
+  end
+
+  def courses
+    #course type and matching URL based on allrecipes.com
+    {
+      "bread"=> "bread",
+      "appetizer"=> "appetizers-and-snacks",
+      "breakfast"=> "breakfast-and-brunch",
+      "dessert"=> "desserts",
+      "drink"=> "drinks",
+      "main"=> "main-dish",
+      "salad"=> "salad",
+      "side"=> "side-dish",
+      "soup"=> "soups-stews-and-chili",
+      "fruit"=> "fruits-and-vegetables",
+      "herbs"=> "herbs-and-spices",
+      "meat"=> "meat-and-poultry",
+      "pasta"=> "pasta",
+      "seafood"=> "seafood",
+      "wholegrains"=> "whole-grains"
+    }
+  end
+
+  def get_region_url(region_type)
+    begin
+      "http://allrecipes.com/recipes/world-cuisine/" + regions[region_type]
+    rescue Exception => e
+      puts e.message
+      puts e.backtrace.inspect
+    end
+  end
+
+  def regions
+    {
+      "asian"=> "asian",
+        "chinese" => "asian/chinese",
+        "thai" => "asian/thai",
+        "japanese" => "asian/japanese",
+        "filipino" => "asian/filipino",
+        "korean" => "asian/korean",
+        "vietnamese" => "asian/vietnamese",
+        "malaysian" => "asian/malaysian",
+        "pakistani" => "asian/pakistani",
+        "indonesian" => "asian/indonesian",
+        "iranian" => "asian/iranian",
+        "bangladeshi" => "asian/bangladeshi",
+        "indian" => "asian/indian",
+
+      "african"=> "african",
+        "african_main"=> "african/main-dishes",
+        "moroccan"=> "african/moroccan",
+        "south_african"=> "african/south-african",
+        "egyptian"=> "african/egyptian",
+
+      "australian"=> "australian-and-new-zealander",
+
+      "canadian"=> "canadian",
+        "vancouver" => "canadian/vancouver",
+        "toronto" => "canadian/toronto",
+        "quebec" => "canadian/quebec-recipes",
+
+      "european"=> "european",
+        "italian"=> "european/italian",
+        "uk"=> "european/uk-and-ireland",
+        "french"=> "european/french",
+        "greek"=> "european/greek",
+        "eastern_european"=> "european/eastern-european",
+        "german"=> "european/german",
+        "scandinavian"=> "european/scandinavian",
+        "spanish"=> "european/spanish",
+        "portuguese"=> "european/portuguese",
+        "dutch"=> "european/dutch",
+        "austrian"=> "european/austrian",
+        "swiss"=> "european/swiss",
+        "belgian"=> "european/belgian",
+
+      "latin_american"=> "latin-american",
+        "mexican" => "latin-american/mexican",
+        "caribbean" => "latin-american/caribbean",
+        "south_american" => "latin-american/south-american",
+
+      "middle_eastern"=> "middle-eastern",
+        "lebanese" => "middle-eastern/lebanese",
+        "turkish" => "middle-eastern/turkish",
+        "israeli" => "middle-eastern/israeli",
+
+    }
+  end
+
+  def search_sort_parameter(sort_type)
+    case sort_type
+      when "date" then "n"
+      when "title" then "t"
+      else "p"
+    end
+  end
+
+  def ingredient_sort_parameter(sort_type)
+    case sort_type
+      when "rating" then "ra"
+      when "popularity" then "p"
+      else "re"
+    end
+  end
+end

data/lib/allrecipes/version.rb

@@ -0,0 +1,3 @@
+class Allrecipes
+  VERSION = "1.0.0"
+end

data/spec/allrecipes_spec.rb

@@ -0,0 +1,124 @@
+require 'spec_helper'
+describe Allrecipes do
+  subject { Allrecipes.new }
+
+  describe "#all" do
+    context "without options" do
+      before do
+        VCR.use_cassette "all" do
+          @recipes = subject.all
+        end
+      end
+      it "requests the correct url" do
+        expect(a_request(:get, "http://allrecipes.com/recipes?page=&st=p")).to have_been_made
+      end
+      it "count should be 20" do
+        expect(@recipes.count).to eq 20
+      end
+    end
+  end
+
+  describe "#course" do
+
+    context "without options" do
+
+      before do
+        VCR.use_cassette "course_1" do
+          @recipes = subject.course("bread")
+        end
+      end
+
+      it "requests the correct url" do
+        expect(a_request(:get, "http://allrecipes.com/recipes/bread?page=&st=p")).to have_been_made
+      end
+
+      it "should return 20 recipes" do
+        expect(@recipes.count).to eq 20
+      end
+
+    end
+
+    context "non existent course" do
+      let(:nonexistent_course) { -> { subject.course("nonexistent") } }
+      it "should give appropriate error message" do
+        expect(nonexistent_course).to raise_error("Course type doesn't exist")
+      end
+    end
+
+  end
+
+  describe "#region" do
+    context "without options main region" do
+      before do
+        VCR.use_cassette "region" do
+          @recipes = subject.region("asian")
+        end
+      end
+
+      it "requests the correct url" do
+        expect(a_request(:get, "http://allrecipes.com/recipes/world-cuisine/asian?page=&st=p")).to have_been_made
+      end
+
+      it "should return 20 recipes" do
+        expect(@recipes.count).to eq 20
+      end
+
+    end
+
+    context "without options sub region" do
+
+      before do
+        VCR.use_cassette "sub_region" do
+          @recipes = subject.region("chinese")
+        end
+      end
+
+      it "requests the correct url" do
+        expect(a_request(:get, "http://allrecipes.com/recipes/world-cuisine/asian/chinese?page=&st=p")).to have_been_made
+      end
+
+      it "should return 20 recipes" do
+        expect(@recipes.count).to eq 20
+      end
+
+    end
+
+    context "non existent region" do
+      let(:nonexistent_region) { -> { subject.region("nonexistent") } }
+      it "should give appropriate error message" do
+        expect(nonexistent_region).to raise_error("Region doesn't exist")
+      end
+    end
+  end
+
+  describe "#ingredient" do
+    context "without options" do
+      before do
+        VCR.use_cassette "ingredients" do
+          @recipes = subject.ingredient("apples")
+        end
+      end
+
+      it "requests the correct url" do
+        expect(a_request(:get, "http://allrecipes.com/search/?wt=apples&page=&sb=re")).to have_been_made
+      end
+
+      it "should return 21 recipes" do
+        expect(@recipes.count).to eq 21
+      end
+
+      its "recipes should include apple" do
+        expect(@recipes.first[:ingredients].select{ |ingredient| ingredient["name"].include?("apples") }.count).to eq 1
+      end
+
+    end
+
+    context "no recipes for ingredient" do
+      let(:nonexistent_ingredient) { -> { subject.ingredient("nonexistent") } }
+      it "should give appropriate error message" do
+        expect(nonexistent_ingredient).to raise_error("Could not find recipes that include this ingredient")
+      end
+    end
+  end
+
+end

data/spec/fixtures/recipe.json

@@ -0,0 +1,128 @@
+{
+  {
+    "name": "Ravioli",
+    "image": "http://placehold.it/350x150",
+    servings: 5,
+    ingredients: [],
+    directions: []
+  },
+  {
+    "name": "Ravioli",
+    "image": "http://placehold.it/350x150",
+    servings: 5,
+    ingredients: [],
+    directions: []
+  },
+  {
+    "name": "Ravioli",
+    "image": "http://placehold.it/350x150",
+    servings: 5,
+    ingredients: [],
+    directions: []
+  },
+  {
+    "name": "Ravioli",
+    "image": "http://placehold.it/350x150",
+    servings: 5,
+    ingredients: [],
+    directions: []
+  },
+  {
+    "name": "Ravioli",
+    "image": "http://placehold.it/350x150",
+    servings: 5,
+    ingredients: [],
+    directions: []
+  },
+  {
+    "name": "Ravioli",
+    "image": "http://placehold.it/350x150",
+    servings: 5,
+    ingredients: [],
+    directions: []
+  },
+  {
+    "name": "Ravioli",
+    "image": "http://placehold.it/350x150",
+    servings: 5,
+    ingredients: [],
+    directions: []
+  },
+  {
+    "name": "Ravioli",
+    "image": "http://placehold.it/350x150",
+    servings: 5,
+    ingredients: [],
+    directions: []
+  },
+  {
+    "name": "Ravioli",
+    "image": "http://placehold.it/350x150",
+    servings: 5,
+    ingredients: [],
+    directions: []
+  },
+  {
+    "name": "Ravioli",
+    "image": "http://placehold.it/350x150",
+    servings: 5,
+    ingredients: [],
+    directions: []
+  },
+  {
+    "name": "Ravioli",
+    "image": "http://placehold.it/350x150",
+    servings: 5,
+    ingredients: [],
+    directions: []
+  },
+  {
+    "name": "Ravioli",
+    "image": "http://placehold.it/350x150",
+    servings: 5,
+    ingredients: [],
+    directions: []
+  },
+  {
+    "name": "Ravioli",
+    "image": "http://placehold.it/350x150",
+    servings: 5,
+    ingredients: [],
+    directions: []
+  },
+  {
+    "name": "Ravioli",
+    "image": "http://placehold.it/350x150",
+    servings: 5,
+    ingredients: [],
+    directions: []
+  },
+  {
+    "name": "Ravioli",
+    "image": "http://placehold.it/350x150",
+    servings: 5,
+    ingredients: [],
+    directions: []
+  },
+  {
+    "name": "Ravioli",
+    "image": "http://placehold.it/350x150",
+    servings: 5,
+    ingredients: [],
+    directions: []
+  },
+  {
+    "name": "Ravioli",
+    "image": "http://placehold.it/350x150",
+    servings: 5,
+    ingredients: [],
+    directions: []
+  },
+  {
+    "name": "Ravioli",
+    "image": "http://placehold.it/350x150",
+    servings: 5,
+    ingredients: [],
+    directions: []
+  }
+}

data/spec/page_parser_spec.rb

@@ -0,0 +1,15 @@
+require 'spec_helper'
+describe PageParser do
+  before do
+    VCR.use_cassette "page" do
+      url = "http://allrecipes.com/recipes"
+      page = Mechanize.new.get(url)
+      @parser = PageParser.new(page)
+    end
+  end
+
+  it "should have the right amount of recipes" do
+    expect(@parser.recipes.count).to eq 20
+  end
+
+end

data/spec/recipe_filter_spec.rb

@@ -0,0 +1,230 @@
+require 'spec_helper'
+describe Allrecipes do
+  subject { Allrecipes.new }
+  describe "options" do
+    context "limit" do
+      describe "valid limit" do
+        before do
+          VCR.use_cassette "valid_limit" do
+            @all_recipes = subject.all({limit: 10})
+            @region_recipes = subject.region("asian", {limit: 10})
+            @course_recipes = subject.course("bread", {limit: 10})
+            @ingredient_recipes = subject.ingredient("apples", {limit: 10})
+          end
+        end
+
+        it "should restrict recipes to 10" do
+          expect(@all_recipes.count).to eq 10
+          expect(@region_recipes.count).to eq 10
+          expect(@course_recipes.count).to eq 10
+          expect(@ingredient_recipes.count).to eq 10
+        end
+      end
+    end
+
+    context "page" do
+      describe "valid page" do
+        before do
+          VCR.use_cassette "valid_pages" do
+            @all_recipes = subject.all({page: 2})
+            @all_recipes_initial = subject.all
+
+            @region_recipes = subject.region("asian", {page: 3})
+            @region_recipes_initial = subject.region("asian")
+
+            @course_recipes = subject.course("bread", {page: 4})
+            @course_recipes_initial = subject.course("bread")
+
+            @ingredient_recipes = subject.ingredient("apples", {page: 5})
+            @ingredient_recipes_intiial = subject.ingredient("apples")
+          end
+        end
+
+        it "should call the correct urls" do
+          expect(a_request(:get, "http://allrecipes.com/recipes?page=2&st=p")).to have_been_made
+          expect(a_request(:get, "http://allrecipes.com/recipes/world-cuisine/asian?page=3&st=p")).to have_been_made
+          expect(a_request(:get, "http://allrecipes.com/recipes/bread?page=4&st=p")).to have_been_made
+          expect(a_request(:get, "http://allrecipes.com/search/?wt=apples&page=5&sb=re")).to have_been_made
+        end
+
+        its "results should be different from the initial page" do
+          expect(@all_recipes).to_not eq @all_recipes_initial
+          expect(@region_recipes).to_not eq @region_recipes_initial
+          expect(@course_recipes).to_not eq @course_recipes_initial
+          expect(@ingredient_recipes).to_not eq @ingredient_recipes_initial
+        end
+      end
+
+      describe "invalid page" do
+        before do
+          VCR.use_cassette "invalid page" do
+            @all_recipes = subject.all({ page: 10000 })
+            @region_recipes = subject.region("asian", { page: 10000 })
+            @course_recipes = subject.course("bread", { page: 10000 })
+            @ingredient_recipes = subject.ingredient("apples", { page: 10000 })
+          end
+        end
+
+        it "should call correct url" do
+          expect(a_request(:get, "http://allrecipes.com/recipes?page=10000&st=p")).to have_been_made
+          expect(a_request(:get, "http://allrecipes.com/recipes/world-cuisine/asian?page=10000&st=p")).to have_been_made
+          expect(a_request(:get, "http://allrecipes.com/recipes/bread?page=10000&st=p")).to have_been_made
+          expect(a_request(:get, "http://allrecipes.com/search/?wt=apples&page=10000&sb=re")).to have_been_made
+        end
+
+        it "should return an empty array" do
+          expect(@all_recipes).to eq []
+          expect(@region_recipes).to eq []
+          expect(@course_recipes).to eq []
+          expect(@ingredient_recipes).to eq []
+        end
+      end
+    end
+
+    context "sort by" do
+      describe "valid sort" do
+        before do
+          VCR.use_cassette "default search" do
+              @all_recipes_initial = subject.all
+              @region_recipes_initial = subject.region("asian")
+              @course_recipes_initial = subject.course("bread")
+              @ingredient_recipes_initial = subject.ingredient("apples")
+          end
+        end
+        context "popularity" do
+          before do
+            VCR.use_cassette "popularity_sort" do
+              @all_recipes = subject.all({ sort_by: "popularity" })
+
+              @region_recipes = subject.region("asian", { sort_by: "popularity"})
+              @course_recipes = subject.course("bread", { sort_by: "popularity"})
+              @ingredient_recipes = subject.ingredient("apples", { sort_by: "popularity"})
+            end
+          end
+
+          it "should call the correct URLs" do
+            expect(a_request(:get, "http://allrecipes.com/recipes?page=&st=p")).to have_been_made.times(2)
+            expect(a_request(:get, "http://allrecipes.com/recipes/world-cuisine/asian?page=&st=p")).to have_been_made.times(2)
+            expect(a_request(:get, "http://allrecipes.com/recipes/bread?page=&st=p")).to have_been_made.times(2)
+            expect(a_request(:get, "http://allrecipes.com/search/?wt=apples&page=&sb=re")).to have_been_made
+
+          end
+
+          it "should have the correct count of recipes" do
+            expect(@all_recipes.count).to eq 20
+            expect(@region_recipes.count).to eq 20
+            expect(@course_recipes.count).to eq 20
+            expect(@ingredient_recipes.count).to eq 21
+          end
+
+          its "default search should be popularity" do
+            expect(@all_recipes).to eq @all_recipes_initial
+            expect(@region_recipes).to eq @region_recipes_initial
+            expect(@course_recipes).to eq @course_recipes_initial
+          end
+
+          it "should search for recipes based on ingredients sorted by popularity" do
+            expect(@ingredient_recipes).to_not eq @ingredient_recipes_initial
+          end
+        end
+
+        context "date" do
+          before do
+            VCR.use_cassette "date_sort" do
+              @all_recipes = subject.all({ sort_by: "date" })
+
+              @region_recipes = subject.region("asian", { sort_by: "date"})
+              @course_recipes = subject.course("bread", { sort_by: "date"})
+            end
+          end
+
+          it "should call the correct URLs" do
+            expect(a_request(:get, "http://allrecipes.com/recipes?page=&st=n")).to have_been_made
+            expect(a_request(:get, "http://allrecipes.com/recipes/world-cuisine/asian?page=&st=n")).to have_been_made
+            expect(a_request(:get, "http://allrecipes.com/recipes/bread?page=&st=n")).to have_been_made
+          end
+
+          it "should have the correct count of recipes" do
+            expect(@all_recipes.count).to eq 20
+            expect(@region_recipes.count).to eq 20
+            expect(@course_recipes.count).to eq 20
+          end
+
+          it "should be different than default search" do
+            expect(@all_recipes).to_not eq @all_recipes_initial
+            expect(@region_recipes).to_not eq @region_recipes_initial
+            expect(@course_recipes).to_not eq @course_recipes_initial
+          end
+        end
+        context "title" do
+          before do
+            VCR.use_cassette "title_sort" do
+              @all_recipes = subject.all({ sort_by: "title" })
+
+              @region_recipes = subject.region("asian", { sort_by: "title"})
+              @course_recipes = subject.course("bread", { sort_by: "title"})
+            end
+          end
+
+          it "should call the correct URLs" do
+            expect(a_request(:get, "http://allrecipes.com/recipes?page=&st=t")).to have_been_made
+            expect(a_request(:get, "http://allrecipes.com/recipes/world-cuisine/asian?page=&st=t")).to have_been_made
+            expect(a_request(:get, "http://allrecipes.com/recipes/bread?page=&st=t")).to have_been_made
+          end
+
+          it "should have the correct count of recipes" do
+            expect(@all_recipes.count).to eq 20
+            expect(@region_recipes.count).to eq 20
+            expect(@course_recipes.count).to eq 20
+          end
+
+          it "should be different than default search" do
+            expect(@all_recipes).to_not eq @all_recipes_initial
+            expect(@region_recipes).to_not eq @region_recipes_initial
+            expect(@course_recipes).to_not eq @course_recipes_initial
+          end
+        end
+        context "Relevance for ingredient search" do
+          before do
+            VCR.use_cassette "relevance_sort" do
+              @ingredient_recipes = subject.ingredient("apples",{ sort_by: "relevance" })
+            end
+          end
+
+          it "should call the correct URL" do
+            expect(a_request(:get, "http://allrecipes.com/search/?wt=apples&page=&sb=re")).to have_been_made.times(2)
+          end
+
+          it "should have the correct count of recipes" do
+            expect(@ingredient_recipes.count).to eq 21
+          end
+
+          it "should be the same as default search" do
+            recipe_names = @ingredient_recipes.map{ |ing| ing[:name] }.sort
+            initial_recipe_names = @ingredient_recipes_initial.map{ |ing| ing[:name] }.sort
+            expect(recipe_names).to eq initial_recipe_names@ingredient_recipes_initial
+          end
+        end
+        context "Rating sort for ingredient search" do
+          before do
+            VCR.use_cassette "rating_sort" do
+              @ingredient_recipes = subject.ingredient("apples",{ sort_by: "rating" })
+            end
+          end
+
+          it "should call the correct URL" do
+            expect(a_request(:get, "http://allrecipes.com/search/?wt=apples&page=&sb=ra")).to have_been_made
+          end
+
+          it "should have the correct count of recipes" do
+            expect(@ingredient_recipes.count).to eq 21
+          end
+
+          it "should be different from default search" do
+            expect(@ingredient_recipes).to_not eq @ingredient_recipes_initial
+          end
+        end
+      end
+    end
+  end
+end

data/spec/recipe_parser_spec.rb

@@ -0,0 +1,53 @@
+require 'spec_helper'
+describe RecipeParser do
+  before do
+    VCR.use_cassette "recipe" do
+      url = "/Recipe/Worlds-Best-Lasagna/"
+      @recipe = RecipeParser.new(url).recipe
+    end
+  end
+
+  it "should have the right name" do
+    expect(@recipe[:name]).to eq "World's Best Lasagna"
+  end
+
+  it "should have the right image url" do
+    expect(@recipe[:image]).to eq "http://images.media-allrecipes.com/userphotos/250x250/00/03/24/32427.jpg"
+  end
+
+  it "should have the right amount of servings" do
+    expect(@recipe[:servings]).to eq 12
+  end
+
+  context "ingredients" do
+
+    it "should have the right amount of ingredients" do
+      expect(@recipe[:ingredients].count).to eq 21
+    end
+    it "should have the right quantity" do
+      expect(@recipe[:ingredients].first["quantity"]).to eq 1
+    end
+    it "should have the right unit" do
+      expect(@recipe[:ingredients].first["unit"]).to eq "pound"
+    end
+    it "should have the right name" do
+      expect(@recipe[:ingredients].first["name"]).to eq "sweet Italian sausage"
+    end
+
+  end
+
+  it "should have the right amount of directions" do
+    expect(@recipe[:directions].count).to eq 5
+  end
+
+  it "should return a formatted recipe" do
+    expected_output = {
+      name: @recipe[:name],
+      image: @recipe[:image],
+      servings: @recipe[:servings],
+      ingredients: @recipe[:ingredients],
+      directions: @recipe[:directions]
+    }
+    expect(@recipe).to eq expected_output
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,18 @@
+require 'allrecipes'
+require 'vcr'
+require 'webmock/rspec'
+
+VCR.configure do |c|
+  c.cassette_library_dir = 'spec/fixtures/vcr_cassettes'
+  c.hook_into :webmock
+end
+
+def fixture_path
+  File.expand_path('../fixtures', __FILE__)
+end
+
+def fixture(file)
+  File.new(fixture_path + '/' + file)
+end
+
+

metadata

@@ -0,0 +1,167 @@
+--- !ruby/object:Gem::Specification
+name: allrecipes
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- shivamd
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-06-09 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: mechanize
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !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: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  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: vcr
+  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'
+description: A Ruby wrapper for allrecipes.com. A simple interface to scrape recipes
+  from allrecipes.com
+email:
+- daryananis@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- allrecipes.gemspec
+- lib/allrecipes.rb
+- lib/allrecipes/main.rb
+- lib/allrecipes/page_parser.rb
+- lib/allrecipes/recipe_parser.rb
+- lib/allrecipes/url_helper.rb
+- lib/allrecipes/version.rb
+- spec/allrecipes_spec.rb
+- spec/fixtures/recipe.json
+- spec/page_parser_spec.rb
+- spec/recipe_filter_spec.rb
+- spec/recipe_parser_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/shivamd/allrecipes
+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.6
+signing_key: 
+specification_version: 4
+summary: A Ruby wrapper for allrecipes.com
+test_files:
+- spec/allrecipes_spec.rb
+- spec/fixtures/recipe.json
+- spec/page_parser_spec.rb
+- spec/recipe_filter_spec.rb
+- spec/recipe_parser_spec.rb
+- spec/spec_helper.rb