goodreads 0.6.1 → 0.6.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 32d6d10732050dfe55085f6f38358ca6884d4d84
-  data.tar.gz: aacf42830b97b3ce07eff81bc77b4a520cf946ea
+SHA256:
+  metadata.gz: 7c94efd63197915ee10a6ba023cb810e4fac84c2943f4544e83642f2a002a0ec
+  data.tar.gz: ce3afa10705116414371ac7b21788c6e6114e7d7a691a31fdd7f49fd80d6e266
 SHA512:
-  metadata.gz: cf4836f8619cab1de139614b155614347f43b60aa6078246392ea6671f83bed456eb0a6139f930e72a4c8574ea3ec5fb3986955a2cc5b8eaa3d00edf67ea3d89
-  data.tar.gz: fa0b3ae21e4caa744e61479c445d863d73e0e68182af09bc169a461ec89178e70b9478469b88a86c77763742d8d5e534d809b2bdccb5a26bd9fea2a46bc48cc7
+  metadata.gz: 58091fa38ec8c80c653e0f50ec46e401e5a5a3eb048354cd11e2b9591a20e2011d401f5816e3dc2ca63107974a084e12af9bf2184103162e61b576a30499afc1
+  data.tar.gz: d602443eae15c2cf6123d21242f5ac68c90314eb15e4b9d45603234aaafc2b814eb2c1ecae1ae57daa289db895ab2fb595f0c223755163d85845ae285b1f292a

data/.travis.yml

@@ -5,6 +5,7 @@ rvm:
   - 2.2
   - 2.3
   - 2.4
+  - 2.5
 
 script:
   - bundle exec rake test

data/README.md

@@ -210,4 +210,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/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/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/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?
@@ -38,18 +52,35 @@ module Goodreads
       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.6.1"
+  VERSION = "0.6.2"
 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.6.1
+  version: 0.6.2
 platform: ruby
 authors:
 - Dan Sosedoff
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-01-09 00:00:00.000000000 Z
+date: 2018-07-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: webmock
@@ -192,9 +192,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
@@ -220,7 +225,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.6.13
+rubygems_version: 2.7.7
 signing_key: 
 specification_version: 4
 summary: Goodreads API wrapper
@@ -237,9 +242,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