quixoten-craigler 1.0.0

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.gitignore

@@ -0,0 +1,5 @@
+*.sw?
+.DS_Store
+coverage
+rdoc
+pkg

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Devin Christensen
+
+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/README.rdoc

@@ -0,0 +1,29 @@
+= craigler
+
+Search API for craigslist
+
+== SYNOPSIS:
+  
+  Craigler.search(:motorcycles, :in => [:utah, :nevada, :arizona], :for => 'Boulevard M50) do |item|
+    puts item.title
+    puts item.url
+    puts item.time
+  end
+  
+  Craigler.find('Boulevard M50', :in => [:utah, :nevada, :arizona], :only => :motorcycles) do |item|
+    puts item.title
+    puts item.url
+    puts item.time
+  end
+
+== REQUIREMENTS:
+
+* Hpricot
+
+== INSTALL:
+
+* sudo gem install quixoten-craigler
+
+== Copyright
+
+Copyright (c) 2009 Devin Christensen. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,56 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "craigler"
+    gem.summary = %Q{Search API for craigslist}
+    gem.email = "quixoten@gmail.com"
+    gem.homepage = "http://github.com/quixoten/craigler"
+    gem.authors = ["Devin Christensen"]
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: sudo gem install jeweler"
+end
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/*_test.rb'
+  test.verbose = true
+end
+
+begin
+  require 'rcov/rcovtask'
+  Rcov::RcovTask.new do |test|
+    test.libs << 'test'
+    test.pattern = 'test/**/*_test.rb'
+    test.verbose = true
+  end
+rescue LoadError
+  task :rcov do
+    abort "RCov is not available. In order to run rcov, you must: sudo gem install spicycode-rcov"
+  end
+end
+
+
+task :default => :test
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  if File.exist?('VERSION.yml')
+    config = YAML.load(File.read('VERSION.yml'))
+    version = "#{config[:major]}.#{config[:minor]}.#{config[:patch]}"
+  else
+    version = ""
+  end
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "craigler #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+

data/VERSION.yml

@@ -0,0 +1,4 @@
+---
+:major: 1
+:minor: 0
+:patch: 0

data/craigler.gemspec

@@ -0,0 +1,50 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{craigler}
+  s.version = "1.0.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Devin Christensen"]
+  s.date = %q{2009-07-06}
+  s.email = %q{quixoten@gmail.com}
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+     ".gitignore",
+     "LICENSE",
+     "README.rdoc",
+     "Rakefile",
+     "VERSION.yml",
+     "craigler.gemspec",
+     "lib/craigler.rb",
+     "lib/craigler/constants.rb",
+     "lib/craigler/search.rb",
+     "test/craigler_search_test.rb",
+     "test/craigler_test.rb",
+     "test/test_helper.rb"
+  ]
+  s.homepage = %q{http://github.com/quixoten/craigler}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.4}
+  s.summary = %q{Search API for craigslist}
+  s.test_files = [
+    "test/craigler_search_test.rb",
+     "test/craigler_test.rb",
+     "test/test_helper.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end

data/lib/craigler.rb

@@ -0,0 +1,24 @@
+require 'open-uri'
+require 'Hpricot'
+
+require 'craigler/constants'
+require 'craigler/search'
+
+module Craigler
+  VERSION = '0.1.0'
+  
+  class CraiglerError < StandardError; end
+  class InvalidCategory < CraiglerError; end
+  class InvalidSearchTerm < CraiglerError; end
+  class InvalidLocation < CraiglerError; end
+  
+  class << self
+    def search(category, options = {})
+      search = Search.new(options[:for], :in => (options[:in] || :anywhere), :only => category)
+    end
+    
+    def find(search_term, options = {})
+      search = Search.new(search_term, options)
+    end
+  end
+end

data/lib/craigler/constants.rb

@@ -0,0 +1,98 @@
+module Craigler
+  LOCATIONS = {
+    :alabama => ['http://auburn.craigslist.org/','http://bham.craigslist.org/','http://columbusga.craigslist.org/','http://dothan.craigslist.org/','http://shoals.craigslist.org/','http://gadsden.craigslist.org/','http://huntsville.craigslist.org/','http://mobile.craigslist.org/','http://montgomery.craigslist.org/','http://tuscaloosa.craigslist.org/'],
+    :alaska => ['http://anchorage.craigslist.org/'],
+    :arizona => ['http://flagstaff.craigslist.org/','http://mohave.craigslist.org/','http://phoenix.craigslist.org/','http://prescott.craigslist.org/','http://sierravista.craigslist.org/','http://tucson.craigslist.org/','http://yuma.craigslist.org/'],
+    :arkansas => ['http://fayar.craigslist.org/','http://fortsmith.craigslist.org/','http://jonesboro.craigslist.org/','http://littlerock.craigslist.org/','http://memphis.craigslist.org/','http://texarkana.craigslist.org/'],
+    :california => ['http://sfbay.craigslist.org/','http://bakersfield.craigslist.org/','http://chico.craigslist.org/','http://fresno.craigslist.org/','http://goldcountry.craigslist.org/','http://humboldt.craigslist.org/','http://imperial.craigslist.org/','http://inlandempire.craigslist.org/','http://losangeles.craigslist.org/','http://mendocino.craigslist.org/','http://merced.craigslist.org/','http://modesto.craigslist.org/','http://monterey.craigslist.org/','http://orangecounty.craigslist.org/','http://palmsprings.craigslist.org/','http://redding.craigslist.org/','http://reno.craigslist.org/','http://sacramento.craigslist.org/','http://sandiego.craigslist.org/','http://slo.craigslist.org/','http://santabarbara.craigslist.org/','http://stockton.craigslist.org/','http://ventura.craigslist.org/','http://visalia.craigslist.org/','http://yubasutter.craigslist.org/'],
+    :colorado => ['http://boulder.craigslist.org/','http://cosprings.craigslist.org/','http://denver.craigslist.org/','http://fortcollins.craigslist.org/','http://pueblo.craigslist.org/','http://rockies.craigslist.org/','http://westslope.craigslist.org/'],
+    :connecticut => ['http://newlondon.craigslist.org/','http://hartford.craigslist.org/','http://newhaven.craigslist.org/','http://nwct.craigslist.org/'],
+    :delaware => ['http://delaware.craigslist.org/'],
+    :dc => ['http://washingtondc.craigslist.org/'],
+    :florida => ['http://daytona.craigslist.org/','http://keys.craigslist.org/','http://fortmyers.craigslist.org/','http://gainesville.craigslist.org/','http://jacksonville.craigslist.org/','http://lakeland.craigslist.org/','http://ocala.craigslist.org/','http://orlando.craigslist.org/','http://panamacity.craigslist.org/','http://pensacola.craigslist.org/','http://sarasota.craigslist.org/','http://miami.craigslist.org/','http://spacecoast.craigslist.org/','http://staugustine.craigslist.org/','http://tallahassee.craigslist.org/','http://tampa.craigslist.org/','http://treasure.craigslist.org/'],
+    :georgia => ['http://athensga.craigslist.org/','http://atlanta.craigslist.org/','http://augusta.craigslist.org/','http://brunswick.craigslist.org/','http://columbusga.craigslist.org/','http://macon.craigslist.org/','http://savannah.craigslist.org/','http://valdosta.craigslist.org/'],
+    :hawaii => ['http://honolulu.craigslist.org/'],
+    :idaho => ['http://boise.craigslist.org/','http://eastidaho.craigslist.org/','http://pullman.craigslist.org/','http://spokane.craigslist.org/','http://twinfalls.craigslist.org/'],
+    :illinois => ['http://bn.craigslist.org/','http://carbondale.craigslist.org/','http://chambana.craigslist.org/','http://chicago.craigslist.org/','http://decatur.craigslist.org/','http://peoria.craigslist.org/','http://quadcities.craigslist.org/','http://rockford.craigslist.org/','http://springfieldil.craigslist.org/','http://stlouis.craigslist.org/'],
+    :indiana => ['http://bloomington.craigslist.org/','http://evansville.craigslist.org/','http://fortwayne.craigslist.org/','http://indianapolis.craigslist.org/','http://tippecanoe.craigslist.org/','http://muncie.craigslist.org/','http://southbend.craigslist.org/','http://terrahaute.craigslist.org/'],
+    :iowa => ['http://ames.craigslist.org/','http://cedarrapids.craigslist.org/','http://desmoines.craigslist.org/','http://dubuque.craigslist.org/','http://iowacity.craigslist.org/','http://omaha.craigslist.org/','http://quadcities.craigslist.org/','http://siouxcity.craigslist.org/','http://waterloo.craigslist.org/'],
+    :kansas => ['http://kansascity.craigslist.org/','http://lawrence.craigslist.org/','http://ksu.craigslist.org/','http://topeka.craigslist.org/','http://wichita.craigslist.org/'],
+    :kentucky => ['http://bgky.craigslist.org/','http://cincinnati.craigslist.org/','http://huntington.craigslist.org/','http://lexington.craigslist.org/','http://louisville.craigslist.org/','http://westky.craigslist.org/'],
+    :louisiana => ['http://batonrouge.craigslist.org/','http://lafayette.craigslist.org/','http://lakecharles.craigslist.org/','http://monroe.craigslist.org/','http://neworleans.craigslist.org/','http://shreveport.craigslist.org/'],
+    :maine => ['http://maine.craigslist.org/'],
+    :maryland => ['http://annapolis.craigslist.org/','http://baltimore.craigslist.org/','http://easternshore.craigslist.org/','http://smd.craigslist.org/','http://westmd.craigslist.org/'],
+    :mass => ['http://boston.craigslist.org/','http://capecod.craigslist.org/','http://southcoast.craigslist.org/','http://westernmass.craigslist.org/','http://worcester.craigslist.org/'],
+    :michigan => ['http://annarbor.craigslist.org/','http://centralmich.craigslist.org/','http://detroit.craigslist.org/','http://flint.craigslist.org/','http://grandrapids.craigslist.org/','http://jxn.craigslist.org/','http://kalamazoo.craigslist.org/','http://lansing.craigslist.org/','http://muskegon.craigslist.org/','http://nmi.craigslist.org/','http://porthuron.craigslist.org/','http://saginaw.craigslist.org/','http://southbend.craigslist.org/','http://swmi.craigslist.org/','http://up.craigslist.org/'],
+    :minnesota => ['http://duluth.craigslist.org/','http://fargo.craigslist.org/','http://mankato.craigslist.org/','http://minneapolis.craigslist.org/','http://rmn.craigslist.org/','http://stcloud.craigslist.org/'],
+    :mississippi => ['http://gulfport.craigslist.org/','http://hattiesburg.craigslist.org/','http://jackson.craigslist.org/','http://memphis.craigslist.org/','http://northmiss.craigslist.org/'],
+    :missouri => ['http://columbiamo.craigslist.org/','http://joplin.craigslist.org/','http://kansascity.craigslist.org/','http://semo.craigslist.org/','http://springfield.craigslist.org/','http://stlouis.craigslist.org/'],
+    :montana => ['http://montana.craigslist.org/'],
+    :nebraska => ['http://grandisland.craigslist.org/','http://lincoln.craigslist.org/','http://omaha.craigslist.org/','http://siouxcity.craigslist.org/'],
+    :nevada => ['http://lasvegas.craigslist.org/','http://reno.craigslist.org/'],
+    :n_hampshire => ['http://nh.craigslist.org/'],
+    :new_jersey => ['http://cnj.craigslist.org/','http://jerseyshore.craigslist.org/','http://newjersey.craigslist.org/','http://southjersey.craigslist.org/'],
+    :new_mexico => ['http://albuquerque.craigslist.org/','http://farmington.craigslist.org/','http://lascruces.craigslist.org/','http://roswell.craigslist.org/','http://santafe.craigslist.org/'],
+    :new_york => ['http://albany.craigslist.org/','http://binghamton.craigslist.org/','http://buffalo.craigslist.org/','http://catskills.craigslist.org/','http://chautauqua.craigslist.org/','http://elmira.craigslist.org/','http://hudsonvalley.craigslist.org/','http://ithaca.craigslist.org/','http://longisland.craigslist.org/','http://newyork.craigslist.org/','http://plattsburgh.craigslist.org/','http://rochester.craigslist.org/','http://syracuse.craigslist.org/','http://utica.craigslist.org/','http://watertown.craigslist.org/'],
+    :n_carolina => ['http://asheville.craigslist.org/','http://boone.craigslist.org/','http://charlotte.craigslist.org/','http://eastnc.craigslist.org/','http://fayetteville.craigslist.org/','http://greensboro.craigslist.org/','http://hickory.craigslist.org/','http://outerbanks.craigslist.org/','http://raleigh.craigslist.org/','http://wilmington.craigslist.org/','http://winstonsalem.craigslist.org/'],
+    :north_dakota => ['http://fargo.craigslist.org/','http://nd.craigslist.org/'],
+    :ohio => ['http://akroncanton.craigslist.org/','http://athensohio.craigslist.org/','http://cincinnati.craigslist.org/','http://cleveland.craigslist.org/','http://columbus.craigslist.org/','http://dayton.craigslist.org/','http://huntington.craigslist.org/','http://limaohio.craigslist.org/','http://mansfield.craigslist.org/','http://parkersburg.craigslist.org/','http://sandusky.craigslist.org/','http://toledo.craigslist.org/','http://wheeling.craigslist.org/','http://youngstown.craigslist.org/'],
+    :oklahoma => ['http://fortsmith.craigslist.org/','http://lawton.craigslist.org/','http://oklahomacity.craigslist.org/','http://stillwater.craigslist.org/','http://tulsa.craigslist.org/'],
+    :oregon => ['http://bend.craigslist.org/','http://corvallis.craigslist.org/','http://eastoregon.craigslist.org/','http://eugene.craigslist.org/','http://medford.craigslist.org/','http://oregoncoast.craigslist.org/','http://portland.craigslist.org/','http://roseburg.craigslist.org/','http://salem.craigslist.org/'],
+    :pennsylvania => ['http://altoona.craigslist.org/','http://erie.craigslist.org/','http://harrisburg.craigslist.org/','http://lancaster.craigslist.org/','http://allentown.craigslist.org/','http://philadelphia.craigslist.org/','http://pittsburgh.craigslist.org/','http://poconos.craigslist.org/','http://reading.craigslist.org/','http://scranton.craigslist.org/','http://pennstate.craigslist.org/','http://williamsport.craigslist.org/','http://york.craigslist.org/'],
+    :rhode_island => ['http://providence.craigslist.org/'],
+    :s_carolina => ['http://charleston.craigslist.org/','http://columbia.craigslist.org/','http://florencesc.craigslist.org/','http://greenville.craigslist.org/','http://hiltonhead.craigslist.org/','http://myrtlebeach.craigslist.org/'],
+    :south_dakota => ['http://sd.craigslist.org/'],
+    :tennessee => ['http://chattanooga.craigslist.org/','http://clarksville.craigslist.org/','http://jacksontn.craigslist.org/','http://knoxville.craigslist.org/','http://memphis.craigslist.org/','http://nashville.craigslist.org/','http://tricities.craigslist.org/'],
+    :texas => ['http://abilene.craigslist.org/','http://amarillo.craigslist.org/','http://austin.craigslist.org/','http://beaumont.craigslist.org/','http://brownsville.craigslist.org/','http://collegestation.craigslist.org/','http://corpuschristi.craigslist.org/','http://dallas.craigslist.org/','http://elpaso.craigslist.org/','http://galveston.craigslist.org/','http://houston.craigslist.org/','http://killeen.craigslist.org/','http://laredo.craigslist.org/','http://lubbock.craigslist.org/','http://mcallen.craigslist.org/','http://odessa.craigslist.org/','http://sanantonio.craigslist.org/','http://sanmarcos.craigslist.org/','http://texarkana.craigslist.org/','http://easttexas.craigslist.org/','http://victoriatx.craigslist.org/','http://waco.craigslist.org/','http://wichitafalls.craigslist.org/'],
+    :utah => ['http://logan.craigslist.org/','http://ogden.craigslist.org/','http://provo.craigslist.org/','http://saltlakecity.craigslist.org/','http://stgeorge.craigslist.org/'],
+    :vermont => ['http://burlington.craigslist.org/'],
+    :virginia => ['http://blacksburg.craigslist.org/','http://charlottesville.craigslist.org/','http://danville.craigslist.org/','http://easternshore.craigslist.org/','http://fredericksburg.craigslist.org/','http://norfolk.craigslist.org/','http://harrisonburg.craigslist.org/','http://lynchburg.craigslist.org/','http://richmond.craigslist.org/','http://roanoke.craigslist.org/'],
+    :washington => ['http://bellingham.craigslist.org/','http://kpr.craigslist.org/','http://olympic.craigslist.org/','http://pullman.craigslist.org/','http://seattle.craigslist.org/','http://skagit.craigslist.org/','http://spokane.craigslist.org/','http://wenatchee.craigslist.org/','http://yakima.craigslist.org/'],
+    :west_virginia => ['http://charlestonwv.craigslist.org/','http://huntington.craigslist.org/','http://martinsburg.craigslist.org/','http://morgantown.craigslist.org/','http://parkersburg.craigslist.org/','http://wv.craigslist.org/','http://wheeling.craigslist.org/'],
+    :wisconsin => ['http://appleton.craigslist.org/','http://duluth.craigslist.org/','http://eauclaire.craigslist.org/','http://greenbay.craigslist.org/','http://janesville.craigslist.org/','http://racine.craigslist.org/','http://lacrosse.craigslist.org/','http://madison.craigslist.org/','http://milwaukee.craigslist.org/','http://sheboygan.craigslist.org/','http://wausau.craigslist.org/'],
+    :wyoming => ['http://wyoming.craigslist.org/']
+  }
+
+  CATEGORIES = {
+    :community => 'ccc',
+    :event => 'eee',
+    :all_for_sale_or_wanted => 'sss',
+    :art_and_crafts => 'art',
+    :auto_parts => 'pts',
+    :baby_and_kid_stuff => 'bab',
+    :barter => 'bar',
+    :bicycles => 'bik',
+    :boats => 'boa',
+    :books => 'bks',
+    :business => 'bfs',
+    :cars_and_trucks => 'cta',
+    :media => 'emd',
+    :clothing => 'clo',
+    :collectibles => 'clt',
+    :computers_and_tech => 'sys',
+    :electronics => 'ele',
+    :farm_and_garden => 'grd',
+    :free_stuff => 'zip',
+    :furniture => 'fua',
+    :games_and_toys => 'tag',
+    :garage_sales => 'gms',
+    :general => 'for',
+    :household => 'hsh',
+    :items_wanted => 'wan',
+    :jewelry => 'jwl',
+    :materials => 'mat',
+    :motorcycles => 'mcy',
+    :musical_instruments => 'msg',
+    :photo_and_video => 'pho',
+    :recreational_vehicles => 'rvs',
+    :sporting_goods => 'spo',
+    :tickets => 'tix',
+    :tools => 'tls',
+    :gigs => 'ggg',
+    :housing => 'hhh',
+    :jobs => 'jjj',
+    :personals => 'ppp',
+    :resume => 'res',
+    :services_offered => 'bbb'
+  }
+end

data/lib/craigler/search.rb

@@ -0,0 +1,66 @@
+require 'erb'
+
+module Craigler
+  class Search
+    include ERB::Util
+    
+    attr_reader :search_term, :categories, :locations
+    
+    def initialize(search_term, options = {})
+      raise InvalidSearchTerm if search_term.nil? || search_term == ''
+      
+      @search_term = search_term
+      @results     = nil
+      _parse_options(options)
+    end
+    
+    def results(refresh = false)
+      return @results unless @results.nil? || refresh
+      
+      @results = []
+      _for_each_locations_search_url() do |location, url|
+        (0..19).each do |page|
+          items = _extract_items_from_url(location, "#{url}&s=#{page*25}")
+          @results.push(*items)
+          break unless items.size == 25
+        end
+      end
+      
+      results
+    end
+    
+    private
+    def _parse_options(options)
+      options     = {:in => LOCATIONS.keys, :only => :all_for_sale_or_wanted}.merge(options)
+      @locations  = options[:in].is_a?(Array) ? options[:in] : [options[:in]]
+      @categories = options[:only].is_a?(Array) ? options[:only] : [options[:only]] 
+      
+      @locations.each() do |location|
+        raise InvalidLocation unless location == :anywhere || LOCATIONS.key?(location)
+      end
+      
+      @categories.each() do |category|
+        raise InvalidCategory unless category == :all_for_sale_or_wanted || CATEGORIES.key?(category)
+      end
+    end
+    
+    def _for_each_locations_search_url()
+      @locations.each do |location|
+        LOCATIONS[location].each do |url|
+          @categories.each do |category|
+            yield(location, "#{url}search/#{CATEGORIES[category]}?query=#{url_encode(@search_term)}&format=rss")
+          end
+        end
+      end
+    end
+    
+    def _extract_items_from_url(location, url)
+      (Hpricot(open(url))/'item').collect { |item| {
+        :url          => item['rdf:about'],
+        :title        => (item%'title').inner_text,
+        :location     => location.to_s,
+        :published_at => Time.parse((item%'dc:date').inner_text)
+      }}
+    end
+  end
+end

data/test/craigler_search_test.rb

@@ -0,0 +1,58 @@
+require 'test_helper'
+
+class CraiglerSearchTest < Test::Unit::TestCase
+  context "creating a search" do
+    should "require a valid category" do
+      assert_raises(Craigler::InvalidCategory) do
+        Craigler::Search.new('Yamaha Radian', :only => :invalid)
+      end
+    end
+    
+    should "require a search term" do
+      assert_raises(Craigler::InvalidSearchTerm) do
+        Craigler::Search.new(nil)
+      end
+      
+      assert_raises(ArgumentError) do
+        Craigler::Search.new()
+      end
+    end
+    
+    should "not require a location" do
+      assert_nothing_raised() do
+        Craigler::Search.new('Yamaha Roadstar Warrior', :only => :motorcycles)
+      end
+    end
+    
+    should "not require a category" do
+      assert_nothing_raised() do
+        Craigler::Search.new('Honda Shadow', :in => :utah)
+      end
+    end
+    
+    should "require that the location is valid" do
+      assert_raises(Craigler::InvalidLocation) do
+        Craigler::Search.new('Honda Nighthawk', :in => :invalid)
+      end
+    end
+    
+    should "accept multiple locations" do
+      assert_nothing_raised() do
+        Craigler::Search.new('Suzuki Boulevard M50', :in => [:utah, :nevada])
+      end
+    end
+  end
+  
+  context "fetching search results" do
+    setup do
+      @search = Craigler::Search.new('Honda Shadow', :in => :utah, :only => :motorcycles)
+    end
+    
+    should "return an array of hashes" do
+      results = @search.results()
+      assert(results.is_a?(Array), "Array exptected but was #{results.class}")
+      assert(results.size > 0, "No results were returned")
+      assert(results.inject(true) {|t,r| t && r.is_a?(Hash)})
+    end
+  end
+end

data/test/craigler_test.rb

@@ -0,0 +1,11 @@
+require 'test_helper'
+
+class CraiglerTest < Test::Unit::TestCase
+  should "respond to search" do
+    assert_respond_to(Craigler, :search)
+  end
+  
+  should "respond to find" do
+    assert_respond_to(Craigler, :find)
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,10 @@
+require 'rubygems'
+require 'test/unit'
+require 'shoulda'
+
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'craigler'
+
+class Test::Unit::TestCase
+end

metadata

@@ -0,0 +1,68 @@
+--- !ruby/object:Gem::Specification 
+name: quixoten-craigler
+version: !ruby/object:Gem::Version 
+  version: 1.0.0
+platform: ruby
+authors: 
+- Devin Christensen
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-07-06 00:00:00 -07:00
+default_executable: 
+dependencies: []
+
+description: 
+email: quixoten@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.rdoc
+files: 
+- .document
+- .gitignore
+- LICENSE
+- README.rdoc
+- Rakefile
+- VERSION.yml
+- craigler.gemspec
+- lib/craigler.rb
+- lib/craigler/constants.rb
+- lib/craigler/search.rb
+- test/craigler_search_test.rb
+- test/craigler_test.rb
+- test/test_helper.rb
+has_rdoc: false
+homepage: http://github.com/quixoten/craigler
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+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: 
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 3
+summary: Search API for craigslist
+test_files: 
+- test/craigler_search_test.rb
+- test/craigler_test.rb
+- test/test_helper.rb