powells 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: c9bc301f76a4e6930e5aeb6590a038b0add6f881
+  data.tar.gz: 771df08d8a3f6cb816a56ad0cf23e3def01aa591
+SHA512:
+  metadata.gz: dad222fd1f928c9e5abc68117fbaa7cdd1abae9ac08b394a26f08f9ca1abd04ed7e33197663f27d18a07c85331f90dd48cffe96cdf900c3ab0f97fc36adec95d
+  data.tar.gz: 28f3e58e4fb11c8a7185d56cc0924a6c7d89ffddd2cd841e74d0d924b763f54edd5074b03f727bf357e5c90ef51a5daccf6f4f0472191ba0c28f4b5f988f09fa

data/LICENSE

@@ -0,0 +1,22 @@
+(The MIT License)
+
+Copyright (c) 2014 Hakan Ensari
+
+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,5 @@
+# Ruby wrapper to the Powells API
+
+It does what it says [on the tin][1].
+
+[1]: http://api.powells.com/stable

data/lib/powells/request.rb

@@ -0,0 +1,86 @@
+require 'excon'
+require 'powells/response'
+
+module Powells
+  class Request
+    # Create a new request
+    def initialize(api_key: ENV['POWELLS_API_KEY'], api_version: 'v0c')
+      @api_key = api_key
+      @api_version = api_version
+    end
+
+    # Retrieve inventory data for a particular ISBN or SKU
+    def inventory(isbn_or_sku)
+      get('inventory', isbn_or_sku)
+    end
+
+    # Retrieve product data for a particular ISBN or SKU
+    def product(isbn_or_sku)
+      get('product', isbn_or_sku)
+    end
+
+    # Retrieve content about an ISBN or SKU
+    #
+    # This can include items like reviews and publisher descriptions.
+    def content(isbn_or_sku)
+      get('content', isbn_or_sku)
+    end
+
+    # Retrieve information about retail locations
+    def locations(slug = nil)
+      get('locations', slug)
+    end
+
+    # Retrieve product information by way of keywords
+    def search(keywords, options = {})
+      get('search', URI.encode(keywords), options: options)
+    end
+
+    # Retrieve product information for related products
+    def recommendation(isbn, options = {})
+      get('recommendation', isbn, options: options)
+    end
+
+    # A list of up to 50 of the bestselling titles from Powells's Portland
+    # locations, sorted most popular first
+    def pdxbestsellers(options = {})
+      get('pdxbestsellers', options: options)
+    end
+
+    # This feed is what Powell's will use to communicate any known issues with
+    # particular API calls or the API in general
+    def apistatus
+      get('apistatus')
+    end
+
+    # Switch to development environment
+    def sandbox
+      @api_key = 'testing'
+      self
+    end
+
+    # Debug requests
+    def debug
+      @debug = true
+      self
+    end
+
+    private
+
+    def get(*query, options: {})
+      path = build_path(query)
+      options.update(debug: 1) if @debug
+      res = http.get(path: path, query: options)
+
+      Response.new(res)
+    end
+
+    def http
+      Excon.new('http://api.powells.com', expects: 200)
+    end
+
+    def build_path(ary)
+      [@api_version, @api_key].concat(ary).compact.join('/')
+    end
+  end
+end

data/lib/powells/response.rb

@@ -0,0 +1,10 @@
+require 'delegate'
+require 'json'
+
+module Powells
+  class Response < SimpleDelegator
+    def to_h
+      JSON.parse(body)
+    end
+  end
+end

data/lib/powells/version.rb

@@ -0,0 +1,3 @@
+module Powells
+  VERSION = '0.0.1'
+end

data/lib/powells.rb

@@ -0,0 +1,10 @@
+require 'forwardable'
+require 'powells/request'
+
+module Powells
+  class << self
+    extend Forwardable
+
+    def_delegator Request, :new
+  end
+end

data/test/helper.rb

@@ -0,0 +1,11 @@
+require 'minitest/autorun'
+require 'pry'
+require 'vcr'
+
+require_relative '../lib/powells'
+
+VCR.configure do |c|
+  c.hook_into :excon
+  c.cassette_library_dir = 'test/vcr_cassettes'
+  c.default_cassette_options = { record: :new_episodes }
+end

data/test/test_powells.rb

@@ -0,0 +1,83 @@
+require_relative 'helper'
+
+class TestPowells < Minitest::Unit::TestCase
+  def setup
+    VCR.insert_cassette('powells')
+    @powells = Powells.new.sandbox
+  end
+
+  def teardown
+    VCR.eject_cassette
+  end
+
+  def test_inventory_isbn
+    res = @powells.inventory('9780590353427')
+    refute_empty res.to_h
+  end
+
+  def test_inventory_sku
+    res = @powells.inventory('17-9780590353427-80')
+    refute_empty res.to_h
+  end
+
+  def test_product_isbn
+    res = @powells.product('9780590353427')
+    refute_empty res.to_h
+  end
+
+  def test_product_sku
+    res = @powells.product('17-9780590353427-80')
+    refute_empty res.to_h
+  end
+
+  def test_content_isbn
+    res = @powells.content('9780590353427')
+    refute_empty res.to_h
+  end
+
+  def test_content_sku
+    res = @powells.content('17-9780590353427-80')
+    refute_empty res.to_h
+  end
+
+  def test_locations
+    res = @powells.locations
+    refute_empty res.to_h
+  end
+
+  def test_locations_slug
+    res = @powells.locations('powells-city-of-books')
+    refute_empty res.to_h
+  end
+
+  def test_search
+    res = @powells.search('harry potter')
+    refute_empty res.to_h
+  end
+
+  def test_recommendation
+    res = @powells.recommendation('9780590353427')
+    refute_empty res.to_h
+  end
+
+  def test_pdxbestsellers
+    res = @powells.pdxbestsellers
+    refute_empty res.to_h
+  end
+
+  def test_apistatus
+    skip('Powells is not returning JSON')
+    res = @powells.apistatus
+    refute_empty res.to_h
+  end
+
+  def test_accepts_options
+    res = @powells.search('harry potter', per_page: 20)
+    assert_equal 20, res.to_h['results'].count
+  end
+
+  def test_debug
+    res = @powells.debug.search('harry potter')
+    assert_includes res.to_h.keys, 'input'
+  end
+end