faroo 0.0.1

data/lib/faroo.rb

@@ -0,0 +1,71 @@
+require 'rubygems'
+
+require 'cgi'
+require 'json'
+require 'open-uri'
+
+
+FarooResult = Struct.new :title, :abstract, :url, :image_url, :domain, :author,
+    :news, :votes, :date, :related
+
+
+class Faroo 
+  # API for Faroo search engine
+  # 
+  # Example:
+  #   >> Faroo.new('[Referer]', ['Num results']).search('nano fibers')
+  #   => [ #<ClioResult:...>, ... ]
+  #
+  # Arguments:
+  #   referer: (String)
+  #   num_results: (Integer+)
+
+  API_PATH = 'http://www.faroo.com/instant.json?'
+
+  attr_accessor :referer, :num_results
+
+  def initialize(referer='', num_results=100)
+    @referer = referer
+    @num_results = num_results
+  end
+
+  def web(query, start=1, language='en')
+    search(query, 'web', start, language)
+  end
+
+  def news(query, start=1, language='en')
+    search(query, 'news', start, language)
+  end
+  
+  def search(query, src, start, language)
+    # API Parameters
+    # q=query
+    # start=start
+    # length=length
+    # l=language (en, de, zh)
+    # src=source (web, news)
+
+    params = "start=#{start}&length=#{@num_results}&q=#{CGI.escape(query)}"
+    params += "&src=#{src}&l=#{language}"
+    response = open(API_PATH + params, { 'Referer' => @referer })
+    return nil if response.class.superclass == Net::HTTPServerError
+    doc = JSON.load(response)
+
+    return [] if doc['length'] == 0
+
+    doc['results'].map do |result|
+      FarooResult.new(
+        result['title'],
+        result['kwic'],
+        result['url'],
+        result['iurl'],
+        result['domain'],
+        result['author'],
+        result['news'],
+        result['votes'],
+        result['date'],
+        result['related']
+      )
+    end
+  end
+end

metadata

@@ -0,0 +1,45 @@
+--- !ruby/object:Gem::Specification
+name: faroo
+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: []
+description: API for Faroo
+email: peter@helioid.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/faroo.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.24
+signing_key: 
+specification_version: 3
+summary: API for Faroo
+test_files: []