eshopworks-rboss 0.1.0

data/History.txt

@@ -0,0 +1,2 @@
+== 0.1.0
+* Brand spanking new release.

data/License.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2008 eShopworks
+
+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/Manifest.txt

@@ -0,0 +1,31 @@
+History.txt
+License.txt
+Manifest.txt
+README.textile
+Rakefile
+TODO.txt
+config/hoe.rb
+config/requirements.rb
+gem_tasks/deployment.rake
+gem_tasks/environment.rake
+gem_tasks/fix_cr_lf.rake
+gem_tasks/gemspec.rake
+gem_tasks/rspec.rake
+gem_tasks/website.rake
+lib/boss.rb
+lib/boss/api.rb
+lib/boss/config.rb
+lib/boss/result.rb
+lib/boss/result/base.rb
+lib/boss/result/image.rb
+lib/boss/result/news.rb
+lib/boss/result/spell.rb
+lib/boss/result/web.rb
+lib/boss/result_factory.rb
+lib/boss/version.rb
+rboss.gemspec
+spec/boss/api_spec.rb
+spec/boss/config_spec.rb
+spec/boss/result_factory_spec.rb
+spec/spec.opts
+spec/spec_helper.rb

data/README.textile

@@ -0,0 +1,93 @@
+h1. RBoss-gem Yahoo Boss Search
+
+"Yahoo boss search":http://developer.yahoo.com/search/boss/
+
+"Yahoo boss API":http://developer.yahoo.com/search/boss/boss_guide/
+
+h2.  DESCRIPTION:
+
+A handy gem to make using the Yahoo Boss API nice and easy in ruby.
+
+Bug Tracking: "http://eshopworks.lighthouseapp.com/projects/15732-rboss/overview":http://eshopworks.lighthouseapp.com/projects/15732-rboss/overview
+
+h2.  FEATURES:
+
+Search
+* Images
+* News
+* Web
+
+Also spelling suggestions
+
+Return results as:
+* JSON string
+* XML string
+* Plain old ruby objects (POROs)
+
+h2. INSTALL:
+
+<pre><code>
+  gem sources --add http://gems.github.com/ 
+  gem install eshopworks-rboss
+</code></pre>
+
+Get a yahoo boss api-key: "http://developer.yahoo.com/wsregapp":http://developer.yahoo.com/wsregapp
+
+h2. USAGE:
+
+<pre><code>
+  require 'rubygems'
+  require 'boss'
+  
+  api = Boss::Api.new('boss-api-key-got-from-yahoo')
+  
+  #Search defaults to web search with following defaults
+  # count = 10  
+  # format = object (ruby object)
+  # lang = eng
+  api.search('monkeys')
+  
+  #Search images, spelling, news and web
+  api.search_images('monkeys')
+  api.search_spelling('monkeys')
+  api.search_news('monkeys')
+  api.search_web('monkeys')
+
+  #By default returns ruby object results
+  results = api.search_web('monkeys')
+  results.each { |web| puts web.title }
+
+  #Configure search with hash
+  xml = api.search_spelling('monkeys', :format => 'xml', :count => 5)
+
+  #Configure search with block
+  xml = api.search_spelling('monkeys') do |config|
+    config.format = 'xml'
+    config.count = 5
+  end
+</code></pre>
+  
+Check "http://developer.yahoo.com/search/boss/boss_guide/":http://developer.yahoo.com/search/boss/boss_guide/ for the different values accessible for news/images/web/spell ruby object results
+
+h2.  LICENSE:
+
+Copyright (c) 2008 eShopworks
+
+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/Rakefile

@@ -0,0 +1,4 @@
+require 'config/requirements'
+require 'config/hoe' # setup Hoe + all gem configuration
+
+Dir['gem_tasks/**/*.rake'].each { |rake| load rake }

data/TODO.txt

@@ -0,0 +1,3 @@
+== FEATURES/PROBLEMS:
+
+* Search all

data/config/hoe.rb

@@ -0,0 +1,69 @@
+require 'boss'
+require 'boss/version'
+
+AUTHOR = 'Joseph Wilk'  # can also be an array of Authors
+EMAIL = "joe@eshopworks.co.uk"
+DESCRIPTION = "Api wrapping Yahoo Boss search"
+GEM_NAME = 'rboss' # what ppl will type to install your gem
+HOMEPATH = "http://github.com/eshopworks/rboss-gem"
+RUBYFORGE_PROJECT = nil
+
+@config_file = "~/.rubyforge/user-config.yml"
+@config = nil
+RUBYFORGE_USERNAME = "eshopworks"
+def rubyforge_username
+  unless @config
+    begin
+      @config = YAML.load(File.read(File.expand_path(@config_file)))
+    rescue
+      puts <<-EOS
+ERROR: No rubyforge config file found: #{@config_file}
+Run 'rubyforge setup' to prepare your env for access to Rubyforge
+ - See http://newgem.rubyforge.org/rubyforge.html for more details
+      EOS
+      exit
+    end
+  end
+  RUBYFORGE_USERNAME.replace @config["username"]
+end
+
+
+REV = nil 
+# UNCOMMENT IF REQUIRED: 
+# REV = YAML.load(`svn info`)['Revision']
+VERS = Boss::VERSION::STRING + (REV ? ".#{REV}" : "")
+RDOC_OPTS = ['--quiet', '--title', 'RBoss documentation',
+    "--opname", "index.html",
+    "--line-numbers", 
+    "--main", "README.textile",
+    "--inline-source"]
+
+class Hoe
+  def extra_deps 
+    @extra_deps.reject! { |x| Array(x).first == 'hoe' } 
+    @extra_deps
+  end 
+end
+
+# Generate all the Rake tasks
+# Run 'rake -T' to see list of generated tasks (from gem root directory)
+$hoe = Hoe.new(GEM_NAME, VERS) do |p|
+  p.developer(AUTHOR, EMAIL)
+  p.description = DESCRIPTION
+  p.summary = DESCRIPTION
+  p.url = HOMEPATH
+  p.rubyforge_name = RUBYFORGE_PROJECT if RUBYFORGE_PROJECT
+  p.clean_globs |= ['**/.*.sw?', '*.gem', '.config', '**/.DS_Store', '**/*.class', '**/*.jar']  #An array of file patterns to delete on clean.
+  
+  # == Optional
+  p.changes = p.paragraphs_of("History.txt", 0..1).join("\n\n")
+  #p.extra_deps = []     # An array of rubygem dependencies [name, version], e.g. [ ['active_support', '>= 1.3.1'] ]
+  p.extra_deps = [ ['json', '>= 1.1.3'], ['rspec', '>= 1.1.4'], ['diff-lcs', '>= 1.1.2'] ]
+
+  #p.spec_extras = {}    # A hash of extra values to set in the gemspec.
+end
+
+CHANGES = $hoe.paragraphs_of('History.txt', 0..1).join("\\n\\n")
+PATH    = (RUBYFORGE_PROJECT == GEM_NAME) ? RUBYFORGE_PROJECT : "#{RUBYFORGE_PROJECT}/#{GEM_NAME}"
+$hoe.remote_rdoc_dir = File.join(PATH.gsub(/^#{RUBYFORGE_PROJECT}\/?/,''), 'rdoc')
+$hoe.rsync_args = '-av --delete --ignore-errors'

data/config/requirements.rb

@@ -0,0 +1,15 @@
+require 'fileutils'
+include FileUtils
+
+require 'rubygems'
+%w[rake hoe].each do |req_gem|
+  begin
+    require req_gem
+  rescue LoadError
+    puts "This Rakefile requires the '#{req_gem}' RubyGem."
+    puts "Installation: gem install #{req_gem} -y"
+    exit
+  end
+end
+
+$:.unshift(File.join(File.dirname(__FILE__), %w[.. lib]))

data/gem_tasks/deployment.rake

@@ -0,0 +1,34 @@
+desc 'Release the website and new gem version'
+task :deploy => [:check_version, :website, :release] do
+  puts "Remember to create SVN tag:"
+  puts "svn copy svn+ssh://#{rubyforge_username}@rubyforge.org/var/svn/#{PATH}/trunk " +
+    "svn+ssh://#{rubyforge_username}@rubyforge.org/var/svn/#{PATH}/tags/REL-#{VERS} "
+  puts "Suggested comment:"
+  puts "Tagging release #{CHANGES}"
+end
+
+desc 'Runs tasks website_generate and install_gem as a local deployment of the gem'
+task :local_deploy => [:website_generate, :install_gem]
+
+task :check_version do
+  unless ENV['VERSION']
+    puts 'Must pass a VERSION=x.y.z release version'
+    exit
+  end
+  unless ENV['VERSION'] == VERS
+    puts "Please update your version.rb to match the release version, currently #{VERS}"
+    exit
+  end
+end
+
+desc 'Install the package as a gem, without generating documentation(ri/rdoc)'
+task :install_gem_no_doc => [:clean, :package] do
+  sh "#{'sudo ' unless Hoe::WINDOZE }gem install pkg/*.gem --no-rdoc --no-ri"
+end
+
+namespace :manifest do
+  desc 'Recreate Manifest.txt to include ALL files'
+  task :refresh do
+    `rake check_manifest | patch -p0 > Manifest.txt`
+  end
+end

data/gem_tasks/environment.rake

@@ -0,0 +1,7 @@
+task :ruby_env do
+  RUBY_APP = if RUBY_PLATFORM =~ /java/
+    "jruby"
+  else
+    "ruby"
+  end unless defined? RUBY_APP
+end

data/gem_tasks/fix_cr_lf.rake

@@ -0,0 +1,10 @@
+desc 'Make all files use UNIX (\n) line endings'
+task :fix_cr_lf do
+  files = FileList['**/*']
+  files.each do |f|
+    next if File.directory?(f)
+    s = IO.read(f)
+    s.gsub!(/\r?\n/, "\n")
+    File.open(f, "w") { |io| io.write(s) }
+  end
+end

data/gem_tasks/gemspec.rake

@@ -0,0 +1,6 @@
+namespace :gemspec do
+  desc 'Refresh rboss-gem.gemspec to include ALL files'
+  task :refresh => 'manifest:refresh' do
+    File.open('rboss.gemspec', 'w') {|io| io.write($hoe.spec.to_ruby)}
+  end
+end

data/gem_tasks/rspec.rake

@@ -0,0 +1,21 @@
+begin
+  require 'spec'
+rescue LoadError
+  require 'rubygems'
+  require 'spec'
+end
+begin
+  require 'spec/rake/spectask'
+rescue LoadError
+  puts <<-EOS
+To use rspec for testing you must install rspec gem:
+    gem install rspec
+EOS
+  exit(0)
+end
+
+desc "Run the specs under spec/models"
+Spec::Rake::SpecTask.new do |t|
+  t.spec_opts = ['--options', "spec/spec.opts"]
+  t.spec_files = FileList['spec/**/*_spec.rb']
+end

data/gem_tasks/website.rake

@@ -0,0 +1,17 @@
+desc 'Generate website files'
+task :website_generate => :ruby_env do
+  (Dir['website/**/*.txt'] - Dir['website/version*.txt']).each do |txt|
+    sh %{ #{RUBY_APP} script/txt2html #{txt} > #{txt.gsub(/txt$/,'html')} }
+  end
+end
+
+desc 'Upload website files to rubyforge'
+task :website_upload do
+  host = "#{rubyforge_username}@rubyforge.org"
+  remote_dir = "/var/www/gforge-projects/#{PATH}/"
+  local_dir = 'website'
+  sh %{rsync -aCv #{local_dir}/ #{host}:#{remote_dir}}
+end
+
+desc 'Generate and upload website files'
+task :website => [:website_generate, :website_upload, :publish_docs]

data/lib/boss/api.rb

@@ -0,0 +1,92 @@
+require 'net/http'
+require 'rexml/document'
+require 'uri'
+
+require 'ostruct'
+  
+module Boss
+
+  module SearchType
+    %w[web images news spell].each { |e| const_set(e.upcase, e) }
+  end
+
+  module SearchService
+    #Annoying inconsitency between 'spelling' and 'spell' in api
+    SPELL = 'spelling'
+  end
+
+  FORMATS = %w[xml json]
+
+  class Api
+
+    def initialize(app_id)
+      @app_id = app_id
+      @endpoint = 'http://boss.yahooapis.com/ysearch/'
+    end
+
+    def search_images(term, *conditions, &block)
+      search term, SearchType::IMAGES, *conditions, &block
+    end
+
+    def search_news(term, *conditions, &block)
+      search term, SearchType::NEWS, *conditions, &block
+    end
+
+    def search_web(term, *conditions, &block)
+      search term, SearchType::WEB, *conditions, &block
+    end
+
+    def search_spelling(term, *conditions, &block)
+      search term, SearchService::SPELL, *conditions, &block
+    end
+
+    def search(terms, search_type=SearchType::WEB, config = {})
+      config = config.empty? ? Config.new : Config.new(config)
+      search_results = []
+
+      yield config if block_given?
+
+      if config.format == 'object'
+        format_as_objects=true
+        config.format= "json"
+      else
+        format_as_objects=false
+      end
+        
+      raise InvalidFormat unless (FORMATS.include? config.format)
+      raise InvalidConfig unless (config.count>0)
+        
+      response = Net::HTTP.get_response(URI.parse(query_url(terms, search_type, config)))
+
+      case response.code
+      when "200"
+        data = response.body
+      
+        if format_as_objects
+          search_results = ResultFactory.build search_type, data
+        else
+          search_results = data
+        end
+      else
+        raise BossError, parse_error(data)
+      end
+
+      search_results
+    end
+    
+    def parse_error(data)
+    end
+
+    protected
+    def query_url(terms, search_type, config)
+      #puts "#{@endpoint}#{search_type}/#{boss_version}/#{terms}?appid=#{@app_id}#{config.to_url}"
+      "#{@endpoint}#{search_type}/#{boss_version}/#{terms}?appid=#{@app_id}#{config.to_url}"
+    end
+
+    def boss_version
+      "v#{Boss::YAHOO_VERSION}"
+    end
+
+  end
+
+end

data/lib/boss/config.rb

@@ -0,0 +1,16 @@
+module Boss
+
+  class Config < OpenStruct
+
+    def initialize(hash={})
+      #Setup defaults      
+      super({:count => 10, :lang => "en", :format => "object"}.merge(hash))
+    end
+   
+    def to_url
+      self.marshal_dump.inject("") {|accum, key| accum+="&#{key[0]}=#{key[1]}"  }
+    end
+
+  end
+
+end

data/lib/boss/result/base.rb

@@ -0,0 +1,13 @@
+module Boss
+  module Result
+    class Base < OpenStruct
+
+      def initialize(data={})
+        super
+      end
+
+    end
+    
+  end
+  
+end

data/lib/boss/result/image.rb

@@ -0,0 +1,8 @@
+module Boss
+  module Result
+    class Image < Base
+    end
+
+  end
+
+end

data/lib/boss/result/news.rb

@@ -0,0 +1,8 @@
+module Boss
+  module Result
+    class News < Base
+    end
+    
+  end
+  
+end

data/lib/boss/result/spell.rb

@@ -0,0 +1,8 @@
+module Boss
+  module Result
+    class Spell < Base
+    end
+    
+  end
+  
+end

data/lib/boss/result/web.rb

@@ -0,0 +1,8 @@
+module Boss
+  module Result
+    class Web < Base
+    end
+    
+  end
+  
+end

data/lib/boss/result.rb

@@ -0,0 +1 @@
+%w{base web image news spell}.each{|f| require "boss/result/#{f}"}

data/lib/boss/result_factory.rb

@@ -0,0 +1,53 @@
+require 'json'
+
+module Boss
+  class ResultFactory
+
+    class << self
+
+      SEARCH_RESPONSE = 'ysearchresponse'
+      RESULT_SET = 'resultset'
+
+      def build(search_type, data)
+
+        #Deal with inconsistency between search service 'spelling' and result 'spell'
+        search_type = SearchType::SPELL if search_type == SearchService::SPELL
+
+        json_hash = JSON.parse(data)
+
+        if json_hash.has_key? 'Error'
+          raise BossError, "Web service error"
+        end
+
+        search_results=[]
+                
+        if has_results json_hash, :for => search_type
+
+          json_hash[SEARCH_RESPONSE]["#{RESULT_SET}_#{search_type}"].each do |result|
+
+            case search_type
+            when SearchType::WEB
+              search_results << Result::Web.new(result)
+            when SearchType::IMAGES
+              search_results << Result::Image.new(result)
+            when SearchType::NEWS
+              search_results << Result::News.new(result)
+            when SearchType::SPELL
+              search_results << Result::Spell.new(result)
+            end
+
+          end
+        end
+
+        search_results
+      end
+
+      def has_results(json_hash, type={})
+        !(json_hash[SEARCH_RESPONSE]["#{RESULT_SET}_#{type[:for]}"]).nil?
+      end
+
+    end
+
+  end
+
+end

data/lib/boss/version.rb

@@ -0,0 +1,9 @@
+module Boss #:nodoc:
+  class VERSION #:nodoc:
+    MAJOR = 0
+    MINOR = 1
+    TINY  = 0
+
+    STRING = [MAJOR, MINOR, TINY].join('.')
+  end
+end

data/lib/boss.rb

@@ -0,0 +1,16 @@
+$:.unshift(File.dirname(__FILE__)) unless
+  $:.include?(File.dirname(__FILE__)) || $:.include?(File.expand_path(File.dirname(__FILE__)))
+
+require 'boss/api'
+require 'boss/config'
+require 'boss/result'
+require 'boss/result_factory'
+require 'boss/version'
+
+module Boss
+  YAHOO_VERSION = 1
+ 
+  class BossError < StandardError; end
+  class InvalidFormat < StandardError; end
+  class InvalidConfig < StandardError; end
+end

data/rboss.gemspec

@@ -0,0 +1,41 @@
+Gem::Specification.new do |s|
+  s.name = %q{rboss}
+  s.version = "0.1.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Joseph Wilk"]
+  s.date = %q{2008-08-19}
+  s.description = %q{Api wrapping Yahoo Boss search}
+  s.email = ["joe@eshopworks.co.uk"]
+  s.extra_rdoc_files = ["History.txt", "License.txt", "Manifest.txt", "TODO.txt"]
+  s.files = ["History.txt", "License.txt", "Manifest.txt", "README.textile", "Rakefile", "TODO.txt", "config/hoe.rb", "config/requirements.rb", "gem_tasks/deployment.rake", "gem_tasks/environment.rake", "gem_tasks/fix_cr_lf.rake", "gem_tasks/gemspec.rake", "gem_tasks/rspec.rake", "gem_tasks/website.rake", "lib/boss.rb", "lib/boss/api.rb", "lib/boss/config.rb", "lib/boss/result.rb", "lib/boss/result/base.rb", "lib/boss/result/image.rb", "lib/boss/result/news.rb", "lib/boss/result/spell.rb", "lib/boss/result/web.rb", "lib/boss/result_factory.rb", "lib/boss/version.rb", "rboss.gemspec", "spec/boss/api_spec.rb", "spec/boss/config_spec.rb", "spec/boss/result_factory_spec.rb", "spec/spec.opts", "spec/spec_helper.rb"]
+  s.has_rdoc = true
+  s.homepage = %q{http://github.com/eshopworks/rboss-gem}
+  s.rdoc_options = ["--main", "README.txt"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{rboss}
+  s.rubygems_version = %q{1.2.0}
+  s.summary = %q{Api wrapping Yahoo Boss search}
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 2
+
+    if current_version >= 3 then
+      s.add_runtime_dependency(%q<json>, [">= 1.1.3"])
+      s.add_runtime_dependency(%q<rspec>, [">= 1.1.4"])
+      s.add_runtime_dependency(%q<diff-lcs>, [">= 1.1.2"])
+      s.add_development_dependency(%q<hoe>, [">= 1.7.0"])
+    else
+      s.add_dependency(%q<json>, [">= 1.1.3"])
+      s.add_dependency(%q<rspec>, [">= 1.1.4"])
+      s.add_dependency(%q<diff-lcs>, [">= 1.1.2"])
+      s.add_dependency(%q<hoe>, [">= 1.7.0"])
+    end
+  else
+    s.add_dependency(%q<json>, [">= 1.1.3"])
+    s.add_dependency(%q<rspec>, [">= 1.1.4"])
+    s.add_dependency(%q<diff-lcs>, [">= 1.1.2"])
+    s.add_dependency(%q<hoe>, [">= 1.7.0"])
+  end
+end

data/spec/boss/api_spec.rb

@@ -0,0 +1,152 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+# require File.dirname(__FILE__) + '/../../boss/api.rb'
+
+describe Boss::Api do
+
+  def mock_http_response(stubs={})
+    mock('http_response', {:body => 'pretend:"json"', :code => "200"}.merge(stubs))
+  end
+
+  before(:each) do
+    @api = Boss::Api.new( appid = 'test' )
+  end
+
+  describe "responding to spelling search" do
+
+    it "should make a spelling request to yahoo service" do
+      Net::HTTP.should_receive(:get_response).and_return{ mock_http_response }
+      Boss::ResultFactory.stub!(:build)
+
+      @api.search_spelling "girafes"
+    end
+
+    it "should build the spelling objects" do
+      Net::HTTP.stub!(:get_response).and_return{ mock_http_response }
+      Boss::ResultFactory.should_receive(:build).with(Boss::SearchService::SPELL, 'pretend:"json"')
+
+      @api.search_spelling "girafes"
+    end
+
+  end
+
+  describe "responding to news search" do
+    it "should make a news request to yahoo service" do
+      Net::HTTP.should_receive(:get_response).and_return{ mock_http_response }
+      Boss::ResultFactory.stub!(:build)
+
+      @api.search_news "monkey"
+    end
+
+    it "should build the news objects" do
+      Net::HTTP.stub!(:get_response).and_return{ mock_http_response }
+      Boss::ResultFactory.should_receive(:build).with(Boss::SearchType::NEWS, 'pretend:"json"')
+
+      @api.search_news "monkey"
+    end
+  end
+
+  describe "responding to image search" do
+    it "should make a image request to yahoo service" do
+      Net::HTTP.should_receive(:get_response).and_return{ mock_http_response }
+      Boss::ResultFactory.stub!(:build)
+
+      @api.search_images "hippo"
+    end
+
+    it "should build the image objects" do
+      Net::HTTP.stub!(:get_response).and_return{ mock_http_response }
+      Boss::ResultFactory.should_receive(:build).with(Boss::SearchType::IMAGES, 'pretend:"json"')
+
+      @api.search_images "hippo"
+    end
+  end
+
+  describe "responding to web search" do
+
+    it "should make a web request to yahoo service" do
+      Net::HTTP.should_receive(:get_response).and_return{ mock_http_response }
+      Boss::ResultFactory.stub!(:build)
+      @api.search_web "monkey"
+    end
+
+    it "should build the web objects" do
+      Net::HTTP.stub!(:get_response).and_return{ mock_http_response }
+      Boss::ResultFactory.should_receive(:build).with(Boss::SearchType::WEB, 'pretend:"json"')
+
+      @api.search_web "monkey"
+    end
+
+  end
+
+  describe "failed search" do
+
+    it "should raise error on failed search" do
+      Net::HTTP.stub!(:get_response).and_return{ mock_http_response :code => "404" }
+
+      lambda { @api.search_web "monkey"  }.should raise_error(Boss::BossError)
+    end
+
+  end
+
+  describe "search should still work when get returns a successful but not code 200" do
+    it "should description" do
+      pending("fix for http://rboss.lighthouseapp.com/projects/15732/tickets/1")
+      Net::HTTP.stub!(:get_response).and_return{ mock_http_response :code => "206" }
+
+      lambda { @api.search_web "monkey"  }.should_not raise_error(Boss::BossError)
+    end
+  end
+
+  describe "configuring search" do
+
+    before(:each) do
+      Net::HTTP.stub!(:get_response).and_return{ mock_http_response }
+      Boss::ResultFactory.stub!(:build)
+
+      @config = Boss::Config.new
+    end
+
+    it "should allow configuring through block" do
+      @config.should_receive(:count=).with(1)
+      Boss::Config.should_receive(:new).and_return(@config)
+
+      result = @api.search_web "monkeys" do |setup|
+        setup.count = 1
+      end
+    end
+
+    it "should allow configuring through hash" do
+      Boss::Config.should_receive(:new).with({:count => 1}).and_return(@config)
+
+      @api.search_web "monkeys", :count => 1
+    end
+
+  end
+
+  describe "formats" do
+
+    before(:each) do
+      Net::HTTP.stub!(:get_response).and_return{ mock_http_response }
+    end
+
+    it "should not return any objects when format is 'xml'" do
+      Boss::ResultFactory.should_receive(:build).never
+      @api.search_web "monkeys", :format => 'xml', :count => 1
+    end
+
+    it "should not return any objects when format is 'json'" do
+      Boss::ResultFactory.should_receive(:build).never
+      @api.search_web "monkeys", :format => 'json', :count => 1
+    end
+
+    it "should raise an error invalid format" do
+      lambda { @api.search_web "monkeys", :format => 'grilled_cheese', :count => 1 }.should raise_error(Boss::InvalidFormat)
+    end
+
+    it "should raise an error on invalid count" do
+      lambda { @api.search_web "monkeys", :count => 0 }.should raise_error(Boss::InvalidConfig)
+    end
+
+  end
+
+end

data/spec/boss/config_spec.rb

@@ -0,0 +1,27 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+
+describe Boss::Config do
+
+  it "should create with defaults" do
+    config = Boss::Config.new
+
+    config.respond_to?(:count).should be_true
+    config.respond_to?(:lang).should be_true
+    config.respond_to?(:format).should be_true
+  end
+  
+  it "should create url from defaults" do
+    config = Boss::Config.new :count => 1, :lang => 'en', :format => "object"
+  
+    config.to_url.should include("&count=1")
+    config.to_url.should include("&format=object")
+    config.to_url.should include("&lang=en")
+  end
+  
+  it "should add custom values to url" do
+    config = Boss::Config.new :mizaru => 'cannot_see'
+    
+    config.to_url.should include("&mizaru=cannot_see")
+  end
+  
+end

data/spec/boss/result_factory_spec.rb

@@ -0,0 +1,44 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+
+describe Boss::ResultFactory do
+
+   news_json_result = '{"ysearchresponse":{"responsecode":"200","nextpage":"nextpage","totalhits":"344","count":"1","start":"0","resultset_news":[{"abstract":"abstract","clickurl":"clickurl","date":"2008\/08\/18","language":"en english","source":"source","sourceurl":"sourceurl","time":"09:17:29","title":"monkey_title","url":"url"}]}}'
+
+   image_json_result = '{"ysearchresponse":{"responsecode":"200","nextpage":"http:\/\/www.example.com","totalhits":"80","count":"1","start":"0","resultset_images":[{"abstract":"more monkeys","clickurl":"http:\/\/www.example.con\/click","date":"2001\/12\/19","filename":"monkeys.jpg","format":"jpeg","height":"600","mimetype":"image\/jpeg","refererclickurl":"http:\/\/www.example.com\/ref","refererurl":"http:\/\/www.monkeys.com","size":"60900","thumbnail_height":"116","thumbnail_url":"http:\/\/monkey.com\/image\/25\/m7\/3918546506","thumbnail_width":"155","title":"monkeys.jpg","url":"http:\/\/monkey\/monkeys.jpg","width":"800"}]}}'
+
+   web_json_result = '{"ysearchresponse":{"responsecode":"200","nextpage":"nextpage","totalhits":"344","count":"1","start":"0","resultset_web":[{"abstract":"abstract","clickurl":"clickurl","date":"2008\/08\/18","language":"en english","source":"source","sourceurl":"sourceurl","time":"09:17:29","title":"monkey_title","url":"url"}]}}'
+   
+   spelling_json_result = '{"ysearchresponse":{"responsecode":"200","totalhits":"1","count":"1","start":"0","resultset_spell":[{"suggestion":"giraffes"}]}}'
+
+
+  it "should create a new news object from json" do
+    Boss::Result::News.should_receive(:new).once
+
+    Boss::ResultFactory.build(Boss::SearchType::NEWS, news_json_result)
+  end
+
+  it "should correctly map fields with from json to news object" do
+    news_results = Boss::ResultFactory.build(Boss::SearchType::NEWS, news_json_result)
+
+    news_results[0].title.should == "monkey_title"
+  end
+  
+  it "should build image objects from json" do
+    Boss::Result::Image.should_receive(:new).once
+
+    Boss::ResultFactory.build(Boss::SearchType::IMAGES, image_json_result)
+  end
+  
+  it "should build web object from json" do
+    Boss::Result::Web.should_receive(:new).once
+
+    Boss::ResultFactory.build(Boss::SearchType::WEB, web_json_result)
+  end
+   
+  it "should build spelling object from json" do
+    Boss::Result::Spell.should_receive(:new).once
+    
+    Boss::ResultFactory.build(Boss::SearchType::SPELL, spelling_json_result)
+  end
+  
+end

data/spec/spec.opts

@@ -0,0 +1,2 @@
+--colour
+--diff

data/spec/spec_helper.rb

@@ -0,0 +1,7 @@
+require 'rubygems'
+gem 'rspec'
+require 'spec'
+
+$:.unshift(File.join(File.dirname(__FILE__), %w[.. lib]))
+
+require 'boss'

metadata

@@ -0,0 +1,123 @@
+--- !ruby/object:Gem::Specification 
+name: eshopworks-rboss
+version: !ruby/object:Gem::Version 
+  version: 0.1.0
+platform: ruby
+authors: 
+- Joseph Wilk
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-08-19 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: json
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.1.3
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.1.4
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: diff-lcs
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.1.2
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: hoe
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.7.0
+    version: 
+description: Api wrapping Yahoo Boss search
+email: 
+- joe@eshopworks.co.uk
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- History.txt
+- License.txt
+- Manifest.txt
+- TODO.txt
+files: 
+- History.txt
+- License.txt
+- Manifest.txt
+- README.textile
+- Rakefile
+- TODO.txt
+- config/hoe.rb
+- config/requirements.rb
+- gem_tasks/deployment.rake
+- gem_tasks/environment.rake
+- gem_tasks/fix_cr_lf.rake
+- gem_tasks/gemspec.rake
+- gem_tasks/rspec.rake
+- gem_tasks/website.rake
+- lib/boss.rb
+- lib/boss/api.rb
+- lib/boss/config.rb
+- lib/boss/result.rb
+- lib/boss/result/base.rb
+- lib/boss/result/image.rb
+- lib/boss/result/news.rb
+- lib/boss/result/spell.rb
+- lib/boss/result/web.rb
+- lib/boss/result_factory.rb
+- lib/boss/version.rb
+- rboss.gemspec
+- spec/boss/api_spec.rb
+- spec/boss/config_spec.rb
+- spec/boss/result_factory_spec.rb
+- spec/spec.opts
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: http://github.com/eshopworks/rboss-gem
+post_install_message: 
+rdoc_options: 
+- --main
+- README.txt
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: rboss
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: Api wrapping Yahoo Boss search
+test_files: []
+