harvestdor 0.0.13

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 3036c2f23661946012d909179b67effa433c2dd9
+  data.tar.gz: 149e27d97f4c9d48ca46772d550537aca8a55362
+SHA512:
+  metadata.gz: 4406cda66fcb2a726564ba912c60364433b9209ac03218fc2fbf70200fe679f8c964fa416abc0f163eecdabc4db51ad7b57de148f38cf4773b84a4de3fde854e
+  data.tar.gz: b18c647163a3970ae02cb3ee79ba0df04f4d5920ccbc5740a83b19b2958297ce2b1e0c761128293ae7bbb51633e419a6689b839f33f34f602a5292b2a078a4db

data/.gitignore

@@ -0,0 +1,25 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+.travis
+.rvmrc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+spec/test_logs
+test/tmp
+test/version_tmp
+tmp
+logs
+.DS_Store
+*.tmproj
+tmtags
+.idea/*

data/.travis.yml

@@ -0,0 +1,14 @@
+language: ruby
+script: rake rspec
+rvm:
+  - ruby-head
+  - 2.1.1
+  - 2.0.0
+  - 1.9.3
+  - jruby-19mode # JRuby in 1.9 mode
+#  - jruby-head
+notifications:
+  email:
+    - ndushay@stanford.edu
+    - laneymcg@stanford.edu
+    - bess@stanford.edu

data/.yardopts

@@ -0,0 +1,3 @@
+--title 'Harvestdor Gem Documentation'
+lib/**/*.rb -
+README.rdoc LICENSE.txt 

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# See harvestdor.gemspec for this gem's dependencies
+gemspec

data/LICENSE.txt

@@ -0,0 +1,5 @@
+Copyright (c) 20XX-2012.  The Board of Trustees of the Leland Stanford Junior University. All rights reserved.
+
+Redistribution and use of this distribution in source and binary forms, with or without modification, are permitted provided that: The above copyright notice and this permission notice appear in all copies and supporting documentation; The name, identifiers, and trademarks of The Board of Trustees of the Leland Stanford Junior University are not used in advertising or publicity without the express prior written permission of The Board of Trustees of the Leland Stanford Junior University; Recipients acknowledge that this distribution is made available as a research courtesy, "as is", potentially with defects, without any obligation on the part of The Board of Trustees of the Leland Stanford Junior University to provide support, services, or repair;
+
+THE BOARD OF TRUSTEES OF THE LELAND STANFORD JUNIOR UNIVERSITY DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, WITH REGARD TO THIS SOFTWARE, INCLUDING WITHOUT LIMITATION ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, AND IN NO EVENT SHALL THE BOARD OF TRUSTEES OF THE LELAND STANFORD JUNIOR UNIVERSITY BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, TORT (INCLUDING NEGLIGENCE) OR STRICT LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

data/README.rdoc

@@ -0,0 +1,162 @@
+= Harvestdor
+{<img src="https://travis-ci.org/sul-dlss/harvestdor.svg?branch=master" alt="Build Status" />}[https://travis-ci.org/sul-dlss/harvestdor] {<img src="https://gemnasium.com/sul-dlss/harvestdor.svg" alt="Dependency Status" />}[https://gemnasium.com/sul-dlss/harvestdor]
+
+A Gem to harvest metadata from DOR.
+
+== Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'harvestdor'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install harvestdor
+
+== Usage
+
+=== Configuration
+
+==== Possible configuration options (with default values unless otherwise indicated)
+
+  client = Harvestdor::Client.new({ # Example with all possible options
+    :log_dir => File.join(File.dirname(__FILE__), "..", "logs"),
+    :log_name => 'harvestdor.log',
+    :purl => 'http://purl.stanford.edu',
+    :http_options => { 'ssl' => { 
+                       'verify' => false 
+                       }, 
+                     'request' => {
+                         'timeout' => 60, # open/read timeout (seconds)
+                         'open_timeout' => 60 # connection open timeout (seconds)
+                       }
+                     },
+    :oai_repository_url => 'https://dor-oaiprovider-prod.stanford.edu/oai', # The OAI repository to connect to
+    :oai_client_debug => false,
+    :default_metadata_prefix => 'mods',
+    :default_from_date => '2012-12-01', # default value is nil
+    :default_until_date => '2014-12-01', # default value is nil
+    :default_set => 'is_governed_by_hy787xj5878', # default value is nil
+ })
+
+==== Option 1:  use a yaml file
+
+for contents of yml --  see spec/config/oai.yml
+
+  client = Harvestdor::Client.new({:config_yml_path => path_to_my_yml})
+  client.druids_via_oai do |druid|
+    # do stuff with the druid, e.g. 
+    #  cm = client.content_metadata(druid)
+    #  mods = client.mods(druid)
+    #  create solr doc from mods and cm
+    #  write solr doc to your app's index
+  end
+
+==== Option 2:  pass in non-default configurations as a hash
+
+  client = Harvestdor::Client.new({:oai_repository_url => 'http://my_oai.org', :default_from_date => '2012-12-01'})
+  client.druids_via_oai do |druid|
+    # do stuff with the druid, e.g. 
+    #  cm = client.content_metadata(druid)
+    #  mods = client.mods(druid)
+    #  create solr doc from mods and cm
+    #  write solr doc to your app's index
+  end
+
+==== Option 3:  set the attributes explicitly in your code
+
+  client = Harvestdor::Client.new
+  client.config.oai_repository_url = 'http://my_oai.org'
+  client.oai_records do |rec|
+    # do stuff with the OAI rec, e.g.
+    #  manipulate metadata into solr doc
+    #  manipulate stuff from record.about into solr doc
+    #  write solr doc to your app's index
+  end
+
+==== Option 4:  set the OAI parameters as params in call to Harvestdor::Client.harvest_xx
+
+  client = Harvestdor::Client.new({oai_repository_url = 'http://my_oai.org'})
+  client.oai_headers(:metadataPrefix => 'foo', :from => '2012-11-27', :set => 'is_governed_by_hy787xj5878') do | id |
+    # do stuff with the druid
+  end
+
+=== OAI Harvesting
+
+  Harvestdor::Client.druids_via_oai  gets enumerated druids for the records in your specified set / date range  (druids are not preceded by 'druid:')
+
+  Harvestdor::Client.oai_records  gets enumerated OAI record objects in your specified set / data range, with the metadata format you indicated
+
+You can also get these as arrays:
+
+  druid_array = client.druids_via_oai(:metadataPrefix => 'foo', :from => '(last_harvested_date)', :set => 'asdfasdf')
+
+=== XML from PURL pages
+
+You can get, for example, the contentMetadata for a druid:
+
+  it "#content_metadata retrieves contentMetadata as a Nokogiri::XML::Document" do
+    cm = Harvestdor.content_metadata('bb375wb8869', 'http://purl-test.stanford.edu')
+    cm.should be_kind_of(Nokogiri::XML::Document)
+    cm.root.name.should == 'contentMetadata'
+    cm.root.attributes['objectId'].text.should == @druid
+  end
+
+Or the MODS metadata:
+
+  it "#mods returns a Nokogiri::XML::Document from the purl mods" do
+    x = Harvestdor.mods('bb375wb8869', 'http://purl-test.stanford.edu')
+    x.should be_kind_of(Nokogiri::XML::Document)
+    x.root.name.should == 'mods'
+    x.root.namespace.href.should == Harvestdor::MODS_NAMESPACE
+  end
+
+Similarly for
+# mods
+# public_xml  (all of it)
+# content_metadata
+# identity_metadata
+# rights_metadata
+# rdf
+# dc
+
+You can also do this from a Harvestdor::Client object, and it will use the purl from the Client.config:
+
+  client = Harvestdor::Client.new({:purl_url => 'http://thisone.org'})
+  client.identity_metadata('bb375wb8869')
+
+
+=== TODO: Last Harvested Datestamp (Incremental Harvests)
+
+Harvestdor::Client.last_datestamp
+
+persist this information with your app for incremental harvests
+
+
+== Contributing
+
+# Fork it
+# Create your feature branch (`git checkout -b my-new-feature`)
+# Write code and tests.
+# Commit your changes (`git commit -am 'Added some feature'`)
+# Push to the branch (`git push origin my-new-feature`)
+# Create new Pull Request
+
+== Releases
+
+* <b>0.0.13</b> Updated to work with Faraday 0.9, releases via rubygems instead of sul-gems
+* <b>0.0.11</b> better error handling, and better testing for errors
+* <b>0.0.10</b> tweak specs to test that unnec fetching isn't done.
+* <b>0.0.9</b> allows public xml to be passed as Nokogiri::XML::Document to content_metadata, etc. to avoid unnec fetching
+* <b>0.0.8</b> avoid undefined method 'size' from scrub_oai_args when using a non-nil default date param
+* <b>0.0.7</b> add oai client timeout overrides, update README
+* <b>0.0.6</b> refactoring oai_harvest for greater simplicity and passing errors through, add oai_record (get_record OAI request)
+* <b>0.0.5</b> don't send empty string arguments to OAI server so you can get actual results
+* <b>0.0.4</b> add integration spec and get it working with actual OAI server
+* <b>0.0.3</b> add method to get mods from purl
+* <b>0.0.2</b> tidy up README
+* <b>0.0.1</b> initial commit

data/Rakefile

@@ -0,0 +1,50 @@
+require "bundler/gem_tasks"
+
+require 'rake'
+require 'bundler'
+
+require 'rspec/core/rake_task'
+require 'yard'
+require 'yard/rake/yardoc_task'
+
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+
+task :default => :ci  
+
+desc "run continuous integration suite (tests, coverage, docs)" 
+task :ci => [:rspec, :doc]
+
+task :spec => :rspec
+
+desc "run specs EXCEPT integration specs"
+RSpec::Core::RakeTask.new(:spec_fast) do |spec|
+  spec.rspec_opts = ["-c", "-f progress", "--tty", "-t ~integration", "-r ./spec/spec_helper.rb"]
+end
+
+RSpec::Core::RakeTask.new(:rspec) do |spec|
+  spec.rspec_opts = ["-c", "-f progress", "--tty", "-r ./spec/spec_helper.rb"]
+end
+
+# Use yard to build docs
+begin
+  project_root = File.expand_path(File.dirname(__FILE__))
+  doc_dest_dir = File.join(project_root, 'doc')
+
+  YARD::Rake::YardocTask.new(:doc) do |yt|
+    yt.files = Dir.glob(File.join(project_root, 'lib', '**', '*.rb')) +
+                 [ File.join(project_root, 'README.rdoc') ]
+    yt.options = ['--output-dir', doc_dest_dir, '--readme', 'README.rdoc', '--title', 'Harvestdor Gem Documentation']
+  end
+rescue LoadError
+  desc "Generate YARD Documentation"
+  task :doc do
+    abort "Please install the YARD gem to generate rdoc."
+  end
+end  
+

data/harvestdor.gemspec

@@ -0,0 +1,41 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'harvestdor/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "harvestdor"
+  gem.version       = Harvestdor::VERSION
+  gem.authors       = ["Naomi Dushay"]
+  gem.email         = ["ndushay@stanford.edu"]
+  gem.description   = %q{Harvest DOR object metadata via a relationship (e.g. hydra:isGovernedBy rdf:resource="info:fedora/druid:hy787xj5878") and dates}
+  gem.summary       = %q{Harvest DOR object metadata}
+  gem.homepage      = "https://consul.stanford.edu/display/chimera/Chimera+project"
+
+  gem.files         = `git ls-files`.split($/)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^spec/})
+  gem.require_paths = ["lib"]
+  
+  gem.add_dependency 'oai', '~> 0.3.0'
+  gem.add_dependency 'faraday', '>= 0.9.0'
+  gem.add_dependency 'confstruct'
+  gem.add_dependency 'nokogiri'
+  
+  # Runtime dependencies
+  # gem.add_runtime_dependency 'nokogiri'
+
+  # Development dependencies
+  # Bundler will install these gems too if you've checked out solrmarc-wrapper source from git and run 'bundle install'
+  # It will not add these as dependencies if you require solrmarc-wrapper for other projects
+  gem.add_development_dependency "rake"
+  # docs
+  gem.add_development_dependency "rdoc"
+  gem.add_development_dependency "yard"
+  # tests
+	gem.add_development_dependency 'rspec'
+	gem.add_development_dependency 'simplecov'
+	gem.add_development_dependency 'simplecov-rcov'
+	# gem.add_development_dependency 'ruby-debug19'
+  
+end

data/lib/harvestdor/errors.rb

@@ -0,0 +1,12 @@
+module Harvestdor
+  module Errors
+    MissingPurlPage = Class.new(StandardError) 
+    MissingMods = Class.new(StandardError) 
+    MissingPublicXml = Class.new(StandardError) 
+    MissingContentMetadata = Class.new(StandardError) 
+    MissingIdentityMetadata = Class.new(StandardError) 
+    MissingRightsMetadata = Class.new(StandardError) 
+    MissingRDF = Class.new(StandardError) 
+    MissingDC = Class.new(StandardError) 
+  end
+end

data/lib/harvestdor/oai_harvest.rb

@@ -0,0 +1,115 @@
+require 'oai'
+
+module Harvestdor
+
+  # Mixin:  methods to perform an OAI harvest and iterate over results
+  class Client
+
+    # return Array of OAI::Records from the OAI harvest indicated by OAI params (metadata_prefix, from, until, set)
+    # @param [Hash] oai_args optional OAI params (:metadata_prefix, :from, :until, :set) to be used in lieu of config default values
+    # @return [Array<OAI::Record>] or enumeration over it, if block is given
+    def oai_records oai_args = {}
+      return to_enum(:oai_records, oai_args).to_a unless block_given?
+
+      harvest(:list_records, scrub_oai_args(oai_args)) do |oai_rec|
+        yield oai_rec
+      end 
+    end
+  
+    # return Array of OAI::Headers from the OAI harvest indicated by OAI params (metadata_prefix, from, until, set)
+    # @param [Hash] oai_args optional OAI params (:metadata_prefix, :from, :until, :set) to be used in lieu of config default values
+    # @return [Array<OAI::Header>] or enumeration over it, if block is given
+    def oai_headers oai_args = {}
+      return to_enum(:oai_headers, oai_args).to_a unless block_given?
+      
+      harvest(:list_identifiers, scrub_oai_args(oai_args)) do |oai_hdr|
+        yield oai_hdr
+      end
+    end
+
+    # return Array of druids contained in the OAI harvest indicated by OAI params (metadata_prefix, from, until, set)
+    # @param [Hash] oai_args optional OAI params (:metadata_prefix, :from, :until, :set) to be used in lieu of config default values
+    # @return [Array<String>] or enumeration over it, if block is given
+    def druids_via_oai oai_args = {}
+      return to_enum(:druids_via_oai, oai_args).to_a unless block_given?
+
+      harvest(:list_identifiers, scrub_oai_args(oai_args)) do |oai_hdr|
+        yield Harvestdor.druid(oai_hdr)
+      end
+    end
+    
+    # get a single OAI record using a get_record OAI request
+    # @param [String] druid (which will be turned into OAI identifier)
+    # @param [String] md_prefix the OAI metadata prefix determining which metadata will be in the retrieved OAI::Record object
+    # @return [OAI::Record] record object retrieved from OAI server
+    def oai_record druid, md_prefix = 'mods'
+      prefix = md_prefix ? md_prefix : config.default_metadata_prefix
+      oai_client.get_record({:identifier => "oai:searchworks.stanford.edu/druid:#{druid}", :metadata_prefix => prefix}).record
+    end
+    
+    protected #---------------------------------------------------------------------
+
+    # @param [Hash] oai_args Hash of OAI params (metadata_prefix, from, until, set) to be used in lieu of config default values
+    # @return [Hash] OAI params (metadata_prefix, from, until, set) cleaned up for making harvest request
+    def scrub_oai_args oai_args = {}
+      scrubbed_args={}
+      scrubbed_args[:metadata_prefix] = oai_args.keys.include?(:metadata_prefix) ? oai_args[:metadata_prefix] : config.default_metadata_prefix 
+      scrubbed_args[:from] = oai_args.keys.include?(:from) ? oai_args[:from] : config.default_from_date
+      scrubbed_args[:until] = oai_args.keys.include?(:until) ? oai_args[:until] : config.default_until_date
+      scrubbed_args[:set] = oai_args.keys.include?(:set) ? oai_args[:set] : config.default_set
+      scrubbed_args.each { |k, v|  
+        scrubbed_args.delete(k) if v.nil? || v == ''
+      }
+      scrubbed_args
+    end
+    
+    # harvest OAI headers or OAI records and return a response object with one entry for each record/header retrieved
+    #  follows resumption tokens (i.e. chunks are all present in result)
+    # @param [Symbol] verb :list_identifiers or :list_records
+    # @param [Hash] oai_args OAI params (metadata_prefix, from, until, set) used for request
+    # @return response to OAI request, as one enumerable object 
+    # TODO: This could be moved into ruby-oai?
+    def harvest (verb, oai_args, &block)
+      response = oai_client.send verb, oai_args
+      while response && response.entries.size > 0
+        response.entries.each &block
+
+        token = response.resumption_token
+        if token.nil? or token.empty?
+          break
+        else
+          response = oai_client.send(verb, :resumption_token => token)
+        end
+      end
+    rescue Faraday::Error::TimeoutError => e
+      logger.error "No response from OAI Provider"
+      logger.error e
+      raise e
+    rescue OAI::Exception => e
+      # possibly unnecessary after ruby-oai 0.0.14
+      logger.error "Received unexpected OAI::Exception"
+      logger.error e
+      raise e
+    end
+
+  end # class OaiHarvester
+
+end # module Harvestdor
+
+module OAI
+  class Client
+    # monkey patch to adjust timeouts
+    # Do the actual HTTP get, following any temporary redirects
+    def get(uri)
+      # OLD: response = @http_client.get uri
+      response = @http_client.get do |req|
+        req.url uri
+        # FIXME: hard-coded default settings in harvestdor are used here
+        # values are in seconds
+        req.options[:timeout] = Harvestdor::Client.default_config.http_options.timeout     # open/read timeout
+        req.options[:open_timeout] = Harvestdor::Client.default_config.http_options.open_timeout   # connection open timeout
+      end
+      response.body
+    end
+  end
+end

data/lib/harvestdor/purl_xml.rb

@@ -0,0 +1,200 @@
+require 'nokogiri'
+
+module Harvestdor
+  # Mixin:  code to retrieve Purl public xml pieces
+  
+  RDF_NAMESPACE = 'http://www.w3.org/1999/02/22-rdf-syntax-ns#'
+  OAI_DC_NAMESPACE = 'http://www.openarchives.org/OAI/2.0/oai_dc/'
+  MODS_NAMESPACE = 'http://www.loc.gov/mods/v3'
+
+  # the MODS metadata for this fedora object, from the purl server
+  # @param [String] druid e.g. ab123cd4567
+  # @param [String] purl_url url for the purl server.  default is Harvestdor::PURL_DEFAULT
+  # @return [Nokogiri::XML::Document] the MODS for the fedora object
+  def self.mods druid, purl_url = Harvestdor::PURL_DEFAULT
+    begin
+      Nokogiri::XML(open("#{purl_url}/#{druid}.mods"),nil,'UTF-8')
+    rescue OpenURI::HTTPError
+      raise Harvestdor::Errors::MissingMods.new(druid)
+    end
+  end
+
+  # the public xml for this fedora object, from the purl page
+  # @param [String] druid e.g. ab123cd4567
+  # @param [String] purl_url url for the purl server.  default is Harvestdor::PURL_DEFAULT
+  # @return [Nokogiri::XML::Document] the public xml for the fedora object
+  def self.public_xml druid, purl_url = Harvestdor::PURL_DEFAULT
+    return druid if druid.instance_of?(Nokogiri::XML::Document)
+    begin
+      ng_doc = Nokogiri::XML(open("#{purl_url}/#{druid}.xml"))
+      raise Harvestdor::Errors::MissingPublicXml.new(druid) if !ng_doc || ng_doc.children.empty?
+      ng_doc 
+    rescue OpenURI::HTTPError
+      raise Harvestdor::Errors::MissingPurlPage.new(druid)
+    end
+  end
+
+  # the contentMetadata for this fedora object, from the purl xml
+  # @param [Object] object a String containing a druid (e.g. ab123cd4567), or 
+  #  a Nokogiri::XML::Document containing the public_xml for an object
+  # @param [String] purl_url url for the purl server.  default is Harvestdor::PURL_DEFAULT
+  # @return [Nokogiri::XML::Document] the contentMetadata for the fedora object
+  def self.content_metadata object, purl_url = Harvestdor::PURL_DEFAULT
+    pub_xml_ng_doc = pub_xml(object, purl_url)
+    begin
+      # preserve namespaces, etc for the node
+      ng_doc = Nokogiri::XML(pub_xml_ng_doc.root.xpath('/publicObject/contentMetadata').to_xml)
+      raise Harvestdor::Errors::MissingContentMetadata.new(object.inspect) if !ng_doc || ng_doc.children.empty?
+      ng_doc 
+    rescue
+      raise Harvestdor::Errors::MissingContentMetadata.new(object.inspect)
+    end
+  end
+
+  # the identityMetadata for this fedora object, from the purl xml
+  # @param [Object] object a String containing a druid (e.g. ab123cd4567), or 
+  #  a Nokogiri::XML::Document containing the public_xml for an object
+  # @param [String] purl_url url for the purl server.  default is Harvestdor::PURL_DEFAULT
+  # @return [Nokogiri::XML::Document] the identityMetadata for the fedora object
+  def self.identity_metadata object, purl_url = Harvestdor::PURL_DEFAULT
+    pub_xml_ng_doc = pub_xml(object, purl_url)
+    begin
+      # preserve namespaces, etc for the node
+      ng_doc = Nokogiri::XML(pub_xml_ng_doc.root.xpath('/publicObject/identityMetadata').to_xml)
+      raise Harvestdor::Errors::MissingIdentityMetadata.new(object.inspect) if !ng_doc || ng_doc.children.empty?
+      ng_doc 
+    rescue
+      raise Harvestdor::Errors::MissingIdentityMetadata.new(object.inspect)
+    end
+  end
+
+  # the rightsMetadata for this fedora object, from the purl xml
+  # @param [Object] object a String containing a druid (e.g. ab123cd4567), or 
+  #  a Nokogiri::XML::Document containing the public_xml for an object
+  # @param [String] purl_url url for the purl server.  default is Harvestdor::PURL_DEFAULT
+  # @return [Nokogiri::XML::Document] the rightsMetadata for the fedora object
+  def self.rights_metadata object, purl_url = Harvestdor::PURL_DEFAULT
+    pub_xml_ng_doc = pub_xml(object, purl_url)
+    begin
+      # preserve namespaces, etc for the node
+      ng_doc = Nokogiri::XML(pub_xml_ng_doc.root.xpath('/publicObject/rightsMetadata').to_xml)
+      raise Harvestdor::Errors::MissingRightsMetadata.new(object.inspect) if !ng_doc || ng_doc.children.empty?
+      ng_doc
+    rescue
+      raise Harvestdor::Errors::MissingRightsMetadata.new(object.inspect)
+    end
+  end
+
+  # the RDF for this fedora object, from the purl xml
+  # @param [Object] object a String containing a druid (e.g. ab123cd4567), or 
+  #  a Nokogiri::XML::Document containing the public_xml for an object
+  # @param [String] purl_url url for the purl server.  default is Harvestdor::PURL_DEFAULT
+  # @return [Nokogiri::XML::Document] the RDF for the fedora object
+  def self.rdf object, purl_url = Harvestdor::PURL_DEFAULT
+    pub_xml_ng_doc = pub_xml(object, purl_url)
+    begin
+      # preserve namespaces, etc for the node
+      ng_doc = Nokogiri::XML(pub_xml_ng_doc.root.xpath('/publicObject/rdf:RDF', {'rdf' => Harvestdor::RDF_NAMESPACE}).to_xml)
+      raise Harvestdor::Errors::MissingRDF.new(object.inspect) if !ng_doc || ng_doc.children.empty?
+      ng_doc
+    rescue
+      raise Harvestdor::Errors::MissingRDF.new(object.inspect)
+    end
+  end
+
+  # the Dublin Core for this fedora object, from the purl xml
+  # @param [Object] object a String containing a druid (e.g. ab123cd4567), or 
+  #  a Nokogiri::XML::Document containing the public_xml for an object
+  # @param [String] purl_url url for the purl server.  default is Harvestdor::PURL_DEFAULT
+  # @return [Nokogiri::XML::Document] the dc for the fedora object
+  def self.dc object, purl_url = Harvestdor::PURL_DEFAULT
+    pub_xml_ng_doc = pub_xml(object, purl_url)
+    begin
+      # preserve namespaces, etc for the node
+      ng_doc = Nokogiri::XML(pub_xml_ng_doc.root.xpath('/publicObject/dc:dc', {'dc' => Harvestdor::OAI_DC_NAMESPACE}).to_xml)
+      raise Harvestdor::Errors::MissingDC.new(object.inspect) if !ng_doc || ng_doc.children.empty?
+      ng_doc
+    rescue
+      raise Harvestdor::Errors::MissingDC.new(object.inspect)
+    end
+  end
+
+
+  class Client
+    
+    # the public xml for this fedora object, from the purl server
+    # @param [String] druid e.g. ab123cd4567, in the purl url
+    # @return [Nokogiri::XML::Document] the MODS metadata for the fedora object
+    def mods druid
+      Harvestdor.mods(druid, config.purl)
+    end
+
+    # the public xml for this fedora object, from the purl xml
+    # @param [String] druid e.g. ab123cd4567, in the purl url
+    # @return [Nokogiri::XML::Document] the public xml for the fedora object
+    def public_xml druid
+      Harvestdor.public_xml(druid, config.purl)
+    end
+
+    # the contentMetadata for this fedora object, from the purl xml
+    # @param [Object] object a String containing a druid (e.g. ab123cd4567), or 
+    #  a Nokogiri::XML::Document containing the public_xml for an object
+    # @return [Nokogiri::XML::Document] the contentMetadata for the fedora object
+    def content_metadata object
+      Harvestdor.content_metadata(object, config.purl)
+    end
+
+    # the identityMetadata for this fedora object, from the purl xml
+    # @param [Object] object a String containing a druid (e.g. ab123cd4567), or 
+    #  a Nokogiri::XML::Document containing the public_xml for an object
+    # @return [Nokogiri::XML::Document] the identityMetadata for the fedora object
+    def identity_metadata object
+      Harvestdor.identity_metadata(object, config.purl)
+    end
+
+    # the rightsMetadata for this fedora object, from the purl xml
+    # @param [Object] object a String containing a druid (e.g. ab123cd4567), or 
+    #  a Nokogiri::XML::Document containing the public_xml for an object
+    # @return [Nokogiri::XML::Document] the rightsMetadata for the fedora object
+    def rights_metadata object
+      Harvestdor.rights_metadata(object, config.purl)
+    end
+
+    # the RDF for this fedora object, from the purl xml
+    # @param [Object] object a String containing a druid (e.g. ab123cd4567), or 
+    #  a Nokogiri::XML::Document containing the public_xml for an object
+    # @return [Nokogiri::XML::Document] the RDF for the fedora object
+    def rdf object
+      Harvestdor.rdf(object, config.purl)
+    end
+
+    # the Dublin Core for this fedora object, from the purl xml
+    # @param [Object] object a String containing a druid (e.g. ab123cd4567), or 
+    #  a Nokogiri::XML::Document containing the public_xml for an object
+    # @return [Nokogiri::XML::Document] the dc for the fedora object
+    def dc object
+      Harvestdor.dc(object, config.purl)
+    end
+    
+  end # class Client
+
+  protected #--------------------------------------------
+  
+  # @param [Object] object a String containing a druid (e.g. ab123cd4567), or 
+  #  a Nokogiri::XML::Document containing the public_xml for an object
+  # @param [String] purl_url url for the purl server.  default is Harvestdor::PURL_DEFAULT
+  # @return [Nokogiri::XML::Document] the public xml for a DOR object
+  def self.pub_xml(object, purl_url = Harvestdor::PURL_DEFAULT)
+    case 
+      when object.instance_of?(String)
+        # it's a druid
+        pub_xml_ng_doc = Harvestdor.public_xml(object, purl_url)
+      when object.instance_of?(Nokogiri::XML::Document)
+        pub_xml_ng_doc = object
+      else
+        raise "expected String or Nokogiri::XML::Document for first argument, got #{object.class}"
+    end
+    pub_xml_ng_doc    
+  end
+
+end # module Harvestdor

data/lib/harvestdor/version.rb

@@ -0,0 +1,3 @@
+module Harvestdor
+  VERSION = "0.0.13"
+end