librarything-api 0.1.0

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.gitignore

@@ -0,0 +1,24 @@
+## MAC OS
+.DS_Store
+
+## TEXTMATE
+*.tmproj
+tmtags
+
+## EMACS
+*~
+\#*
+.\#*
+
+## VIM
+*.swp
+
+## PROJECT::GENERAL
+coverage
+rdoc
+pkg
+doc
+.yardoc
+
+## PROJECT::SPECIFIC
+credentials.rb

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2010 Jason Wadsworth
+
+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.rdoc

@@ -0,0 +1,17 @@
+= librarything-api
+
+Description goes here.
+
+== Note on Patches/Pull Requests
+ 
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a
+  future version unintentionally.
+* Commit, do not mess with rakefile, version, or history.
+  (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+== Copyright
+
+Copyright (c) 2010 Jason Wadsworth. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,48 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "librarything-api"
+    gem.summary = %Q{Gem for accessing the LibraryThing API}
+    gem.description = %Q{Gem for accessing the LibraryThing API}
+    gem.email = "jdwadsworth@gmail.com"
+    gem.homepage = "http://github.com/subakva/librarything-api"
+    gem.authors = ["Jason Wadsworth"]
+    gem.add_development_dependency "rspec", ">= 1.3.0"
+    gem.add_development_dependency "fakeweb", ">= 1.2.8"
+    gem.add_development_dependency "yard", ">= 0"
+    gem.add_dependency "httparty", ">= 0.5.2"
+    gem.add_dependency "nokogiri", ">= 1.4.1"
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+
+require 'spec/rake/spectask'
+Spec::Rake::SpecTask.new(:spec) do |spec|
+  spec.ruby_opts << ['-r rubygems']
+  spec.libs << 'lib' << 'spec'
+  spec.spec_files = FileList['spec/**/*_spec.rb']
+end
+
+Spec::Rake::SpecTask.new(:rcov) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :spec => :check_dependencies
+
+task :default => :spec
+
+begin
+  require 'yard'
+  YARD::Rake::YardocTask.new
+rescue LoadError
+  task :yardoc do
+    abort "YARD is not available. In order to run yardoc, you must: sudo gem install yard"
+  end
+end

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/lib/librarything/author.rb

@@ -0,0 +1,7 @@
+require File.expand_path(File.dirname(__FILE__) + "/shared_requires")
+
+module LibraryThing
+  class Author < LibraryThing::Resource
+    get_method 'librarything.ck.getauthor'
+  end
+end

data/lib/librarything/errors.rb

@@ -0,0 +1,3 @@
+module LibraryThing
+  class Error < Exception; end
+end

data/lib/librarything/resource.rb

@@ -0,0 +1,122 @@
+require 'httparty'
+
+module LibraryThing
+
+  class NodeWrapper
+
+    attr_reader :node
+
+    def initialize(node)
+      @node = node
+    end
+
+    def content
+      @node.content
+    end
+
+    def [](name)
+      # Check for attributes first. Why? It works for the LT xml (for now).
+      if @node.attributes.has_key?(name)
+        return @node.attributes[name].value
+      end
+
+      # Find child elements with that name
+      children = @node.xpath("lt:#{name}")
+      if children.size == 1
+        child = children.first
+      
+        # LT-specific hack to simplify access to lists. Ill-advised?
+        if child.name =~ /^[\w]*List$/
+          return wrap_children(child.children)
+        else
+          return NodeWrapper.new(child)
+        end
+      elsif children.size > 1
+        return wrap_children(children)
+      else
+        return nil
+      end
+    end
+
+    protected
+
+    def wrap_children(children)
+      children.map { |c| NodeWrapper.new(c) if c.element? }.compact
+    end
+  end
+
+  class Resource
+    include HTTParty
+    base_uri 'http://www.librarything.com/services/rest/1.0'
+
+    attr_reader :xml
+    attr_reader :document
+    attr_reader :item_node
+
+    def initialize(xml)
+      @xml = xml
+      @document = self.parse_response(@xml)
+      @item_node = self.find_item_node(@document)
+    end
+
+    def [](name)
+      @item_node[name]
+    end
+
+    protected
+
+    def parse_response(xml)
+      doc = Nokogiri::XML(xml)
+      self.check_for_errors(doc)
+      doc
+    end
+
+    def find_item_node(doc)
+      doc.root.add_namespace('lt', 'http://www.librarything.com/')
+      item = doc.xpath('/response/lt:ltml/lt:item').first
+      raise LibraryThing::Error.new('Missing item element in response') if item.nil?
+      NodeWrapper.new(item)
+    end
+
+    def check_for_errors(doc)
+      response = doc.xpath('//response')
+      raise LibraryThing::Error.new("LT response was missing the 'response' element.") if response.empty?
+
+      statuses = doc.xpath('//response/@stat')
+      status = statuses.first.value unless statuses.empty?
+      if status && status != 'ok'
+        errors = doc.xpath('//response/err')
+        error = errors.first unless errors.empty?
+        error_code = error.attributes['code'] if error
+        error_message = error.content if error
+
+        raise LibraryThing::Error.new("status = #{status}, error_code = #{error_code}, error_message = #{error_message}")
+      end
+    end
+
+    class << self
+      def get_method(method_name = nil)
+        if method_name
+          @get_method = method_name
+        elsif @get_method
+          @get_method
+        else
+          raise LibraryThing::Error.new('Cannot get a generic resource. Try LibraryThing::Work.get or LibraryThing::Author.get')
+        end
+      end
+
+      def get(query)
+        raise LibraryThing::Error.new("Missing developer key. Please define LibraryThing::DEVELOPER_KEY") unless defined?(LibraryThing::DEVELOPER_KEY)
+
+        all_params = {
+          :apikey => LibraryThing::DEVELOPER_KEY,
+          :method => self.get_method
+        }.merge(query)
+
+        response = super('', :query => all_params)
+        self.new(response.body)
+      end
+    end
+    
+  end
+end

data/lib/librarything/shared_requires.rb

@@ -0,0 +1,4 @@
+require 'httparty'
+require 'nokogiri'
+require File.expand_path(File.dirname(__FILE__) + "/errors")
+require File.expand_path(File.dirname(__FILE__) + "/resource")

data/lib/librarything/work.rb

@@ -0,0 +1,7 @@
+require File.expand_path(File.dirname(__FILE__) + "/shared_requires")
+
+module LibraryThing
+  class Work < LibraryThing::Resource
+    get_method 'librarything.ck.getwork'
+  end
+end

data/lib/librarything-api.rb

@@ -0,0 +1 @@
+require File.expand_path(File.dirname(__FILE__) + "/librarything")

data/lib/librarything.rb

@@ -0,0 +1,2 @@
+require File.expand_path(File.dirname(__FILE__) + "/librarything/author")
+require File.expand_path(File.dirname(__FILE__) + "/librarything/work")

data/spec/librarything/author_spec.rb

@@ -0,0 +1,83 @@
+require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
+
+describe LibraryThing::Author do
+  describe 'configuration' do
+    it "knows the method name for getting an author" do
+      LibraryThing::Author.get_method.should == 'librarything.ck.getauthor'
+    end
+  end
+
+  describe '#get' do
+    before(:each) do
+      @fake_response = load_response_body(LibraryThing::Author.get_method, '216')
+      @error_response = load_response_body(LibraryThing::Author.get_method, 'error')
+      @crash_response = load_response_body(LibraryThing::Author.get_method, 'crash')
+    end
+
+    it "complains if the response is not xml" do
+      expected_request_url = api_url(LibraryThing::Author.get_method, {:id => '216'})
+      FakeWeb.register_uri(:get, expected_request_url, :body => 'Not xml' )
+
+      lambda {
+        LibraryThing::Author.get(:id => '216')
+      }.should raise_error(LibraryThing::Error, 'LT response was missing the \'response\' element.')
+    end
+
+    it "complains if the response does not have the response element" do
+      expected_request_url = api_url(LibraryThing::Author.get_method, {:id => '216'})
+      FakeWeb.register_uri(:get, expected_request_url, :body => @crash_response )
+
+      lambda {
+        LibraryThing::Author.get(:id => '216')
+      }.should raise_error(LibraryThing::Error, 'LT response was missing the \'response\' element.')
+    end
+
+    it "complains if the response status is not 'ok'" do
+      expected_request_url = api_url(LibraryThing::Author.get_method, {:id => '216'})
+      FakeWeb.register_uri(:get, expected_request_url, :body => @error_response )
+
+      lambda {
+        LibraryThing::Author.get(:id => '216')
+      }.should raise_error(LibraryThing::Error, "status = fail, error_code = 106, error_message = Could not determine author from supplied arguments")
+    end
+
+    def check_author_response(author)
+      author.should_not be_nil
+      author['id'].should == '216'
+      author['url'].content.should == 'http://www.librarything.com/author/216'
+
+      author_element = author['author']
+      author_element.should_not be_nil
+      author_element['id'].should == '216'
+      author_element['authorcode'].should == 'clarkesusanna'
+      author_element['name'].content.should == 'Susanna Clarke'
+      
+      field_list = author['commonknowledge']['fieldList']
+      field_list.size.should == 8
+    end
+
+    it "retrieves an author by id" do
+      expected_request_url = api_url(LibraryThing::Author.get_method, {:id => '216'})
+      FakeWeb.register_uri(:get, expected_request_url, :body => @fake_response )
+
+      author = LibraryThing::Author.get(:id => 216)
+      check_author_response(author)
+    end
+
+    it "retrieves an author by authorcode" do
+      expected_request_url = api_url(LibraryThing::Author.get_method, {:authorcode => 'clarkesusanna'})
+      FakeWeb.register_uri(:get, expected_request_url, :body => @fake_response )
+
+      author = LibraryThing::Author.get(:authorcode => 'clarkesusanna')
+      check_author_response(author)
+    end
+
+    it "retrieves an author by name" do
+      expected_request_url = api_url(LibraryThing::Author.get_method, {:name => 'Clarke,+Susanna'})
+      FakeWeb.register_uri(:get, expected_request_url, :body => @fake_response )
+
+      author = LibraryThing::Author.get(:name => 'Clarke,+Susanna')
+      check_author_response(author)
+    end
+  end
+end

data/spec/librarything/resource_spec.rb

@@ -0,0 +1,9 @@
+require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
+
+describe LibraryThing::Resource do
+  it "complains about trying to get a Resource instance" do
+    lambda {
+      LibraryThing::Resource.get(:id => '123')
+    }.should raise_error(LibraryThing::Error, 'Cannot get a generic resource. Try LibraryThing::Work.get or LibraryThing::Author.get')
+  end
+end

data/spec/librarything/work_spec.rb

@@ -0,0 +1,127 @@
+require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
+
+describe LibraryThing::Work do
+  describe 'configuration' do
+    it "knows the method name for getting a work" do
+      LibraryThing::Work.get_method.should == 'librarything.ck.getwork'
+    end
+  end
+
+  describe '#get' do
+    before(:each) do
+      @fake_response = load_response_body(LibraryThing::Work.get_method, '1060')
+      @error_response = load_response_body(LibraryThing::Work.get_method, 'error')
+      @crash_response = load_response_body(LibraryThing::Work.get_method, 'crash')
+    end
+
+    it "complains if the response is not xml" do
+      expected_request_url = api_url(LibraryThing::Work.get_method, {:id => '1060'})
+      FakeWeb.register_uri(:get, expected_request_url, :body => 'Not xml' )
+
+      lambda {
+        LibraryThing::Work.get(:id => '1060')
+      }.should raise_error(LibraryThing::Error, 'LT response was missing the \'response\' element.')
+    end
+
+    it "complains if the response does not have the response element" do
+      expected_request_url = api_url(LibraryThing::Work.get_method, {:id => '1060'})
+      FakeWeb.register_uri(:get, expected_request_url, :body => @crash_response )
+
+      lambda {
+        LibraryThing::Work.get(:id => '1060')
+      }.should raise_error(LibraryThing::Error, 'LT response was missing the \'response\' element.')
+    end
+
+    it "complains if the response status is not 'ok'" do
+      expected_request_url = api_url(LibraryThing::Work.get_method, {:id => '1060'})
+      FakeWeb.register_uri(:get, expected_request_url, :body => @error_response )
+
+      lambda {
+        LibraryThing::Work.get(:id => '1060')
+      }.should raise_error(LibraryThing::Error, "status = fail, error_code = 105, error_message = Could not find work ID matching supplied arguments")
+    end
+
+    def check_work_response(work)
+      work.should_not be_nil
+      work['id'].should == '1060'
+      work['url'].content.should == 'http://www.librarything.com/work/1060'
+
+      author = work['author']
+      author.should_not be_nil
+      author['id'].should == '216'
+      author['authorcode'].should == 'clarkesusanna'
+      author.content.should == 'Susanna Clarke'
+      
+      field_list = work['commonknowledge']['fieldList']
+      field_list.size.should == 15
+
+      epigraph = field_list.first
+      epigraph['type'].should == '28'
+      epigraph['name'].should == 'epigraph'
+      epigraph['displayName'].should == 'Epigraph'
+      epigraph['versionList'].size.should == 1
+      
+      work['garbage'].should be_nil
+    end
+
+    it "retrieves a work by id" do
+      expected_request_url = api_url(LibraryThing::Work.get_method, {:id => '1060'})
+      FakeWeb.register_uri(:get, expected_request_url, :body => @fake_response )
+
+      work = LibraryThing::Work.get(:id => 1060)
+      check_work_response(work)
+    end
+
+    it "retrieves a work object by isbn" do
+      expected_request_url = api_url(LibraryThing::Work.get_method, {:isbn => '0765356155'})
+      FakeWeb.register_uri(:get, expected_request_url, :body => @fake_response )
+
+      work = LibraryThing::Work.get(:isbn => '0765356155')
+      check_work_response(work)
+    end
+
+    # Note: This appears to be broken on LT.
+    # 
+    # http://www.librarything.com/services/rest/1.0/?method=librarything.ck.getwork&lccn=PR6103.L375J65&apikey=XXXXXXX
+    # 
+    # <font color=ff0000>
+    # Warning: Missing argument 2 for workforLCCNorOCLC(), called in /var/www/html/services/rest/1.0/class_WS_CommonKnowledge.php on line 209 and defined in /var/www/html/inc_thingISBN.php on line 5
+    # </font><font color=ff0000>
+    # Warning: Invalid argument supplied for foreach() in /var/www/html/inc_thingISBN.php on line 13
+    # </font><?xml version="1.0" encoding="UTF-8"?>
+    # <response stat="fail"><err code="105">Could not find work ID matching supplied arguments</err></response>
+    # 
+    it "retrieves a work object by lccn" do
+      expected_request_url = api_url(LibraryThing::Work.get_method, {:lccn => 'PR6103.L375J65'})
+      FakeWeb.register_uri(:get, expected_request_url, :body => @fake_response )
+
+      work = LibraryThing::Work.get(:lccn => 'PR6103.L375J65')
+      check_work_response(work)
+    end
+
+    # Note: This appears to be broken on LT.
+    # 
+    # http://www.librarything.com/services/rest/1.0/?method=librarything.ck.getwork&oclc=185392674&apikey=XXXXXXX
+    # 
+    # <font color=ff0000>
+    # Warning: Invalid argument supplied for foreach() in /var/www/html/inc_thingISBN.php on line 12
+    # </font><?xml version="1.0" encoding="UTF-8"?>
+    # <response stat="fail"><err code="105">Could not find work ID matching supplied arguments</err></response>
+    # 
+    it "retrieves a work object by oclc id" do
+      expected_request_url = api_url(LibraryThing::Work.get_method, {:oclc => '185392674'})
+      FakeWeb.register_uri(:get, expected_request_url, :body => @fake_response )
+
+      work = LibraryThing::Work.get(:oclc => '185392674')
+      check_work_response(work)
+    end
+
+    it "retrieves a work object by name" do
+      expected_request_url = api_url(LibraryThing::Work.get_method, {:name => 'Jonathan+Strange'})
+      FakeWeb.register_uri(:get, expected_request_url, :body => @fake_response )
+
+      work = LibraryThing::Work.get(:name => 'Jonathan+Strange')
+      check_work_response(work)
+    end
+  end
+end

data/spec/librarything-api_spec.rb

@@ -0,0 +1,7 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe "LibrarythingApi" do
+  it "should require the librarything library" do
+    defined?(LibraryThing).should be_true
+  end
+end

data/spec/librarything_spec.rb

@@ -0,0 +1,11 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe LibraryThing do
+  it "should require the Work class" do
+    defined?(LibraryThing::Work).should be_true
+  end
+
+  it "should require the Author class" do
+    defined?(LibraryThing::Author).should be_true
+  end
+end

data/spec/spec.opts

@@ -0,0 +1,2 @@
+--color
+--format specdoc

data/spec/spec_helper.rb

@@ -0,0 +1,13 @@
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+require 'librarything-api'
+require 'spec'
+require 'spec/autorun'
+
+Dir[File.expand_path(File.join(File.dirname(__FILE__),'support','helpers','**','*.rb'))].each { |f| require f }
+
+LibraryThing::DEVELOPER_KEY = 'lt_test_key'
+
+Spec::Runner.configure do |config|
+  
+end

data/spec/support/helpers/fakeweb_helper.rb

@@ -0,0 +1,20 @@
+require 'fakeweb'
+require 'rack'
+
+def spec_support_dir
+  File.expand_path(File.join(File.dirname(__FILE__), '..'))
+end
+
+def load_response_body(method, id)
+  parts = [spec_support_dir, 'responses', method, "#{id}.xml"]
+  File.new(File.join(parts)).read
+end
+
+def api_url(method, params, include_key = true)
+  all_params = {:apikey => 'lt_test_key', :method => method}.merge(params) if include_key
+  all_params ||= params
+  query_string = Rack::Utils.build_query(all_params)
+  "http://www.librarything.com/services/rest/1.0?" + query_string
+end
+
+FakeWeb.allow_net_connect = false

data/spec/support/responses/librarything.ck.getauthor/216.xml

@@ -0,0 +1,137 @@
+<?xml version="1.0"?>
+<response stat="ok">
+  <ltml xmlns="http://www.librarything.com/" version="1.0">
+    <item id="216" type="author">
+      <author id="216" authorcode="clarkesusanna">
+        <name>Susanna Clarke</name>
+      </author>
+      <url>http://www.librarything.com/author/216</url>
+      <commonknowledge>
+        <fieldList>
+          <field type="6" name="placesofresidence" displayName="Places of residence">
+            <versionList>
+              <version id="1215367" archived="0" lang="eng">
+                <date timestamp="1236540583">Sun, 08 Mar 2009 15:29:43 -0400</date>
+                <person id="617371">
+                  <name>C.S._Lewis</name>
+                  <url>http://www.librarything.com/profile/C.S._Lewis</url>
+                </person>
+                <factList>
+                  <fact>County Durham, England, UK</fact>
+                  <fact>Nottingham, Nottinghamshire, England, UK (birth)</fact>
+                  <fact>Cambridge, Cambridgeshire, England, UK</fact>
+                  <fact>Oxford, Oxfordshire, England, UK</fact>
+                  <fact>Bilbao, Spain</fact>
+                  <fact>Turin, Italy</fact>
+                </factList>
+              </version>
+            </versionList>
+          </field>
+          <field type="22" name="canonicalname" displayName="Canonical name">
+            <versionList>
+              <version id="645774" archived="0" lang="eng">
+                <date timestamp="1223010501">Fri, 03 Oct 2008 01:08:21 -0400</date>
+                <person id="116044">
+                  <name>Shortride</name>
+                  <url>http://www.librarything.com/profile/Shortride</url>
+                </person>
+                <factList>
+                  <fact>Clarke, Susanna</fact>
+                </factList>
+              </version>
+            </versionList>
+          </field>
+          <field type="9" name="education" displayName="Education">
+            <versionList>
+              <version id="295469" archived="0" lang="eng">
+                <date timestamp="1206327674">Sun, 23 Mar 2008 23:01:14 -0400</date>
+                <person id="108140">
+                  <name>DisassemblyOfReason</name>
+                  <url>http://www.librarything.com/profile/DisassemblyOfReason</url>
+                </person>
+                <factList>
+                  <fact>Oxford University (St. Hilda's, 1981)</fact>
+                </factList>
+              </version>
+            </versionList>
+          </field>
+          <field type="18" name="nationality" displayName="Nationality">
+            <versionList>
+              <version id="291288" archived="0" lang="eng">
+                <date timestamp="1206114287">Fri, 21 Mar 2008 11:44:47 -0400</date>
+                <person id="45396">
+                  <name>bw42</name>
+                  <url>http://www.librarything.com/profile/bw42</url>
+                </person>
+                <factList>
+                  <fact>UK</fact>
+                </factList>
+              </version>
+            </versionList>
+          </field>
+          <field type="17" name="occupations" displayName="Occupations">
+            <versionList>
+              <version id="272547" archived="0" lang="eng">
+                <date timestamp="1204897922">Fri, 07 Mar 2008 08:52:02 -0500</date>
+                <person id="55491">
+                  <name>Osbaldistone</name>
+                  <url>http://www.librarything.com/profile/Osbaldistone</url>
+                </person>
+                <factList>
+                  <fact>editor</fact>
+                  <fact>writer</fact>
+                  <fact>author</fact>
+                  <fact>novelist</fact>
+                </factList>
+              </version>
+            </versionList>
+          </field>
+          <field type="4" name="awards" displayName="Awards and honors">
+            <versionList>
+              <version id="87001" archived="0" lang="eng">
+                <date timestamp="1194126277">Sat, 03 Nov 2007 17:44:37 -0400</date>
+                <person id="116044">
+                  <name>Shortride</name>
+                  <url>http://www.librarything.com/profile/Shortride</url>
+                </person>
+                <factList>
+                  <fact>British Book Award (Newcomer of the Year, 2005)</fact>
+                  <fact>Waterstones 25 Authors for the Future (2007)</fact>
+                </factList>
+              </version>
+            </versionList>
+          </field>
+          <field type="8" name="birthdate" displayName="Birthdate">
+            <versionList>
+              <version id="36742" archived="0" lang="eng">
+                <date timestamp="1192329357">Sat, 13 Oct 2007 22:35:57 -0400</date>
+                <person id="198088">
+                  <name>AnnaClaire</name>
+                  <url>http://www.librarything.com/profile/AnnaClaire</url>
+                </person>
+                <factList>
+                  <fact>1959-11-01</fact>
+                </factList>
+              </version>
+            </versionList>
+          </field>
+          <field type="5" name="gender" displayName="Gender">
+            <versionList>
+              <version id="7537" archived="0" lang="eng">
+                <date timestamp="1191988667">Tue, 09 Oct 2007 23:57:47 -0400</date>
+                <person id="1496">
+                  <name>felius</name>
+                  <url>http://www.librarything.com/profile/felius</url>
+                </person>
+                <factList>
+                  <fact>female</fact>
+                </factList>
+              </version>
+            </versionList>
+          </field>
+        </fieldList>
+      </commonknowledge>
+    </item>
+    <legal>By using this data you agree to the LibraryThing API terms of service.</legal>
+  </ltml>
+</response>

data/spec/support/responses/librarything.ck.getauthor/crash.xml

@@ -0,0 +1,3 @@
+<font color=ff0000>
+Fatal error: Call to undefined method WS_CommonKnowledge::returnError() in /var/www/html/services/rest/1.0/index.php on line 65
+</font>

data/spec/support/responses/librarything.ck.getauthor/error.xml

@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<response stat="fail">
+  <err code="106">Could not determine author from supplied arguments</err>
+</response>

data/spec/support/responses/librarything.ck.getwork/1060.xml

@@ -0,0 +1,286 @@
+<?xml version="1.0"?>
+<response stat="ok">
+  <ltml xmlns="http://www.librarything.com/" version="1.0">
+    <item id="1060" type="work">
+      <author id="216" authorcode="clarkesusanna">Susanna Clarke</author>
+      <url>http://www.librarything.com/work/1060</url>
+      <commonknowledge>
+        <fieldList>
+          <field type="28" name="epigraph" displayName="Epigraph">
+            <versionList>
+              <version id="2184856" archived="0" lang="eng">
+                <date timestamp="1265498292">Sat, 06 Feb 2010 18:18:12 -0500</date>
+                <person id="684944">
+                  <name>fig2</name>
+                  <url>http://www.librarything.com/profile/fig2</url>
+                </person>
+                <factList>
+                  <fact>&lt;![CDATA[ He hardly ever spoke of magic, and when he did it was like a history lesson and no one could bear to listen to him. ]]&gt;</fact>
+                </factList>
+              </version>
+            </versionList>
+          </field>
+          <field type="4" name="awards" displayName="Awards and honors">
+            <versionList>
+              <version id="2138966" archived="0" lang="eng">
+                <date timestamp="1264486541">Tue, 26 Jan 2010 01:15:41 -0500</date>
+                <person id="849103">
+                  <name>LamontCranston</name>
+                  <url>http://www.librarything.com/profile/LamontCranston</url>
+                </person>
+                <factList>
+                  <fact>World Fantasy Award (Novel, 2005)</fact>
+                  <fact>Hugo (Novel, 2005)</fact>
+                  <fact>British Fantasy Award Nominee (August Derleth Fantasy Award, 2005)</fact>
+                  <fact>British Science Fiction Association Award Shortlist (2004)</fact>
+                  <fact>Nebula Nominee (Novel, 2005)</fact>
+                  <fact>SF Site Editor's Choice (#1, 2004)</fact>
+                  <fact>Book Sense Book of the Year (2005.8 | Adult Fiction Winner, 2005)</fact>
+                  <fact>Whitbread Shortlist (First Novel, 2004)</fact>
+                  <fact>Locus Recommended Reading (First Novel, 2004)</fact>
+                  <fact>SF Site Reader's Choice (#1, 2004)</fact>
+                  <fact>Guardian 1000 (Science Fiction &amp; Fantasy)</fact>
+                  <fact>Time Magazine's Best Books of the Year (2004.10|Fiction (1), 2004)</fact>
+                  <fact>Salon Book Award (2004)</fact>
+                  <fact>Booker Prize Longlist (2004)</fact>
+                  <fact>Guardian First Book Award (Shortlist, 2004)</fact>
+                  <fact>British Book Award (Literary Fiction Award Shortlist, 2005)</fact>
+                  <fact>Locus (First Novel, 2005)</fact>
+                  <fact>Mythopoeic Fantasy Award (Adult Literature, 2005)</fact>
+                  <fact>British Book Award (Newcomer of the Year, 2005)</fact>
+                  <fact>Geffen Award (Best Translated Fantasy Book, 2007)</fact>
+                  <fact>thisrecording.com 100 Greatest Science Fiction or Fantasy Novels of All Time (95)</fact>
+                </factList>
+              </version>
+            </versionList>
+          </field>
+          <field type="3" name="characternames" displayName="People/Characters">
+            <versionList>
+              <version id="1931873" archived="0" lang="eng">
+                <date timestamp="1258228496">Sat, 14 Nov 2009 14:54:56 -0500</date>
+                <person id="108140">
+                  <name>DisassemblyOfReason</name>
+                  <url>http://www.librarything.com/profile/DisassemblyOfReason</url>
+                </person>
+                <factList>
+                  <fact>Jonathan Strange</fact>
+                  <fact>Gilbert Norrell</fact>
+                  <fact>The gentleman with thistle-down hair</fact>
+                  <fact>Stephen Black</fact>
+                  <fact>Lady Pole</fact>
+                  <fact>John Childermass</fact>
+                  <fact>Mr. Christopher Drawlight</fact>
+                  <fact>John Segundus</fact>
+                  <fact>Mr. Honeyfoot</fact>
+                  <fact>Dr. Foxcastle</fact>
+                  <fact>Mrs. Pleasance</fact>
+                  <fact>Mr. Thorpe</fact>
+                  <fact>Mrs. Godesdone</fact>
+                  <fact>Mr. Lascelles</fact>
+                  <fact>Vinculus</fact>
+                  <fact>John Uskglass (The Raven King)</fact>
+                  <fact>Arabella Strange</fact>
+                  <fact>Sir Walter Pole</fact>
+                  <fact>Emma Wintertowne</fact>
+                  <fact>Napoleon Bonaparte</fact>
+                  <fact>Arthur Wellesley, 1st Duke of Wellington</fact>
+                  <fact>George III, King of the United Kingdom</fact>
+                  <fact>Flora Greysteel</fact>
+                  <fact>Signor Tosetti</fact>
+                  <fact>The old lady of Cannregio</fact>
+                </factList>
+              </version>
+            </versionList>
+          </field>
+          <field type="2" name="placesmentioned" displayName="Important places">
+            <versionList>
+              <version id="1902680" archived="0" lang="eng">
+                <date timestamp="1257306914">Tue, 03 Nov 2009 22:55:14 -0500</date>
+                <person id="108140">
+                  <name>DisassemblyOfReason</name>
+                  <url>http://www.librarything.com/profile/DisassemblyOfReason</url>
+                </person>
+                <factList>
+                  <fact>London, England, UK</fact>
+                  <fact>York, Yorkshire, England, UK</fact>
+                  <fact>Faerie (fictional)</fact>
+                  <fact>France</fact>
+                  <fact>Portugal</fact>
+                  <fact>Venice, Veneto, Italy</fact>
+                  <fact>York Cathedral, York, Yorkshire, England, UK</fact>
+                  <fact>Shropshire, England, UK</fact>
+                  <fact>Lost-Hope, Faerie (fictional)</fact>
+                  <fact>Padua, Veneto, Italy</fact>
+                  <fact>Eternal Night (fictional)</fact>
+                </factList>
+              </version>
+            </versionList>
+          </field>
+          <field type="36" name="mediareviews" displayName="Media reviews">
+            <versionList>
+              <version id="1889043" archived="0" lang="eng">
+                <date timestamp="1256884900">Fri, 30 Oct 2009 02:41:40 -0400</date>
+                <person id="116044">
+                  <name>Shortride</name>
+                  <url>http://www.librarything.com/profile/Shortride</url>
+                </person>
+                <factList>
+                  <fact>129</fact>
+                  <fact>145</fact>
+                  <fact>146</fact>
+                  <fact>276</fact>
+                  <fact>1029</fact>
+                  <fact>4977</fact>
+                </factList>
+              </version>
+            </versionList>
+          </field>
+          <field type="27" name="quotations" displayName="Quotations">
+            <versionList>
+              <version id="1633900" archived="0" lang="eng">
+                <date timestamp="1248286869">Wed, 22 Jul 2009 14:21:09 -0400</date>
+                <person id="515980">
+                  <name>aynar</name>
+                  <url>http://www.librarything.com/profile/aynar</url>
+                </person>
+                <factList>
+                  <fact>&lt;![CDATA[ At sixteen she spoke -- not only French, Italian and German -- which are part of any lady's commonplace accomplishments -- but all the languages of the civilized (and uncivilized) world. She spoke the language of the Scottish Highlands (which is like singing). She spoke Basque, which is a language which rarely makes any impression upon the brains of any other race, so that a man may hear it as often and as long as he likes, but never afterwards be able to recall a single syllable of it. She even learnt the language of a strange country which, Signor Tosetti had been told, some people believed still existed, although no one in the world could say where it was. (The name of the country was Wales.) ]]&gt;</fact>
+                </factList>
+              </version>
+            </versionList>
+          </field>
+          <field type="1" name="literaryeditors" displayName="Publisher's editor">
+            <versionList>
+              <version id="1548889" archived="0" lang="eng">
+                <date timestamp="1245397367">Fri, 19 Jun 2009 03:42:47 -0400</date>
+                <person id="61510">
+                  <name>KingRat</name>
+                  <url>http://www.librarything.com/profile/KingRat</url>
+                </person>
+                <factList>
+                  <fact>Nielsen Hayden, Patrick</fact>
+                </factList>
+              </version>
+            </versionList>
+          </field>
+          <field type="34" name="events" displayName="Important events">
+            <versionList>
+              <version id="1494516" archived="0" lang="eng">
+                <date timestamp="1243869673">Mon, 01 Jun 2009 11:21:13 -0400</date>
+                <person id="517024">
+                  <name>aethercowboy</name>
+                  <url>http://www.librarything.com/profile/aethercowboy</url>
+                </person>
+                <factList>
+                  <fact>Peninsular War</fact>
+                  <fact>Napoleonic Wars</fact>
+                  <fact>Battle of Waterloo</fact>
+                </factList>
+              </version>
+            </versionList>
+          </field>
+          <field type="23" name="series" displayName="Series">
+            <versionList>
+              <version id="915020" archived="0" lang="eng">
+                <date timestamp="1232521494">Wed, 21 Jan 2009 02:04:54 -0500</date>
+                <person id="28389">
+                  <name>WylieMaercklein</name>
+                  <url>http://www.librarything.com/profile/WylieMaercklein</url>
+                </person>
+                <factList>
+                  <fact>Clarke's Faerie Stories (1)</fact>
+                </factList>
+              </version>
+            </versionList>
+          </field>
+          <field type="29" name="blurbers" displayName="Blurbers">
+            <versionList>
+              <version id="902293" archived="0" lang="eng">
+                <date timestamp="1232212596">Sat, 17 Jan 2009 12:16:36 -0500</date>
+                <person id="200103">
+                  <name>PhaedraB</name>
+                  <url>http://www.librarything.com/profile/PhaedraB</url>
+                </person>
+                <factList>
+                  <fact>Gaiman, Neil </fact>
+                  <fact>Palliser, Charles </fact>
+                </factList>
+              </version>
+            </versionList>
+          </field>
+          <field type="21" name="canonicaltitle" displayName="Canonical title">
+            <versionList>
+              <version id="705800" archived="0" lang="eng">
+                <date timestamp="1225654390">Sun, 02 Nov 2008 14:33:10 -0500</date>
+                <person id="61056">
+                  <name>amweb</name>
+                  <url>http://www.librarything.com/profile/amweb</url>
+                </person>
+                <factList>
+                  <fact>Jonathan Strange &amp; Mr Norrell</fact>
+                </factList>
+              </version>
+            </versionList>
+          </field>
+          <field type="30" name="dedication" displayName="Dedication">
+            <versionList>
+              <version id="644458" archived="0" lang="eng">
+                <date timestamp="1222962793">Thu, 02 Oct 2008 11:53:13 -0400</date>
+                <person id="200103">
+                  <name>PhaedraB</name>
+                  <url>http://www.librarything.com/profile/PhaedraB</url>
+                </person>
+                <factList>
+                  <fact>&lt;![CDATA[ In memory of my brother, Paul Frederick Gunn Clarke, 1961-2000 ]]&gt;</fact>
+                </factList>
+              </version>
+            </versionList>
+          </field>
+          <field type="26" name="lastwords" displayName="Last words">
+            <versionList>
+              <version id="523019" archived="0" lang="eng">
+                <date timestamp="1218425509">Sun, 10 Aug 2008 23:31:49 -0400</date>
+                <person id="23570">
+                  <name>conceptDawg</name>
+                  <url>http://www.librarything.com/profile/conceptDawg</url>
+                </person>
+                <factList>
+                  <fact>&lt;![CDATA[ Then he turned upon his heel and disappeared into the Darkness. ]]&gt;</fact>
+                </factList>
+              </version>
+            </versionList>
+          </field>
+          <field type="25" name="firstwords" displayName="First words">
+            <versionList>
+              <version id="523018" archived="0" lang="eng">
+                <date timestamp="1218425423">Sun, 10 Aug 2008 23:30:23 -0400</date>
+                <person id="23570">
+                  <name>conceptDawg</name>
+                  <url>http://www.librarything.com/profile/conceptDawg</url>
+                </person>
+                <factList>
+                  <fact>&lt;![CDATA[ Some years ago there was in the city of York a society of magicians. ]]&gt;</fact>
+                </factList>
+              </version>
+            </versionList>
+          </field>
+          <field type="16" name="originalpublicationdate" displayName="Original publication date">
+            <versionList>
+              <version id="132984" archived="0" lang="eng">
+                <date timestamp="1198164481">Thu, 20 Dec 2007 10:28:01 -0500</date>
+                <person id="311651">
+                  <name>tom1066</name>
+                  <url>http://www.librarything.com/profile/tom1066</url>
+                </person>
+                <factList>
+                  <fact>2004-09-08</fact>
+                </factList>
+              </version>
+            </versionList>
+          </field>
+        </fieldList>
+      </commonknowledge>
+    </item>
+    <legal>By using this data you agree to the LibraryThing API terms of service.</legal>
+  </ltml>
+</response>

data/spec/support/responses/librarything.ck.getwork/crash.xml

@@ -0,0 +1,3 @@
+<font color=ff0000>
+Fatal error: Call to undefined method WS_CommonKnowledge::returnError() in /var/www/html/services/rest/1.0/index.php on line 65
+</font>

data/spec/support/responses/librarything.ck.getwork/error.xml

@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<response stat="fail">
+  <err code="105">Could not find work ID matching supplied arguments</err>
+</response>

metadata

@@ -0,0 +1,137 @@
+--- !ruby/object:Gem::Specification 
+name: librarything-api
+version: !ruby/object:Gem::Version 
+  version: 0.1.0
+platform: ruby
+authors: 
+- Jason Wadsworth
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-03-13 00:00:00 -05:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.3.0
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: fakeweb
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.2.8
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: yard
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: httparty
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.5.2
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: nokogiri
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.4.1
+    version: 
+description: Gem for accessing the LibraryThing API
+email: jdwadsworth@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.rdoc
+files: 
+- .document
+- .gitignore
+- LICENSE
+- README.rdoc
+- Rakefile
+- VERSION
+- lib/librarything-api.rb
+- lib/librarything.rb
+- lib/librarything/author.rb
+- lib/librarything/errors.rb
+- lib/librarything/resource.rb
+- lib/librarything/shared_requires.rb
+- lib/librarything/work.rb
+- spec/librarything-api_spec.rb
+- spec/librarything/author_spec.rb
+- spec/librarything/resource_spec.rb
+- spec/librarything/work_spec.rb
+- spec/librarything_spec.rb
+- spec/spec.opts
+- spec/spec_helper.rb
+- spec/support/helpers/fakeweb_helper.rb
+- spec/support/responses/librarything.ck.getauthor/216.xml
+- spec/support/responses/librarything.ck.getauthor/crash.xml
+- spec/support/responses/librarything.ck.getauthor/error.xml
+- spec/support/responses/librarything.ck.getwork/1060.xml
+- spec/support/responses/librarything.ck.getwork/crash.xml
+- spec/support/responses/librarything.ck.getwork/error.xml
+has_rdoc: true
+homepage: http://github.com/subakva/librarything-api
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: Gem for accessing the LibraryThing API
+test_files: 
+- spec/librarything/author_spec.rb
+- spec/librarything/resource_spec.rb
+- spec/librarything/work_spec.rb
+- spec/librarything-api_spec.rb
+- spec/librarything_spec.rb
+- spec/spec_helper.rb
+- spec/support/helpers/fakeweb_helper.rb