classifoclc 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: ac9cfb0520534dc348802194962647569fa8f18e
+  data.tar.gz: d2156f7446f3946d95070269fe49353cc4968366
+SHA512:
+  metadata.gz: 751f946d8157c1c403e078fa4cb67b7e2e783713b6c05bd0c8cc4ad31fe4d8adee9d36df361066b7493d70e4a335aa2b8cf76b2a286da17f019f75cddf5d9cc9
+  data.tar.gz: d6563c241c508cbd1a8c5e359cd41b38a011735622db4235d6b70f4ce901a1bdf4104742cec2583801618dedc93802276b830472cc0c67dba1924c10fab42f2e

data/.gitignore

@@ -0,0 +1,16 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+# rspec failure tracking
+.rspec_status
+
+Gemfile.lock
+*.gem
+# Emacs files
+*~

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.travis.yml

@@ -0,0 +1,10 @@
+sudo: false
+language: ruby
+rvm:
+  - 2.5
+  - 2.4
+  - 2.4
+  - 2.3
+  - 2.2
+  - 2.1
+before_install: gem install bundler -v 1.16.1

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,74 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as
+contributors and maintainers pledge to making participation in our project and
+our community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, gender identity and expression, level of experience,
+nationality, personal appearance, race, religion, or sexual identity and
+orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment
+include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or
+advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic
+  address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable
+behavior and are expected to take appropriate and fair corrective action in
+response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community. Examples of
+representing a project or community include using an official project e-mail
+address, posting via an official social media account, or acting as an appointed
+representative at an online or offline event. Representation of a project may be
+further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting the project team at github-smr@sneakemail.com. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. The project team is
+obligated to maintain confidentiality with regard to the reporter of an incident.
+Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good
+faith may face temporary or permanent repercussions as determined by other
+members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
+available at [http://contributor-covenant.org/version/1/4][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/4/

data/Gemfile

@@ -0,0 +1,12 @@
+source "https://rubygems.org"
+
+git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }
+
+# Specify your gem's dependencies in classifoclc.gemspec
+gemspec
+
+# Added at 2018-04-08 10:18:30 -0400 by sean:
+gem "webmock", "~> 3.3", :group => [:development]
+
+# Added at 2018-04-08 11:15:19 -0400 by sean:
+gem "nokogiri", "~> 1.8"

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2018 Sean Redmond
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,184 @@
+# Classifoclc
+
+Interface to OCLC's Classify service, "a FRBR-based prototype designed to
+support the assignment of classification numbers and subject headings for books,
+DVDs, CDs, and other types of materials." See the [OCLC
+documentation](https://www.oclc.org/developer/develop/web-services/classify.en.html). Classifoclc
+is aimed mainly at getting works from various other identifiers.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'classifoclc'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install classifoclc
+
+## Usage
+
+### Look ups
+
+The easiest way to use `Classifoclc` is to lookup works by several standard identifiers:
+
+* `Classifoclc::isbn`
+* `Classifoclc::lccn`
+* `Classifoclc::oclc`
+* `Classifoclc::owi`
+
+Each of these returns an `Enumerator` that can be looped over to get the
+individual `Classifoclc::Work` objects. A "work" is an abstraction, and each
+work has one or more editions. An "edition" is a physical (or digital) item that
+can be held by a library. From the `Classifoclc::Work` object you can get
+several pieces of information, most usefully, perhaps, the number of editions
+(`#edition_count`), the number of libraries that hold the work (`#holdings`) and
+and that hold the work digitally (`#eholdings`), and the editions themselves (`#editions`)
+
+    > works = Classifoclc::isbn("0151592659")
+    > wrk = works.first
+    > wrk.title
+     => "Meridian"
+    > wrk.owi
+     => "201096"
+    > wrk.format
+     => "Book"
+    > wrk.itemtype
+     => "itemtype-book"
+    > wrk.edition_count
+     => 114
+    > wrk.holdings
+     => 3264
+    > wrk.eholdings
+     => 196
+    > wrk.editions # Returns an Enumerator
+    > wrk.authors # Returns an Array
+    > wrk.recommendations # Returns a Recommendations object
+    
+
+A work has an array authors which seems to include all the authors of all the
+editions of a work, including their VIAF and LC identifiers:
+
+    > work = Classifoclc::isbn("0151592659").first
+    > auth = work.authors.first
+    > auth.name
+     => "Walker, Alice, 1944-"
+    > auth.viaf
+     => "108495772"
+    > auth.lc
+     => "n79109131"
+
+You can also lookup by author(`Classifoclc::author`), title
+(`Classifoclc::title`) and FAST identifier (`Classifoclc::fast`) but these can
+return a _very large_ number of results that take a long time and thousands of
+requests to return.
+
+Finally, you can search by author and title:
+
+    > works = Classifoclc::authorAndTitle("Walker, Alice", "Meridian")
+	> works.count
+	 => 5
+	> works.first.owi
+     => "201096"
+    > works.first.edition_count
+     => 114	 
+
+### Sort order
+
+You can change how the results are sorted by passing an `:orderby` and/or
+`:order` parameter to the lookup. `:orderby` can take one of the following
+values:
+
+|Contant|Meaning|
+|-------|-------|
+|`Classifoclc::OrderBy::EDITIONS`|Number of editions the work has (default)|
+|`Classifoclc::OrderBy::HOLDINGS`|Number of libraries that hold the work|
+|`Classifoclc::OrderBy::FIRSTYEAR`|Date of first edition|
+|`Classifoclc::OrderBy::LASTYEAR`|Date of latest edition|
+|`Classifoclc::OrderBy::LANGUAGE`|Language|
+|`Classifoclc::OrderBy::HEADING`|FAST subject heading|
+|`Classifoclc::OrderBy::WORKS`|Number of works with this FAST subject heading|
+|`Classifoclc::OrderBy::SUBJTYPE`|FAST subject type|
+
+`:order` can be either `Classifoclc::Order::ASC` (default) or `Classifoclc::Order::DESC`.
+
+    > works = Classifoclc::isbn("0151592659", :orderby => Classifoclc::OrderBy::HOLDINGS, :order => Classifoclc::Order::DESC)
+    
+### Editions
+
+Use the `#editions` method to get editions of a work. The method returns an `Enumerator`
+
+    > work = Classifoclc::isbn("0151592659").first
+    > work.edition_count
+     => 114
+    > work.editions.each do |ed|
+     # 114 loops
+    > end
+    > ed = work.editions.first
+    > ed.oclc
+     => "2005960"
+    > ed.title
+     => "Meridian"
+    > ed.format
+     => "Book"
+    > ed.itemtype
+     => "itemtype-book"
+    > ed.holdings
+     => 1420
+    > ed.eholdings
+     => 0
+    > ed.language
+     => "eng"
+    > ed.authors
+     => "Walker, Alice, 1944-"
+    > ed.classifications
+     => [{:edition=>"0", :ind1=>"0", :ind2=>"0", :sf2=>"00", :sfa=>"813.54", :tag=>"082"}, {:ind1=>"0", :ind2=>"0", :sfa=>"PS3573.A425", :tag=>"050"}, {:ind1=>"0", :ind2=>"0", :sfa=>"PZ4.W176", :tag=>"050"}]
+     
+Note that `Edition#authors` just returns a string, _not_ an Array of `Author` objects like `Work#authors`
+
+For the meaning of the classifications, refer to the [OCLC documentation](https://www.oclc.org/developer/develop/web-services/classify/classification.en.html).
+
+### Recommendations
+
+Each `Work` has a set of recommended classifications available through the `#recommendations` method. This returns a `Recommendations` object
+
+    > work = Classifoclc::isbn("0151592659").first
+    > recs = work.recommendations
+    
+The recommendations include an array of FAST subject headings
+
+    > recs.fast.first
+     => {:heading=>"Southern States", :holdings=>"2945", :ident=>"1244550"}
+     
+LCC and Dewey Decimal recommendations are each hashes with the possible keys `:mostPopular`, `:mostRecent`, and `:latestEdition`. For each key the value is an array of recommended classifiers:
+
+    > recs.lcc[:mostPopular].first
+     => {:holdings=>"3221", :nsfa=>"PS3573.A425", :sfa=>"PS3573.A425"}
+    recs.ddc[:mostPopular].first
+     => {:holdings=>"2632", :nsfa=>"813.54", :sfa=>"813.54"}
+     
+For the meaning of the classifications, refer to the [OCLC documentation](https://www.oclc.org/developer/develop/web-services/classify/classification.en.html).
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/seanredmond/classifoclc. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+
+## Code of Conduct
+
+Everyone interacting in the Classifoclc project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/seanredmond/classifoclc/blob/master/CODE_OF_CONDUCT.md).

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "classifoclc"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/classifoclc.gemspec

@@ -0,0 +1,26 @@
+
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "classifoclc/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "classifoclc"
+  spec.version       = Classifoclc::VERSION
+  spec.authors       = ["Sean Redmond"]
+  spec.email         = ["github-smr@sneakemail.com"]
+
+  spec.summary       = %q{Interface to OCLC Classify service}
+  spec.homepage      = "https://github.com/seanredmond/classifoclc"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.16"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec", "~> 3.0"
+end

data/lib/classifoclc.rb

@@ -0,0 +1,201 @@
+require "classifoclc/author.rb"
+require "classifoclc/constants.rb"
+require "classifoclc/edition.rb"
+require "classifoclc/errors.rb"
+require "classifoclc/recommendations"
+require "classifoclc/version"
+require "classifoclc/work"
+require "nokogiri"
+require "open-uri"
+require "uri"
+
+# Interface to OCLC's Classify service, "a FRBR-based prototype designed to
+# support the assignment of classification numbers and subject headings for
+# books, DVDs, CDs, and other types of materials."
+#
+# @see https://www.oclc.org/developer/develop/web-services/classify.en.html
+#   OCLC Documentation
+module Classifoclc
+  # Number of records returned per request
+  @@maxRecs = 25
+
+  # @overload maxRecs
+  #   Get the max records per request
+  #   @return [Numeric] 
+  # @overload maxRecs=(value)
+  #   Set the max records
+  #   @param value [Numeric] the new value
+  #   @return [Numeric] the new value
+  def self.maxRecs
+    @@maxRecs
+  end
+
+  def self.maxRecs= m
+    @@maxRecs = m
+  end
+
+  # Find works by ISBN number
+  # @param [String] isbn ISBN number to search for
+  # @param [Hash] hsh more options
+  # @return [Enumerator<Classifoclc::Work>]
+  def self.isbn(isbn, hsh = {})
+    lookup(default_options(hsh, {:identifier => Id::ISBN, :value  => isbn}))
+  end
+
+  # Find works by OCLC work ID
+  # @param [String] owi Work ID to search for
+  # @param [Hash] hsh more options
+  # @return [Enumerator<Classifoclc::Work>]
+  def self.owi(owi, hsh = {})
+    lookup(default_options(hsh, {:identifier => Id::OWI, :value  => owi, :summary => false}))
+  end
+
+  # Find works by OCLC number
+  # @param [String] oclc OCLC number to search for
+  # @param [Hash] hsh more options
+  # @return [Enumerator<Classifoclc::Work>]
+  def self.oclc(oclc, hsh = {})
+    lookup(default_options(hsh, {:identifier => Id::OCLC, :value  => oclc}))
+  end
+
+  # Find works by Library of Congress Control Number
+  # @param [String] lccn LCCN to search for
+  # @param [Hash] hsh more options
+  # @return [Enumerator<Classifoclc::Work>]
+  def self.lccn(lccn, hsh = {})
+    lookup(default_options(hsh, {:identifier => Id::LCCN, :value  => lccn}))
+  end
+
+  # Find works by author
+  # @param [String] author Author to search for
+  # @param [Hash] hsh more options
+  # @return [Enumerator<Classifoclc::Work>]
+  def self.author(auth, hsh = {})
+    lookup(default_options(hsh, {:identifier => Id::AUTHOR, :value  => auth}))
+  end
+
+  # Find works by title
+  # @param [String] title Titleto search for
+  # @param [Hash] hsh more options
+  # @return [Enumerator<Classifoclc::Work>]
+  def self.title(title, hsh = {})
+    lookup(default_options(hsh, {:identifier => Id::TITLE, :value  => title}))
+  end
+
+  # Find works by author and title
+  # @param [String] author Author to search for
+  # @param [String] title Title to search for
+  # @param [Hash] hsh more options
+  # @return [Enumerator<Classifoclc::Work>]
+  def self.authorAndTitle(author, title, hsh = {})
+    lookup(default_options(hsh, {:identifier => [Id::AUTHOR, Id::TITLE], :value => [author, title], :summary => false}))
+  end
+
+  # Find works by FAST subject heading
+  # @param [String] fast FAST subject ID to search for
+  # @param [String] title Title to search for
+  # @param [Hash] hsh more options
+  # @return [Enumerator<Classifoclc::Work>]
+  def self.fast(ident, hsh = {})
+    lookup(default_options(hsh, {:identifier => Id::IDENT, :value  => ident}))
+  end
+  
+  private_class_method def self.lookup(hsh)
+    parsed = fetch_data(hsh)
+    resp_code = parsed.css('response').first['code']
+
+    if resp_code == '0'
+      owid = parsed.css('work').first['owi']
+      return owi(owid)
+    end
+
+    if resp_code == '2'
+      return Enumerator.new do |w|
+        w << Work::new(parsed)
+      end
+    end
+
+    if resp_code == "4"
+      if hsh[:identifier] == :owi
+        if parsed.css('work').map{|w| w['owi']}.include?(hsh[:value])
+          raise Classifoclc::InfiniteLoopError.new("The record for owi %s contains records also with the owi %s. Cannot fetch data as it would lead to an infinite loop" % [hsh[:value], hsh[:value]])
+        end
+      end
+      return multiwork(parsed, hsh)
+    end
+    
+    if resp_code == '100'
+      raise BadIdentifierError.
+              new "%s is not allowed as an identifer" % hsh[:identifier]
+    end
+
+    if resp_code == '101'
+      raise BadIdentifierFormatError.
+              new "Invalid format (%s) for %s identifier" %
+                  [hsh[:value], hsh[:identifier]]
+    end
+
+    if resp_code =='102'
+      return Enumerator.new do |w|
+      end
+    end
+
+    if resp_code == '200'
+      raise UnexpectedError.new "Unexpected error"
+    end
+    
+    raise UnexpectedError.new "Unexpected response code %s" % resp_code
+  end
+
+  private_class_method def self.multiwork(parsed, hsh)
+    return Enumerator.new do |work|
+      loop do
+        if parsed.css("navigation next").empty?
+          next_page = nil
+        else
+          next_page = parsed.css("navigation next").first.text
+        end
+        
+        parsed.css('work').each do |multi|
+          owi(multi['owi']).each do |w|
+            work << w
+          end
+        end
+        break if next_page.nil?
+        parsed = fetch_data(hsh.clone.merge({:startRec => next_page}))
+      end
+    end
+  end
+
+  private_class_method def self.default_options(hsh1, hsh2 = {})
+    {:orderby => OrderBy::HOLDINGS,
+     :order => Order::DESC,
+     :maxRecs => maxRecs,
+     :summary => true}.merge(hsh1).merge(hsh2)
+  end
+
+  private_class_method def self.api_params(hsh)
+    params = {:orderBy => "%s %s" % [hsh.delete(:orderby), hsh.delete(:order)]}.merge(hsh)
+    return params
+  end
+  
+  private_class_method def self.param_string(hsh)
+    id = hsh.delete(:identifier)
+    val = hsh.delete(:value)
+
+    if id.is_a? Array
+      params = default_options(Hash[id.zip(val)], hsh)
+    else
+      params = default_options({id => val}, hsh)
+    end
+    
+    return api_params(params)
+             .map{|k,v| "#{k}=#{URI.encode_www_form_component(v)}"}.join("&") 
+  end
+
+  def self.fetch_data(hsh)
+    resp = open(URL % param_string(hsh.clone), "User-Agent" => "Classifoclc/#{Classifoclc::VERSION}",).read
+    parsed = Nokogiri::XML(resp)
+    return parsed
+  end
+end

data/lib/classifoclc/author.rb

@@ -0,0 +1,21 @@
+module Classifoclc
+  # Author of a Classifoclc::Work
+  class Author
+    # The author's name
+    # @return [String]
+    attr_reader :name
+
+    # The author's Library of Congress id number
+    # @return [String]
+    attr_reader :lc
+
+    # The author's VIAF number
+    # @return [String]
+    attr_reader :viaf
+    def initialize(name, lc, viaf)
+      @name = name
+      @lc = lc
+      @viaf = viaf
+    end
+  end
+end

data/lib/classifoclc/constants.rb

@@ -0,0 +1,44 @@
+module Classifoclc
+
+  URL = "http://classify.oclc.org/classify2/Classify?%s"
+
+  # See http://classify.oclc.org/classify2/api_docs/classify.html
+  
+  # API also allows stdnbr, ident, heading, author, and title but without
+  # pagination, the number of results may be too unwieldy
+  module Id
+    OCLC    = :oclc
+    ISBN    = :isbn
+    LCCN    = :lccn
+    ISSN    = :issn
+    UPC     = :upc
+    OWI     = :owi
+    AUTHOR  = :author
+    TITLE   = :title
+    IDENT   = :ident
+  end
+
+  module OrderBy
+    # number of editions
+    EDITIONS  = :mancount
+    # holdings
+    HOLDINGS  = :hold
+    # date of first edition
+    FIRSTYEAR = :lyr
+    # date of latest edition
+    LASTYEAR  = :hyr
+    # language
+    LANGUAGE  = :ln
+    # FAST subject heading
+    HEADING   = :sheading
+    # number of works with this FAST subject heading
+    WORKS     = :works
+    # FAST subject type
+    SUBJTYPE  = :type
+  end
+
+  module Order
+    ASC  = :asc
+    DESC = :desc
+  end
+end

data/lib/classifoclc/edition.rb

@@ -0,0 +1,69 @@
+module Classifoclc
+  # An expression of a work. The physical books libraries held (or
+  # their digitizations) are "manifestations" of these editions
+  class Edition
+    attr_reader :classifications
+
+    def initialize(node)
+      @edition = node
+      @classifications = load_classifications(node)
+    end
+
+    # The OCLC number of the edition
+    # @return [String]
+    def oclc
+      @edition['oclc']
+    end
+
+    # The author of the edition
+    # @return [String]
+    def authors
+      @edition['author']
+    end
+    
+    # The title of the edition
+    # @return [String]
+    def title
+      @edition['title']
+    end
+
+    # The format of the edition
+    # @return [String]
+    def format
+      @edition['format']
+    end
+
+    # The type of item the edition
+    # @return [String]
+    def itemtype
+      @edition['itemtype']
+    end
+
+    # The number of libraries that hold a copy of this work
+    # @return [Integer]
+    def holdings
+      @edition['holdings'].to_i
+    end
+
+    # The number of libraries that hold a digital copy of this work
+    # @return [Integer]
+    def eholdings
+      @edition['eholdings'].to_i
+    end
+
+    # The language of item the edition
+    # @return [String]
+    def language
+      @edition['language']
+    end
+
+    def load_classifications(node)
+      cls = node.css("classifications class")
+      return nil if cls.empty?
+      cls.map{|c| Hash[c.keys.map{|k| [k.to_sym, c[k]]}]}
+    end
+
+    private :load_classifications
+  end
+end
+    

data/lib/classifoclc/errors.rb

@@ -0,0 +1,9 @@
+module Classifoclc
+  class BadIdentifierError < StandardError; end
+
+  class BadIdentifierFormatError < StandardError; end
+
+  class InfiniteLoopError < StandardError; end
+
+  class UnexpectedError < StandardError; end
+end

data/lib/classifoclc/recommendations.rb

@@ -0,0 +1,81 @@
+module Classifoclc
+  class Recommendations
+    # A hash of links to Google Charts graphs showing the proportion
+    # of libraries using which identifiers
+    # @return [Hash]
+    attr_accessor :graphs
+
+    # Recommended FAST subject headings
+    # @return [Hash]
+    attr_accessor :fast
+
+    # Recommended Dewey Decimal classifications
+    # @return [Hash]
+    attr_accessor :ddc
+
+    # Recommended Library of Congress classifications
+    # @return [Hash]
+    attr_accessor :lcc
+    
+    def initialize(node)
+      @graphs = load_graphs(node)
+      @fast = load_fast(node)
+      @ddc = load_classifications(node, 'ddc')
+      @lcc = load_classifications(node, 'lcc')
+    end
+
+    def load_graphs(node)
+      graphs = {}
+      node.css("graph").each do |g|
+        if g.parent.name == "recommendations"
+          graphs[:all] = g.text
+        else
+          graphs[g.parent.name.to_sym] = g.text
+        end
+      end
+
+      return graphs
+    end
+
+    def load_fast(node)
+      node.css("fast heading").map{|h| { :heading => h.text,
+                                         :holdings => h['heldby'],
+                                         :ident => h['ident']}
+      }
+    end
+
+    def load_classifications(node, e)
+      return nil if node.css(e).empty?
+      Hash[
+        # Get to desired element
+        node.css(e).
+          # Pick out all it's children that are elements but aren't <graph>
+          map{|d| d.children.
+                select{|c| c.element? and c.name != "graph"}}.
+          # It will be an Array containing one Array, so we just need to first
+          # element (i.e. the inner Array)
+          first.
+
+          # There can be multiples of the same element, so group the Array by
+          # element
+          group_by{|c| c.name}.
+
+          # Now we have a hash. Each key is the name of one of the child
+          # elements of the element started with (ddc or lcc). The values are
+          # hashes of all the elements with that name. 
+          map{|k, v|
+          [
+            # Convert the names of the elements to symbols
+            k.to_sym,
+            # convert each element to a hash of its attributes where the
+            # keys are the attribute names converted to symbols, and the
+            # values the values of the attributes
+            v.map{|a| Hash[a.keys.map{|k| [k.to_sym, a[k]]}]
+            }
+          ]
+        }]
+    end
+      
+    private :load_graphs, :load_fast, :load_classifications
+  end
+end

data/lib/classifoclc/version.rb

@@ -0,0 +1,3 @@
+module Classifoclc
+  VERSION = "1.0.0"
+end

data/lib/classifoclc/work.rb

@@ -0,0 +1,118 @@
+module Classifoclc
+  # An abstract work. A work is not a physical book, but the
+  # conceptual work of which all the physical books are manifestions
+  class Work
+    attr_reader :authors
+    def initialize(node)
+      @node = node
+      @work = node.css('work').first
+      @authors = node.css('author').
+                   map{|a| Classifoclc::Author.new(a.text, a['lc'], a['viaf'])}
+      @recommendations = load_recommendations(node)
+    end
+
+    # Get the work ID
+    # @return [String]
+    def owi
+      @work['owi']
+    end
+
+    # Get the title
+    # @return [String]
+    def title
+      @work['title']
+    end
+
+    # Get the format
+    # @return [String]
+    def format
+      @work['format']
+    end
+
+    # Get the type of item
+    # @return [String]
+    def itemtype
+      @work['itemtype']
+    end
+
+    # Get the number of editions the work has
+    # @return [Integer]
+    def edition_count
+      @work['editions'].to_i
+    end
+
+    # Get the number of libraries that hold a copy of this work
+    # @return [Integer]
+    def holdings
+      @work['holdings'].to_i
+    end
+
+    # Get the number of libraries that hold a digital copy of this work
+    # @return [Integer]
+    def eholdings
+      @work['eholdings'].to_i
+    end
+
+    # Get the editions of this work
+    # @return [Enumerator<Classifoclc::Edition>]
+    def editions
+      Enumerator.new do |e|
+        pages.each do |pg|
+          pg.each do |edition|
+            e << edition
+          end
+        end
+      end
+    end
+
+    # Get the recommended classifications for this work
+    # @return [Array<Classifoclc::Recommendations>]
+    def recommendations
+      @recommendations
+    end
+
+    def full(hsh = {})
+      params = {:identifier => 'owi', :value => owi,
+                :summary => false}.merge(hsh)
+      data = Classifoclc::fetch_data(params)
+      editions = data.css('edition').map{|e| Edition::new(e)}
+
+      navigation = data.css("navigation")
+
+      next_page = nil
+      unless navigation.empty?
+        n = data.css("navigation next").first
+
+        if n.nil?
+          next_page = nil
+        else
+          next_page = n.text.to_i
+        end
+      end
+
+      return {:editions => editions, :next => next_page}
+    end
+
+    # Iterate over pages of results
+    def pages
+      hsh = full()
+      Enumerator.new do |page|
+        page << hsh[:editions]
+        loop do
+          break if hsh[:next].nil?
+          hsh = full(:startRec => hsh[:next])
+          page << hsh[:editions]
+        end
+      end
+    end
+
+    def load_recommendations(node)
+      recs = node.css('recommendations')
+      return nil if recs.empty?
+
+      return Recommendations.new(recs.first)
+    end
+
+    private :full, :pages, :load_recommendations
+  end
+end

metadata

@@ -0,0 +1,105 @@
+--- !ruby/object:Gem::Specification
+name: classifoclc
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Sean Redmond
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2018-05-08 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: 
+email:
+- github-smr@sneakemail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- CODE_OF_CONDUCT.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- classifoclc.gemspec
+- lib/classifoclc.rb
+- lib/classifoclc/author.rb
+- lib/classifoclc/constants.rb
+- lib/classifoclc/edition.rb
+- lib/classifoclc/errors.rb
+- lib/classifoclc/recommendations.rb
+- lib/classifoclc/version.rb
+- lib/classifoclc/work.rb
+homepage: https://github.com/seanredmond/classifoclc
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.6.14
+signing_key: 
+specification_version: 4
+summary: Interface to OCLC Classify service
+test_files: []