barometer 0.3.2 → 0.5.0

data/spec/{units_spec.rb → data/units_spec.rb}

@@ -5,7 +5,7 @@ describe "Units" do
   describe "when initialized" do
     
     before(:each) do
-      @units = Barometer::Units.new
+      @units = Data::Units.new
     end
     
     it "responds to metric, defaults to true" do
@@ -15,7 +15,7 @@ describe "Units" do
     it "allows metric to be set" do
       @units.metric.should be_true
       
-      @units2 = Barometer::Units.new(false)
+      @units2 = Data::Units.new(false)
       @units2.metric.should be_false
     end
     
@@ -32,7 +32,7 @@ describe "Units" do
   describe "changing units" do
     
     before(:each) do
-      @units = Barometer::Units.new
+      @units = Data::Units.new
     end
     
     it "indicates if metric?" do
@@ -62,7 +62,7 @@ describe "Units" do
     
     before(:each) do
       module Barometer
-        class Units
+        class Data::Units
           attr_accessor :a, :b
           def metric_default=(value)
             self.a = value
@@ -72,8 +72,8 @@ describe "Units" do
           end
         end
       end
-      @units_metric = Barometer::Units.new(true)
-      @units_imperial = Barometer::Units.new(false)
+      @units_metric = Data::Units.new(true)
+      @units_imperial = Data::Units.new(false)
       @test_value_a = 5.5
       @test_value_b = 9.9
     end

data/spec/{data_zone_spec.rb → data/zone_spec.rb}

@@ -1,17 +1,17 @@
 require 'spec_helper'
 
-describe "Zone" do
+describe "Data::Zone" do
   
   describe "and class methods" do
     
     it "responds to now and returns Time object" do
-      Barometer::Zone.respond_to?("now").should be_true
-      Barometer::Zone.now.is_a?(Time).should be_true
+      Data::Zone.respond_to?("now").should be_true
+      Data::Zone.now.is_a?(Time).should be_true
     end
 
     it "responds to today and returns Date object" do
-      Barometer::Zone.respond_to?("today").should be_true
-      Barometer::Zone.today.is_a?(Date).should be_true
+      Data::Zone.respond_to?("today").should be_true
+      Data::Zone.today.is_a?(Date).should be_true
     end
     
   end
@@ -21,7 +21,7 @@ describe "Zone" do
     before(:each) do
       @utc = Time.now.utc
       @timezone = "Europe/Paris"
-      @zone = Barometer::Zone.new(@timezone)
+      @zone = Data::Zone.new(@timezone)
     end
     
     it "responds to timezone" do
@@ -30,26 +30,26 @@ describe "Zone" do
     end
     
     it "responds to tz" do
-      lambda { Barometer::Zone.new("invalid timezone") }.should raise_error(TZInfo::InvalidTimezoneIdentifier)
+      lambda { Data::Zone.new("invalid timezone") }.should raise_error(TZInfo::InvalidTimezoneIdentifier)
       
-      zone = Barometer::Zone.new(@timezone)
+      zone = Data::Zone.new(@timezone)
       zone.tz.should_not be_nil
     end
     
     it "responds to code" do
       @zone.respond_to?("code").should be_true
-      zone = Barometer::Zone.new(@timezone)
+      zone = Data::Zone.new(@timezone)
       zone.tz = nil
       zone.tz.should be_nil
       zone.code.should == ""
       
-      zone = Barometer::Zone.new(@timezone)
+      zone = Data::Zone.new(@timezone)
       zone.code.should == "CEST"
     end
     
     it "responds to dst?" do
       @zone.respond_to?("dst?").should be_true
-      zone = Barometer::Zone.new(@timezone)
+      zone = Data::Zone.new(@timezone)
       zone.tz = nil
       zone.tz.should be_nil
       zone.dst?.should be_nil
@@ -66,11 +66,11 @@ describe "Zone" do
     end
     
     it "responds to now" do
-      Barometer::Zone.respond_to?("now").should be_true
+      Data::Zone.respond_to?("now").should be_true
     end
     
     it "responds to today" do
-      Barometer::Zone.respond_to?("today").should be_true
+      Data::Zone.respond_to?("today").should be_true
     end
     
     it "converts local_time to utc" do
@@ -104,7 +104,7 @@ describe "Zone" do
       # in two UTC times that are off by the same offset
       original_difference = local_offset - target_offset
       
-      target_utc_time = Barometer::Zone.code_to_utc(target_time, target_zone)
+      target_utc_time = Data::Zone.code_to_utc(target_time, target_zone)
       local_utc_time = local_time.utc
       
       (target_utc_time - local_time.utc).to_i.should == original_difference.to_i
@@ -118,7 +118,7 @@ describe "Zone" do
       date = Date.parse(merge_date)
       time = Time.parse(merge_time)
       
-      utc_time = Barometer::Zone.merge(merge_time, merge_date, merge_zonecode)
+      utc_time = Data::Zone.merge(merge_time, merge_date, merge_zonecode)
       
       utc_time.year.should == date.year
       utc_time.month.should == date.month

data/spec/fixtures/formats/weather_id/90210.xml

@@ -0,0 +1 @@
+<?xml version='1.0' encoding='ISO-8859-1'?> <!-- This document is intended only for use by authorized licensees of The --> <!-- Weather Channel. Unauthorized use is prohibited. Copyright 1995-2009, --> <!-- The Weather Channel Interactive, Inc. All Rights Reserved. --> <search ver='3.0'> <loc id='USCA0090' type='1'> Beverly Hills, CA </loc> </search>

data/spec/fixtures/formats/weather_id/atlanta.xml

@@ -0,0 +1 @@
+<?xml version='1.0' encoding='ISO-8859-1'?> <!-- This document is intended only for use by authorized licensees of The --> <!-- Weather Channel. Unauthorized use is prohibited. Copyright 1995-2009, --> <!-- The Weather Channel Interactive, Inc. All Rights Reserved. --> <search ver='3.0'> <loc id='USGA0028' type='1'> Atlanta, GA </loc> <loc id='USGA0029' type='1'> Atlanta/Fulton County Arpt, GA </loc> </search>

data/spec/fixtures/formats/weather_id/from_USGA0028.xml

@@ -0,0 +1 @@
+<?xml version="1.0" encoding="UTF-8" standalone="yes" ?> <rss version="2.0" xmlns:yweather="http://xml.weather.yahoo.com/ns/rss/1.0" xmlns:geo="http://www.w3.org/2003/01/geo/wgs84_pos#"> <channel> <title>Yahoo! Weather - Atlanta, GA</title> <link>http://us.rd.yahoo.com/dailynews/rss/weather/Atlanta__GA/*http://weather.yahoo.com/forecast/USGA0028_f.html</link> <description>Yahoo! Weather for Atlanta, GA</description> <language>en-us</language> <lastBuildDate>Mon, 04 May 2009 2:52 am EDT</lastBuildDate> <ttl>60</ttl> <yweather:location city="Atlanta" region="GA" country="US"/> <yweather:units temperature="F" distance="mi" pressure="in" speed="mph"/> <yweather:wind chill="63" direction="230" speed="8" /> <yweather:atmosphere humidity="90" visibility="10" pressure="29.96" rising="0" /> <yweather:astronomy sunrise="6:47 am" sunset="8:23 pm"/> <image> <title>Yahoo! Weather</title> <width>142</width> <height>18</height> <link>http://weather.yahoo.com</link> <url>http://l.yimg.com/a/i/us/nws/th/main_142b.gif</url> </image> <item> <title>Conditions for Atlanta, GA at 2:52 am EDT</title> <geo:lat>33.75</geo:lat> <geo:long>-84.39</geo:long> <link>http://us.rd.yahoo.com/dailynews/rss/weather/Atlanta__GA/*http://weather.yahoo.com/forecast/USGA0028_f.html</link> <pubDate>Mon, 04 May 2009 2:52 am EDT</pubDate> <yweather:condition text="Mostly Cloudy" code="27" temp="63" date="Mon, 04 May 2009 2:52 am EDT" /> <description><![CDATA[ <img src="http://l.yimg.com/a/i/us/we/52/27.gif"/><br /> <b>Current Conditions:</b><br /> Mostly Cloudy, 63 F<BR /> <BR /><b>Forecast:</b><BR /> Mon - Strong Storms. High: 77 Low: 64<br /> Tue - Thunderstorms. High: 70 Low: 59<br /> <br /> <a href="http://us.rd.yahoo.com/dailynews/rss/weather/Atlanta__GA/*http://weather.yahoo.com/forecast/USGA0028_f.html">Full Forecast at Yahoo! Weather</a><BR/> (provided by The Weather Channel)<br/> ]]></description> <yweather:forecast day="Mon" date="4 May 2009" low="64" high="77" text="Strong Storms" code="3" /> <yweather:forecast day="Tue" date="5 May 2009" low="59" high="70" text="Thunderstorms" code="4" /> <guid isPermaLink="false">USGA0028_2009_05_04_2_52_EDT</guid> </item> </channel> </rss><!-- api4.weather.sp1.yahoo.com compressed/chunked Mon May 4 00:02:14 PDT 2009 -->

data/spec/fixtures/formats/weather_id/new_york.xml

@@ -0,0 +1 @@
+<?xml version='1.0' encoding='ISO-8859-1'?> <!-- This document is intended only for use by authorized licensees of The --> <!-- Weather Channel. Unauthorized use is prohibited. Copyright 1995-2009, --> <!-- The Weather Channel Interactive, Inc. All Rights Reserved. --> <search ver='3.0'> <loc id='USNY0996' type='1'> New York, NY </loc> <loc id='USNY0011' type='1'> Albany, NY </loc> <loc id='USNY0181' type='1'> Buffalo, NY </loc> <loc id='USNY1232' type='1'> Rochester, NY </loc> <loc id='USNY1434' type='1'> Syracuse, NY </loc> <loc id='USNY1010' type='1'> Niagara Falls, NY </loc> <loc id='USNY1630' type='1'> York, NY </loc> <loc id='USNY0997' type='1'> New York Mills, NY </loc> <loc id='USNY0819' type='1'> Little York, NY </loc> <loc id='USNY0998' type='1'> New York/Central Park, NY </loc> </search>

data/spec/fixtures/geocode/atlanta.xml

@@ -0,0 +1 @@
+<?xml version="1.0" encoding="UTF-8" ?> <kml xmlns="http://earth.google.com/kml/2.0"><Response> <name>Atlanta, GA, US</name> <Status> <code>200</code> <request>geocode</request> </Status> <Placemark id="p1"> <address>Atlanta, GA, USA</address> <AddressDetails Accuracy="4" xmlns="urn:oasis:names:tc:ciq:xsdschema:xAL:2.0"><Country><CountryNameCode>US</CountryNameCode><CountryName>USA</CountryName><AdministrativeArea><AdministrativeAreaName>GA</AdministrativeAreaName><Locality><LocalityName>Atlanta</LocalityName></Locality></AdministrativeArea></Country></AddressDetails> <ExtendedData> <LatLonBox north="33.8869080" south="33.6478380" east="-84.2894180" west="-84.5466630" /> </ExtendedData> <Point><coordinates>-84.3896630,33.7544870,0</coordinates></Point> </Placemark> </Response></kml>

data/spec/fixtures/services/weather_dot_com/90210.xml

@@ -0,0 +1 @@
+<?xml version="1.0" encoding="ISO-8859-1"?> <!-- This document is intended only for use by authorized licensees of The --> <!-- Weather Channel. Unauthorized use is prohibited. Copyright 1995-2009, --> <!-- The Weather Channel Interactive, Inc. All Rights Reserved. --> <weather ver="2.0"> <head> <locale>en_US</locale> <form>MEDIUM</form> <ut>C</ut> <ud>km</ud> <us>km/h</us> <up>mb</up> <ur>mm</ur> </head> <loc id="90210"> <dnam>Beverly Hills, CA (90210)</dnam> <tm>1:26 AM</tm> <lat>34.10</lat> <lon>-118.41</lon> <sunr>6:01 AM</sunr> <suns>7:40 PM</suns> <zone>-7</zone> </loc> <lnks type="prmo"> <link pos="1"> <l>http://www.weather.com/allergies?par=xoap&amp;site=textlink&amp;cm_ven=XOAP&amp;cm_cat=TextLink&amp;cm_pla=Link1&amp;cm_ite=Allergies</l> <t>Local Pollen Reports</t> </link> <link pos="2"> <l>http://www.weather.com/flights?par=xoap&amp;site=textlink&amp;cm_ven=XOAP&amp;cm_cat=TextLink&amp;cm_pla=Link2&amp;cm_ite=BusinessTraveler</l> <t>Airport Conditions</t> </link> <link pos="3"> <l>http://www.weather.com/garden?par=xoap&amp;site=textlink&amp;cm_ven=XOAP&amp;cm_cat=TextLink&amp;cm_pla=Link3&amp;cm_ite=Garden</l> <t>Lawn and Garden Weather</t> </link> <link pos="4"> <l>http://www.weather.com/traffic?par=xoap&amp;site=textlink&amp;cm_ven=XOAP&amp;cm_cat=TextLink&amp;cm_pla=Link4&amp;cm_ite=Traffic</l> <t>Rush Hour Traffic</t> </link> </lnks> <cc> <lsup>5/4/09 12:51 AM PDT</lsup> <obst>Santa Monica, CA</obst> <tmp>16</tmp> <flik>16</flik> <t>Fair</t> <icon>33</icon> <bar> <r>1016.6</r> <d>rising</d> </bar> <wind> <s>5</s> <gust>N/A</gust> <d>80</d> <t>E</t> </wind> <hmid>75</hmid> <vis>16.1</vis> <uv> <i>0</i> <t>Low</t> </uv> <dewp>12</dewp> <moon> <icon>9</icon> <t>Waxing Gibbous</t> </moon> </cc> <dayf> <lsup>5/4/09 12:25 AM PDT</lsup> <day d="0" t="Sunday" dt="May 3"> <hi>N/A</hi> <low>14</low> <sunr>6:02 AM</sunr> <suns>7:40 PM</suns> <part p="d"> <icon>30</icon> <t>Partly Cloudy</t> <wind> <s>16</s> <gust>N/A</gust> <d>288</d> <t>WNW</t> </wind> <bt>P Cloudy</bt> <ppcp>10</ppcp> <hmid>65</hmid> </part> <part p="n"> <icon>29</icon> <t>Partly Cloudy</t> <wind> <s>14</s> <gust>N/A</gust> <d>335</d> <t>NNW</t> </wind> <bt>P Cloudy</bt> <ppcp>10</ppcp> <hmid>71</hmid> </part> </day> <day d="1" t="Monday" dt="May 4"> <hi>25</hi> <low>14</low> <sunr>6:01 AM</sunr> <suns>7:40 PM</suns> <part p="d"> <icon>30</icon> <t>Partly Cloudy</t> <wind> <s>18</s> <gust>N/A</gust> <d>260</d> <t>W</t> </wind> <bt>P Cloudy</bt> <ppcp>10</ppcp> <hmid>53</hmid> </part> <part p="n"> <icon>29</icon> <t>Partly Cloudy</t> <wind> <s>13</s> <gust>N/A</gust> <d>334</d> <t>NNW</t> </wind> <bt>P Cloudy</bt> <ppcp>0</ppcp> <hmid>67</hmid> </part> </day> <day d="2" t="Tuesday" dt="May 5"> <hi>26</hi> <low>16</low> <sunr>6:00 AM</sunr> <suns>7:41 PM</suns> <part p="d"> <icon>30</icon> <t>Partly Cloudy</t> <wind> <s>19</s> <gust>N/A</gust> <d>279</d> <t>W</t> </wind> <bt>P Cloudy</bt> <ppcp>0</ppcp> <hmid>53</hmid> </part> <part p="n"> <icon>33</icon> <t>Mostly Clear</t> <wind> <s>10</s> <gust>N/A</gust> <d>313</d> <t>NW</t> </wind> <bt>M Clear</bt> <ppcp>0</ppcp> <hmid>63</hmid> </part> </day> <day d="3" t="Wednesday" dt="May 6"> <hi>27</hi> <low>16</low> <sunr>5:59 AM</sunr> <suns>7:42 PM</suns> <part p="d"> <icon>34</icon> <t>Mostly Sunny</t> <wind> <s>13</s> <gust>N/A</gust> <d>286</d> <t>WNW</t> </wind> <bt>M Sunny</bt> <ppcp>0</ppcp> <hmid>55</hmid> </part> <part p="n"> <icon>31</icon> <t>Clear</t> <wind> <s>8</s> <gust>N/A</gust> <d>313</d> <t>NW</t> </wind> <bt>Clear</bt> <ppcp>0</ppcp> <hmid>56</hmid> </part> </day> <day d="4" t="Thursday" dt="May 7"> <hi>26</hi> <low>16</low> <sunr>5:58 AM</sunr> <suns>7:43 PM</suns> <part p="d"> <icon>32</icon> <t>Sunny</t> <wind> <s>14</s> <gust>N/A</gust> <d>318</d> <t>NW</t> </wind> <bt>Sunny</bt> <ppcp>0</ppcp> <hmid>49</hmid> </part> <part p="n"> <icon>31</icon> <t>Clear</t> <wind> <s>6</s> <gust>N/A</gust> <d>13</d> <t>NNE</t> </wind> <bt>Clear</bt> <ppcp>0</ppcp> <hmid>50</hmid> </part> </day> </dayf> </weather>

data/spec/formats/coordinates_spec.rb

@@ -0,0 +1,158 @@
+require 'spec_helper'
+
+describe "Query::Coordinates" do
+  
+  before(:each) do
+    @short_zipcode = "90210"
+    @zipcode = @short_zipcode
+    @long_zipcode = "90210-5555"
+    @weather_id = "USGA0028"
+    @postal_code = "T5B 4M9"
+    @coordinates = "40.756054,-73.986951"
+    @geocode = "New York, NY"
+    @icao = "KSFO"
+  end
+  
+  describe "and class methods" do
+    
+    it "returns a format" do
+      Query::Format::Coordinates.format.should == :coordinates
+    end
+    
+    it "returns a country" do
+      Query::Format::Coordinates.country_code.should be_nil
+    end
+    
+    it "returns a regex" do
+      Query::Format::Coordinates.regex.should_not be_nil
+      Query::Format::Coordinates.regex.is_a?(Regexp).should be_true
+    end
+    
+    it "returns the convertable_formats" do
+      Query::Format::Coordinates.convertable_formats.should_not be_nil
+      Query::Format::Coordinates.convertable_formats.is_a?(Array).should be_true
+      Query::Format::Coordinates.convertable_formats.include?(:short_zipcode).should be_true
+      Query::Format::Coordinates.convertable_formats.include?(:zipcode).should be_true
+      Query::Format::Coordinates.convertable_formats.include?(:postalcode).should be_true
+      Query::Format::Coordinates.convertable_formats.include?(:weather_id).should be_true
+      Query::Format::Coordinates.convertable_formats.include?(:coordinates).should be_true
+      Query::Format::Coordinates.convertable_formats.include?(:icao).should be_true
+      Query::Format::Coordinates.convertable_formats.include?(:geocode).should be_true
+    end
+    
+    describe "is?," do
+      
+      before(:each) do
+        @valid = "40.756054,-73.986951"
+        @invalid = "invalid"
+      end
+      
+      it "recognizes a valid format" do
+        Query::Format::Coordinates.is?(@valid).should be_true
+      end
+      
+      it "recognizes non-valid format" do
+        Query::Format::Coordinates.is?(@invalid).should be_false
+      end
+      
+    end
+  
+    describe "when converting using 'to'," do
+      
+      it "requires a Query::Format object" do
+        lambda { Query::Format::Coordinates.to }.should raise_error(ArgumentError)
+        lambda { Query::Format::Coordinates.to("invalid") }.should raise_error(ArgumentError)
+        query = Barometer::Query.new(@zipcode)
+        query.is_a?(Barometer::Query).should be_true
+        lambda { Query::Format::Coordinates.to(original_query) }.should_not raise_error(ArgumentError)
+      end
+      
+      it "returns a Barometer::Query" do
+        query = Barometer::Query.new(@short_zipcode)
+        Query::Format::Coordinates.to(query).is_a?(Barometer::Query).should be_true
+      end
+
+      it "converts from short_zipcode" do
+        query = Barometer::Query.new(@short_zipcode)
+        query.format.should == :short_zipcode
+        new_query = Query::Format::Coordinates.to(query)
+        new_query.q.should == "34.1030032,-118.4104684"
+        new_query.country_code.should == "US"
+        new_query.format.should == :coordinates
+        new_query.geo.should_not be_nil
+      end
+
+      it "converts from zipcode" do
+        query = Barometer::Query.new(@zipcode)
+        query.format = :zipcode
+        query.format.should == :zipcode
+        new_query = Query::Format::Coordinates.to(query)
+        new_query.q.should == "34.1030032,-118.4104684"
+        new_query.country_code.should == "US"
+        new_query.format.should == :coordinates
+        new_query.geo.should_not be_nil
+      end
+
+      it "converts from weather_id" do
+        query = Barometer::Query.new(@weather_id)
+        query.format.should == :weather_id
+        new_query = Query::Format::Coordinates.to(query)
+        new_query.q.should == "33.754487,-84.389663"
+        new_query.country_code.should == "US"
+        new_query.format.should == :coordinates
+        new_query.geo.should_not be_nil
+      end
+
+      it "converts from geocode" do
+        query = Barometer::Query.new(@geocode)
+        query.format.should == :geocode
+        new_query = Query::Format::Coordinates.to(query)
+        new_query.q.should == "40.756054,-73.986951"
+        new_query.country_code.should == "US"
+        new_query.format.should == :coordinates
+        new_query.geo.should_not be_nil
+      end
+
+      it "converts from postal_code" do
+        query = Barometer::Query.new(@postal_code)
+        query.format.should == :postalcode
+        new_query = Query::Format::Coordinates.to(query)
+        new_query.q.should == "53.570447,-113.456083"
+        new_query.country_code.should == "CA"
+        new_query.format.should == :coordinates
+        new_query.geo.should_not be_nil
+      end
+
+      it "converts from icao" do
+        query = Barometer::Query.new(@icao)
+        query.format.should == :icao
+        new_query = Query::Format::Coordinates.to(query)
+        new_query.q.should == "37.615223,-122.389979"
+        new_query.country_code.should == "US"
+        new_query.format.should == :coordinates
+        new_query.geo.should_not be_nil
+      end
+
+      it "returns nil for other formats" do
+        query = Barometer::Query.new(@coordinates)
+        query.format.should == :coordinates
+        new_query = Query::Format::Coordinates.to(query)
+        new_query.q.should == "40.756201,-73.986513"
+        new_query.country_code.should == "US"
+        new_query.format.should == :coordinates
+        new_query.geo.should_not be_nil
+      end
+
+      it "skips conversion when no API key" do
+        Barometer.google_geocode_key = nil
+        Barometer.google_geocode_key.should be_nil
+        query = Barometer::Query.new(@short_zipcode)
+        Query::Format::Coordinates.to(query).q.should be_nil
+        Barometer.google_geocode_key = KEY
+      end
+
+    end
+    
+  end
+  
+end

data/spec/formats/format_spec.rb

@@ -0,0 +1,73 @@
+require 'spec_helper'
+
+describe "Query::Format" do
+  
+  describe "and class methods" do
+    
+    describe "is?," do
+      
+      it "requires a String" do
+        invalid = 1
+        lambda { Barometer::Query::Format.is?(invalid) }.should raise_error(ArgumentError)
+        
+        valid = "string"
+        valid.is_a?(String).should be_true
+        lambda { Barometer::Query::Format.is?(valid) }.should_not raise_error(ArgumentError)
+      end
+      
+      it "calls a stubbed undefined method" do
+        lambda { Barometer::Query::Format.is?("valid") }.should raise_error(NotImplementedError)
+      end 
+      
+    end
+    
+    describe "converts?," do
+      
+      it "requires a Query object" do
+        invalid = 1
+        Barometer::Query::Format.converts?(invalid).should be_false
+        
+        valid = Barometer::Query.new
+        valid.is_a?(Barometer::Query).should be_true
+        lambda { Barometer::Query::Format.converts?(valid) }.should_not raise_error(ArgumentError)
+      end
+      
+      it "returns false" do
+        valid = Barometer::Query.new
+        Barometer::Query::Format.converts?(valid).should be_false
+      end 
+      
+    end
+    
+    it "detects a Query object" do
+      invalid = 1
+      Barometer::Query::Format.is_a_query?.should be_false
+      Barometer::Query::Format.is_a_query?(invalid).should be_false
+      valid = Barometer::Query.new
+      valid.is_a?(Barometer::Query).should be_true
+      Barometer::Query::Format.is_a_query?(valid).should be_true
+    end
+    
+    it "stubs regex" do
+      lambda { Barometer::Query::Format.regex }.should raise_error(NotImplementedError)
+    end
+    
+    it "stubs format" do
+      lambda { Barometer::Query::Format.format }.should raise_error(NotImplementedError)
+    end
+    
+    it "stubs to" do
+      Barometer::Query::Format.to.should be_nil
+    end
+    
+    it "stubs country_code" do
+      Barometer::Query::Format.country_code.should be_nil
+    end
+    
+    it "stubs convertable_formats" do
+      Barometer::Query::Format.convertable_formats.should == []
+    end
+    
+  end
+  
+end

data/spec/formats/geocode_spec.rb

@@ -0,0 +1,179 @@
+require 'spec_helper'
+
+describe "Query::Geocode" do
+  
+  before(:each) do
+    @short_zipcode = "90210"
+    @zipcode = @short_zipcode
+    @long_zipcode = "90210-5555"
+    @weather_id = "USGA0028"
+    @postal_code = "T5B 4M9"
+    @coordinates = "40.756054,-73.986951"
+    @geocode = "New York, NY"
+    @icao = "KSFO"
+  end
+  
+  describe "and class methods" do
+    
+    it "returns a format" do
+      Query::Format::Geocode.format.should == :geocode
+    end
+    
+    it "returns a country" do
+      Query::Format::Geocode.country_code.should be_nil
+    end
+    
+    it "returns the convertable_formats" do
+      Query::Format::Geocode.convertable_formats.should_not be_nil
+      Query::Format::Geocode.convertable_formats.is_a?(Array).should be_true
+      Query::Format::Geocode.convertable_formats.include?(:short_zipcode).should be_true
+      Query::Format::Geocode.convertable_formats.include?(:zipcode).should be_true
+      Query::Format::Geocode.convertable_formats.include?(:coordinates).should be_true
+      Query::Format::Geocode.convertable_formats.include?(:weather_id).should be_true
+      Query::Format::Geocode.convertable_formats.include?(:icao).should be_true
+    end
+    
+    describe "is?," do
+      
+      before(:each) do
+        @valid = "New York, NY"
+      end
+      
+      it "recognizes a valid format" do
+        Query::Format::Geocode.is?(@valid).should be_true
+        Query::Format::Geocode.is?.should be_false
+      end
+      
+    end
+  
+    describe "when converting using 'to'," do
+      
+      before(:each) do
+        Barometer.force_geocode = false
+      end
+      
+      it "requires a Barometer::Query object" do
+        lambda { Query::Format::Geocode.to }.should raise_error(ArgumentError)
+        lambda { Query::Format::Geocode.to("invalid") }.should raise_error(ArgumentError)
+        query = Barometer::Query.new(@zipcode)
+        query.is_a?(Barometer::Query).should be_true
+        lambda { Query::Format::Geocode.to(query) }.should_not raise_error(ArgumentError)
+      end
+      
+      it "returns a Barometer::Query" do
+        query = Barometer::Query.new(@short_zipcode)
+        Query::Format::Geocode.to(query).is_a?(Barometer::Query).should be_true
+      end
+
+      it "converts from short_zipcode" do
+        query = Barometer::Query.new(@short_zipcode)
+        query.format.should == :short_zipcode
+        new_query = Query::Format::Geocode.to(query)
+        new_query.q.should == "Beverly Hills, CA, USA"
+        new_query.country_code.should == "US"
+        new_query.format.should == :geocode
+        new_query.geo.should_not be_nil
+      end
+
+      it "converts from zipcode" do
+        query = Barometer::Query.new(@zipcode)
+        query.format = :zipcode
+        query.format.should == :zipcode
+        new_query = Query::Format::Geocode.to(query)
+        new_query.q.should == "Beverly Hills, CA, USA"
+        new_query.country_code.should == "US"
+        new_query.format.should == :geocode
+        new_query.geo.should_not be_nil
+      end
+      
+      it "converts from weather_id" do
+        query = Barometer::Query.new(@weather_id)
+        query.format.should == :weather_id
+        new_query = Query::Format::Geocode.to(query)
+        new_query.q.should == "Atlanta, GA, US"
+        new_query.country_code.should be_nil
+        new_query.format.should == :geocode
+        new_query.geo.should be_nil
+      end
+      
+      it "converts from coordinates" do
+        query = Barometer::Query.new(@coordinates)
+        query.format.should == :coordinates
+        new_query = Query::Format::Geocode.to(query)
+        new_query.q.should == "New York, NY, USA"
+        new_query.country_code.should == "US"
+        new_query.format.should == :geocode
+        new_query.geo.should_not be_nil
+      end
+      
+      it "converts from icao" do
+        query = Barometer::Query.new(@icao)
+        query.format.should == :icao
+        new_query = Query::Format::Geocode.to(query)
+        new_query.q.should == "San Francisco Airport, USA"
+        new_query.country_code.should == "US"
+        new_query.format.should == :geocode
+        new_query.geo.should_not be_nil
+      end
+      
+      it "does not convert postalcode" do
+        query = Barometer::Query.new(@postal_code)
+        query.format.should == :postalcode
+        new_query = Query::Format::Geocode.to(query)
+        new_query.should be_nil
+      end
+      
+      it "leaves geocode untouched" do
+        query = Barometer::Query.new(@geocode)
+        query.format.should == :geocode
+        new_query = Query::Format::Geocode.to(query)
+        new_query.q.should == "New York, NY"
+        new_query.country_code.should be_nil
+        new_query.format.should == :geocode
+        new_query.geo.should be_nil
+      end
+      
+      it "skips conversion when no API key" do
+        Barometer.google_geocode_key = nil
+        Barometer.google_geocode_key.should be_nil
+        query = Barometer::Query.new(@coordinates)
+        Query::Format::Geocode.to(query).q.should be_nil
+        Barometer.google_geocode_key = KEY
+      end
+
+    end
+    
+    describe "when geocoding" do
+      
+      it "requires a Barometer::Query object" do
+        lambda { Query::Format::Geocode.geocode }.should raise_error(ArgumentError)
+        lambda { Query::Format::Geocode.geocode("invalid") }.should raise_error(ArgumentError)
+        query = Barometer::Query.new(@zipcode)
+        query.is_a?(Barometer::Query).should be_true
+        lambda { Query::Format::Geocode.geocode(original_query) }.should_not raise_error(ArgumentError)
+      end
+      
+      it "returns a Barometer::Query" do
+        query = Barometer::Query.new(@short_zipcode)
+        Query::Format::Geocode.geocode(query).is_a?(Barometer::Query).should be_true
+      end
+      
+      it "converts from short_zipcode" do
+        query = Barometer::Query.new(@short_zipcode)
+        query.format.should == :short_zipcode
+        new_query = Query::Format::Geocode.geocode(query)
+        new_query.q.should == "Beverly Hills, CA, USA"
+        new_query.country_code.should == "US"
+        new_query.format.should == :geocode
+        new_query.geo.should_not be_nil
+      end
+
+    end
+    
+    it "doesn't define a regex" do
+      lambda { Query::Format::Geocode.regex }.should raise_error(NotImplementedError)
+    end
+    
+  end
+  
+end