clio-search 0.0.1

data/lib/clio.rb

@@ -0,0 +1,74 @@
+require 'rubygems'
+
+require 'cgi'
+require 'nokogiri'
+require 'open-uri'
+
+
+ClioResult = Struct.new :title, :subtitle, :authors, :published, :online
+
+class Clio 
+  # API for Columbia Library CLIO Beta search engine
+  # 
+  # Example:
+  #   >> Clio.new('[Referer]').search('nano fibers')
+  #   => [ #<Result:...>, ... ]
+  #
+  # Arguments:
+  #   referer: (String)
+  #   num_results: (Integer+)
+
+  API_PATH = "http://cliobeta.columbia.edu/catalog?&"
+
+  attr_accessor :referer, :num_results
+
+  def initialize(referer='', num_results=100)
+    @referer = referer
+    @num_results = num_results
+  end
+  
+  def search(query)
+    params = "per_page=#{@num_results}&q=#{CGI.escape(query)}"
+    response = open(API_PATH + params, { 'Referer' => @referer })
+    return nil if response.class.superclass == Net::HTTPServerError
+    doc = Nokogiri::HTML(response)
+    # check that results were returned
+    # fetch number of results so we slice properly
+    num_returned = doc.css('.pageEntriesInfo b:first')[0]
+    return [] if num_returned == nil
+    num_returned = num_returned.content.split(/(\d+)/)[-1].to_i
+    css_types = {
+      :title => 0,
+      :other => 1
+    }
+    css_attrs = [
+      '.title a',
+      '.details',
+    ]
+    tag_sets = doc.css(css_attrs.join(', ')
+        ).each_slice(num_returned).map { |el| el }.transpose
+    tag_sets.map do |tag_set|
+      # build hash from details
+      details = {}
+      tag_set[css_types[:other]].css('.row').each do |row|
+        label = row.css('.label')[0].content.downcase
+        entries = row.css('.entry')
+        # online labels have >= 1 links to extract
+        details[label] = (label == 'online') ? entries.inject({}) do |h, entry|
+          link = entry.css('a')[0]
+          h[link.content] = link['href']
+          h
+        end : entries[0].content
+      end
+
+      ClioResult.new(
+        tag_set[css_types[:title]].content,
+        details['subtitle'],
+        details['author'],
+        details['published'],
+        details['online']
+      )
+    end
+  end
+end
+

metadata

@@ -0,0 +1,56 @@
+--- !ruby/object:Gem::Specification
+name: clio-search
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Peter Lubell-Doughtie
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-06-24 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: &11102200 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *11102200
+description: API for Columbia Library CLIO Beta
+email: peter@helioid.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/clio.rb
+homepage: http://www.helioid.com/
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.15
+signing_key: 
+specification_version: 3
+summary: API for Columbia Library CLIO Beta
+test_files: []