vaporizer 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 19931f1173bb1426c8d52d9e184c1c8205e430d8
+  data.tar.gz: a613dcdc751e1b90835e23709128859fb11050c6
+SHA512:
+  metadata.gz: e1b558f5279c6976366d75e984d665918c9be861df3faef61c4255f774df97bf183f3dee17d39641e61a5b2d9ac8bf635a5d612eca4b5aee74c487a025d79405
+  data.tar.gz: 9c24aa296db539ee1e94f72d4ed26b09dfe29168b8d73bb814e59a0a19746906bf8b7e55ca48f3b5ee2fc585c5b8954799e20a4532d028887224f1bae8f2b96f

data/.gitignore

@@ -0,0 +1,28 @@
+*.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
+
+.DS_Store
+secrets.yml
+spec/fixtures/*.yml
+spec/fixtures/strains/*.yml
+spec/fixtures/locations/*.yml

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2015 Nicolas Florentin
+
+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,127 @@
+# Vaporizer
+
+Gem under construction
+
+Will cover all endpoints of new Leafly API
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'vaporizer'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install vaporizer
+    
+## Good to know
+
+Some things to know before using this gem:
+* This is my first gem, please be tolerant
+* Leafly API is kind of inconsistent and do not respect rules of JSON API standard, that's not my fault
+* Changes in Leafly API could break this gem, if it happens, do not hesitate to open an issue and I will fix it as fast as possible
+* Vaporizer returns pure parsed JSON and do not wrap results with objects
+* If you need more functionalities, do not hesitate to contact me and we will discuss it
+
+## Configuration
+
+```ruby
+require 'vaporizer'
+
+Vaporizer.configure do |config|
+  config.app_id = "YOUR_APP_ID"
+  config.app_key = "YOUR_APP_KEY"
+  config.timeout = 3 # timeout for the requests, optional, in seconds
+end
+```
+## Usage examples
+
+These examples are a bit minimalist but you can of course pass more arguments to the methods
+
+### Strains
+
+**search**
+```ruby
+Vaporizer::Strain.search(search: 'dream', page: 0, take: 10)
+```
+
+**more complex search**
+```ruby
+Vaporizer::Strain.search(
+    filters: {
+      flavors: ['blueberry'],
+      conditions: ['anxiety']
+    },
+    search: '',
+    page: 0, take: 10
+)
+```
+
+**details**
+```ruby
+Vaporizer::Strain.details('la-confidential') # argument is a slug of strain's name
+```
+
+**reviews**
+```ruby
+Vaporizer::Strain.reviews('la-confidential', { page: 0, take: 3 })
+```
+
+**review details**
+```ruby
+Vaporizer::Strain.review_details('la-confidential', 2836) # 2nd argument is the review id
+```
+
+**photos**
+```ruby
+Vaporizer::Strain.photos('la-confidential', { page: 0, take: 4 })
+```
+
+**availabilities**
+```ruby
+Vaporizer::Strain.availabilities('la-confidential', { lat: 33.5, lon: -117.6 })
+```
+
+### Locations
+
+**search**
+```ruby
+Vaporizer::Location.search(latitude: 47.606, longitude: -122.333, page: 0, take: 5)
+```
+
+**details**
+```ruby
+Vaporizer::Location.details('papa-ganja')
+```
+
+**menu**
+```ruby
+Vaporizer::Location.menu('papa-ganja')
+```
+
+**reviews**
+```ruby
+Vaporizer::Location.reviews('papa-ganja', { take: 3, skip: 0})
+```
+
+**specials**
+```ruby
+Vaporizer::Location.specials('papa-ganja')
+```
+
+## More options
+
+To have the list of all params and filters available of the Leafly API, please refer to
+the <a href="https://developer.leafly.com/docs">official documentation</a>
+
+## Contributing
+
+1. Fork it ( https://github.com/[my-github-username]/vaporizer/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request

data/Rakefile

@@ -0,0 +1,2 @@
+require "bundler/gem_tasks"
+

data/lib/vaporizer.rb

@@ -0,0 +1,33 @@
+require 'vaporizer/strain'
+require 'vaporizer/location'
+require 'vaporizer/http_client'
+require 'vaporizer/validatable'
+require 'vaporizer/version'
+require 'vaporizer/error'
+
+module Vaporizer
+
+  class << self
+    attr_accessor :config
+  end
+
+  def self.configure
+    self.config ||= Config.new
+    yield config
+  end
+
+  class Config
+    attr_accessor :app_id, :app_key
+
+    def timeout=(sec)
+      Vaporizer::HttpClient.module_eval do
+        default_timeout sec
+      end
+    end
+
+    def initialize
+      @app_id = ""
+      @app_key = ""
+    end
+  end
+end

data/lib/vaporizer/error.rb

@@ -0,0 +1,10 @@
+module Vaporizer
+  class Error < StandardError; end
+
+  class ServerError < Error; end
+  class NotFound < ServerError; end
+
+  class ClientError < Error; end
+  class MissingPathParameter < Error; end
+  class MissingParameter < Error; end
+end

data/lib/vaporizer/http_client.rb

@@ -0,0 +1,76 @@
+require 'httparty'
+
+module Vaporizer
+  module HttpClient
+    include HTTParty
+
+    default_timeout 1
+    base_uri 'http://data.leafly.com'
+    headers 'Accept' => 'application/json', 'Accept-Encoding' => 'gzip, deflate'
+
+    def define_httparty_request_wrapper(name, method, route, extra_headers = {})
+      splited_route = split_route(route)
+      route_params_defined = extract_params_from_route(splited_route)
+      sub_paths = splited_route - route_params_defined
+
+      route_params_defined = strip_symbolize_route_params(route_params_defined)
+
+      define_singleton_method name do |params_given = {}, query_params = {}|
+        headers = { 'app_id' => Vaporizer.config.app_id,
+                    'app_key' => Vaporizer.config.app_key
+                  }.merge(extra_headers)
+
+        opts = { headers: headers }.merge(query_params)
+
+        params_values = get_route_params_values(route_params_defined, params_given)
+        built_path = build_path(sub_paths, params_values)
+
+        response = Vaporizer::HttpClient.send(method, built_path, opts)
+        handle_response(response)
+      end
+    end
+
+    def get_route_params_values(url_params, params_given)
+      params_values = []
+      url_params.each do |param|
+        if !params_given.keys.include?(param)
+          raise Vaporizer::MissingPathParameter, "Path parameter #{param} is missing"
+        else
+          params_values << params_given[param]
+        end
+      end
+      params_values
+    end
+
+    private
+    def handle_response(response)
+      if response.not_found?
+        raise Vaporizer::NotFound, "#{response.code}"
+      elsif response.client_error?
+        raise Vaporizer::ClientError, "#{response.code}"
+      elsif response.server_error?
+        raise Vaporizer::ServerError, "#{response.code}"
+      elsif response.success?
+        response.parsed_response
+      else
+        raise Vaporizer::Error, "#{response.code}"
+      end
+    end
+
+    def build_path(sub_paths, params_values)
+      sub_paths.zip(params_values).flatten.compact.join
+    end
+
+    def strip_symbolize_route_params(params_array)
+      params_array.map { |param| param[1..-1].to_sym }
+    end
+
+    def split_route(route)
+      route.split(/(:[a-z_]+)/)
+    end
+
+    def extract_params_from_route(splited_path)
+      splited_path.select { |e| e[0] == ':' }
+    end
+  end
+end

data/lib/vaporizer/location.rb

@@ -0,0 +1,39 @@
+require 'vaporizer/http_client'
+require 'vaporizer/validatable'
+
+module Vaporizer
+  module Location
+    extend Vaporizer::HttpClient
+    extend Vaporizer::Validatable
+
+    define_httparty_request_wrapper :locations_search, :post, '/locations'
+    define_httparty_request_wrapper :locations_show, :get, '/locations/:slug'
+    define_httparty_request_wrapper :locations_menu_index, :get, '/locations/:slug/menu'
+    define_httparty_request_wrapper :locations_reviews_index, :get, '/locations/:slug/reviews'
+    define_httparty_request_wrapper :locations_specials_index, :get, '/locations/:slug/specials'
+
+    def self.search(params = {})
+      validate_presence_of([:page, :take, :latitude, :longitude], params)
+      params = { body: params }
+      locations_search({}, params)
+    end
+
+    def self.details(slug)
+      locations_show(slug: slug)
+    end
+
+    def self.menu(slug)
+      locations_menu_index(slug: slug)
+    end
+
+    def self.reviews(slug, params = {})
+      validate_presence_of([:take, :skip], params)
+      params = { query: params }
+      locations_reviews_index({ slug: slug }, params)
+    end
+
+    def self.specials(slug)
+      locations_specials_index({ slug: slug})
+    end
+  end
+end

data/lib/vaporizer/strain.rb

@@ -0,0 +1,48 @@
+require 'vaporizer/http_client'
+require 'vaporizer/validatable'
+
+module Vaporizer
+  module Strain
+    extend Vaporizer::HttpClient
+    extend Vaporizer::Validatable
+
+    define_httparty_request_wrapper :strains_search, :post, '/strains'
+    define_httparty_request_wrapper :strains_show, :get, '/strains/:slug'
+    define_httparty_request_wrapper :strains_reviews_index, :get, '/strains/:slug/reviews'
+    define_httparty_request_wrapper :strains_reviews_show, :get, '/strains/:slug/reviews/:review_id'
+    define_httparty_request_wrapper :strains_photos_index, :get, '/strains/:slug/photos'
+    define_httparty_request_wrapper :strains_availabilities_index, :get, '/strains/:slug/availability'
+
+    def self.search(params = {})
+      validate_presence_of([:page, :take], params)
+      params = { body: params.to_json }
+      strains_search({}, params)
+    end
+
+    def self.details(slug)
+      strains_show(slug: slug)
+    end
+
+    def self.reviews(slug, params = {})
+      validate_presence_of([:page, :take], params)
+      params = { query: params }
+      strains_reviews_index({ slug: slug }, params)
+    end
+
+    def self.review_details(slug, review_id)
+      strains_reviews_show({ slug: slug, review_id: review_id })
+    end
+
+    def self.photos(slug, params = {})
+      validate_presence_of([:page, :take], params)
+      params = { query: params }
+      strains_photos_index({ slug: slug }, params)
+    end
+
+    def self.availabilities(slug, params = {})
+      validate_presence_of([:lat, :lon], params)
+      params = { query: params }
+      strains_availabilities_index({ slug: slug }, params)
+    end
+  end
+end

data/lib/vaporizer/validatable.rb

@@ -0,0 +1,13 @@
+require 'vaporizer/error'
+
+module Vaporizer
+  module Validatable
+    def validate_presence_of(keys, hash)
+      keys.each do |key|
+        unless hash.keys.include?(key)
+          raise Vaporizer::MissingParameter, "Missing param '#{key}'"
+        end
+      end
+    end
+  end
+end

data/lib/vaporizer/version.rb

@@ -0,0 +1,3 @@
+module Vaporizer
+  VERSION = "0.1.0"
+end

data/spec/spec_helper.rb

@@ -0,0 +1,10 @@
+require 'rspec'
+require 'vcr'
+require 'webmock/rspec'
+require 'vaporizer'
+
+VCR.configure do |config|
+  config.debug_logger = $stderr
+  config.hook_into :webmock
+  config.cassette_library_dir = "spec/fixtures"
+end

data/spec/vaporizer/http_client_spec.rb

@@ -0,0 +1,41 @@
+require 'spec_helper'
+
+describe Vaporizer::HttpClient do
+  before :all do
+    @api = Module.new
+    @api.class.extend(Vaporizer::HttpClient)
+    @api = @api.class
+  end
+
+  describe 'get_route_params_values(url_params, params_given)' do
+    it "should return empty array if there are not url params" do
+      expect(@api.get_route_params_values([],{})).to eq([])
+    end
+  end
+
+  describe 'get_route_params_values(url_params, params_given)' do
+    context "there are no missing params" do
+      it "should return values of params values" do
+        expect(@api.get_route_params_values([:strain_id], { strain_id: '123' })).to eq(['123'])
+      end
+    end
+
+    context "there is missing param" do
+      it "should raise an error" do
+        expect { @api.get_route_params_values([:strain_id], {}) }.to raise_error(Vaporizer::MissingPathParameter)
+      end
+    end
+  end
+
+  describe "call define_httparty_request_wrapper at class level" do
+    before :all do
+      @api.class_eval do
+        define_httparty_request_wrapper :test_method, :get, '/testUrl/:test'
+      end
+    end
+
+    it "should define the method" do
+      expect(@api).to respond_to(:test_method)
+    end
+  end
+end

data/spec/vaporizer/location_spec.rb

@@ -0,0 +1,177 @@
+require 'spec_helper'
+require 'yaml'
+
+secrets = YAML.load_file('./secrets.yml')
+
+describe Vaporizer::Location do
+
+  it { expect(Vaporizer::Location).to respond_to(:locations_search) }
+  it { expect(Vaporizer::Location).to respond_to(:locations_show) }
+  it { expect(Vaporizer::Location).to respond_to(:locations_menu_index) }
+  it { expect(Vaporizer::Location).to respond_to(:locations_reviews_index) }
+  it { expect(Vaporizer::Location).to respond_to(:locations_specials_index) }
+
+  before :all do
+    Vaporizer.configure do |config|
+      config.app_id = secrets['app_id']
+      config.app_key = secrets['app_key']
+    end
+
+    @location_slug = 'papa-ganja'
+
+    @non_existing_location_slug = "5d0e71bda1005d0770a4e31e1a27580"
+    VCR.use_cassette('locations/non-existing-details') do
+      begin
+        Vaporizer::Location.details(@non_existing_location_slug)
+      rescue Vaporizer::NotFound
+      end
+    end
+  end
+
+  describe '.search(params = {})' do
+    context "valid params" do
+      before :all do
+        @take = 3
+        VCR.use_cassette('locations/search-valid_params') do
+          @locations = Vaporizer::Location.search(latitude: 47.606, longitude: -122.333, page: 0, take: @take)
+        end
+      end
+
+      it 'should return a hash' do
+        VCR.use_cassette('locations/search-valid_params') do
+          expect(@locations.class).to be(Hash)
+        end
+      end
+
+      it "should return a hash with a key named 'stores'" do
+         VCR.use_cassette('locations/search-valid_params') do
+          expect(@locations).to have_key('stores')
+        end
+      end
+    end
+
+    context "missing params" do
+      it "should raise error Vaporizer::MissingParameter" do
+        expect { Vaporizer::Location.search(search: '', longitude: -122.333, page: 0, take: @take) }.to raise_error(Vaporizer::MissingParameter)
+      end
+
+      it "should raise error Vaporizer::MissingParameter" do
+        expect { Vaporizer::Location.search(search: '', latitude: 47.606, page: 0) }.to raise_error(Vaporizer::MissingParameter)
+      end
+    end
+  end
+
+  describe '.details(slug)' do
+    before :all do
+      VCR.use_cassette('locations/details') do
+        @location = Vaporizer::Location.details(@location_slug)
+      end
+    end
+
+    it 'should return a hash' do
+      VCR.use_cassette('locations/details') do
+        expect(@location.class).to be(Hash)
+      end
+    end
+
+    it "should return the specified store" do
+      VCR.use_cassette('locations/details') do
+        expect(@location['slug']).to eq(@location_slug)
+      end
+    end
+
+    it "should raise an error if store doesn't exist" do
+      expect do
+        VCR.use_cassette('locations/non-existing-details') do
+          Vaporizer::Location.details(@non_existing_location_slug)
+        end
+      end.to raise_error(Vaporizer::NotFound)
+    end
+  end
+
+  describe '.menu(slug)' do
+    before :all do
+      VCR.use_cassette('locations/menu') do
+        @menu = Vaporizer::Location.menu(@location_slug)
+      end
+    end
+
+    it 'should return a Array' do
+      VCR.use_cassette('locations/menu') do
+        expect(@menu.class).to be(Array)
+      end
+    end
+
+    it "should raise an error if store doesn't exist" do
+      expect do
+        VCR.use_cassette('locations/non-existing-menu') do
+          Vaporizer::Location.menu(@non_existing_location_slug)
+        end
+      end.to raise_error(Vaporizer::NotFound)
+    end
+  end
+
+  describe '.reviews(slug, params = {})' do
+    before :all do
+      VCR.use_cassette('locations/reviews') do
+        @reviews = Vaporizer::Location.reviews(@location_slug, { take: 1, skip: 0})
+      end
+    end
+
+    it 'should return a Array' do
+      VCR.use_cassette('locations/reviews') do
+        expect(@reviews.class).to be(Hash)
+      end
+    end
+
+    it 'should have key \'reviews\'' do
+      VCR.use_cassette('locations/reviews') do
+        expect(@reviews).to have_key('reviews')
+      end
+    end
+
+    it "should raise an error if store doesn't exist" do
+      expect do
+        VCR.use_cassette('locations/non-existing-reviews') do
+          Vaporizer::Location.reviews(@non_existing_location_slug, { take: 1, skip: 0})
+        end
+      end.to raise_error(Vaporizer::NotFound)
+    end
+
+    context "missing params" do
+      it "should raise error Vaporizer::MissingParameter" do
+        VCR.use_cassette('locations/reviews') do
+          expect { Vaporizer::Location.reviews(@location_slug, { take: 1}) }.to raise_error(Vaporizer::MissingParameter)
+        end
+      end
+
+      it "should raise error Vaporizer::MissingParameter" do
+        VCR.use_cassette('locations/reviews') do
+          expect { Vaporizer::Location.reviews(@location_slug, { skip: 0}) }.to raise_error(Vaporizer::MissingParameter)
+        end
+      end
+    end
+  end
+
+  describe '.specials(slug, params = {})' do
+    before :all do
+      VCR.use_cassette('locations/specials') do
+        @specials = Vaporizer::Location.specials(@location_slug)
+      end
+    end
+
+    it 'should return a Array' do
+      VCR.use_cassette('locations/specials') do
+        expect(@specials.class).to be(Array)
+      end
+    end
+
+    it "should raise an error if store doesn't exist" do
+      expect do
+        VCR.use_cassette('locations/non-existing-specials') do
+          Vaporizer::Location.specials(@non_existing_location_slug)
+        end
+      end.to raise_error(Vaporizer::NotFound)
+    end
+  end
+end

data/spec/vaporizer/strain_spec.rb

@@ -0,0 +1,336 @@
+require 'spec_helper'
+require 'yaml'
+
+secrets = YAML.load_file('./secrets.yml')
+
+describe Vaporizer::Strain do
+
+  it { expect(Vaporizer::Strain).to respond_to(:strains_search) }
+  it { expect(Vaporizer::Strain).to respond_to(:strains_show) }
+  it { expect(Vaporizer::Strain).to respond_to(:strains_reviews_index) }
+  it { expect(Vaporizer::Strain).to respond_to(:strains_reviews_show) }
+  it { expect(Vaporizer::Strain).to respond_to(:strains_photos_index) }
+  it { expect(Vaporizer::Strain).to respond_to(:strains_availabilities_index) }
+
+  before :all do
+    Vaporizer.configure do |config|
+      config.app_id = secrets['app_id']
+      config.app_key = secrets['app_key']
+    end
+
+    @strain_slug = 'la-confidential'
+    @non_existing_strain_slug = "5d0e71bda1005d0770a4e31e1a27580d"
+
+    VCR.use_cassette('strains/non-existing-details') do
+      begin
+        Vaporizer::Strain.details(@non_existing_strain_slug)
+      rescue Vaporizer::NotFound
+      end
+    end
+
+    VCR.use_cassette('strains/non-existing-reviews') do
+      begin
+        Vaporizer::Strain.reviews(@non_existing_strain_slug, page: 0, take: 1)
+      rescue Vaporizer::NotFound
+      end
+    end
+  end
+
+  describe '.search(params = {})' do
+    context "valid params" do
+      before :all do
+        @take = 10
+        VCR.use_cassette('strains/search-valid_params') do
+          @strains = Vaporizer::Strain.search(search: '', page: 0, take: @take)
+        end
+      end
+
+      it 'should return a hash' do
+        VCR.use_cassette('strains/search-valid_params') do
+          expect(@strains.class).to be(Hash)
+        end
+      end
+
+      it "should return a hash with a key named 'Strains'" do
+         VCR.use_cassette('strains/search-valid_params') do
+          expect(@strains).to have_key('Strains')
+        end
+      end
+
+      it "should return the right number of strains" do
+        VCR.use_cassette('strains/search-valid_params') do
+          expect(@strains['Strains'].size).to eq(@take)
+        end
+      end
+    end
+
+    context "missing params" do
+      it "should raise error Vaporizer::MissingParameter" do
+        expect { Vaporizer::Strain.search(search: '', page: 0) }.to raise_error(Vaporizer::MissingParameter)
+      end
+
+      it "should raise error Vaporizer::MissingParameter" do
+        expect { Vaporizer::Strain.search(search: '', take: 0) }.to raise_error(Vaporizer::MissingParameter)
+      end
+    end
+
+    context "a bit more complex search" do
+      before :all do
+        @flavor = 'blueberry'
+        @condition = 'anxiety'
+        VCR.use_cassette('strains/search-complex') do
+          @strains = Vaporizer::Strain.search(
+            filters: {
+              flavors: [@flavor],
+              conditions: [@condition]
+            },
+            search: '',
+            page: 0, take: 1
+          )
+        end
+      end
+
+      it 'should return a hash' do
+        VCR.use_cassette('strains/search-complex') do
+          expect(@strains.class).to be(Hash)
+        end
+      end
+
+      it "should return a hash with a key named 'Strains'" do
+        VCR.use_cassette('strains/search-complex') do
+          expect(@strains).to have_key('Strains')
+        end
+      end
+
+      it "should return strains with specified flavor" do
+        VCR.use_cassette('strains/search-complex') do
+          expect(
+            @strains["Strains"][0]['Flavors'].map { |flavor| flavor['Name'].downcase }
+          ).to include(@flavor)
+        end
+      end
+
+      it "should return strains with specified condition" do
+        VCR.use_cassette('strains/search-complex') do
+          expect(
+            @strains["Strains"][0]['Conditions'].map { |condition| condition['Name'].downcase }
+          ).to include(@condition)
+        end
+      end
+    end
+  end
+
+  describe '.details(slug)' do
+    before :all do
+      VCR.use_cassette('strains/details') do
+        @strain = Vaporizer::Strain.details(@strain_slug)
+      end
+    end
+
+    it 'should return a hash' do
+      VCR.use_cassette('strains/details') do
+        expect(@strain.class).to be(Hash)
+      end
+    end
+
+    it "should return the specified strain" do
+      VCR.use_cassette('strains/details') do
+        expect(@strain['slug']).to eq(@strain_slug)
+      end
+    end
+
+    it "should raise an error if strain doesn't exist" do
+      expect do
+        VCR.use_cassette('strains/non-existing-details') do
+          Vaporizer::Strain.details(@non_existing_strain_slug)
+        end
+      end.to raise_error(Vaporizer::NotFound)
+    end
+  end
+
+  describe '.reviews(slug, params = {})' do
+    context "valid params" do
+      before :all do
+        @take = 7
+        @page = 0
+        VCR.use_cassette('strains/reviews') do
+          @reviews = Vaporizer::Strain.reviews(@strain_slug, { page: @page, take: @take })
+        end
+      end
+
+      it 'should return a hash' do
+        VCR.use_cassette('strains/reviews') do
+          expect(@reviews.class).to be(Hash)
+        end
+      end
+
+      it "should return a hash with a key named 'reviews'" do
+         VCR.use_cassette('strains/reviews') do
+          expect(@reviews).to have_key('reviews')
+        end
+      end
+
+      it "should return the right number of reviews" do
+        VCR.use_cassette('strains/reviews') do
+          expect(@reviews['reviews'].size).to eq(@take)
+        end
+      end
+
+      it "should give paging context corresponding to sent params" do
+        VCR.use_cassette('strains/reviews') do
+          expect(@reviews['pagingContext']['PageIndex']).to eq(@page)
+        end
+      end
+
+      it "should give paging context corresponding to sent params" do
+        VCR.use_cassette('strains/reviews') do
+          expect(@reviews['pagingContext']['PageSize']).to eq(@take)
+        end
+      end
+
+      it "should raise an error if strain doesn't exist" do
+        expect do
+          VCR.use_cassette('strains/non-existing-reviews') do
+            Vaporizer::Strain.reviews(@non_existing_strain_slug, { page: 0, take: 1 })
+          end
+        end.to raise_error(Vaporizer::NotFound)
+      end
+    end
+
+    context "missing params" do
+      it "should raise error Vaporizer::MissingParameter" do
+        expect { Vaporizer::Strain.reviews(@strain_slug, { take: 2 }) }.to raise_error(Vaporizer::MissingParameter)
+      end
+
+      it "should raise error Vaporizer::MissingParameter" do
+        expect { Vaporizer::Strain.reviews(@strain_slug, { page: 1 }) }.to raise_error(Vaporizer::MissingParameter)
+      end
+    end
+  end
+
+  describe '.review_details(slug, review_id)' do
+    context "valid params" do
+      before :all do
+        @id = 2836
+        @strain_slug = @strain_slug
+        VCR.use_cassette('strains/review_details') do
+          @review = Vaporizer::Strain.review_details(@strain_slug, @id)
+        end
+      end
+
+      it 'should return a hash' do
+        VCR.use_cassette('strains/review_details') do
+          expect(@review.class).to be(Hash)
+        end
+      end
+
+      it 'should return the right review' do
+        VCR.use_cassette('strains/review_details') do
+          expect(@review['id']).to eq(@id)
+        end
+      end
+
+      it 'should correspond to the right strain' do
+        VCR.use_cassette('strains/review_details') do
+          expect(@review['strainSlug']).to eq(@strain_slug)
+        end
+      end
+    end
+  end
+
+  describe '.photos(slug, params = {})' do
+    context "valid params" do
+      before :all do
+        @take = 7
+        @page = 0
+        VCR.use_cassette('strains/photos') do
+          @photos = Vaporizer::Strain.photos(@strain_slug, { page: @page, take: @take })
+        end
+      end
+
+      it 'should return a hash' do
+        VCR.use_cassette('strains/photos') do
+          expect(@photos.class).to be(Hash)
+        end
+      end
+
+      it "should return a hash with a key named 'photos'" do
+         VCR.use_cassette('strains/photos') do
+          expect(@photos).to have_key('photos')
+        end
+      end
+
+      it "should return the right number of reviews" do
+        VCR.use_cassette('strains/photos') do
+          expect(@photos['photos'].size).to eq(@take)
+        end
+      end
+
+      it "should give paging context corresponding to sent params" do
+        VCR.use_cassette('strains/photos') do
+          expect(@photos['pagingContext']['PageIndex']).to eq(@page)
+        end
+      end
+
+      it "should give paging context corresponding to sent params" do
+        VCR.use_cassette('strains/photos') do
+          expect(@photos['pagingContext']['PageSize']).to eq(@take)
+        end
+      end
+
+      context "missing params" do
+        it "should raise error Vaporizer::MissingParameter" do
+          expect { Vaporizer::Strain.photos(@strain_slug, { take: 2 }) }.to raise_error(Vaporizer::MissingParameter)
+        end
+
+        it "should raise error Vaporizer::MissingParameter" do
+          expect { Vaporizer::Strain.photos(@strain_slug, { page: 1 }) }.to raise_error(Vaporizer::MissingParameter)
+        end
+      end
+
+      it "should raise an error if strain doesn't exist" do
+        expect do
+          VCR.use_cassette('strains/non-existing-photos') do
+            Vaporizer::Strain.photos(@non_existing_strain_slug, { page: 0, take: 1 })
+          end
+        end.to raise_error(Vaporizer::NotFound)
+      end
+    end
+  end
+
+  describe '.availabilities(slug, params = {})' do
+    context "valid params" do
+      before :all do
+        @take = 7
+        @page = 0
+        VCR.use_cassette('strains/availabilities') do
+          @availabilities = Vaporizer::Strain.availabilities(@strain_slug, { lat: 50, lon: 50 })
+        end
+      end
+
+      it 'should return an array' do
+        VCR.use_cassette('strains/availabilities') do
+          expect(@availabilities.class).to be(Array)
+        end
+      end
+
+      context "missing params" do
+        it "should raise error Vaporizer::MissingParameter" do
+          expect { Vaporizer::Strain.availabilities(@strain_slug, { lat: 0 }) }.to raise_error(Vaporizer::MissingParameter)
+        end
+
+        it "should raise error Vaporizer::MissingParameter" do
+          expect { Vaporizer::Strain.availabilities(@strain_slug, { lon: 0 }) }.to raise_error(Vaporizer::MissingParameter)
+        end
+      end
+
+      it "should raise error if strain doesn't exist" do
+        expect do
+          VCR.use_cassette('strains/non-existing-availabilities') do
+            Vaporizer::Strain.availabilities(@non_existing_strain_slug, { lat: 0, lon: 0 })
+          end
+        end.to raise_error(Vaporizer::NotFound)
+      end
+    end
+  end
+end

data/spec/vaporizer_spec.rb

@@ -0,0 +1,15 @@
+require 'spec_helper'
+
+describe Vaporizer do
+  it { expect(Vaporizer).to respond_to(:configure) }
+
+  context "after configure" do
+    before :all do
+      Vaporizer.configure do |config|
+      end
+    end
+
+    it { expect(Vaporizer.config).to respond_to(:app_key) }
+    it { expect(Vaporizer.config).to respond_to(:app_id) }
+  end
+end

data/vaporizer.gemspec

@@ -0,0 +1,29 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'vaporizer/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "vaporizer"
+  spec.version       = Vaporizer::VERSION
+  spec.authors       = ["Nicolas Florentin"]
+  spec.email         = ["nf.florentin@gmail.com"]
+  spec.summary       = 'A lightweight ruby wrapper to consume Leafly API'
+  spec.description   = 'Vaporizer is a lightweight ruby wrapper which enable to consume easily the new Leafly API which needs authentication'
+  spec.homepage      = ""
+  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"]
+
+  spec.add_development_dependency "bundler", "~> 1.6"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency 'vcr'
+  spec.add_development_dependency 'rspec'
+  spec.add_development_dependency 'webmock'
+
+  spec.add_runtime_dependency('json')
+  spec.add_runtime_dependency('httparty')
+end

metadata

@@ -0,0 +1,168 @@
+--- !ruby/object:Gem::Specification
+name: vaporizer
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Nicolas Florentin
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-03-26 00:00:00.000000000 Z
+dependencies:
+- !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: 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'
+- !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: json
+  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: httparty
+  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'
+description: Vaporizer is a lightweight ruby wrapper which enable to consume easily
+  the new Leafly API which needs authentication
+email:
+- nf.florentin@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/vaporizer.rb
+- lib/vaporizer/error.rb
+- lib/vaporizer/http_client.rb
+- lib/vaporizer/location.rb
+- lib/vaporizer/strain.rb
+- lib/vaporizer/validatable.rb
+- lib/vaporizer/version.rb
+- spec/fixtures/.gitkeep
+- spec/spec_helper.rb
+- spec/vaporizer/http_client_spec.rb
+- spec/vaporizer/location_spec.rb
+- spec/vaporizer/strain_spec.rb
+- spec/vaporizer_spec.rb
+- vaporizer.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.4.5
+signing_key: 
+specification_version: 4
+summary: A lightweight ruby wrapper to consume Leafly API
+test_files:
+- spec/fixtures/.gitkeep
+- spec/spec_helper.rb
+- spec/vaporizer/http_client_spec.rb
+- spec/vaporizer/location_spec.rb
+- spec/vaporizer/strain_spec.rb
+- spec/vaporizer_spec.rb