outoftime-noaa 0.1.0 → 0.2.0

data/CHANGELOG

@@ -1 +1,3 @@
+v0.2.0. Get #weather_type_code and #image_url from CurrentConditions and Forecast
+
 v0.1.0. Initial release

data/README

@@ -22,7 +22,7 @@ daily forecasts (through NOAA::Forecast).
 
   sudo gem sources --add http://gems.github.com (only if you haven't done this before)
   sudo gem install outoftime-noaa
-  noaa-update-stations
+  sudo noaa-update-stations
 
 == Usage:
 

data/Rakefile

@@ -14,7 +14,7 @@ Echoe.new('noaa', NOAA::VERSION) do |p|
   p.description = 'Ruby API for National Oceanic and Atmospheric Administration weather data'
   p.email = 'mat@patch.com'
   p.url = 'http://github.com/outoftime/noaa'
-  p.install_message = "Be sure to update the weather station list:\n\n\tnoaa-update-stations\n\nThis can be run at any time to update the stations, but you must run it once to initially populate the station list."
+  p.install_message = "Be sure to update the weather station list:\n\n\tsudo noaa-update-stations\n\nThis can be run at any time to update the stations, but you must run it once to initially populate the station list."
   p.runtime_dependencies = [Gem::Dependency.new('libxml-ruby', '>= 0.9.7'),
                             Gem::Dependency.new('andre-geokit', '>= 1.2.0')]
   p.development_dependencies = [Gem::Dependency.new('jeremymcanally-context', '>= 0.0.6'),

data/lib/noaa/current_conditions.rb

@@ -29,6 +29,50 @@ module NOAA
     def weather_description
       @weather_description ||= text_from_node('weather')
     end
+    alias_method :weather_summary, :weather_description
+
+    # 
+    # NWS code representing weather type. This distills the #weather_description
+    # into one of a much more manageable set of possibilities. Possible values are:
+    #
+    # - <code>:skc</code> - Clear
+    # - <code>:wind</code> - Windy
+    # - <code>:few</code> - A Few Clouds
+    # - <code>:sct</code> - Partly Cloudy
+    # - <code>:bkn</code> - Mostly Cloudy
+    # - <code>:ovc</code> - Overcast
+    # - <code>:ra1</code> - Light Rain
+    # - <code>:ra</code> - Rain
+    # - <code>:shra</code> - Rain Showers
+    # - <code>:tsra</code> - Thunderstorms
+    # - <code>:ip</code> - Hail
+    # - <code>:fzra</code> - Freezing Rain
+    # - <code>:mix</code> - Wintry Mix
+    # - <code>:sn</code> - Snow
+    # - <code>:fg</code> - Fog
+    # - <code>:smoke</code> - Smoke
+    # - <code>:dust</code> - Dust/Sand
+    # - <code>:mist</code> - Haze
+    # - <code>:nsvrtsra</code> - Tornado
+    # - <code>:fzrara</code> - Freezing Rain/Rain
+    # - <code>:raip</code> - Rain/Hail
+    # - <code>:rasn</code> - Rain/Snow
+    # - <code>:hi_shwrs</code> - Showers in Vicinity
+    # - <code>:hi_tsra</code> - Thunderstorm in Vicinity
+    #
+    # See http://www.weather.gov/xml/current_obs/weather.php for the NWS's list of possible
+    # descriptions and their type codes.
+    #
+    def weather_type_code
+      @weather_type_code ||= text_from_node('icon_url_name').sub(/\.jpg$/, '').to_sym
+    end
+
+    # 
+    # Return the NWS image URL for the current weather as string
+    #
+    def image_url
+      @image_url ||= "#{text_from_node('icon_url_base')}#{text_from_node('icon_url_name')}"
+    end
 
     #
     # The current temperature in the requested units.

data/lib/noaa/forecast.rb

@@ -48,6 +48,8 @@ module NOAA
           day.high = maxima[i]
           day.low = minima[i]
           day.weather_summary = weather_summaries[i]
+          day.weather_type_code = weather_type_codes[i]
+          day.image_url = image_urls[i]
           day.daytime_precipitation_probability = precipitation_probabilities[i*2]
           day.evening_precipitation_probability = precipitation_probabilities[i*2+1]
         end
@@ -85,6 +87,18 @@ module NOAA
       end
     end
 
+    def image_urls
+      @image_urls ||= @doc.find(%q{/dwml/data/parameters[1]/conditions-icon/icon-link/text()}).map do |node|
+        node.to_s
+      end
+    end
+
+    def weather_type_codes
+      @weather_type_codes ||= image_urls.map do |url|
+        url.match(/n?([a-z_]+)\d*\.jpg$/)[1].to_sym
+      end
+    end
+
     def precipitation_probabilities
       @precipitation_probabilities ||= @doc.find(%q{/dwml/data/parameters[1]/probability-of-precipitation[1]/value/text()}).map do |node|
         node.to_s.to_i

data/lib/noaa/forecast_day.rb

@@ -18,6 +18,13 @@ module NOAA
 
     # String summary of weather (e.g., 'Fair')
     attr_reader :weather_summary
+    alias_method :weather_description, :weather_summary
+
+    # Symbol representing NOAA weather type. See NOAA::CurrentConditions#weather_type_code
+    attr_reader :weather_type_code
+
+    # URL string for NOAA weather image
+    attr_reader :image_url
 
     # Percentage probability of precipitation during the day, between 6am and 6pm, as an integer (0-100)
     attr_reader :daytime_precipitation_probability
@@ -25,6 +32,7 @@ module NOAA
     # Percentage probability of precipitation during the evening/night, between 6pm and 6am, as an integer (0-100)
     attr_reader :evening_precipitation_probability
 
-    attr_writer :starts_at, :ends_at, :high, :low, :weather_summary, :daytime_precipitation_probability, :evening_precipitation_probability #:nodoc:
+    attr_writer :starts_at, :ends_at, :high, :low, :weather_summary, :weather_type_code, :image_url, #:nodoc:
+                :daytime_precipitation_probability, :evening_precipitation_probability #:nodoc:
   end
 end

data/lib/noaa.rb

@@ -14,7 +14,7 @@ require 'geokit'
 # NOAA API you will need; one exception is discussed below.
 #
 module NOAA
-  VERSION = '0.1.0'
+  VERSION = '0.2.0'
 
   class <<self
     # 

data/noaa.gemspec

@@ -2,11 +2,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{noaa}
-  s.version = "0.1.0"
+  s.version = "0.2.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
   s.authors = ["Mat Brown"]
-  s.date = %q{2008-12-26}
+  s.date = %q{2008-12-30}
   s.default_executable = %q{noaa-update-stations}
   s.description = %q{Ruby API for National Oceanic and Atmospheric Administration weather data}
   s.email = %q{mat@patch.com}
@@ -17,7 +17,7 @@ Gem::Specification.new do |s|
   s.homepage = %q{http://github.com/outoftime/noaa}
   s.post_install_message = %q{Be sure to update the weather station list:
 
-	noaa-update-stations
+	sudo noaa-update-stations
 
 This can be run at any time to update the stations, but you must run it once to initially populate the station list.}
   s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Noaa", "--main", "README"]
@@ -34,9 +34,9 @@ This can be run at any time to update the stations, but you must run it once to
     if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
       s.add_runtime_dependency(%q<libxml-ruby>, [">= 0.9.7"])
       s.add_runtime_dependency(%q<andre-geokit>, [">= 1.2.0"])
-      s.add_runtime_dependency(%q<jeremymcanally-context>, [">= 0.0.6"])
-      s.add_runtime_dependency(%q<jeremymcanally-matchy>, [">= 0.0.1"])
-      s.add_runtime_dependency(%q<ruby-debug>, ["~> 0.10"])
+      s.add_development_dependency(%q<jeremymcanally-context>, [">= 0.0.6"])
+      s.add_development_dependency(%q<jeremymcanally-matchy>, [">= 0.0.1"])
+      s.add_development_dependency(%q<ruby-debug>, ["~> 0.10"])
     else
       s.add_dependency(%q<libxml-ruby>, [">= 0.9.7"])
       s.add_dependency(%q<andre-geokit>, [">= 1.2.0"])

data/test/test_current_conditions.rb

@@ -11,25 +11,37 @@ class TestCurrentConditions < NOAA::TestCase
     conditions.weather_description.should == 'Fair'
   end
 
-  test 'should return temperature in fahrenheit by default' do
-    conditions.temperature.should == 24
+  test 'should return weather description from #weather_summary' do
+    conditions.weather_summary.should == 'Fair'
   end
 
-  test 'should return temperature in fahrenheit when specified' do
-    conditions.temperature(:f).should == 24
+  test 'should return weather type code' do
+    conditions.weather_type_code.should == :skc
   end
 
-  test 'should return temperature in celsius when specified' do
-    conditions.temperature(:c).should == -4
-  end
+  test 'should return image URL' do
+  conditions.image_url.should == 'http://weather.gov/weather/images/fcicons/skc.jpg'
+end
 
-  test 'should raise ArgumentError if unknown unit specified for temperature' do
-    lambda { conditions.temperature(:kelvin) }.should raise_error(ArgumentError)
-  end
+test 'should return temperature in fahrenheit by default' do
+  conditions.temperature.should == 24
+end
 
-  test 'should return relative humidity' do
-    conditions.relative_humidity.should == 52
-  end
+test 'should return temperature in fahrenheit when specified' do
+  conditions.temperature(:f).should == 24
+end
+
+test 'should return temperature in celsius when specified' do
+  conditions.temperature(:c).should == -4
+end
+
+test 'should raise ArgumentError if unknown unit specified for temperature' do
+  lambda { conditions.temperature(:kelvin) }.should raise_error(ArgumentError)
+end
+
+test 'should return relative humidity' do
+  conditions.relative_humidity.should == 52
+end
 
   test 'should return wind direction' do
     conditions.wind_direction.should == 'Northwest'

data/test/test_forecast.rb

@@ -37,6 +37,18 @@ class TestForecast < NOAA::TestCase
     end
   end
 
+  4.times do |i|
+    should "return correct weather type code for day #{i}" do
+      forecast[i].weather_type_code.should == :ra
+    end
+  end
+
+  [80, 90, 20, 50].each_with_index do |probability, i|
+    should "return correct image URL for day #{i}" do
+      forecast[i].image_url.should == "http://www.nws.noaa.gov/weather/images/fcicons/ra#{probability}.jpg"
+    end
+  end
+
   [5, 94, 22, 50].each_with_index do |probability, i|
     should "return correct daytime probability of precipitation for day #{i}" do
       forecast[i].daytime_precipitation_probability.should == probability

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: outoftime-noaa
 version: !ruby/object:Gem::Version 
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors: 
 - Mat Brown
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2008-12-26 00:00:00 -08:00
+date: 2008-12-30 00:00:00 -08:00
 default_executable: noaa-update-stations
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -105,7 +105,7 @@ homepage: http://github.com/outoftime/noaa
 post_install_message: |-
   Be sure to update the weather station list:
   
-  	noaa-update-stations
+  	sudo noaa-update-stations
   
   This can be run at any time to update the stations, but you must run it once to initially populate the station list.
 rdoc_options: