groupon2 0.0.1

data/.gitignore

@@ -0,0 +1,9 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+*.swp
+*.swo
+coverage
+doc
+.yardoc

data/Gemfile

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

data/Rakefile

@@ -0,0 +1,2 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks

data/groupon2.gemspec

@@ -0,0 +1,34 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "groupon/version"
+
+Gem::Specification.new do |s|
+  s.name        = "groupon2"
+  s.version     = Groupon::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Josh Deeden"]
+  s.email       = ["jdeeden@gmail.com"]
+  s.homepage    = ""
+  s.summary     = %q{A wrapper for the Groupon v2 API}
+  s.description = %q{A wrapper for the Groupon v2 API}
+
+  s.rubyforge_project = "groupon2"
+  s.add_development_dependency('rake', '~> 0.8')
+  s.add_development_dependency('rspec', '~> 2.5')
+  s.add_development_dependency('simplecov', '~> 0.4')
+  s.add_development_dependency('vcr', '~> 1.7.0')
+  s.add_development_dependency('fakeweb')
+  s.add_development_dependency('yard', '~> 0.6')
+  s.add_development_dependency('maruku', '~> 0.6')
+  s.add_runtime_dependency("faraday", '~> 0.5.7')
+  s.add_runtime_dependency("faraday_middleware", '~> 0.3.2')
+  s.add_runtime_dependency("typhoeus", '~> 0.2.4')
+  s.add_runtime_dependency('hashie', '~> 1.0.0')
+  s.add_runtime_dependency('yajl-ruby', '~> 0.8.1')
+  s.add_runtime_dependency('multi_json', '~> 0.0.5')
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+end

data/lib/core_ext/array.rb

@@ -0,0 +1,5 @@
+class Array
+  def extract_options!
+    last.is_a?(::Hash) ? pop : {}
+  end
+end

data/lib/groupon.rb

@@ -0,0 +1,85 @@
+require 'faraday'
+require 'faraday_middleware'
+require 'core_ext/array'
+require 'yajl'
+
+module Groupon
+  class Client
+    attr_reader :api_key, :conn
+
+    # Initialize the client.
+    # TODO:  Document.
+    def initialize(*args)
+      options = args.extract_options!
+      @api_key = args[0]
+      @conn = Faraday.new(:url => "http://api.groupon.com/") do |builder|
+        builder.adapter Faraday.default_adapter
+        builder.adapter  :logger if options[:debug] == true
+        builder.use Faraday::Response::ParseJson
+        builder.use Faraday::Response::Mashify
+      end
+    end
+
+    # @overload deals(options={})
+    #   Search for Deals
+    #   @param [Hash] options A customizable set of options
+    #   @option options [String] :lat Latitude of point to to sort deals by proximity to. Use with lon.  Uses radius.
+    #   @option options [String] :lon Longitude of point to to sort deals by proximity to. Use with lat.  Uses radius.
+    #   @option options [Fixnum] :radius Maximum distance of radius in miles to deal location from center point. Defaults to 10. Requires lat and lon
+    #   @option options [String] :divisions One or more division slugs (comma separated). See Divisions API for more details.
+    #   @option options [String] :source One or more source slugs (comma separated). See Sources API for more details.
+    #   @option options [String] :phone Deals available at a business matching one of the phone numbers. See Businesses API for more details.
+    #   @option options [String] :tag One or more tag slugs (comma separated). See Tags API for more details. Note: Specifying multiple tags returns deals matching any one of the tags, NOT all of them
+    #   @option options [Boolean] :paid Shows deals filtered on paid status.  Defaults to false. Set to true if you would like to see all deals.
+    #   @return [Array] An array of Hashie::Mash objects representing Groupon deals
+    #   @example Search deals by latitude and longitude
+    #       client.deals(:lat => "-37.74", :lon => "-76.00")
+    #   @example Search deals within a 2 miles radius of latitude and longitude
+    #       client.deals(:lat => "-37.74", :lon => "-76.00", :radius => 2)
+    #   @example Search deals from Groupon
+    #       client.deals(:source => "Groupon")
+    #   @example Search deals based on phone number
+    #       client.deals(:phone => "7185551212")
+    #   @example Search deals based on tags
+    #       client.deals(:tag => "restaurants,spa")
+    #   @example Search deals based on paid status. (Defaults to false)
+    #       client.deals(:paid => true)
+    # @overload deals(deal_id)
+    #   Get deal details
+    #   @param [Fixnum] deal_id A Deal Id
+    #   @return [Hashie::Mash] A Hashie::Mash object representing a Groupon deal
+    def deals(*args)
+      super
+    end
+
+    # @overload sources(options={})
+    #   Search for sources
+    #   @param [Hash] options A customizable set of options
+    #   @option options [String] :division One or more division slugs. See Divisions API for more details. Note: Specifying multiple divisions returns sources that exist in either of the divisions, NOT all of them.
+    #   @option options [String] :paid When paid is true, only paid sources are returned. Defaults to false.
+    # @overload sources(source_id)
+    #   Get source details
+    #   @param [String] slug A source slug
+    #   @return [Hashie::Mash] A Hashie::Mash object representing a Groupon Deal Source
+    def sources(*args)
+      super
+    end
+
+    # @overload tags(options={})
+    #   This method returns a list of all tags. There are no parameters specific to tags.
+    #   @param [Hash] options A customizable set of options
+    #   @return [Array] An array of Hashie::Mash objects representing Groupon tags.
+    def tags(*args)
+      super
+    end
+    def divisions(*args)
+      super
+    end
+
+    def method_missing(sym, *args, &block)
+      options = args.extract_options!.merge(:client_id => api_key)
+      response = conn.get("/v2/#{sym.to_s}/#{args[0]}") { |req| req.params = options  }
+      args[0].nil? ? response.body.send(sym) : response.body.send(sym.to_s.chop)
+    end
+  end
+end

data/lib/groupon/version.rb

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

data/spec/client/client_spec.rb

@@ -0,0 +1,9 @@
+require File.expand_path('../../spec_helper', __FILE__)
+describe Groupon::Client do
+  context "api" do
+    before(:all) do
+      api_key="39666de32f9626a0241f676db703795a9b0277cc"
+      @client = Groupon::Client.new(api_key)
+    end
+  end
+end

data/spec/deals/deals_spec.rb

@@ -0,0 +1,63 @@
+require File.expand_path('../../spec_helper', __FILE__)
+
+describe Groupon::Client do
+  context "api" do
+    before(:all) do
+      @client = Groupon::Client.new(API_KEY)
+    end
+    context "deals" do
+      context "search" do
+        context "with no args" do
+          use_vcr_cassette
+          before(:all) do
+            @deals = @client.deals
+          end
+          subject { @deals }
+          it { should_not be_nil }
+          it { should be_an(Array) }
+          it { should have_at_least(1).items }
+        end
+        context "with Brooklyn, NY lat/long" do
+          before(:all) do
+            @deals = @client.deals(:lat => "40.7325859", :lng => "-73.9568557")
+          end
+          subject { @deals }
+          it { should_not be_nil }
+          subject { @deals.first.division.name }
+          it { should eql "New York City" }
+          subject { @deals.last.division.name }
+          it { should eql "New York City" }
+        end
+        # TODO:  Better test.
+        context "with Brooklyn, NY lat/long, scoped to a 10 mile radius" do
+          before(:all) do
+            @deals = @client.deals(:lat => "40.7325859", :lng => "-73.9568557", :radius => 10)
+          end
+          subject { @deals }
+          it { should_not be_nil }
+          subject { @deals.first.division.name }
+          it { should eql "New York City" }
+          subject { @deals.last.division.name }
+          it { should eql "New York City" }
+        end
+      end
+      context "details" do
+        before(:all) do
+          @deal = @client.deals("museum-of-modern-art")
+          puts "deal: #{@deal.inspect}"
+        end
+        subject { @deal }
+        it { should_not be_nil }
+        it { should be_a(Hashie::Mash) }
+        it { should respond_to(:id) }
+        it { should respond_to(:title) }
+        it { should respond_to(:merchant) }
+        it { should respond_to(:endAt) }
+        it { should respond_to(:type) }
+        it { should respond_to(:areas) }
+        # etc...
+      end
+    end
+  end
+end
+

data/spec/divisions/divisions_spec.rb

@@ -0,0 +1,25 @@
+require File.expand_path('../../spec_helper', __FILE__)
+
+describe Groupon::Client do
+  context "api" do
+    before(:all) do
+      @client = Groupon::Client.new(API_KEY)
+    end
+    context "divisions" do
+      context "search divisions" do
+        # use_vcr_cassette
+        context "all" do
+          before(:all) do
+            @divisions = @client.divisions
+            puts @divisions.inspect
+          end
+          context "the results" do
+            subject { @divisions }
+            specify { should_not be_nil }
+            specify { should have_at_least(1).items }
+          end
+        end
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,23 @@
+require 'simplecov'
+
+SimpleCov.start do
+  add_group 'Groupon', 'lib/groupon'
+  add_group 'Specs', 'spec'
+end
+
+require File.expand_path('../../lib/groupon', __FILE__)
+require 'rubygems'
+require 'rspec'
+require 'vcr'
+
+VCR.config do |c|
+  c.cassette_library_dir = 'spec/cassettes'
+  c.stub_with                :typhoeus
+  c.default_cassette_options = { :record => :new_episodes }
+end
+
+RSpec.configure do |c|
+  c.extend VCR::RSpec::Macros
+end
+
+API_KEY="39666de32f9626a0241f676db703795a9b0277cc"

metadata

@@ -0,0 +1,212 @@
+--- !ruby/object:Gem::Specification 
+name: groupon2
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: 0.0.1
+platform: ruby
+authors: 
+- Josh Deeden
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-03-29 00:00:00 -04:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rake
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: "0.8"
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: "2.5"
+  type: :development
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: simplecov
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: "0.4"
+  type: :development
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: vcr
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 1.7.0
+  type: :development
+  version_requirements: *id004
+- !ruby/object:Gem::Dependency 
+  name: fakeweb
+  prerelease: false
+  requirement: &id005 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :development
+  version_requirements: *id005
+- !ruby/object:Gem::Dependency 
+  name: yard
+  prerelease: false
+  requirement: &id006 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: "0.6"
+  type: :development
+  version_requirements: *id006
+- !ruby/object:Gem::Dependency 
+  name: maruku
+  prerelease: false
+  requirement: &id007 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: "0.6"
+  type: :development
+  version_requirements: *id007
+- !ruby/object:Gem::Dependency 
+  name: faraday
+  prerelease: false
+  requirement: &id008 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 0.5.7
+  type: :runtime
+  version_requirements: *id008
+- !ruby/object:Gem::Dependency 
+  name: faraday_middleware
+  prerelease: false
+  requirement: &id009 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 0.3.2
+  type: :runtime
+  version_requirements: *id009
+- !ruby/object:Gem::Dependency 
+  name: typhoeus
+  prerelease: false
+  requirement: &id010 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 0.2.4
+  type: :runtime
+  version_requirements: *id010
+- !ruby/object:Gem::Dependency 
+  name: hashie
+  prerelease: false
+  requirement: &id011 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 1.0.0
+  type: :runtime
+  version_requirements: *id011
+- !ruby/object:Gem::Dependency 
+  name: yajl-ruby
+  prerelease: false
+  requirement: &id012 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 0.8.1
+  type: :runtime
+  version_requirements: *id012
+- !ruby/object:Gem::Dependency 
+  name: multi_json
+  prerelease: false
+  requirement: &id013 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 0.0.5
+  type: :runtime
+  version_requirements: *id013
+description: A wrapper for the Groupon v2 API
+email: 
+- jdeeden@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- Rakefile
+- groupon2.gemspec
+- lib/core_ext/array.rb
+- lib/groupon.rb
+- lib/groupon/version.rb
+- spec/client/client_spec.rb
+- spec/deals/deals_spec.rb
+- spec/divisions/divisions_spec.rb
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: ""
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+requirements: []
+
+rubyforge_project: groupon2
+rubygems_version: 1.6.2
+signing_key: 
+specification_version: 3
+summary: A wrapper for the Groupon v2 API
+test_files: 
+- spec/client/client_spec.rb
+- spec/deals/deals_spec.rb
+- spec/divisions/divisions_spec.rb
+- spec/spec_helper.rb