yilp 0.1

data/Manifest

@@ -0,0 +1,16 @@
+config/yilp_appid.yml
+lib/yilp.rb
+Rakefile
+README.rdoc
+spec/fixtures/places_sydney.xml
+spec/fixtures/placetypes.xml
+spec/fixtures/woid_1105779.xml
+spec/fixtures/woid_1105779_ancestors.xml
+spec/fixtures/woid_1105779_belongto.xml
+spec/fixtures/woid_1105779_children.xml
+spec/fixtures/woid_1105779_neighbors.xml
+spec/fixtures/woid_1105779_parent.xml
+spec/fixtures/woid_1105779_siblings.xml
+spec/specs.html
+spec/yilp_spec.rb
+Manifest

data/README.rdoc

@@ -0,0 +1,29 @@
+In simple terms, the Service allows you to look up the unique identifier - called the Where on Earth ID, or WOEID - for
+almost any named place on the Earth; it also allows you to resolve a WOEID you have received from a third party - such as
+Fire Eagle™ or Upcoming - to the place it represents.
+
+The API is accessed via HTTP GET; the following examples can be cut-and-paste into a web browser to view the results:
+
+Find the WOEID of a significant landmark:
+http://where.yahooapis.com/v1/places.q('sydney%20opera%20house')
+
+Resolve a WOEID to a place:
+http://where.yahooapis.com/v1/place/2507854
+
+Find the WOEID of a specific place:
+http://where.yahooapis.com/v1/places.q('northfield%20mn%20usa')
+
+Obtain a range of WOEIDs that match a given place, ordered by the most likely:
+http://where.yahooapis.com/v1/places.q('springfield');start=0;count=5
+
+Find the parent of a given WOEID (and return a detailed record):
+http://where.yahooapis.com/v1/place/638242/parent?select=long
+
+Return the Placename for a given WOEID in a specific language (where it exists):
+http://where.yahooapis.com/v1/places.q('usa')?lang=fr
+
+To obtain the representation of a place in JSON format:
+http://where.yahooapis.com/v1/place/2487956?format=json
+
+To obtain a list of geographies that neighbor a specific WOEID:
+http://where.yahooapis.com/v1/place/12795711/neighbors

data/Rakefile

@@ -0,0 +1,15 @@
+require "rubygems"
+require "rake"
+require "echoe"
+
+Echoe.new('yilp', '0.1') do |p|
+  p.description     = "Ruby wrapper arround Yahoo Internet Location Platform" 
+# p.url             = "http://github.com/sabman/yilp"  
+  p.url             = "http://yilp.rubyforge.org"
+  p.author          = "Shoaib Burq & David Troy"
+  p.email           = "shoaib@nomad-labs.com"
+  p.ignore_pattern  = ["tmp/*", "script/*"]
+  p.development_dependencies =  ["active_support"]
+end
+
+Dir["#{File.dirname(__FILE__)}/tasks/*.rake"].sort.each { |ext| load ext }

data/config/yilp_appid.yml

@@ -0,0 +1,12 @@
+appid:
+  fallback: 
+    RKxL3NrV34Fwy2Xx2IRhxKz_cy4ESJWC9QUyr45ZMdnj85FXjIGs.yrUdBTQyXWFZu8-
+      
+  test: 
+    RKxL3NrV34Fwy2Xx2IRhxKz_cy4ESJWC9QUyr45ZMdnj85FXjIGs.yrUdBTQyXWFZu8-
+
+  development: 
+    RKxL3NrV34Fwy2Xx2IRhxKz_cy4ESJWC9QUyr45ZMdnj85FXjIGs.yrUdBTQyXWFZu8-
+
+  production: 
+    RKxL3NrV34Fwy2Xx2IRhxKz_cy4ESJWC9QUyr45ZMdnj85FXjIGs.yrUdBTQyXWFZu8-

data/lib/yilp.rb

@@ -0,0 +1,58 @@
+require 'rubygems'
+require "open-uri"
+require "active_support"
+module YILP
+  class YILP      
+    APP_ID = ENV["RAILS_ENV"].nil? ? 
+      YAML::load_file("./config/yilp_appid.yml")["appid"]["fallback"] : 
+      YAML::load_file("./config/yilp_appid.yml")["appid"][ENV["RAILS_ENV"]] 
+    
+    @@lang_hash = {
+      :French => 'fr',
+      :German => 'de',
+      :Italian => 'de',
+      :Dutch => 'nl',
+      :Greek => 'el',
+      :Spanish => 'es',
+      :Portuguese => 'pt', 
+      :Arabic => 'ar', 
+      :Hebrew => 'he', 
+      :Russian => 'ru', 
+      :Chinese => 'zh', 
+      :Japanese => 'ja', 
+      :Hindi => 'hi',
+      :Urdu => 'ur', 
+      :Sanskrit => 'sa'
+    }
+
+    @@baseurl = "http://where.yahooapis.com/v1"
+    
+    def self.find(query, options={})
+      if query.is_a?(Fixnum)  # /place/{woeid}
+        valid_keys = [:neighbors, :parent, :ancestors, :belongtos, :siblings, :children]
+        options.assert_valid_keys(valid_keys)
+        url = "place/#{query}"
+        valid_keys.find { |k| url += "/#{k.to_s}" if options[k] }
+        url += "?appid=#{APP_ID}"
+      else  # /places.q('query')
+        valid_keys = [:lang]
+        options.assert_valid_keys(valid_keys)
+        url = "places.q(#{URI.encode(query)})"
+        url += "?appid=#{APP_ID}"
+        url += "&lang=#{lang(options[:lang])}" if options[:lang]
+      end    
+      Hash.from_xml(open("#{@@baseurl}/#{url}"))      
+    end
+    
+    def self.placetypes
+      # http://where.yahooapis.com/v1/placetypes?appid=RKxL3NrV34Fwy2Xx2IRhxKz_cy4ESJWC9QUyr45ZMdnj85FXjIGs.yrUdBTQyXWFZu8-      
+      url = "placetypes?appid=#{APP_ID}"
+      Hash.from_xml(open("#{@@baseurl}/#{url}"))    
+    end
+  
+    def self.lang(lang)
+      language = @@lang_hash[lang.to_s.capitalize.to_sym]
+    end       
+    
+  end
+end

data/spec/fixtures/places_sydney.xml

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<places xmlns="http://where.yahooapis.com/v1/schema.rng" xmlns:yahoo="http://www.yahooapis.com/v1/base.rng" yahoo:start="0" yahoo:count="1" yahoo:total="1"><place yahoo:uri="http://where.yahooapis.com/v1/place/1105779" xml:lang="en"><woeid>1105779</woeid><placeTypeName code="7">Town</placeTypeName><name>Sydney</name><country type="Country" code="AU">Australia</country><admin1 type="State" code="AU-NSW">New South Wales</admin1><admin2></admin2><admin3></admin3><locality1>Sydney</locality1><locality2></locality2><postal></postal><centroid><latitude>-33.869629</latitude><longitude>151.206955</longitude></centroid><boundingBox><southWest><latitude>-34.18961</latitude><longitude>150.517166</longitude></southWest><northEast><latitude>-33.57814</latitude><longitude>151.342575</longitude></northEast></boundingBox></place></places>

data/spec/fixtures/placetypes.xml

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<placeTypes xmlns="http://where.yahooapis.com/v1/schema.rng" xmlns:yahoo="http://www.yahooapis.com/v1/base.rng" yahoo:start="0" yahoo:count="32" yahoo:total="32"><placeType yahoo:uri="http://where.yahooapis.com/v1/placetype/0" xml:lang="en"><placeTypeName code="0">Undefined</placeTypeName></placeType><placeType yahoo:uri="http://where.yahooapis.com/v1/placetype/1" xml:lang="en"><placeTypeName code="1">Geocoded Building</placeTypeName></placeType><placeType yahoo:uri="http://where.yahooapis.com/v1/placetype/2" xml:lang="en"><placeTypeName code="2">Geocoded Segment</placeTypeName></placeType><placeType yahoo:uri="http://where.yahooapis.com/v1/placetype/3" xml:lang="en"><placeTypeName code="3">Geocoded Nearby Building</placeTypeName></placeType><placeType yahoo:uri="http://where.yahooapis.com/v1/placetype/4" xml:lang="en"><placeTypeName code="4">Geocoded Street</placeTypeName></placeType><placeType yahoo:uri="http://where.yahooapis.com/v1/placetype/5" xml:lang="en"><placeTypeName code="5">Geocoded Intersection</placeTypeName></placeType><placeType yahoo:uri="http://where.yahooapis.com/v1/placetype/6" xml:lang="en"><placeTypeName code="6">Street</placeTypeName></placeType><placeType yahoo:uri="http://where.yahooapis.com/v1/placetype/7" xml:lang="en"><placeTypeName code="7">Town</placeTypeName></placeType><placeType yahoo:uri="http://where.yahooapis.com/v1/placetype/8" xml:lang="en"><placeTypeName code="8">State</placeTypeName></placeType><placeType yahoo:uri="http://where.yahooapis.com/v1/placetype/9" xml:lang="en"><placeTypeName code="9">County</placeTypeName></placeType><placeType yahoo:uri="http://where.yahooapis.com/v1/placetype/10" xml:lang="en"><placeTypeName code="10">Local Admin</placeTypeName></placeType><placeType yahoo:uri="http://where.yahooapis.com/v1/placetype/11" xml:lang="en"><placeTypeName code="11">Postal Code</placeTypeName></placeType><placeType yahoo:uri="http://where.yahooapis.com/v1/placetype/12" xml:lang="en"><placeTypeName code="12">Country</placeTypeName></placeType><placeType yahoo:uri="http://where.yahooapis.com/v1/placetype/13" xml:lang="en"><placeTypeName code="13">Island</placeTypeName></placeType><placeType yahoo:uri="http://where.yahooapis.com/v1/placetype/14" xml:lang="en"><placeTypeName code="14">Airport</placeTypeName></placeType><placeType yahoo:uri="http://where.yahooapis.com/v1/placetype/15" xml:lang="en"><placeTypeName code="15">Drainage</placeTypeName></placeType><placeType yahoo:uri="http://where.yahooapis.com/v1/placetype/16" xml:lang="en"><placeTypeName code="16">Land Feature</placeTypeName></placeType><placeType yahoo:uri="http://where.yahooapis.com/v1/placetype/17" xml:lang="en"><placeTypeName code="17">Miscellaneous</placeTypeName></placeType><placeType yahoo:uri="http://where.yahooapis.com/v1/placetype/18" xml:lang="en"><placeTypeName code="18">Nationality</placeTypeName></placeType><placeType yahoo:uri="http://where.yahooapis.com/v1/placetype/19" xml:lang="en"><placeTypeName code="19">Supername</placeTypeName></placeType><placeType yahoo:uri="http://where.yahooapis.com/v1/placetype/20" xml:lang="en"><placeTypeName code="20">Point of Interest</placeTypeName></placeType><placeType yahoo:uri="http://where.yahooapis.com/v1/placetype/21" xml:lang="en"><placeTypeName code="21">Region</placeTypeName></placeType><placeType yahoo:uri="http://where.yahooapis.com/v1/placetype/22" xml:lang="en"><placeTypeName code="22">Suburb</placeTypeName></placeType><placeType yahoo:uri="http://where.yahooapis.com/v1/placetype/23" xml:lang="en"><placeTypeName code="23">Sports Team</placeTypeName></placeType><placeType yahoo:uri="http://where.yahooapis.com/v1/placetype/24" xml:lang="en"><placeTypeName code="24">Colloquial</placeTypeName></placeType><placeType yahoo:uri="http://where.yahooapis.com/v1/placetype/25" xml:lang="en"><placeTypeName code="25">Zone</placeTypeName></placeType><placeType yahoo:uri="http://where.yahooapis.com/v1/placetype/26" xml:lang="en"><placeTypeName code="26">Historical State</placeTypeName></placeType><placeType yahoo:uri="http://where.yahooapis.com/v1/placetype/27" xml:lang="en"><placeTypeName code="27">Historical County</placeTypeName></placeType><placeType yahoo:uri="http://where.yahooapis.com/v1/placetype/29" xml:lang="en"><placeTypeName code="29">Continent</placeTypeName></placeType><placeType yahoo:uri="http://where.yahooapis.com/v1/placetype/31" xml:lang="en"><placeTypeName code="31">Time Zone</placeTypeName></placeType><placeType yahoo:uri="http://where.yahooapis.com/v1/placetype/32" xml:lang="en"><placeTypeName code="32">Geocoded Nearby Intersection</placeTypeName></placeType><placeType yahoo:uri="http://where.yahooapis.com/v1/placetype/33" xml:lang="en"><placeTypeName code="33">Estate</placeTypeName></placeType></placeTypes>

data/spec/fixtures/woid_1105779.xml

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<place xmlns="http://where.yahooapis.com/v1/schema.rng" xmlns:yahoo="http://www.yahooapis.com/v1/base.rng" yahoo:uri="http://where.yahooapis.com/v1/place/1105779" xml:lang="en"><woeid>1105779</woeid><placeTypeName code="7">Town</placeTypeName><name>Sydney</name><country type="Country" code="AU">Australia</country><admin1 type="State" code="AU-NSW">New South Wales</admin1><admin2></admin2><admin3></admin3><locality1>Sydney</locality1><locality2></locality2><postal></postal><centroid><latitude>-33.869629</latitude><longitude>151.206955</longitude></centroid><boundingBox><southWest><latitude>-34.18961</latitude><longitude>150.517166</longitude></southWest><northEast><latitude>-33.57814</latitude><longitude>151.342575</longitude></northEast></boundingBox></place>

data/spec/fixtures/woid_1105779_ancestors.xml

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<places xmlns="http://where.yahooapis.com/v1/schema.rng" xmlns:yahoo="http://www.yahooapis.com/v1/base.rng" yahoo:start="0" yahoo:count="3" yahoo:total="3"><place yahoo:uri="http://where.yahooapis.com/v1/place/2344700" xml:lang="en"><woeid>2344700</woeid><placeTypeName code="8">State</placeTypeName><name>New South Wales</name></place><place yahoo:uri="http://where.yahooapis.com/v1/place/23424748" xml:lang="en"><woeid>23424748</woeid><placeTypeName code="12">Country</placeTypeName><name>Australia</name></place><place yahoo:uri="http://where.yahooapis.com/v1/place/24865674" xml:lang="en"><woeid>24865674</woeid><placeTypeName code="29">Continent</placeTypeName><name>Pacific</name></place></places>

data/spec/fixtures/woid_1105779_belongto.xml

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<places xmlns="http://where.yahooapis.com/v1/schema.rng" xmlns:yahoo="http://www.yahooapis.com/v1/base.rng" yahoo:start="0" yahoo:count="9" yahoo:total="9"><place yahoo:uri="http://where.yahooapis.com/v1/place/23509401" xml:lang="en"><woeid>23509401</woeid><placeTypeName code="24">Colloquial</placeTypeName><name>South Coast NSW</name></place><place yahoo:uri="http://where.yahooapis.com/v1/place/2344700" xml:lang="en"><woeid>2344700</woeid><placeTypeName code="8">State</placeTypeName><name>New South Wales</name></place><place yahoo:uri="http://where.yahooapis.com/v1/place/28350885" xml:lang="en"><woeid>28350885</woeid><placeTypeName code="31">Time Zone</placeTypeName><name>Australia/Sydney</name></place><place yahoo:uri="http://where.yahooapis.com/v1/place/23424748" xml:lang="en"><woeid>23424748</woeid><placeTypeName code="12">Country</placeTypeName><name>Australia</name></place><place yahoo:uri="http://where.yahooapis.com/v1/place/24865674" xml:lang="en"><woeid>24865674</woeid><placeTypeName code="29">Continent</placeTypeName><name>Pacific</name></place><place yahoo:uri="http://where.yahooapis.com/v1/place/28289417" xml:lang="en"><woeid>28289417</woeid><placeTypeName code="19">Supername</placeTypeName><name>Oceania</name></place></places>

data/spec/fixtures/woid_1105779_children.xml

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<places xmlns="http://where.yahooapis.com/v1/schema.rng" xmlns:yahoo="http://www.yahooapis.com/v1/base.rng" yahoo:start="0" yahoo:count="10" yahoo:total="1450"><place yahoo:uri="http://where.yahooapis.com/v1/place/1093994" xml:lang="en"><woeid>1093994</woeid><placeTypeName code="22">Suburb</placeTypeName><name>Abbotsford</name></place><place yahoo:uri="http://where.yahooapis.com/v1/place/1094076" xml:lang="en"><woeid>1094076</woeid><placeTypeName code="22">Suburb</placeTypeName><name>Annandale</name></place><place yahoo:uri="http://where.yahooapis.com/v1/place/1094115" xml:lang="en"><woeid>1094115</woeid><placeTypeName code="22">Suburb</placeTypeName><name>Artarmon</name></place><place yahoo:uri="http://where.yahooapis.com/v1/place/1094126" xml:lang="en"><woeid>1094126</woeid><placeTypeName code="22">Suburb</placeTypeName><name>Ashfield</name></place><place yahoo:uri="http://where.yahooapis.com/v1/place/1094130" xml:lang="en"><woeid>1094130</woeid><placeTypeName code="22">Suburb</placeTypeName><name>Asquith</name></place><place yahoo:uri="http://where.yahooapis.com/v1/place/1094146" xml:lang="en"><woeid>1094146</woeid><placeTypeName code="22">Suburb</placeTypeName><name>Avalon</name></place><place yahoo:uri="http://where.yahooapis.com/v1/place/1094203" xml:lang="en"><woeid>1094203</woeid><placeTypeName code="22">Suburb</placeTypeName><name>Balgowlah</name></place><place yahoo:uri="http://where.yahooapis.com/v1/place/1094215" xml:lang="en"><woeid>1094215</woeid><placeTypeName code="22">Suburb</placeTypeName><name>Balmain</name></place><place yahoo:uri="http://where.yahooapis.com/v1/place/1094231" xml:lang="en"><woeid>1094231</woeid><placeTypeName code="22">Suburb</placeTypeName><name>Bangor</name></place><place yahoo:uri="http://where.yahooapis.com/v1/place/1094233" xml:lang="en"><woeid>1094233</woeid><placeTypeName code="22">Suburb</placeTypeName><name>Banksmeadow</name></place></places>

data/spec/fixtures/woid_1105779_neighbors.xml

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<places xmlns="http://where.yahooapis.com/v1/schema.rng" xmlns:yahoo="http://www.yahooapis.com/v1/base.rng" yahoo:start="0" yahoo:count="10" yahoo:total="67"><place yahoo:uri="http://where.yahooapis.com/v1/place/55863721" xml:lang="en"><woeid>55863721</woeid><placeTypeName code="7">Town</placeTypeName><name>Macdonaldtown</name></place><place yahoo:uri="http://where.yahooapis.com/v1/place/22721293" xml:lang="en"><woeid>22721293</woeid><placeTypeName code="7">Town</placeTypeName><name>Pleasure Point</name></place><place yahoo:uri="http://where.yahooapis.com/v1/place/28585730" xml:lang="en"><woeid>28585730</woeid><placeTypeName code="7">Town</placeTypeName><name>Ku-Ring-Gai Chase</name></place><place yahoo:uri="http://where.yahooapis.com/v1/place/55864471" xml:lang="en"><woeid>55864471</woeid><placeTypeName code="7">Town</placeTypeName><name>Chisholm Centre</name></place><place yahoo:uri="http://where.yahooapis.com/v1/place/1096314" xml:lang="en"><woeid>1096314</woeid><placeTypeName code="7">Town</placeTypeName><name>Holsworthy</name></place><place yahoo:uri="http://where.yahooapis.com/v1/place/1101796" xml:lang="en"><woeid>1101796</woeid><placeTypeName code="7">Town</placeTypeName><name>Dural</name></place><place yahoo:uri="http://where.yahooapis.com/v1/place/1096586" xml:lang="en"><woeid>1096586</woeid><placeTypeName code="7">Town</placeTypeName><name>Kenthurst</name></place><place yahoo:uri="http://where.yahooapis.com/v1/place/22721374" xml:lang="en"><woeid>22721374</woeid><placeTypeName code="7">Town</placeTypeName><name>Lucas Heights</name></place><place yahoo:uri="http://where.yahooapis.com/v1/place/1094387" xml:lang="en"><woeid>1094387</woeid><placeTypeName code="7">Town</placeTypeName><name>Berrilee</name></place><place yahoo:uri="http://where.yahooapis.com/v1/place/1101412" xml:lang="en"><woeid>1101412</woeid><placeTypeName code="7">Town</placeTypeName><name>Cowan</name></place></places>

data/spec/fixtures/woid_1105779_parent.xml

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<place xmlns="http://where.yahooapis.com/v1/schema.rng" xmlns:yahoo="http://www.yahooapis.com/v1/base.rng" yahoo:uri="http://where.yahooapis.com/v1/place/2344700" xml:lang="en"><woeid>2344700</woeid><placeTypeName code="8">State</placeTypeName><name>New South Wales</name></place>

data/spec/fixtures/woid_1105779_siblings.xml

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<places xmlns="http://where.yahooapis.com/v1/schema.rng" xmlns:yahoo="http://www.yahooapis.com/v1/base.rng" yahoo:start="0" yahoo:count="3" yahoo:total="3"><place yahoo:uri="http://where.yahooapis.com/v1/place/1104584" xml:lang="en"><woeid>1104584</woeid><placeTypeName code="7">Town</placeTypeName><name>Newcastle</name></place><place yahoo:uri="http://where.yahooapis.com/v1/place/1105779" xml:lang="en"><woeid>1105779</woeid><placeTypeName code="7">Town</placeTypeName><name>Sydney</name></place><place yahoo:uri="http://where.yahooapis.com/v1/place/1106771" xml:lang="en"><woeid>1106771</woeid><placeTypeName code="7">Town</placeTypeName><name>Wollongong</name></place></places>

data/spec/specs.html

@@ -0,0 +1,209 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE html 
+  PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+  <title>RSpec results</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+  <meta http-equiv="Expires" content="-1" />
+  <meta http-equiv="Pragma" content="no-cache" />
+  <style type="text/css">
+  body {
+    margin: 0;
+    padding: 0;
+    background: #fff;
+    font-size: 80%;
+  }
+  </style>
+</head>
+<body>
+<div class="rspec-report">
+  <script type="text/javascript">
+    // <![CDATA[
+function moveProgressBar(percentDone) {
+  document.getElementById("rspec-header").style.width = percentDone +"%";
+}
+function makeRed(element_id) {
+  document.getElementById(element_id).style.background = '#C40D0D';
+  document.getElementById(element_id).style.color = '#FFFFFF';
+}
+
+function makeYellow(element_id) {
+  if (element_id == "rspec-header" && document.getElementById(element_id).style.background != '#C40D0D')
+  {
+    document.getElementById(element_id).style.background = '#FAF834';
+    document.getElementById(element_id).style.color = '#000000';
+  }
+  else
+  {
+    document.getElementById(element_id).style.background = '#FAF834';
+    document.getElementById(element_id).style.color = '#000000';
+  }
+}
+
+    // ]]>
+  </script>
+  <style type="text/css">
+#rspec-header {
+  background: #65C400; color: #fff;
+}
+
+.rspec-report h1 {
+  margin: 0px 10px 0px 10px;
+  padding: 10px;
+  font-family: "Lucida Grande", Helvetica, sans-serif;
+  font-size: 1.8em;
+}
+
+#summary {
+  margin: 0; padding: 5px 10px;
+  font-family: "Lucida Grande", Helvetica, sans-serif;
+  text-align: right;
+  position: absolute;
+  top: 0px;
+  right: 0px;
+}
+
+#summary p {
+  margin: 0 0 0 2px;
+}
+
+#summary #totals {
+  font-size: 1.2em;
+}
+
+.example_group {
+  margin: 0 10px 5px;
+  background: #fff;
+}
+
+dl {
+  margin: 0; padding: 0 0 5px;
+  font: normal 11px "Lucida Grande", Helvetica, sans-serif;
+}
+
+dt {
+  padding: 3px;
+  background: #65C400;
+  color: #fff;
+  font-weight: bold;
+}
+
+dd {
+  margin: 5px 0 5px 5px;
+  padding: 3px 3px 3px 18px;
+}
+
+dd.spec.passed {
+  border-left: 5px solid #65C400;
+  border-bottom: 1px solid #65C400;
+  background: #DBFFB4; color: #3D7700;
+}
+
+dd.spec.failed {
+  border-left: 5px solid #C20000;
+  border-bottom: 1px solid #C20000;
+  color: #C20000; background: #FFFBD3;
+}
+
+dd.spec.not_implemented {
+  border-left: 5px solid #FAF834;
+  border-bottom: 1px solid #FAF834;
+  background: #FCFB98; color: #131313;
+}
+
+dd.spec.pending_fixed {
+  border-left: 5px solid #0000C2;
+  border-bottom: 1px solid #0000C2;
+  color: #0000C2; background: #D3FBFF;
+}
+
+.backtrace {
+  color: #000;
+  font-size: 12px;
+}
+
+a {
+  color: #BE5C00;
+}
+
+/* Ruby code, style similar to vibrant ink */
+.ruby {
+  font-size: 12px;
+  font-family: monospace;
+  color: white;
+  background-color: black;
+  padding: 0.1em 0 0.2em 0;
+}
+
+.ruby .keyword { color: #FF6600; }
+.ruby .constant { color: #339999; }
+.ruby .attribute { color: white; }
+.ruby .global { color: white; }
+.ruby .module { color: white; }
+.ruby .class { color: white; }
+.ruby .string { color: #66FF00; }
+.ruby .ident { color: white; }
+.ruby .method { color: #FFCC00; }
+.ruby .number { color: white; }
+.ruby .char { color: white; }
+.ruby .comment { color: #9933CC; }
+.ruby .symbol { color: white; }
+.ruby .regex { color: #44B4CC; }
+.ruby .punct { color: white; }
+.ruby .escape { color: white; }
+.ruby .interp { color: white; }
+.ruby .expr { color: white; }
+
+.ruby .offending { background-color: gray; }
+.ruby .linenum {
+  width: 75px;
+  padding: 0.1em 1em 0.2em 0;
+  color: #000000;
+  background-color: #FFFBD3;
+}
+
+  </style>
+
+<div id="rspec-header">
+  <h1>RSpec Results</h1>
+
+  <div id="summary">
+    <p id="totals">&nbsp;</p>
+    <p id="duration">&nbsp;</p>
+  </div>
+</div>
+
+<div class="results">
+<div class="example_group">
+  <dl>
+  <dt id="example_group_1">YILP</dt>
+    <script type="text/javascript">moveProgressBar('10.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should accept a query string and return a valid hash</span></dd>
+    <script type="text/javascript">moveProgressBar('20.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should accept a numeric WOEID and return a valid hash</span></dd>
+    <script type="text/javascript">moveProgressBar('30.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should accept a numeric WOEID, a parent option and return a valid hash</span></dd>
+    <script type="text/javascript">moveProgressBar('40.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should accept a numeric woeid, an ancestors hash and return a valid hash</span></dd>
+    <script type="text/javascript">moveProgressBar('50.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should accept a neighbors option</span></dd>
+    <script type="text/javascript">moveProgressBar('60.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should accept a valid WOEID and a belongtos option and return a valid hash of a collection of places that contain a place</span></dd>
+    <script type="text/javascript">moveProgressBar('70.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should accept a valid WOEID and a siblings option and return a collection of places that are siblings of a place</span></dd>
+    <script type="text/javascript">moveProgressBar('80.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should accept a valid WOEID and a children option and return a collection of places that are children of a place.</span></dd>
+    <script type="text/javascript">moveProgressBar('90.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should return placetypes</span></dd>
+    <script type="text/javascript">moveProgressBar('100.0');</script>
+    <dd class="spec passed"><span class="passed_spec_name">should have valid key-value pairs for language</span></dd>
+  </dl>
+</div>
+<script type="text/javascript">document.getElementById('duration').innerHTML = "Finished in <strong>4.317402 seconds</strong>";</script>
+<script type="text/javascript">document.getElementById('totals').innerHTML = "10 examples, 0 failures";</script>
+</div>
+</div>
+</body>
+</html>

data/spec/yilp_spec.rb

@@ -0,0 +1,99 @@
+require File.dirname(__FILE__) + '/../lib/yilp.rb'
+require "pp"
+include YILP
+
+describe YILP do
+  before do
+    @h = Hash.new 
+    @valid_place = 'sydney'
+    @valid_woid = 1105777
+    @invalid_woid = "12dsag@!"
+    @invalid_place = "21gdssf32"
+  end
+  
+  after(:each) do
+    @h.should_not be(nil)
+  end
+
+  it  "should find the  yilp api keys in ./config/yilp_appid.yml" do
+    @h = YILP::YILP::APP_ID
+    @h = YILP::YILP.find(@valid_place)
+  end                                                                   
+  
+  it "should accept a query string and return a valid hash" do
+    @h = YILP::YILP.find(@valid_place)
+  end
+    
+  # /place/{woeid}
+  it "should accept a numeric WOEID and return a valid hash" do
+    @h = YILP::YILP.find(@valid_woid)
+  end
+  
+  # /place/{woeid}/parent
+  it "should accept a numeric WOEID, a parent option and return a valid hash" do
+    @h = YILP::YILP.find(@valid_woid, :parent => true)
+  end
+
+  # /place/{woeid}/ancestors
+  it "should accept a numeric woeid, an ancestors hash and return a valid hash" do
+    @h = YILP::YILP.find(@valid_woid, :ancestors => true)
+  end
+
+  # /place/{woeid}/neighbors 
+  it "should accept a neighbors option" do
+    @h = YILP::YILP.find(@valid_woid, :neighbors => true)
+  end
+  
+  # /place/{woeid}/belongtos
+  it "should accept a valid WOEID and a belongtos option and return a valid hash of a collection of places that contain a place" do
+    @h = YILP::YILP.find(@valid_woid, :belongtos => true)
+    @h["places"]["place"].should_not be(nil)
+  end
+  
+  # /place/{woeid}/siblings TODO: siblings may need a spec
+  it "should accept a valid WOEID and a siblings option and return a collection of places that are siblings of a place" do
+    @h = YILP::YILP.find(@valid_woid, :siblings => true)
+    @h["places"]["place"].should_not be(nil)
+  end
+
+  # /place/{woeid}/children
+  it "should accept a valid WOEID and a children option and return a collection of places that are children of a place." do
+    @h = YILP::YILP.find(@valid_woid, :children => true)
+    @h["places"]["place"].should_not be(nil)
+  end
+  
+  # /placetypes
+  it "should return placetypes" do
+    @placetypes = YILP::YILP.placetypes
+    @placetypes.should_not be(nil)
+    @placetypes["place_types"]["place_type"].should_not be(nil)
+  end
+  
+  it "should deal with internationalized placenames" do
+    @h = YILP::YILP.find('Moscow', :lang => :German)
+    @h["places"]["place"]["name"].should eql("Moskau")
+    @h = YILP::YILP.find('USA', :lang => :French)
+    @h["places"]["place"]["name"].should eql("États-Unis")
+  end
+  
+  # http://www.w3.org/TR/REC-html40/struct/dirlang.html#langcodes
+  #TODO: it "should accept a valid lang option and return"
+  
+  it "should have valid key-value pairs for language" do
+    YILP::YILP.lang(:French).should eql('fr') 
+    YILP::YILP.lang(:German).should eql('de') 
+    YILP::YILP.lang(:Italian).should eql('de') 
+    YILP::YILP.lang(:Dutch).should eql('nl') 
+    YILP::YILP.lang(:Greek).should eql('el')
+    YILP::YILP.lang(:Spanish).should eql('es') 
+    YILP::YILP.lang(:Portuguese).should eql('pt')  
+    YILP::YILP.lang(:Arabic).should eql('ar')  
+    YILP::YILP.lang(:Hebrew).should eql('he')  
+    YILP::YILP.lang(:Russian).should eql('ru')  
+    YILP::YILP.lang(:Chinese).should eql('zh')  
+    YILP::YILP.lang(:Japanese).should eql('ja')  
+    YILP::YILP.lang(:Hindi).should eql('hi')
+    YILP::YILP.lang(:Urdu).should eql('ur') 
+    YILP::YILP.lang(:Sanskrit).should eql('sa')
+  end
+end

data/yilp.gemspec

@@ -0,0 +1,34 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{yilp}
+  s.version = "0.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Shoaib Burq & David Troy"]
+  s.date = %q{2009-04-13}
+  s.description = %q{Ruby wrapper arround Yahoo Internet Location Platform}
+  s.email = %q{shoaib@nomad-labs.com}
+  s.extra_rdoc_files = ["lib/yilp.rb", "README.rdoc"]
+  s.files = ["config/yilp_appid.yml", "lib/yilp.rb", "Rakefile", "README.rdoc", "spec/fixtures/places_sydney.xml", "spec/fixtures/placetypes.xml", "spec/fixtures/woid_1105779.xml", "spec/fixtures/woid_1105779_ancestors.xml", "spec/fixtures/woid_1105779_belongto.xml", "spec/fixtures/woid_1105779_children.xml", "spec/fixtures/woid_1105779_neighbors.xml", "spec/fixtures/woid_1105779_parent.xml", "spec/fixtures/woid_1105779_siblings.xml", "spec/specs.html", "spec/yilp_spec.rb", "Manifest", "yilp.gemspec"]
+  s.has_rdoc = true
+  s.homepage = %q{http://yilp.rubyforge.org}
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Yilp", "--main", "README.rdoc"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{yilp}
+  s.rubygems_version = %q{1.3.1}
+  s.summary = %q{Ruby wrapper arround Yahoo Internet Location Platform}
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 2
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<active_support>, [">= 0"])
+    else
+      s.add_dependency(%q<active_support>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<active_support>, [">= 0"])
+  end
+end

metadata

@@ -0,0 +1,84 @@
+--- !ruby/object:Gem::Specification 
+name: yilp
+version: !ruby/object:Gem::Version 
+  version: "0.1"
+platform: ruby
+authors: 
+- Shoaib Burq & David Troy
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-04-13 00:00:00 +10:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: active_support
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+description: Ruby wrapper arround Yahoo Internet Location Platform
+email: shoaib@nomad-labs.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- lib/yilp.rb
+- README.rdoc
+files: 
+- config/yilp_appid.yml
+- lib/yilp.rb
+- Rakefile
+- README.rdoc
+- spec/fixtures/places_sydney.xml
+- spec/fixtures/placetypes.xml
+- spec/fixtures/woid_1105779.xml
+- spec/fixtures/woid_1105779_ancestors.xml
+- spec/fixtures/woid_1105779_belongto.xml
+- spec/fixtures/woid_1105779_children.xml
+- spec/fixtures/woid_1105779_neighbors.xml
+- spec/fixtures/woid_1105779_parent.xml
+- spec/fixtures/woid_1105779_siblings.xml
+- spec/specs.html
+- spec/yilp_spec.rb
+- Manifest
+- yilp.gemspec
+has_rdoc: true
+homepage: http://yilp.rubyforge.org
+post_install_message: 
+rdoc_options: 
+- --line-numbers
+- --inline-source
+- --title
+- Yilp
+- --main
+- README.rdoc
+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: "1.2"
+  version: 
+requirements: []
+
+rubyforge_project: yilp
+rubygems_version: 1.3.1
+signing_key: 
+specification_version: 2
+summary: Ruby wrapper arround Yahoo Internet Location Platform
+test_files: []
+