oclc_classify 0.0.1

data/.gitignore

@@ -0,0 +1,2 @@
+*.gem
+*.lock

data/Gemfile

@@ -0,0 +1,5 @@
+source 'http://rubygems.org'
+
+gem 'open-uri'
+gem 'nokogiri'
+gem 'shoulda'

data/README.txt

@@ -0,0 +1,59 @@
+= oclc_classify
+
+http://www.libcode.net/
+
+== DESCRIPTION:
+
+Retrieve dewey decimal numbers from OCLC's classify service
+
+== FEATURES/PROBLEMS:
+
+Very much a work in progress ...
+
+== SYNOPSIS:
+
+oclc = OCLC::Classify.new 'oclc', '610837844'
+result = oclc.classify
+p result.author
+p result.title
+r = result.recommendations 'ddc', :popular
+s = result.recommendations 'ddc', :recent
+t = result.recommendations 'ddc', :latest
+p r
+p s
+p t
+r.each {|k,v| puts k['nsfa'] }
+
+== REQUIREMENTS:
+
+nokogiri
+open-uri
+
+== INSTALL:
+
+sudo gem install oclc_classify
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2011 FIX
+
+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/Rakefile

@@ -0,0 +1,28 @@
+# -*- ruby -*-
+
+require 'rake/testtask'
+
+desc "Validate the gemspec"
+task :gemspec do
+  	gemspec.validate
+end
+
+desc "Build gem locally"
+task :build => :gemspec do
+	system "gem build #{gemspec.name}.gemspec"
+	FileUtils.mkdir_p "pkg"
+	FileUtils.mv "#{gemspec.name}-#{gemspec.version}.gem", "pkg"
+end
+
+desc "Install gem locally"
+task :install => :build do
+  	system "gem install pkg/#{gemspec.name}-#{gemspec.version}"
+end
+
+Rake::TestTask.new do |t|
+	t.libs << "test"
+	t.test_files = FileList['test/test*.rb']
+	t.verbose = true
+end
+
+# vim: syntax=ruby

data/lib/oclc_classify.rb

@@ -0,0 +1,140 @@
+module OCLC
+
+	VERSION = '0.0.1'
+	require 'nokogiri'
+	require 'open-uri'
+
+	BASE_URL = 'http://classify.oclc.org/classify2/Classify?'
+	
+	ARGUMENTS = [
+		'stdnbr',
+		'oclc',
+		'isbn',
+		'issn',
+		'upc',
+		'ident',
+		'heading',
+		'lccn',
+		'lccn_pfx',
+		'lccn_yr',
+		'lccn_sno',
+		'swid',
+		'author',
+		'title',
+		'summary',
+	]
+
+	ORDER_KEY = 'orderBy'
+	MXREC_KEY = 'maxRecs'
+
+	class Classify
+	
+		attr_reader :url
+
+		##
+		# oclc = OCLC::Classify.new 'oclc', '610837844'
+		# result = oclc.classify
+		# p result.author
+		# p result.title
+		# r = result.recommendations 'ddc', :popular
+		# s = result.recommendations 'ddc', :recent
+		# t = result.recommendations 'ddc', :latest
+		# p r
+		# p s
+		# p t
+		# r.each {|k,v| puts k['nsfa'] }
+
+		def initialize(input, value, summary = false, orderBy = nil, maxRecs = nil)
+			raise "Invalid argument parameter: " + input unless ARGUMENTS.include? input
+			@summary = summary ? '&summary=true' : '&summary=false'
+			@query_string = input + '=' + value + @summary
+			@orderBy = orderBy
+			@maxRecs = maxRecs.to_s if maxRecs
+			self
+		end
+
+		def orderBy(entry)
+			@orderBy ||= entry
+		end
+
+		def maxRecs(number)
+			@maxRecs ||= number.to_s
+		end
+
+		def classify
+			@url = construct_query
+			return OCLC::Classify::Response.new(@url)
+		end
+
+		private
+
+		def construct_query
+			query = BASE_URL + @query_string
+			query = query + '&' + ORDER_KEY + '=' + @orderBy if @orderBy
+			query = query + '&' + MXREC_KEY + '=' + @maxRecs if @maxRecs
+			return query
+		end
+
+		class Response
+
+			attr_reader :response, :code, :author, :title
+
+			XPATH = {
+				:code            => '//response/@code',
+				:author          => '//work/@author',
+				:title           => '//work/@title',
+				:recommendations => '//recommendations',
+			}
+
+			KEYS = {
+				:popular => 'mostpopular',
+				:recent  => 'mostrecent',
+				:latest  => 'latestedition',
+			}
+
+			def initialize(url)
+				@response = Nokogiri::HTML(open(url))
+				@code     = @response.xpath(XPATH[:code]).to_s
+				@author   = @response.xpath(XPATH[:author]).to_s
+				@title    = @response.xpath(XPATH[:title]).to_s
+			end
+
+			def recommendations(scheme, key)
+				raise "Invalid scheme: must be 'ddc' or 'lcc'" unless scheme =~ /(dd|lc)c/
+				raise "Invalid key: " + key.to_s unless KEYS.keys.include? key 
+				path = '/' + scheme + '/' + KEYS[key]
+				if @code == '0' or @code == '2'
+					results = OCLC::Classify::Recommendations.new(@response.xpath(XPATH[:recommendations] + path))
+					results.process
+					return results.recommendations
+				else
+					return []
+				end
+			end
+		
+		end
+
+		class Recommendations
+			
+			attr_reader :recommendations
+
+			def initialize(xml)
+				@xml = xml
+				@recommendations = []
+			end
+
+			def process
+				@xml.each do |r|
+					box = {}
+					k = r.attributes.keys
+					r.attribute_nodes.each_with_index do |a, idx|
+						box[k[idx]] = a.value
+					end
+					@recommendations << box
+				end
+			end
+
+		end
+		
+	end
+end

data/oclc_classify.gemspec

@@ -0,0 +1,48 @@
+#!/usr/bin/env gem build
+# encoding: utf-8
+
+require "base64"
+
+Gem::Specification.new do |s|
+  s.name = %q{oclc_classify}
+  s.version = "0.0.1"
+  s.authors = ["Mark Cooper"]
+  s.date = %q{2011-11-22}
+  s.homepage = %q{http://www.libcode.net}
+  s.email = Base64.decode64("bWFya2NocmlzdG9waGVyY29vcGVyQGdtYWlsLmNvbQ==\n")
+  
+  s.summary = "Retrieve dewey decimal numbers from OCLC's classify service"
+  s.description = "#{s.summary}"
+  s.cert_chain = nil
+  s.has_rdoc = true
+
+  # files
+  s.files = `git ls-files`.split("\n")
+  s.test_files = `git ls-files test`.split("\n")
+  s.extra_rdoc_files = ["README.txt"]
+  s.rdoc_options = ["--main", "README.txt"]
+
+  Dir["bin/*"].map(&File.method(:basename))
+  # s.default_executable = "example"
+  s.require_paths = ["lib"]
+
+  # Ruby version
+  s.required_ruby_version = ::Gem::Requirement.new("~> 1.9")
+
+  # dependencies
+  # RubyGems has runtime dependencies (add_dependency) and
+  # development dependencies (add_development_dependency)
+  # s.add_development_dependency "simple-templater", ">= 0.0.1.2"
+  s.add_development_dependency "bundler"
+
+  begin
+    require "changelog"
+  rescue LoadError
+    warn "You have to have changelog gem installed for post install message"
+  else
+    s.post_install_message = CHANGELOG.new.version_changes
+  end
+
+  # RubyForge
+  s.rubyforge_project = %q{oclc_classify}
+end

data/test/test_oclc_classify.rb

@@ -0,0 +1,22 @@
+require "shoulda"
+require "oclc_classify"
+
+class TestOclcClassify < Test::Unit::TestCase
+	
+	context "" do
+
+  		setup do
+	    	@oclc = OCLC::Classify.new 'oclc', '123456'
+	    	@isbn = OCLC::Classify.new 'isbn', '987654321', true
+	    	@oclc.classify
+	    	@isbn.classify
+  		end
+  		
+  		should "Have constructed correct url" do 
+  			assert_equal 'http://classify.oclc.org/classify2/Classify?oclc=123456&summary=false', @oclc.url
+  			assert_equal 'http://classify.oclc.org/classify2/Classify?isbn=987654321&summary=true', @isbn.url
+  		end
+
+  	end
+
+end

metadata

@@ -0,0 +1,68 @@
+--- !ruby/object:Gem::Specification
+name: oclc_classify
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Mark Cooper
+autorequire: 
+bindir: bin
+cert_chain: 
+date: 2011-11-22 00:00:00.000000000 -08:00
+default_executable: 
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: &10358940 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *10358940
+description: Retrieve dewey decimal numbers from OCLC's classify service
+email: markchristophercooper@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- README.txt
+files:
+- .gitignore
+- Gemfile
+- README.txt
+- Rakefile
+- lib/oclc_classify.rb
+- oclc_classify.gemspec
+- test/test_oclc_classify.rb
+has_rdoc: true
+homepage: http://www.libcode.net
+licenses: []
+post_install_message: 
+rdoc_options:
+- --main
+- README.txt
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ~>
+    - !ruby/object:Gem::Version
+      version: '1.9'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: oclc_classify
+rubygems_version: 1.5.2
+signing_key: 
+specification_version: 3
+summary: Retrieve dewey decimal numbers from OCLC's classify service
+test_files:
+- test/test_oclc_classify.rb