googleajax 0.1.0 → 0.2.0

data/History.txt

@@ -1,6 +1,22 @@
-=== 1.0.0 / 2008-05-19
+=== 0.2.0 / 2009-11-17
 
-* 1 major enhancement
+* New features:
+  * results can use [] and []= for lookup and seting
+  * allows results to be open structs (default) or hash (by requiring 'googleajax/as_hash' instead)
 
-  * Birthday!
+* bug fixes:
+  * Search.web(...).count now returns an int, not a string
+  * many calls were not passing the args argument to #get
+  * Feed.load used to return an open struct with only one method called 'feed' that was a hash. It now returns the feed correctly.
 
+* Behind the scene changes:
+  * specs
+  * shorter, cleaner code
+  * links to google api doc in rdoc
+  * most classes are now modules
+  * small optimizations
+  * All #get now requires arg (see bug fix)
+
+=== 0.1.0 / 2008-05-19
+
+* Initial Release

data/README.txt

@@ -5,40 +5,67 @@
 
 == DESCRIPTION:
 
-Ruby wrapper to the Google AJAX API REST interfaces(Feeds, Language and Search).
+Ruby wrapper for Google AJAX API REST interfaces(Feeds, Language and Search).
 
 == SYNOPSIS:
 
-* First, setup referer: GoogleAjax.referer = 'http://mydomain.com'
-* Optionally, you can also set an api_key: GoogleAjax.api_key = 'YOUR_API_KEY'
-
-=== Now you are set to go, so a few examples:
-* GoogleAjax::Feed.find('ruby') # Find top 10 feeds for 'ruby'
-* GoogleAjax::Feed.load('http://monki.geemus.com/feed/atom.xml') # Load 4 most recent entries from feed 'http://monki.geemus.com/feed/atom.xml'
-* GoogleAjax::Feed.lookup('http://monki.geemus.com') # Find feed for 'http://monki.geemus.com'
-* GoogleAjax::Language.detect('Ciao mondo') # Find the language of the string 'Ciao mondo'
-* GoogleAjax::Language.translate('Hello world', 'en', 'it') # Translate 'Hello world' to italian
-* GoogleAjax::Search.blogs('ruby') # Find top 4 blogs for 'ruby'
-* GoogleAjax::Search.books('ruby') # Find top 4 books for 'ruby'
-* GoogleAjax::Search.images('ruby') # Find top 4 images for 'ruby'
-* GoogleAjax::Search.local('ruby', 48.8565, 2.3509) # Find top 4 local results for 'ruby' at latitude 48.8565, longitude 2.3509
-* GoogleAjax::Search.news('ruby') # Find top 4 news results for 'ruby'
-* GoogleAjax::Search.video('ruby') # Find top 4 video results for 'ruby'
-* GoogleAjax::Search.web('Hello world') # Find top 4 web page results for 'Hello world'
+  # First, setup referer: 
+  GoogleAjax.referer = [your domain name here]
+
+  # Optionally, you can set an api_key:
+  GoogleAjax.api_key = [your api key here]
+
+=== Now you are set to go, so here are a few examples:
+
+  # Find top 10 feeds for 'ruby'
+  GoogleAjax::Feed.find('ruby')
+
+  # Load 4 most recent entries from 'http://monki.geemus.com/feed/atom.xml'
+  GoogleAjax::Feed.load('http://monki.geemus.com/feed/atom.xml')
+
+  # Find feed for 'http://monki.geemus.com'
+  GoogleAjax::Feed.lookup('http://monki.geemus.com')
+
+  # Find the language of the string 'Ciao mondo'
+  GoogleAjax::Language.detect('Ciao mondo')
+
+  # Translate 'Hello world' to italian
+  GoogleAjax::Language.translate('Hello world', 'en', 'it')
+
+  # Find top 4 blogs for 'ruby'
+  GoogleAjax::Search.blogs('ruby')
+
+  # Find top 4 books for 'ruby'
+  GoogleAjax::Search.books('ruby')
+
+  # Find top 4 images for 'ruby'
+  GoogleAjax::Search.images('ruby')
+
+  # Find top 4 local results for 'ruby' at latitude 48.8565, longitude 2.3509
+  GoogleAjax::Search.local('ruby', 48.8565, 2.3509)
+
+  # Find top 4 news results for 'ruby'
+  GoogleAjax::Search.news('ruby')
+
+  # Find top 4 video results for 'ruby'
+  GoogleAjax::Search.video('ruby')
+
+  # Find top 4 web page results for 'Hello world'
+  GoogleAjax::Search.web('Hello world')
 
 == REQUIREMENTS:
 
-* JSON gem to parse the responses
+* JSON gem to parse responses, or rails
 
 == INSTALL:
 
-* sudo gem install googleajax --include-dependencies
+  sudo gem install googleajax
 
 == LICENSE:
 
 (The MIT License)
 
-Copyright (c) 2008 monki(Wesley Beary) => monki@geemus.com
+Copyright (c) 2009 {geemus (Wesley Beary)}[http://github.com/geemus]
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/Rakefile

@@ -1,17 +1,46 @@
-# -*- ruby -*-
-
 require 'rubygems'
-require 'hoe'
-$: << File.dirname(__FILE__) + '/lib'
-require './lib/google_ajax.rb'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "googleajax"
+    gem.summary = %Q{Ruby wrapper to the Google AJAX API REST interfaces(Feeds, Language and Search).}
+    #gem.description = %Q{TODO: longer description of your gem}
+    gem.email = "me@geemus.com"
+    gem.homepage = "http://github.com/geemus/googleajax"
+    gem.authors = ["geemus(Wesley Beary)", "Marc-Andre Lafortune"]
+    gem.add_development_dependency "rspec", ">= 1.2.9"
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+    gem.add_dependency 'json', '>= 1.0.0'
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: sudo gem install jeweler"
+end
+
+require 'spec/rake/spectask'
+Spec::Rake::SpecTask.new(:spec) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.spec_files = FileList['spec/**/*_spec.rb']
+end
 
-Hoe.new('googleajax', GoogleAjax::VERSION::STRING) do |p|
-  p.rubyforge_name = 'googleajax'
-  p.developer('monki(Wesley Beary)', 'monki@geemus.com')
-  p.summary = 'Ruby wrapper to the Google AJAX API REST interfaces(Feeds, Language and Search).'
-  p.url = 'http://googleajax.rubyforge.com'
-  p.remote_rdoc_dir = ''
-  p.extra_deps << ['json', '>= 1.0.0']  
+Spec::Rake::SpecTask.new(:rcov) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
 end
 
-# vim: syntax=Ruby
+task :spec => :check_dependencies
+
+task :default => :spec
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "googleajax #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.2.0

data/lib/googleajax.rb

@@ -0,0 +1,31 @@
+require 'cgi'
+require 'open-uri'
+require 'ostruct'
+require 'rubygems'
+require 'json' unless defined?(Rails)
+
+module GoogleAjax
+  require 'googleajax/base' unless const_defined?("Base")
+  require 'googleajax/feed'
+  require 'googleajax/language'
+  require 'googleajax/search'
+  require 'googleajax/parser'
+
+  API_BASE = 'http://ajax.googleapis.com/ajax/services/'
+  class << self
+    attr_accessor :api_key
+    attr_accessor :referer
+
+    # Api doc is at http://code.google.com/apis/ajaxsearch/documentation/reference.html#_intro_fonje
+    def get(api, method, query, args = nil)
+      raise "You must assign a value to GoogleAjax.referer" unless referer
+      url  = "#{API_BASE}#{api}/"
+      url += "#{method}?"
+      url += "&q=#{CGI::escape(query)}"
+      url += "&key=#{api_key}" if api_key
+      url += "&" + args.collect {|key, value| "#{key}=#{value}"}.join('&') if args && !args.empty?
+      data = open(url, "Referer" => referer).read
+      Parser.parse(api, method, data)
+    end
+  end
+end

data/lib/googleajax/as_hash.rb

@@ -0,0 +1,15 @@
+# Include this file instead of googleajax so that results are simply hashes
+
+module GoogleAjax
+  class Base < Hash
+    def initialize(h)
+      super()
+      replace(h)
+    end
+
+    def self.remap(h)
+    end
+  end
+end
+
+require 'googleajax'

data/lib/googleajax/base.rb

@@ -0,0 +1,25 @@
+module GoogleAjax
+  class Base < OpenStruct
+    def [](key)
+      send(key)
+    end
+
+    def []=(key, value)
+      send("#{key}=", value)
+    end
+
+    def self.remap(h)
+      define_method(:initialize) do |arg|
+        super(arg)
+        h.each do |key, klass|
+          case self[key]
+          when Array
+            self[key] = self[key].map(&klass.method(:new))
+          when Hash
+            self[key] = klass.new(self[key])
+          end
+        end
+      end
+    end
+  end
+end

data/lib/googleajax/feed.rb

@@ -0,0 +1,35 @@
+module GoogleAjax
+  module Feed
+    FEED_VERSION = 1.0
+    # Arguments: http://code.google.com/apis/ajaxfeeds/documentation/reference.html#_intro_fonje
+    def self.get(method, query, args)
+      args = { :v => FEED_VERSION }.merge(args)
+      GoogleAjax::get(:feed, method, query, args)
+    end
+
+    # will return a list of feeds that match the given query
+    # Arguments: http://code.google.com/apis/ajaxfeeds/documentation/reference.html#_fonje_find
+    def self.find(query, args = {})
+      self.get(:find, query, args)
+    end
+
+    # downloads this feed from Google's servers
+    # Arguments: http://code.google.com/apis/ajaxfeeds/documentation/reference.html#_fonje_load
+    def self.load(url, args = {})
+      self.get(:load, url, args)
+    end
+
+    # will return the associated feed if it exists for a given url    
+    # Arguments: http://code.google.com/apis/ajaxfeeds/documentation/reference.html#_intro_fonje
+    def self.lookup(url, args = {})
+      self.get(:lookup, url, args)
+    end    
+
+    class Entry < Base
+    end    
+
+    class Feed < Base
+      remap :entries => Entry
+    end
+  end
+end

data/lib/{google_ajax → googleajax}/language.rb

@@ -1,36 +1,29 @@
-class GoogleAjax
-  class Language
+module GoogleAjax
+  module Language
     LANGUAGE_VERSION = 1.0
-    def self.get(method, query, args = {})
-      args = { :v => LANGUAGE_VERSION }.merge!(args)
+    def self.get(method, query, args)
+      args = { :v => LANGUAGE_VERSION }.merge(args)
       GoogleAjax::get(:language, method, query, args)
     end
     
     # will return the language code that describes the language of the given text
     def self.detect(query, args = {})
-      self.get(:detect, query)
+      self.get(:detect, query, args)
     end
     
     # will return translated text for the given text supplied, matching the destination language.
     def self.translate(query, source, destination, args = {})
-      args = { :langpair => "#{source}%7C#{destination}"}.merge!(args)
+      args = { :langpair => "#{source}%7C#{destination}"}.merge(args)
       self.get(:translate, query, args)
     end
     
-    class Language < OpenStruct
-      def initialize(data)
-        super(data)
-      end
-      
+    class Language < Base
       def name
-        LANGUAGES.invert[self.language]
+        (@@lang_cache ||= LANGUAGES.invert)[self.language]
       end
     end
     
-    class Translation < OpenStruct
-      def initialize(data)
-        super(data)
-      end
+    class Translation < Base
     end
     
     LANGUAGES =
@@ -77,6 +70,6 @@ class GoogleAjax
       'UKRAINIAN' => 'uk',
       'VIETNAMESE' => 'vi',
       'UNKNOWN' => ''
-    }    
+    }
   end
 end

data/lib/googleajax/parser.rb

@@ -0,0 +1,38 @@
+module GoogleAjax
+  module Parser
+    def self.parse(api, method, data)
+      data = if defined? Rails
+        ActiveSupport::JSON::decode(data)
+      else
+        JSON.parse(data)
+      end
+      process_errors(data)
+      parser = PARSERS[api][method]
+      response = data['responseData']
+      parser.is_a?(Symbol) ? send(parser, response) : parser.new(response) if response
+    end
+
+    def self.process_errors(data)
+      status = data['responseStatus']
+      unless (200..206).include? status
+        raise StandardError, data['responseDetails']
+      end
+    end
+
+    def self.parse_feed_list(data)
+      data['entries'].map(&Feed::Feed.method(:new))
+    end
+
+    def self.parse_one_feed(data)
+      Feed::Feed.new(data['feed'])
+    end
+
+    PARSERS = {
+      :feed     => { :find => :parse_feed_list, :load => :parse_one_feed, :lookup => Feed::Feed },
+      :language => { :detect => Language::Language, :translate => Language::Translation },
+      :search   => { :blogs => Search::Results, :books => Search::Results, :images => Search::Results, :local => Search::Results,
+                     :news => Search::Results, :video => Search::Results, :web => Search::Results }
+    }
+
+  end
+end

data/lib/googleajax/search.rb

@@ -0,0 +1,66 @@
+module GoogleAjax
+  module Search
+    SEARCH_VERSION = 1.0
+    # Arguments: http://code.google.com/apis/ajaxsearch/documentation/reference.html#_fonje_web
+    def self.get(method, query, args)
+      args = { :v => SEARCH_VERSION }.merge(args)
+      GoogleAjax::get(:search, method, query, args)
+    end
+  
+    # Arguments: http://code.google.com/apis/ajaxsearch/documentation/reference.html#_fonje_blog
+    def self.blogs(query, args = {})
+      self.get(:blogs, query, args)
+    end
+  
+    # Arguments: http://code.google.com/apis/ajaxsearch/documentation/reference.html#_fonje_book
+    def self.books(query, args = {})
+      self.get(:books, query, args)
+    end
+
+    # Arguments: http://code.google.com/apis/ajaxsearch/documentation/reference.html#_fonje_image
+    def self.images(query, args = {})
+      self.get(:images, query, args)
+    end
+
+    # Arguments: http://code.google.com/apis/ajaxsearch/documentation/reference.html#_fonje_local
+    def self.local(query, latitude, longitude, args = {})
+      args = { :sll => "#{latitude},#{longitude}" }.merge(args)
+      self.get(:local, query, args)
+    end
+
+    # Arguments: http://code.google.com/apis/ajaxsearch/documentation/reference.html#_fonje_news
+    def self.news(query, args = {})
+      self.get(:news, query, args)
+    end
+
+    # Arguments: http://code.google.com/apis/ajaxsearch/documentation/reference.html#_fonje_video
+    def self.video(query, args = {})
+      self.get(:video, query, args)
+    end
+
+    # http://code.google.com/apis/ajaxsearch/documentation/reference.html#_fonje_web
+    def self.web(query, args = {})
+      self.get(:web, query, args)
+    end
+
+    class Result < Base
+    end
+
+    class Page < Base
+    end
+
+    class Cursor < Base
+      remap :pages => Page
+    end
+
+    class Results < Base
+      remap :results => Result,
+            :cursor => Cursor
+
+      def count
+        self['cursor']['estimatedResultCount'].to_i
+      end
+    end
+
+  end
+end

data/spec/googleajax_as_hash_spec.rb

@@ -0,0 +1,15 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+require File.expand_path(File.dirname(__FILE__) + '/googleajax_common')
+
+require 'googleajax/as_hash'
+
+describe "GoogleAjax/as_hash" do
+  it_should_behave_like "GoogleAjax"
+
+  it "returns results as a hash" do
+    GoogleAjax.referer = "http://example.com"
+    response = GoogleAjax::Search.web("apple", :rsz => :large)
+    response.is_a? Hash
+    response['cursor'].is_a? Hash
+  end
+end

data/spec/googleajax_common.rb

@@ -0,0 +1,93 @@
+# encoding:utf-8
+shared_examples_for "GoogleAjax" do
+  it "requires a referer" do
+    GoogleAjax.referer = nil
+    lambda{GoogleAjax::Search.web("testing")}.should raise_error
+  end
+
+  describe "::Search" do
+    describe ".web" do
+      before :each do
+        GoogleAjax.referer = "http://example.com"
+        @response = GoogleAjax::Search.web("apple", :rsz => :large)
+      end
+
+      it "returns the expected results" do
+        @response['results'].select{|result| result['url'] =~ /http:(.*).apple.com/}.size.should >= 4
+      end
+    end
+
+    {
+      :blogs  => 100_000,
+      :books  => 10_000,
+      :images => 10_000,
+      :video  => 10_000,
+      :web    => 1_000_000,
+      :local  => [100, 48.8565, 2.3509]
+    }.each do |method, (min, *args)|
+      describe ".#{method}" do
+        before :each do
+          GoogleAjax.referer = "http://example.com"
+          @response_small = GoogleAjax::Search.send(method, "ruby", *args)
+        end
+
+        it "takes options into account" do
+          @response_large = GoogleAjax::Search.send(method, "ruby", *(args+[{:rsz => :large}]))
+          @response_large['results'].size.should > @response_small['results'].size
+        end unless method == :blogs # Google doesn't seem to support this option for blogs???
+
+        it "returns an approximate count of hits" do
+          @response_small.count.should > min
+        end
+      end
+    end
+  end
+
+  describe "::Language" do
+    before :each do
+      GoogleAjax.referer = "http://example.com"
+    end
+
+    describe ".detect" do
+      it "returns the right language" do
+        GoogleAjax::Language.detect("What's up folks")['language'].should == "en"
+        GoogleAjax::Language.detect("Montréal est une ville incroyable")['language'].should == "fr"
+      end
+    end
+
+    describe ".translate" do
+      it "does an approximate translation" do
+        GoogleAjax::Language.translate("Ruby rocks", "en", "fr")['translatedText'].should == "Ruby roches"
+      end
+    end
+  end
+
+  describe "::Feed" do
+    before :each do
+      GoogleAjax.referer = "http://example.com"
+    end
+
+    describe ".find" do
+      it "returns the right feeds" do
+        feeds = GoogleAjax::Feed.find("Ruby")
+        feeds.size.should == 10
+        feeds.any?{|result| result['url'] == "http://www.ruby-lang.org/en/feeds/news.rss"}.should be_true
+      end
+    end
+
+    describe ".load" do
+      it "loads entries of a feed" do
+        feed = GoogleAjax::Feed.load('http://digg.com/rss/index.xml')
+        feed['title'].should == "digg.com: Stories / Popular"
+        feed['entries'].size.should == 4
+      end
+    end
+
+    describe ".lookup" do
+      it "returns the feed associated with a URL" do
+        feed = GoogleAjax::Feed.lookup("http://digg.com/")
+        feed['url'].should == "http://feeds.digg.com/digg/popular.rss"
+      end
+    end
+  end
+end

data/spec/googleajax_spec.rb

@@ -0,0 +1,15 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+require File.expand_path(File.dirname(__FILE__) + '/googleajax_common')
+
+require 'googleajax'
+
+describe "GoogleAjax (standard)" do
+  it_should_behave_like "GoogleAjax"
+
+  it "returns results as an OpenStuct" do
+    GoogleAjax.referer = "http://example.com"
+    response = GoogleAjax::Search.web("apple", :rsz => :large)
+    response.is_a? OpenStruct
+    response.cursor.is_a? OpenStruct
+  end
+end

data/spec/spec.opts

@@ -0,0 +1 @@
+--color

data/spec/spec_helper.rb

@@ -0,0 +1,8 @@
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+require 'spec'
+require 'spec/autorun'
+
+Spec::Runner.configure do |config|
+  
+end

metadata

@@ -1,64 +1,70 @@
 --- !ruby/object:Gem::Specification 
 name: googleajax
 version: !ruby/object:Gem::Version 
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors: 
-- monki(Wesley Beary)
+- geemus(Wesley Beary)
+- Marc-Andre Lafortune
 autorequire: 
 bindir: bin
 cert_chain: []
 
-date: 2008-05-20 00:00:00 -07:00
+date: 2009-11-17 00:00:00 -08:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
-  name: json
+  name: rspec
+  type: :development
   version_requirement: 
   version_requirements: !ruby/object:Gem::Requirement 
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        version: 1.0.0
+        version: 1.2.9
     version: 
 - !ruby/object:Gem::Dependency 
-  name: hoe
+  name: json
+  type: :runtime
   version_requirement: 
   version_requirements: !ruby/object:Gem::Requirement 
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        version: 1.5.1
+        version: 1.0.0
     version: 
-description: Ruby wrapper to the Google AJAX API REST interfaces(Feeds, Language and Search).
-email: 
-- monki@geemus.com
+description: 
+email: me@geemus.com
 executables: []
 
 extensions: []
 
 extra_rdoc_files: 
-- History.txt
-- Manifest.txt
 - README.txt
 files: 
 - History.txt
-- Manifest.txt
 - README.txt
 - Rakefile
-- lib/google_ajax.rb
-- lib/google_ajax/feed.rb
-- lib/google_ajax/language.rb
-- lib/google_ajax/parser.rb
-- lib/google_ajax/search.rb
-- lib/google_ajax/version.rb
-- test/test_google_ajax.rb
+- VERSION
+- lib/googleajax.rb
+- lib/googleajax/as_hash.rb
+- lib/googleajax/base.rb
+- lib/googleajax/feed.rb
+- lib/googleajax/language.rb
+- lib/googleajax/parser.rb
+- lib/googleajax/search.rb
+- spec/googleajax_as_hash_spec.rb
+- spec/googleajax_common.rb
+- spec/googleajax_spec.rb
+- spec/spec.opts
+- spec/spec_helper.rb
 has_rdoc: true
-homepage: http://googleajax.rubyforge.com
+homepage: http://github.com/geemus/googleajax
+licenses: []
+
 post_install_message: 
 rdoc_options: 
-- --main
-- README.txt
+- --charset=UTF-8
 require_paths: 
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement 
@@ -75,10 +81,13 @@ required_rubygems_version: !ruby/object:Gem::Requirement
   version: 
 requirements: []
 
-rubyforge_project: googleajax
-rubygems_version: 1.1.1
+rubyforge_project: 
+rubygems_version: 1.3.5
 signing_key: 
-specification_version: 2
+specification_version: 3
 summary: Ruby wrapper to the Google AJAX API REST interfaces(Feeds, Language and Search).
 test_files: 
-- test/test_google_ajax.rb
+- spec/googleajax_as_hash_spec.rb
+- spec/googleajax_common.rb
+- spec/googleajax_spec.rb
+- spec/spec_helper.rb

data/Manifest.txt

@@ -1,11 +0,0 @@
-History.txt
-Manifest.txt
-README.txt
-Rakefile
-lib/google_ajax.rb
-lib/google_ajax/feed.rb
-lib/google_ajax/language.rb
-lib/google_ajax/parser.rb
-lib/google_ajax/search.rb
-lib/google_ajax/version.rb
-test/test_google_ajax.rb

data/lib/google_ajax.rb

@@ -1,41 +0,0 @@
-require 'cgi'
-require 'open-uri'
-require 'ostruct'
-require 'rubygems'
-require 'json'
-
-require 'google_ajax/feed'
-require 'google_ajax/language'
-require 'google_ajax/parser'
-require 'google_ajax/search'
-require 'google_ajax/version'
-
-class GoogleAjax
-  API_BASE = 'http://ajax.googleapis.com/ajax/services/'
-  @@api_key = @@referer = nil
-  
-  def self.api_key
-    @@api_key
-  end
-  def self.api_key=(key)
-    @@api_key = key
-  end
-  def self.referer
-    @@referer
-  end
-  def self.referer=(referer)
-    @@referer = referer
-  end
-
-# TODO: Pass query to parser, so it knows where it came from.  Needed for search paging and useful in general.
-  def self.get(api, method, query, args = nil)
-    raise "You must assign a value to GoogleAjax.referer" unless @@referer
-    url  = "#{API_BASE}#{api}/"
-    url += "#{method}?"
-    url += "&q=#{CGI::escape(query)}"
-    url += "&key=" if @@api_key
-    url += "&" + args.collect {|key, value| "#{key}=#{value}"}.join('&') if args && !args.empty?
-    data = open(url, "Referer" => @@referer).read
-    Parser.parse(api, method, data)
-  end  
-end

data/lib/google_ajax/feed.rb

@@ -1,38 +0,0 @@
-class GoogleAjax
-  class Feed
-    FEED_VERSION = 1.0
-    def self.get(method, query, args = {})
-      args = { :v => FEED_VERSION }.merge!(args)
-      GoogleAjax::get(:feed, method, query, args)
-    end
-    
-    # will return a list of feeds that match the given query
-    def self.find(query, args = {})
-      self.get(:find, query)
-    end
-
-    # downloads this feed from Google's servers
-    # Optional: args { :num => number of entries to download(default is 4, maximum is 100) }
-    def self.load(query, args = {})
-      self.get(:load, query, args)
-    end
-    
-    # will return the associated feed if it exists for a given url    
-    def self.lookup(query, args = {})
-      self.get(:lookup, query)
-    end    
-    
-    class Entry < OpenStruct
-      def initialize(data)
-        super(data)
-      end
-    end    
-    
-    class Feed < OpenStruct
-      def initialize(data)
-        super(data)
-        self.entries = entries.collect {|data| Entry.new(data)} if entries
-      end
-    end
-  end
-end

data/lib/google_ajax/parser.rb

@@ -1,90 +0,0 @@
-class GoogleAjax
-  class Parser
-    def self.parse(api, method, data)
-      data = JSON.parse(data)
-      Errors.process(data)
-      parser = Parser::PARSERS[api][method]
-      parser.process(data['responseData'])
-    end
-  end
-  
-  class FeedFind < Parser#:nodoc:
-    def self.process(data)
-      data['entries'].collect {|data| GoogleAjax::Feed::Feed.new(data)} if data
-    end
-  end
-  class FeedLoad < Parser#:nodoc:
-    def self.process(data)
-      GoogleAjax::Feed::Feed.new(data['feed']) if data
-    end
-  end
-  class FeedLookup < Parser#:nodoc:
-    def self.process(data)
-      GoogleAjax::Feed::Feed.new(data) if data
-    end
-  end
-  
-  class LanguageDetect < Parser#:nodoc
-    def self.process(data)
-      GoogleAjax::Language::Language.new(data) if data
-    end
-  end
-  class LanguageTranslate < Parser#:nodoc
-    def self.process(data)
-      GoogleAjax::Language::Translation.new(data) if data
-    end
-  end
-  
-  class SearchBlogs < Parser#:nodoc
-    def self.process(data)
-      GoogleAjax::Search::Results.new(data) if data
-    end
-  end
-  class SearchBooks < Parser#:nodoc
-    def self.process(data)
-      GoogleAjax::Search::Results.new(data) if data
-    end
-  end
-  class SearchImages < Parser#:nodoc
-    def self.process(data)
-      GoogleAjax::Search::Results.new(data) if data
-    end
-  end  
-  class SearchLocal < Parser#:nodoc
-    def self.process(data)
-      GoogleAjax::Search::Results.new(data) if data
-    end
-  end
-  class SearchNews < Parser#:nodoc
-    def self.process(data)
-      GoogleAjax::Search::Results.new(data) if data
-    end
-  end  
-  class SearchVideo < Parser#:nodoc
-    def self.process(data)
-      GoogleAjax::Search::Results.new(data) if data
-    end
-  end
-  class SearchWeb < Parser#:nodoc
-    def self.process(data)
-      GoogleAjax::Search::Results.new(data) if data
-    end
-  end
-  
-  class Parser
-    PARSERS = {
-      :feed     => { :find => FeedFind, :load => FeedLoad, :lookup => FeedLookup },
-      :language => { :detect => LanguageDetect, :translate => LanguageTranslate, },
-      :search   => { :blogs => SearchBlogs, :books => SearchBooks, :images => SearchImages, :local => SearchLocal, :news => SearchNews, :video => SearchVideo, :web => SearchWeb }
-    }
-  end
-  
-  class Errors
-    def self.process(data)
-      status = data['responseStatus']
-      unless [200, 201, 202, 203, 204, 205, 206].include? status
-        raise StandardError.new(data['responseDetails'])
-      end
-    end
-  end
-end

data/lib/google_ajax/search.rb

@@ -1,69 +0,0 @@
-class GoogleAjax
-  class Search
-    SEARCH_VERSION = 1.0
-    def self.get(method, query, args = {})
-      args = { :v => SEARCH_VERSION }.merge!(args)
-      GoogleAjax::get(:search, method, query, args)
-    end
-  
-    def self.blogs(query, args = {})
-      self.get(:blogs, query, args)
-    end
-  
-    def self.books(query, args = {})
-      self.get(:books, query, args)
-    end
-  
-    def self.images(query, args = {})
-      self.get(:images, query, args)
-    end
-  
-    def self.local(query, latitude, longitude, args = {})
-      args = { :sll => "#{latitude},#{longitude}" }.merge!(args)
-      self.get(:local, query, args)
-    end
-
-    def self.news(query, args = {})
-      self.get(:news, query, args)
-    end
-  
-    def self.video(query, args = {})
-      self.get(:video, query, args)
-    end
-  
-    def self.web(query, args = {})
-      self.get(:web, query, args)
-    end
-  
-    class Results < OpenStruct
-      def initialize(data)
-        super(data)                
-        self.results = results.collect {|data| Result.new(data)}
-        self.cursor = Cursor.new(cursor) if self.cursor
-      end
-    
-      def count
-        self.cursor.estimatedResultCount
-      end
-    end
-  
-    class Result < OpenStruct
-      def initialize(data)
-        super(data)
-      end
-    end
-  
-    class Cursor < OpenStruct
-      def initialize(data)
-        super(data)
-        self.pages = pages.collect {|data| Page.new(data)}
-      end
-    end
-  
-    class Page < OpenStruct
-      def initialize(data)
-        super(data)
-      end
-    end      
-  end
-end

data/lib/google_ajax/version.rb

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