README

Path: README
Last Update: Mon Oct 29 15:59:54 -0400 2007

openurl

DESCRIPTION

openurl is a Ruby library creating, parsing and using NISO Z39.88 OpenURLs over HTTP. <openurl.info/registry>

While openurl can send requests to OpenURL 1.0 resolvers, there is no ‘standard’ response format, so parsing the returned value is up to you.

USAGE

  require 'openurl'

  # Create your context object
  context_object = OpenURL::ContextObject.new

  # Add metadata to the Context Object Entities
  context_object.referent.set_format('journal')
  context_object.referent.add_identifier('info:doi/10.1016/j.ipm.2005.03.024')
  context_object.referent.set_metadata('issn', '0306-4573')
  context_object.referent.set_metadata('aulast', 'Bollen')
  context_object.referrer.add_identifier('info:sid/google')

  puts context_object.kev

  puts context_object.xml

  # Send the context object to an OpenURL link resolver
  transport = OpenURL::Transport.new('http://demo.exlibrisgroup.com:9003/lr_3', context_object)
  transport.get
  puts tranport.response

INSTALLATION

You should be able to install the gem:

  gem install openurl

The source lives in subversion:

  http://openurl.rubyforge.org/svn/

CONTACT

Bugs and suggestions to Ross Singer <rossfsinger@gmail.com>

[Validate]