module GScraper::Search

Public Class Methods

ajax_query(options={},&block) click to toggle source

Creates a new AJAX query.

@param [Hash] options

Additional options.

@yield [query]

If a block is given, the new AJAX query will be passed to it.

@yieldparam [AJAXQuery] query

The new AJAX query.

@example

Search.ajax_query(:query => 'ruby')

@see AJAXQuery#initialize

# File lib/gscraper/search/search.rb, line 102
def Search.ajax_query(options={},&block)
  AJAXQuery.new(options,&block)
end
ajax_query_from_url(url,&block) click to toggle source

Creates a AJAX query from a given search URL.

@param [URI::HTTP] url

The search URL.

@yield [query]

If a block is given, the new AJAX query will be passed to it.

@yieldparam [AJAXQuery] query

The new AJAX query.

@see AJAXQuery.from_url.

# File lib/gscraper/search/search.rb, line 120
def Search.ajax_query_from_url(url,&block)
  AJAXQuery.from_url(url,&block)
end
query(options={},&block) click to toggle source

Creates a new web-query.

@param [Hash] options

Additional options.

@yield [query]

If a block is given, it will be passed the new web-query.

@yieldparam [WebQuery] query

The new web query.

@return [WebQuery]

The new web-query.

@example

Search.query(:query => 'ruby', :with_words => 'sow rspec')

@example

Search.query(:exact_phrase => 'fluent interfaces') do |q|
  q.within_past_week = true
end

@see WebQuery#initialize

# File lib/gscraper/search/search.rb, line 51
def Search.query(options={},&block)
  WebQuery.new(options,&block)
end
query_from_url(url,&block) click to toggle source

Creates a web-query from a search URL.

@param [String] url

The search URL.

@yield [query]

If a block is given, it will be passed the new web-query.

@yieldparam [WebQuery] query

The new web query.

@return [WebQuery]

The new web-query.

@example

Search.query_from_url('http://www.google.com/search?q=ruby+zen)

@example

Search.query_from_url('http://www.google.com/search?q=ruby') do |q|
  q.within_last_month = true
  q.occurs_within = :title
end

@see WebQuery.from_url.

# File lib/gscraper/search/search.rb, line 81
def Search.query_from_url(url,&block)
  WebQuery.from_url(url,&block)
end