goodreads 0.5.0 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 0bf2079b03cdc4a3630504bab0adf6fceb39116d
-  data.tar.gz: 41ffa08e6b041c58d284a94489a55926d8be22aa
+SHA256:
+  metadata.gz: 6ea0e771d6f0bb4fe73d87bdc54b96f97c26e58e2dca54c0d956f73263acf557
+  data.tar.gz: 78e582d52e5ddfee249448c3f5bef36e8f56e165c5d241e3f8cb4c9633d6730a
 SHA512:
-  metadata.gz: 76523d2373dc284161ba63dd8b914028a17bbbc09bb943984f4b8610e766d2f2e9fec30be23c76fae2b633e452d389d523e34fbaa9b0d18b44020a1b4d83a91d
-  data.tar.gz: be44f0721b36dcb13f97dba807dc34b81de66612179a82b878aa9f143f05bb9aefba5a0e7b174e74c3e7cd212e2e83e5486be86cd9aeb0fa0ac06460f4dcd736
+  metadata.gz: 70521658f5c0df28b749559f336ed4c6e418257914fa7b3e4572e88166a1347eca0197422ba8c48bbefc4e9c55ca57524aeee83ae6f2b94f41b1846e90d55f70
+  data.tar.gz: d309c6a3874443910a06b7d156a87f29764be70ac6cb79bad8692b0b1436958b31730f3673bf473f4be569b4dda8a321459d53a30e4e0fad098058f9e5734925

data/.travis.yml

@@ -1,10 +1,10 @@
 sudo: false
 
 rvm:
-  - 2.1
-  - 2.2
   - 2.3
   - 2.4
+  - 2.5
+  - 2.6
 
 script:
   - bundle exec rake test

data/LICENSE

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2011-2015 Dan Sosedoff <dan.sosedoff@gmail.com>
+Copyright (c) 2011-2018 Dan Sosedoff <dan.sosedoff@gmail.com>
 
 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

data/README.md

@@ -170,7 +170,6 @@ group_list.total         # => total number of groups
 group_list.group.count  # => number of groups returned in the request
 
 # Loop through the list to get details for each of the groups.
-
 group_list.group.each do |g|
   g.id                 # => group id
   g.access             # => access settings (private, public)
@@ -184,6 +183,14 @@ end
 The `sort` parameter is optional, and defaults to `my_activity`.
 For other sorting options, [see here](http://www.goodreads.com/api#group.list).
 
+### Pagination
+
+To retrieve results for a particular page use the `page` param when making calls:
+
+```ruby
+books = client.search_books("Term", page: 2)
+```
+
 ### OAuth
 
 For API calls requiring permission, such as write operations or browsing friends,
@@ -210,4 +217,4 @@ You're welcome to submit patches and new features.
 
 The MIT License (MIT)
 
-Copyright (c) 2011-2015 Dan Sosedoff, <dan.sosedoff@gmail.com>
+Copyright (c) 2011-2018 Dan Sosedoff, <dan.sosedoff@gmail.com>

data/goodreads.gemspec

@@ -14,12 +14,12 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "rake",      "~> 10"
   spec.add_development_dependency "rspec",     "~> 2.12"
   spec.add_development_dependency "simplecov", "~> 0.7"
-  spec.add_development_dependency "yard",      "~> 0.6"
+  spec.add_development_dependency "yard",      "~> 0.9"
 
   spec.add_runtime_dependency "rest-client",   "~> 2.0"
   spec.add_runtime_dependency "hashie",        "~> 2.0"
   spec.add_runtime_dependency "activesupport", ">= 3.0"
-  spec.add_runtime_dependency "i18n",          "~> 0.5"
+  spec.add_runtime_dependency "i18n",          ">= 0.6", "< 2"
   spec.add_runtime_dependency "oauth",         "~> 0.4"
 
   spec.files         = `git ls-files`.split("\n")

data/lib/goodreads/client.rb

@@ -31,9 +31,18 @@ module Goodreads
     def initialize(options = {})
       fail(ArgumentError, "Options hash required.") unless options.is_a?(Hash)
 
-      @api_key    = options[:api_key] || Goodreads.configuration[:api_key]
-      @api_secret = options[:api_secret] || Goodreads.configuration[:api_secret]
+      @api_key     = options[:api_key] || Goodreads.configuration[:api_key]
+      @api_secret  = options[:api_secret] || Goodreads.configuration[:api_secret]
       @oauth_token = options[:oauth_token]
     end
+
+    # Return if this client is configured with OAuth credentials
+    # for a single user
+    #
+    # False when client is instantiated with an api_key and secret,
+    # true when client is instantiated with an oauth_token
+    def oauth_configured?
+      !oauth_token.nil?
+    end
   end
 end

data/lib/goodreads/client/friends.rb

@@ -4,8 +4,8 @@ module Goodreads
     #
     # user_id - integer or string
     #
-    def friends(user_id)
-      data = oauth_request("/friend/user/#{user_id}")
+    def friends(user_id, options={})
+      data = oauth_request("/friend/user/#{user_id}", options)
       Hashie::Mash.new(data["friends"])
     end
   end

data/lib/goodreads/client/reviews.rb

@@ -31,5 +31,61 @@ module Goodreads
         []
       end
     end
+
+    # Get a user's review for a given book
+    def user_review(user_id, book_id, params = {})
+      data = request('/review/show_by_user_and_book.xml', params.merge(v: "2", user_id: user_id, book_id: book_id))
+      Hashie::Mash.new(data["review"])
+    end
+
+    # Add review for a book
+    #
+    # Params can include :review, :rating, and :shelf
+    #
+    # review: text of the review (optional)
+    # rating: rating (0-5) (optional, default is 0 (no rating))
+    # shelf: Name of shelf to add book to (optional, must exist, see: shelves.list)
+    #
+    # Note that Goodreads API documentation says that this endpoint accepts
+    # the read_at parameter but it does not appear to work as of 2018-06.
+    def create_review(book_id, params = {})
+      params = params.merge(book_id: book_id, v: "2")
+
+      params[:read_at] = params[:read_at].strftime('%Y-%m-%d') if params[:read_at].is_a?(Time)
+
+      params[:'review[review]'] = params.delete(:review) if params[:review]
+      params[:'review[rating]'] = params.delete(:rating) if params[:rating]
+      params[:'review[read_at]'] = params.delete(:read_at) if params[:read_at]
+
+      data = oauth_request_method(:post, '/review.xml', params)
+
+      Hashie::Mash.new(data["review"])
+    end
+
+    # Edit review for a book
+    #
+    # Params can include :review, :rating, :read_at and :shelf, and :finished
+    #
+    # review: text of the review (optional)
+    # rating: rating (0-5) (optional, default is 0 (no rating))
+    # shelf: Name of shelf to add book to (optional, must exist, see: shelves.list)
+    # read_at: Time object or String in YYYY-MM-DD format (optional)
+    # finished: true to mark finished reading (optional)
+    # shelf: Name of shelf to add book to (optional, must exist, see: shelves.list)
+    def edit_review(review_id, params = {})
+      params = params.merge(v: "2")
+
+      params[:read_at] = params[:read_at].strftime('%Y-%m-%d') if params[:read_at].is_a?(Time)
+
+      params[:'review[review]'] = params.delete(:review) if params[:review]
+      params[:'review[rating]'] = params.delete(:rating) if params[:rating]
+      params[:'review[read_at]'] = params.delete(:read_at) if params[:read_at]
+
+      # Documentation says that you should use HTTP PUT, but API returns
+      # 401 Unauthorized when PUT is used instead of POST
+      data = oauth_request_method(:post, "/review/#{review_id}.xml", params)
+
+      Hashie::Mash.new(data["review"])
+    end
   end
 end

data/lib/goodreads/client/shelves.rb

@@ -1,5 +1,36 @@
 module Goodreads
   module Shelves
+    # Lists shelves for a user
+    def shelves(user_id, options = {})
+      options = options.merge(user_id: user_id, v: 2)
+      data = request("/shelf/list.xml", options)
+      shelves = data["shelves"]
+
+      shelves = data["shelves"]["user_shelf"].map do |s|
+        Hashie::Mash.new({
+          id:             s["id"],
+          name:           s["name"],
+          book_count:     s["book_count"],
+          exclusive:      s["exclusive_flag"],
+          description:    s["description"],
+          sort:           s["sort"],
+          order:          s["order"],
+          per_page:       s["per_page"],
+          display_fields: s["display_fields"],
+          featured:       s["featured"],
+          recommend_for:  s["recommend_for"],
+          sticky:         s["sticky"],
+        })
+      end
+
+      Hashie::Mash.new(
+        start:   data["shelves"]["start"].to_i,
+        end:     data["shelves"]["end"].to_i,
+        total:   data["shelves"]["total"].to_i,
+        shelves: shelves
+      )
+    end
+
     # Get books from a user's shelf
     def shelf(user_id, shelf_name, options = {})
       options = options.merge(shelf: shelf_name, v: 2)
@@ -20,5 +51,42 @@ module Goodreads
         books: books
       )
     end
+
+    # Add book to a user's shelf
+    #
+    # Returns the user's review for the book, which includes all its current shelves
+    def add_to_shelf(book_id, shelf_name, options = {})
+      options = options.merge(book_id: book_id, name: shelf_name, v: 2)
+      data = oauth_request_method(:post, "/shelf/add_to_shelf.xml", options)
+
+      # when a book is on a single shelf it is a single hash
+      shelves = data["my_review"]["shelves"]["shelf"]
+      shelves = [shelves] unless shelves.instance_of?(Array)
+      shelves = shelves.map do |s|
+        Hashie::Mash.new({
+          id:             s["id"].to_i,
+          name:           s["name"],
+          exclusive:      s["exclusive"] == "true",
+          sortable:       s["sortable"] == "true",
+        })
+      end
+
+      Hashie::Mash.new(
+        id: data["my_review"]["id"].to_i,
+        book_id: data["my_review"]["book_id"].to_i,
+
+        rating: data["my_review"]["rating"].to_i,
+        body: data["my_review"]["body"],
+        body_raw: data["my_review"]["body_raw"],
+        spoiler: data["my_review"]["spoiler_flag"] == "true",
+
+        shelves: shelves,
+
+        read_at: data["my_review"]["read_at"],
+        started_at: data["my_review"]["started_at"],
+        date_added: data["my_review"]["date_added"],
+        updated_at: data["my_review"]["updated_at"],
+      )
+    end
   end
 end

data/lib/goodreads/errors.rb

@@ -4,4 +4,6 @@ module Goodreads
   class Forbidden < Error; end
   class Unauthorized < Error; end
   class NotFound < Error; end
+  class ServerError < Error; end
+  class UnknownError < Error; end
 end

data/lib/goodreads/request.rb

@@ -9,12 +9,26 @@ module Goodreads
 
     protected
 
-    # Perform an API request
+    # Perform an API request using API key or OAuth token
     #
     # path   - Request path
     # params - Parameters hash
     #
+    # Will make a request with the configured API key (application
+    # authentication) or OAuth token (user authentication) if available.
     def request(path, params = {})
+      if oauth_configured?
+        oauth_request(path, params)
+      else
+        http_request(path, params)
+      end
+    end
+
+    # Perform an API request using API key
+    #
+    # path   - Request path
+    # params - Parameters hash
+    def http_request(path, params)
       token = api_key || Goodreads.configuration[:api_key]
 
       fail(Goodreads::ConfigurationError, "API key required.") if token.nil?
@@ -32,24 +46,45 @@ module Goodreads
           fail(Goodreads::Forbidden)
         when 404
           fail(Goodreads::NotFound)
+        when 500..599
+          fail(Goodreads::ServerError.new(response.code))
+        else
+          fail(Goodreads::UnknownError.new(response.code))
         end
       end
 
       parse(resp)
     end
 
+    # Perform an OAuth API GET request. Goodreads must have been initialized with a valid OAuth access token.
+    #
+    # path   - Request path
+    # params - Parameters hash
+    #
+    def oauth_request(path, params = {})
+      oauth_request_method(:get, path, params)
+    end
+
     # Perform an OAuth API request. Goodreads must have been initialized with a valid OAuth access token.
     #
+    # http_method - HTTP verb supported by OAuth gem (one of :get, :post, :delete, etc.)
     # path   - Request path
     # params - Parameters hash
     #
-    def oauth_request(path, params = nil)
+    def oauth_request_method(http_method, path, params = {})
       fail "OAuth access token required!" unless @oauth_token
-      if params
-        url_params = params.map { |k, v| "#{k}=#{v}" }.join("&")
-        path = "#{path}?#{url_params}"
+
+      headers = { "Accept" => "application/xml" }
+
+      resp = if http_method == :get || http_method == :delete
+        if params
+          url_params = params.map { |k, v| "#{k}=#{v}" }.join("&")
+          path = "#{path}?#{url_params}"
+        end
+        @oauth_token.request(http_method, path, headers)
+      else
+        @oauth_token.request(http_method, path, params || {}, headers)
       end
-      resp = @oauth_token.get(path, "Accept" => "application/xml")
 
       case resp
       when Net::HTTPUnauthorized

data/lib/goodreads/version.rb

@@ -1,3 +1,3 @@
 module Goodreads
-  VERSION = "0.5.0"
+  VERSION = "0.8.0"
 end

data/spec/authentication_spec.rb

@@ -1,24 +1,37 @@
 require "spec_helper"
 
-describe "Client" do
+describe Goodreads::Client do
   before :each do
     Goodreads.reset_configuration
   end
 
-  it "raises Goodreads::ConfigurationError if API key was not provided" do
-    client = Goodreads::Client.new
+  let(:client) do
+    described_class.new(api_key: api_key)
+  end
+
+  context "API key is missing" do
+    let(:api_key) {}
 
-    expect { client.book_by_isbn("0307463745") }
-      .to raise_error(Goodreads::ConfigurationError, "API key required.")
+    it "throws an error" do
+      expect { client.book_by_isbn("0307463745") }
+        .to raise_error(Goodreads::ConfigurationError, "API key required.")
+    end
   end
 
-  it "raises Goodreads::Unauthorized if API key is not valid" do
-    client = Goodreads::Client.new(api_key: "INVALID_KEY")
+  context "API key is invalid" do
+    let(:api_key) { "INVALID_KEY" }
+
+    before do
+      stub_request(:get, "https://www.goodreads.com/book/isbn?format=xml&isbn=1&key=INVALID_KEY")
+        .to_return(status: 401)
 
-    stub_request(:get, "https://www.goodreads.com/book/isbn?format=xml&isbn=054748250711&key=INVALID_KEY")
-      .to_return(status: 401)
+      stub_request(:get, "https://www.goodreads.com/book/isbn?format=xml&isbn=2&key=INVALID_KEY")
+        .to_return(status: 403)
+    end
 
-    expect { client.book_by_isbn("054748250711") }
-      .to raise_error(Goodreads::Unauthorized)
+    it "throws errors" do
+      expect { client.book_by_isbn("1") }.to raise_error(Goodreads::Unauthorized)
+      expect { client.book_by_isbn("2") }.to raise_error(Goodreads::Forbidden)
+    end
   end
 end

data/spec/client_spec.rb

@@ -1,7 +1,7 @@
 require "spec_helper"
 require "oauth"
 
-describe "Client" do
+describe Goodreads::Client do
   let(:client)  { Goodreads::Client.new(api_key: "SECRET_KEY") }
   before(:each) { Goodreads.reset_configuration }
 
@@ -17,6 +17,45 @@ describe "Client" do
     end
   end
 
+  describe "#oauth_configured?" do
+    it "is true when OAuth token provided to constructor" do
+      client = Goodreads::Client.new(oauth_token: "a token")
+      expect(client.oauth_configured?).to be true
+    end
+
+    it "is true when oauth token is not provided to constructor" do
+      client = Goodreads::Client.new(api_key: "SECRET_KEY")
+      expect(client.oauth_configured?).to be false
+    end
+  end
+
+  describe "#request" do
+    context "with oauth token" do
+      it "makes an oauth request" do
+        oauth_token = double
+        response = double
+
+        allow(oauth_token).to receive(:request) { response }
+        allow(response).to receive(:body) { fixture("book.xml") }
+
+        client = Goodreads::Client.new(oauth_token: oauth_token)
+        expect(client.book(123)).to be_a Hash
+      end
+    end
+
+    context "without oauth token" do
+      before do
+        allow(client).to receive(:http_request) {
+          Hash.from_xml(fixture("book.xml"))["GoodreadsResponse"]
+        }
+      end
+
+      it "makes a request" do
+        expect(client.book(123)).to be_a Hash
+      end
+    end
+  end
+
   describe "#book_by_isbn" do
     before { stub_with_key_get("/book/isbn", { isbn: "0307463745" }, "book.xml") }
 
@@ -154,6 +193,26 @@ describe "Client" do
     end
   end
 
+  describe "#user_review" do
+    let(:consumer) { OAuth::Consumer.new("API_KEY", "SECRET_KEY", site: "https://www.goodreads.com") }
+    let(:token)    { OAuth::AccessToken.new(consumer, "ACCESS_TOKEN", "ACCESS_SECRET") }
+
+    it "returns a user's existing review" do
+      stub_request(:get, "https://www.goodreads.com/review/show_by_user_and_book.xml?book_id=50&user_id=1&v=2")
+        .to_return(status: 200, body: fixture("review_show_by_user_and_book.xml"))
+
+      client = Goodreads::Client.new(api_key: "SECRET_KEY", oauth_token: token)
+      review = client.user_review(1, 50)
+
+      expect(review.id).to eq("21")
+      expect(review.book.id).to eq(50)
+
+      expect(review.rating).to eq("5")
+      expect(review.body.strip).to eq("")
+      expect(review.date_added).to eq("Tue Aug 29 11:20:01 -0700 2006")
+    end
+  end
+
   describe "#author" do
     before { stub_with_key_get("/author/show", { id: "18541" }, "author.xml") }
 
@@ -287,6 +346,131 @@ describe "Client" do
     end
   end
 
+  describe "#add_to_shelf" do
+    let(:consumer) { OAuth::Consumer.new("API_KEY", "SECRET_KEY", site: "https://www.goodreads.com") }
+    let(:token)    { OAuth::AccessToken.new(consumer, "ACCESS_TOKEN", "ACCESS_SECRET") }
+
+    it "adds a book to a user's shelf" do
+      stub_request(:post, "https://www.goodreads.com/shelf/add_to_shelf.xml")
+        .with(:body => {"book_id"=>"456", "name"=>"read", "v"=>"2"})
+        .to_return(status: 201, body: fixture("shelf_add_to_shelf.xml"))
+
+      client = Goodreads::Client.new(api_key: "SECRET_KEY", oauth_token: token)
+      review = client.add_to_shelf(456, "read")
+
+      expect(review.id).to eq(2416981504)
+      expect(review.book_id).to eq(456)
+
+      expect(review.rating).to eq(0)
+      expect(review.body).to be nil
+      expect(review.body_raw).to be nil
+      expect(review.spoiler).to be false
+
+      expect(review.shelves.size).to eq(1)
+      expect(review.shelves.first.name).to eq("read")
+      expect(review.shelves.first.id).to eq(269274694)
+      expect(review.shelves.first.exclusive).to be true
+      expect(review.shelves.first.sortable).to be false
+
+
+      expect(review.read_at).to be nil
+      expect(review.started_at).to be nil
+      expect(review.date_added).to eq("Thu Jun 07 19:58:19 -0700 2018")
+      expect(review.updated_at).to eq("Thu Jun 07 19:58:53 -0700 2018")
+
+      expect(review.body).to be nil
+      expect(review.body_raw).to be nil
+      expect(review.spoiler).to be false
+    end
+  end
+
+  describe "#create_review" do
+    let(:consumer) { OAuth::Consumer.new("API_KEY", "SECRET_KEY", site: "https://www.goodreads.com") }
+    let(:token)    { OAuth::AccessToken.new(consumer, "ACCESS_TOKEN", "ACCESS_SECRET") }
+
+    it "creates a new review for a book" do
+      stub_request(:post, "https://www.goodreads.com/review.xml")
+        .with(:body => {
+          "book_id"=>"456",
+          "review" => {
+            "rating" => "3",
+            "review" => "Good book.",
+            "read_at" => "2018-01-02",
+          },
+          "shelf" => "read",
+          "v"=>"2",
+        })
+        .to_return(status: 201, body: fixture("review_create.xml"))
+
+      client = Goodreads::Client.new(api_key: "SECRET_KEY", oauth_token: token)
+      review = client.create_review(456, {
+        :review => "Good book.",
+        :rating => 3,
+        :read_at => Time.parse('2018-01-02'),
+        :shelf => "read",
+      })
+
+      expect(review.id).to eq("67890")
+      expect(review.book.id).to eq(456)
+      expect(review.rating).to eq("3")
+      expect(review.body).to eq("Good book.")
+    end
+  end
+
+  describe "#edit_review" do
+    let(:consumer) { OAuth::Consumer.new("API_KEY", "SECRET_KEY", site: "https://www.goodreads.com") }
+    let(:token)    { OAuth::AccessToken.new(consumer, "ACCESS_TOKEN", "ACCESS_SECRET") }
+
+    it "creates a new review for a book" do
+      stub_request(:post, "https://www.goodreads.com/review/67890.xml")
+        .with(:body => {
+          "finished" => "true",
+          "review" => {
+            "rating" => "5",
+            "review" => "Fantastic book.",
+            "read_at" => "2018-04-15",
+          },
+          "shelf" => "read",
+          "v"=>"2",
+        })
+        .to_return(status: 201, body: fixture("review_update.xml"))
+
+      client = Goodreads::Client.new(api_key: "SECRET_KEY", oauth_token: token)
+      review = client.edit_review(67890, {
+        :finished => true,
+        :review => "Fantastic book.",
+        :rating => 5,
+        :read_at => Time.parse('2018-04-15'),
+        :shelf => "read",
+      })
+
+      expect(review.id).to eq("67890")
+      expect(review.book.id).to eq(456)
+      expect(review.rating).to eq("5")
+      expect(review.body).to eq("Fantastic book.")
+    end
+  end
+
+  describe "#shelves" do
+    it "returns list of user's shelves" do
+      stub_with_key_get("/shelf/list.xml", { user_id: 123, v: "2" }, "shelf_list.xml")
+
+      response = client.shelves(123)
+
+      expect(response).to respond_to(:start)
+      expect(response).to respond_to(:end)
+      expect(response).to respond_to(:total)
+      expect(response).to respond_to(:shelves)
+
+      expect(response.start).to eq(1)
+      expect(response.end).to eq(3)
+      expect(response.total).to eq(3)
+      expect(response.shelves.length).to eq(3)
+      expect(response.shelves.first.id).to eq(9049904)
+      expect(response.shelves.first.name).to eq("read")
+    end
+  end
+
   describe "#user_id" do
     let(:consumer) { OAuth::Consumer.new("API_KEY", "SECRET_KEY", site: "https://www.goodreads.com") }
     let(:token)    { OAuth::AccessToken.new(consumer, "ACCESS_TOKEN", "ACCESS_SECRET") }

data/spec/fixtures/review_create.xml

@@ -0,0 +1,102 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<GoodreadsResponse>
+  <Request>
+    <authentication>true</authentication>
+    <key><![CDATA[SECRET_KEY]]></key>
+    <method><![CDATA[review_create]]></method>
+  </Request>
+
+      <review>
+  <id>67890</id>
+
+  <user>
+    <id>123456</id>
+    <uri>kca://profile:goodreads/A25C3Y1SBGK9NK</uri>
+    <name>Test</name>
+    <display_name>Test User</display_name>
+
+    <location>Lafayette, CA</location>
+
+    <link><![CDATA[https://www.goodreads.com/user/show/123456-test-user]]></link>
+
+    <image_url><![CDATA[https://s.gr-assets.com/assets/nophoto/user/u_111x148-9394ebedbb3c6c218f64be9549657029.png]]></image_url>
+    <small_image_url><![CDATA[https://s.gr-assets.com/assets/nophoto/user/u_50x66-632230dc9882b4352d753eedf9396530.png]]></small_image_url>
+    <has_image>false</has_image>
+
+  </user>
+
+    <book>
+  <id type="integer">456</id>
+  <isbn>0195138570</isbn>
+  <isbn13>9780195138573</isbn13>
+  <text_reviews_count type="integer">11</text_reviews_count>
+  <uri>kca://book/amzn1.gr.book.v1.oHwPZrciugo6gPSINsfCaw</uri>
+  <title>Mindware: An Introduction to the Philosophy of Cognitive Science</title>
+  <title_without_series>Mindware: An Introduction to the Philosophy of Cognitive Science</title_without_series>
+  <image_url>https://s.gr-assets.com/assets/nophoto/book/111x148-bcc042a9c91a29c1d680899eff700a03.png</image_url>
+  <small_image_url>https://s.gr-assets.com/assets/nophoto/book/50x75-a91bf249278a81aabab721ef782c4a74.png</small_image_url>
+  <large_image_url/>
+  <link>https://www.goodreads.com/book/show/456.Mindware</link>
+  <num_pages>224</num_pages>
+  <format>Paperback</format>
+  <edition_information>1st edition</edition_information>
+  <publisher>Oxford University Press, USA</publisher>
+  <publication_day>21</publication_day>
+  <publication_year>2000</publication_year>
+  <publication_month>12</publication_month>
+  <average_rating>3.78</average_rating>
+  <ratings_count>210</ratings_count>
+  <description>&lt;p&gt;&lt;i&gt;Mindware&lt;/i&gt; is an introductory text with a difference. In eight short chapters it tells a story and invites the reader to join in some up-to-the-minute conceptual discussion of the key issues, problems, and opportunities in cognitive science. The story is about the search for a cognitive scientific understanding of mind. It is presented as a no-holds-barred journey from early work in Artificial Intelligence, through connectionist (artificial neural network) counter-visions, and onto neuroscience artificial life, dynamics and robotics. The journey ends with some wide-ranging and provacative speculation about the role of technology and the changing nature of the human mind itself.&lt;br /&gt;Each chapter is organized as an initial sketch of a research program or theme, followed by a substantial discussion section in which specific problems and issues (both familiear and cutting-edge) are raised and pursued. Discussion topics include mental causation, the hardware/software distinction, the relations between life and mind, the nature of perception, cognition and action, and the continuity (or otherwise) of high-level human intelligence with other forms of adaptive response. Classic topics are treated alongside the newer ones in an integrated treatment of the various discussions. The sketches and discussions are accompanied by numerous figures and boxed sections, and followed by suggestions for futher reading.&lt;/p&gt;</description>
+<authors>
+<author>
+<id>3445871</id>
+<name>Andy  Clark</name>
+<role></role>
+<image_url nophoto='false'>
+<![CDATA[https://images.gr-assets.com/authors/1269856267p5/3445871.jpg]]>
+</image_url>
+<small_image_url nophoto='false'>
+<![CDATA[https://images.gr-assets.com/authors/1269856267p2/3445871.jpg]]>
+</small_image_url>
+<link><![CDATA[https://www.goodreads.com/author/show/3445871.Andy_Clark]]></link>
+<average_rating>3.89</average_rating>
+<ratings_count>992</ratings_count>
+<text_reviews_count>74</text_reviews_count>
+</author>
+</authors>
+  <published>2000</published>
+<work>  <id>282613</id>
+  <uri>kca://work/amzn1.gr.work.v1.xCZQesiWRuaIVPV6wsdFGA</uri>
+</work></book>
+
+
+  <rating>3</rating>
+  <votes>0</votes>
+  <spoiler_flag>false</spoiler_flag>
+  <spoilers_state>none</spoilers_state>
+
+
+<shelves>
+    <shelf name="read" exclusive="true" id="269274694" review_shelf_id= ""/>
+
+</shelves>
+
+  <recommended_for></recommended_for>
+  <recommended_by></recommended_by>
+  <started_at></started_at>
+  <read_at></read_at>
+  <date_added>Wed Jun 13 20:52:06 -0700 2018</date_added>
+  <date_updated>Wed Jun 13 20:52:07 -0700 2018</date_updated>
+  <read_count>1</read_count>
+  <body>Good book.</body>
+
+
+
+  <comments_count>0</comments_count>
+    <url><![CDATA[https://www.goodreads.com/review/show/67890]]></url>
+  <link><![CDATA[https://www.goodreads.com/review/show/67890]]></link>
+    <owned>0</owned>
+</review>
+
+
+</GoodreadsResponse>

data/spec/fixtures/review_show_by_user_and_book.xml

@@ -0,0 +1,144 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<GoodreadsResponse>
+  <Request>
+    <authentication>true</authentication>
+    <key><![CDATA[SECRET_KEY]]></key>
+    <method><![CDATA[review_show_by_user_and_book]]></method>
+  </Request>
+      <review>
+  <id>21</id>
+
+  <user>
+    <id>1</id>
+    <uri>kca://profile:goodreads/A2CSQET51X1KEY</uri>
+    <name>Otis</name>
+    <display_name>Otis Chandler</display_name>
+
+    <location>San Francisco, CA</location>
+
+    <link><![CDATA[https://www.goodreads.com/user/show/1-otis-chandler]]></link>
+
+    <image_url><![CDATA[https://images.gr-assets.com/users/1506617226p3/1.jpg]]></image_url>
+    <small_image_url><![CDATA[https://images.gr-assets.com/users/1506617226p2/1.jpg]]></small_image_url>
+    <has_image>true</has_image>
+
+  </user>
+
+    <book>
+  <id type="integer">50</id>
+  <isbn>0689840926</isbn>
+  <isbn13>9780689840920</isbn13>
+  <text_reviews_count type="integer">10396</text_reviews_count>
+  <uri>kca://book/amzn1.gr.book.v1.RXVB3nJhipnhI-zLlVeRTg</uri>
+  <title>Hatchet</title>
+  <title_without_series>Hatchet</title_without_series>
+  <image_url>https://s.gr-assets.com/assets/nophoto/book/111x148-bcc042a9c91a29c1d680899eff700a03.png</image_url>
+  <small_image_url>https://s.gr-assets.com/assets/nophoto/book/50x75-a91bf249278a81aabab721ef782c4a74.png</small_image_url>
+  <large_image_url/>
+  <link>https://www.goodreads.com/book/show/50.Hatchet</link>
+  <num_pages>208</num_pages>
+  <format>Hardcover</format>
+  <edition_information/>
+  <publisher>Atheneum Books for Young Readers: Richard Jackson Books</publisher>
+  <publication_day>1</publication_day>
+  <publication_year>2000</publication_year>
+  <publication_month>4</publication_month>
+  <average_rating>3.69</average_rating>
+  <ratings_count>250763</ratings_count>
+  <description>Brian is on his way to Canada to visit his estranged father when the pilot of his small prop plane suffers a heart attack. Brian is forced to crash-land the plane in a lake--and finds himself stranded in the remote Canadian wilderness with only his clothing and the hatchet his mother gave him as a present before his departure. &lt;br /&gt;&lt;br /&gt;Brian had been distraught over his parents' impending divorce and the secret he carries about his mother, but now he is truly desolate and alone. Exhausted, terrified, and hungry, Brian struggles to find food and make a shelter for himself. He has no special knowledge of the woods, and he must find a new kind of awareness and patience as he meets each day's challenges. Is the water safe to drink? Are the berries he finds poisonous? &lt;br /&gt;&lt;br /&gt;Slowly, Brian learns to turn adversity to his advantage--an invading porcupine unexpectedly shows him how to make fire, a devastating tornado shows him how to retrieve supplies from the submerged airplane. Most of all, Brian leaves behind the self-pity he has felt about his predicament as he summons the courage to stay alive. &lt;br /&gt;&lt;br /&gt;A story of survival and of transformation, this riveting book has sparked many a reader's interest in venturing into the wild.</description>
+<authors>
+<author>
+<id>18</id>
+<name>Gary Paulsen</name>
+<role></role>
+<image_url nophoto='false'>
+<![CDATA[https://images.gr-assets.com/authors/1309159225p5/18.jpg]]>
+</image_url>
+<small_image_url nophoto='false'>
+<![CDATA[https://images.gr-assets.com/authors/1309159225p2/18.jpg]]>
+</small_image_url>
+<link><![CDATA[https://www.goodreads.com/author/show/18.Gary_Paulsen]]></link>
+<average_rating>3.76</average_rating>
+<ratings_count>399462</ratings_count>
+<text_reviews_count>28012</text_reviews_count>
+</author>
+</authors>
+  <published>2000</published>
+<work>  <id>1158125</id>
+  <uri>kca://work/amzn1.gr.work.v1.r_sm_y7tG-b00YGE5HqhQQ</uri>
+</work></book>
+
+
+    <read_statuses>
+        <read_status>
+          <id type="integer">1610038200</id>
+          <old_status></old_status>
+          <status>read</status>
+          <updated_at type="datetime">Fri Dec 09 22:55:21 -0800 2016</updated_at>
+          <ratings_count>0</ratings_count>
+          <comments_count>0</comments_count>
+        </read_status>
+    </read_statuses>
+  <rating>5</rating>
+  <votes>1</votes>
+  <spoiler_flag>false</spoiler_flag>
+  <spoilers_state>none</spoilers_state>
+
+
+<shelves>
+    <shelf name="read" exclusive="true" id="5625761" review_shelf_id= ""/>
+
+    <shelf exclusive='false' id='343477' name='childrensbooks' review_shelf_id='175' sortable='false'></shelf>
+
+    <shelf exclusive='false' id='348056' name='fiction' review_shelf_id='687' sortable='false'></shelf>
+
+    <shelf exclusive='false' id='348035' name='fiction' review_shelf_id='209' sortable='false'></shelf>
+
+</shelves>
+
+  <recommended_for></recommended_for>
+  <recommended_by></recommended_by>
+  <started_at></started_at>
+  <read_at></read_at>
+  <date_added>Tue Aug 29 11:20:01 -0700 2006</date_added>
+  <date_updated>Wed Mar 22 11:44:07 -0700 2017</date_updated>
+  <read_count>1</read_count>
+  <body>
+  </body>
+
+
+
+  <comments_count>1</comments_count>
+    <comments start="1" end="1" total="1">
+        <comment>
+  <id>161860175</id>
+  <body><![CDATA[love this book i read it in sixth grade and we had journals about it]]></body>
+
+  <user>
+    <id>64170165</id>
+    <uri>kca://profile:goodreads/A2PCDUCFEEK4OB</uri>
+    <name>Alise</name>
+    <display_name>Alise</display_name>
+
+    <location>The United States</location>
+
+    <link><![CDATA[https://www.goodreads.com/user/show/64170165-alise]]></link>
+
+    <image_url><![CDATA[https://s.gr-assets.com/assets/nophoto/user/u_111x148-9394ebedbb3c6c218f64be9549657029.png]]></image_url>
+    <small_image_url><![CDATA[https://s.gr-assets.com/assets/nophoto/user/u_50x66-632230dc9882b4352d753eedf9396530.png]]></small_image_url>
+    <has_image>false</has_image>
+
+  </user>
+
+  <created_at>Sun Jan 22 22:49:10 -0800 2017</created_at>
+  <updated_at>Sun Jan 22 22:49:10 -0800 2017</updated_at>
+</comment>
+
+    </comments>
+    <url><![CDATA[https://www.goodreads.com/review/show/21]]></url>
+  <link><![CDATA[https://www.goodreads.com/review/show/21]]></link>
+    <owned>0</owned>
+</review>
+
+
+</GoodreadsResponse>

data/spec/fixtures/review_update.xml

@@ -0,0 +1,104 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<GoodreadsResponse>
+  <Request>
+    <authentication>true</authentication>
+    <key><![CDATA[SECRET_KEY]]></key>
+    <method><![CDATA[review_update_xml]]></method>
+  </Request>
+      <review>
+  <id>67890</id>
+
+  <user>
+    <id>123456</id>
+    <uri>kca://profile:goodreads/A25C3Y1SBGK9NK</uri>
+    <name>Test</name>
+    <display_name>Test User</display_name>
+
+    <location>Lafayette, CA</location>
+
+    <link><![CDATA[https://www.goodreads.com/user/show/123456-test-user]]></link>
+
+    <image_url><![CDATA[https://s.gr-assets.com/assets/nophoto/user/u_111x148-9394ebedbb3c6c218f64be9549657029.png]]></image_url>
+    <small_image_url><![CDATA[https://s.gr-assets.com/assets/nophoto/user/u_50x66-632230dc9882b4352d753eedf9396530.png]]></small_image_url>
+    <has_image>false</has_image>
+
+  </user>
+
+    <book>
+  <id type="integer">456</id>
+  <isbn>0195138570</isbn>
+  <isbn13>9780195138573</isbn13>
+  <text_reviews_count type="integer">11</text_reviews_count>
+  <uri>kca://book/amzn1.gr.book.v1.oHwPZrciugo6gPSINsfCaw</uri>
+  <title>Mindware: An Introduction to the Philosophy of Cognitive Science</title>
+  <title_without_series>Mindware: An Introduction to the Philosophy of Cognitive Science</title_without_series>
+  <image_url>https://s.gr-assets.com/assets/nophoto/book/111x148-bcc042a9c91a29c1d680899eff700a03.png</image_url>
+  <small_image_url>https://s.gr-assets.com/assets/nophoto/book/50x75-a91bf249278a81aabab721ef782c4a74.png</small_image_url>
+  <large_image_url/>
+  <link>https://www.goodreads.com/book/show/456.Mindware</link>
+  <num_pages>224</num_pages>
+  <format>Paperback</format>
+  <edition_information>1st edition</edition_information>
+  <publisher>Oxford University Press, USA</publisher>
+  <publication_day>21</publication_day>
+  <publication_year>2000</publication_year>
+  <publication_month>12</publication_month>
+  <average_rating>3.78</average_rating>
+  <ratings_count>210</ratings_count>
+  <description>&lt;p&gt;&lt;i&gt;Mindware&lt;/i&gt; is an introductory text with a difference. In eight short chapters it tells a story and invites the reader to join in some up-to-the-minute conceptual discussion of the key issues, problems, and opportunities in cognitive science. The story is about the search for a cognitive scientific understanding of mind. It is presented as a no-holds-barred journey from early work in Artificial Intelligence, through connectionist (artificial neural network) counter-visions, and onto neuroscience artificial life, dynamics and robotics. The journey ends with some wide-ranging and provacative speculation about the role of technology and the changing nature of the human mind itself.&lt;br /&gt;Each chapter is organized as an initial sketch of a research program or theme, followed by a substantial discussion section in which specific problems and issues (both familiear and cutting-edge) are raised and pursued. Discussion topics include mental causation, the hardware/software distinction, the relations between life and mind, the nature of perception, cognition and action, and the continuity (or otherwise) of high-level human intelligence with other forms of adaptive response. Classic topics are treated alongside the newer ones in an integrated treatment of the various discussions. The sketches and discussions are accompanied by numerous figures and boxed sections, and followed by suggestions for futher reading.&lt;/p&gt;</description>
+<authors>
+<author>
+<id>3445871</id>
+<name>Andy  Clark</name>
+<role></role>
+<image_url nophoto='false'>
+<![CDATA[https://images.gr-assets.com/authors/1269856267p5/3445871.jpg]]>
+</image_url>
+<small_image_url nophoto='false'>
+<![CDATA[https://images.gr-assets.com/authors/1269856267p2/3445871.jpg]]>
+</small_image_url>
+<link><![CDATA[https://www.goodreads.com/author/show/3445871.Andy_Clark]]></link>
+<average_rating>3.89</average_rating>
+<ratings_count>992</ratings_count>
+<text_reviews_count>74</text_reviews_count>
+</author>
+</authors>
+  <published>2000</published>
+<work>  <id>282613</id>
+  <uri>kca://work/amzn1.gr.work.v1.xCZQesiWRuaIVPV6wsdFGA</uri>
+</work></book>
+
+
+  <rating>5</rating>
+  <votes>0</votes>
+  <spoiler_flag>false</spoiler_flag>
+  <spoilers_state>none</spoilers_state>
+
+
+<shelves>
+    <shelf name="read" exclusive="true" id="269274694" review_shelf_id= ""/>
+
+</shelves>
+
+  <recommended_for></recommended_for>
+  <recommended_by></recommended_by>
+  <started_at></started_at>
+  <read_at>Fri Aug 20 00:00:00 -0700 2004</read_at>
+  <date_added>Wed Jun 13 20:52:06 -0700 2018</date_added>
+  <date_updated>Wed Jun 13 20:52:08 -0700 2018</date_updated>
+  <read_count>1</read_count>
+  <body>Fantastic book.</body>
+  <body_raw>
+
+  </body_raw>
+
+
+
+  <comments_count>0</comments_count>
+    <url><![CDATA[https://www.goodreads.com/review/show/67890]]></url>
+  <link><![CDATA[https://www.goodreads.com/review/show/67890]]></link>
+    <owned>0</owned>
+</review>
+
+
+</GoodreadsResponse>

data/spec/fixtures/shelf_add_to_shelf.xml

@@ -0,0 +1,24 @@
+<GoodreadsResponse>
+  <Request>
+    <authentication>true</authentication>
+    <key><![CDATA[SECRET_KEY]]></key>
+    <method><![CDATA[shelf_add_to_shelf]]></method>
+  </Request>
+  <my_review>
+    <id>2416981504</id>
+    <book_id>456</book_id>
+    <rating>0</rating>
+    <updated_at>Thu Jun 07 19:58:53 -0700 2018</updated_at>
+
+    <shelves>
+        <shelf name="read" exclusive="true" id="269274694" review_shelf_id= ""/>
+    </shelves>
+
+    <body></body>
+    <body_raw></body_raw>
+    <spoiler_flag>false</spoiler_flag>
+    <started_at></started_at>
+    <read_at></read_at>
+    <date_added>Thu Jun 07 19:58:19 -0700 2018</date_added>
+  </my_review>
+</GoodreadsResponse>

data/spec/fixtures/shelf_list.xml

@@ -0,0 +1,51 @@
+<GoodreadsResponse>
+  <Request>
+    <authentication>true</authentication>
+      <key><![CDATA[SECRET_KEY]]></key>
+      <method><![CDATA[ shelf_list ]]></method>
+  </Request>
+  <shelves start="1" end="3" total="3">
+    <user_shelf>
+      <id type="integer">9049904</id>
+      <name>read</name>
+      <book_count type="integer">0</book_count>
+      <exclusive_flag type="boolean">true</exclusive_flag>
+      <description nil="true"/>
+      <sort nil="true"/>
+      <order nil="true"/>
+      <per_page type="integer" nil="true"/>
+      <display_fields/>
+      <featured type="boolean">true</featured>
+      <recommend_for type="boolean">true</recommend_for>
+      <sticky type="boolean" nil="true"/>
+    </user_shelf>
+    <user_shelf>
+      <id type="integer">3701</id>
+      <name>currently-reading</name>
+      <book_count type="integer">0</book_count>
+      <exclusive_flag type="boolean">true</exclusive_flag>
+      <description nil="true"/>
+      <sort nil="true"/>
+      <order nil="true"/>
+      <per_page type="integer" nil="true"/>
+      <display_fields/>
+      <featured type="boolean">false</featured>
+      <recommend_for type="boolean">true</recommend_for>
+      <sticky type="boolean" nil="true"/>
+      </user_shelf>
+    <user_shelf>
+      <id type="integer">3700</id>
+      <name>to-read</name>
+      <book_count type="integer">0</book_count>
+      <exclusive_flag type="boolean">true</exclusive_flag>
+      <description nil="true"/>
+      <sort nil="true"/>
+      <order>a</order>
+      <per_page type="integer" nil="true"/>
+      <display_fields/>
+      <featured type="boolean">false</featured>
+      <recommend_for type="boolean">true</recommend_for>
+      <sticky type="boolean" nil="true"/>
+    </user_shelf>
+  </shelves>
+</GoodreadsResponse>

data/spec/goodreads_spec.rb

@@ -1,6 +1,6 @@
 require "spec_helper"
 
-describe "Goodreads" do
+describe Goodreads do
   describe ".new" do
     it "returns a new client instance" do
       expect(Goodreads.new).to be_a(Goodreads::Client)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: goodreads
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.8.0
 platform: ruby
 authors:
 - Dan Sosedoff
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2017-10-03 00:00:00.000000000 Z
+date: 2020-11-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: webmock
@@ -72,14 +72,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.6'
+        version: '0.9'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.6'
+        version: '0.9'
 - !ruby/object:Gem::Dependency
   name: rest-client
   requirement: !ruby/object:Gem::Requirement
@@ -126,16 +126,22 @@ dependencies:
   name: i18n
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.6'
+    - - "<"
       - !ruby/object:Gem::Version
-        version: '0.5'
+        version: '2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.6'
+    - - "<"
       - !ruby/object:Gem::Version
-        version: '0.5'
+        version: '2'
 - !ruby/object:Gem::Dependency
   name: oauth
   requirement: !ruby/object:Gem::Requirement
@@ -192,9 +198,14 @@ files:
 - spec/fixtures/oauth_response.xml
 - spec/fixtures/recent_reviews.xml
 - spec/fixtures/review.xml
+- spec/fixtures/review_create.xml
+- spec/fixtures/review_show_by_user_and_book.xml
+- spec/fixtures/review_update.xml
 - spec/fixtures/reviews.xml
 - spec/fixtures/reviews_empty.xml
 - spec/fixtures/search_books_by_name.xml
+- spec/fixtures/shelf_add_to_shelf.xml
+- spec/fixtures/shelf_list.xml
 - spec/fixtures/to-read-p2.xml
 - spec/fixtures/to-read.xml
 - spec/fixtures/user.xml
@@ -204,7 +215,7 @@ homepage: http://github.com/sosedoff/goodreads
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -219,9 +230,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.6.13
-signing_key: 
+rubygems_version: 3.0.6
+signing_key:
 specification_version: 4
 summary: Goodreads API wrapper
 test_files:
@@ -237,9 +247,14 @@ test_files:
 - spec/fixtures/oauth_response.xml
 - spec/fixtures/recent_reviews.xml
 - spec/fixtures/review.xml
+- spec/fixtures/review_create.xml
+- spec/fixtures/review_show_by_user_and_book.xml
+- spec/fixtures/review_update.xml
 - spec/fixtures/reviews.xml
 - spec/fixtures/reviews_empty.xml
 - spec/fixtures/search_books_by_name.xml
+- spec/fixtures/shelf_add_to_shelf.xml
+- spec/fixtures/shelf_list.xml
 - spec/fixtures/to-read-p2.xml
 - spec/fixtures/to-read.xml
 - spec/fixtures/user.xml