weather-underground 1.1.0 → 1.1.1

data/Gemfile

@@ -0,0 +1,3 @@
+source "http://rubygems.org"
+
+gemspec

data/History.txt

@@ -1,3 +1,6 @@
+=== 1.1.1 2011-03-05
+* Fix packaging issues with 1.1.0
+
 === 1.1.0 2011-03-04
 
 * 3 major enhancements:

data/Manifest.txt

@@ -1,10 +1,17 @@
+Gemfile
 History.txt
 Manifest.txt
 PostInstall.txt
 README.rdoc
 Rakefile
 lib/weather-underground.rb
+lib/weather-underground/alerts.rb
+lib/weather-underground/base.rb
+lib/weather-underground/current_observation.rb
+lib/weather-underground/forecast.rb
+lib/weather-underground/geo_lookup.rb
 lib/weather-underground/uploader.rb
+lib/weather-underground/utils.rb
 script/console
 script/destroy
 script/generate

data/Rakefile

@@ -19,7 +19,7 @@ $hoe = Hoe.spec 'weather-underground' do
   self.rubyforge_name       = 'sdaguegems' # self.name # TODO this is default value
   self.extra_rdoc_files = ["README.rdoc"]
   self.readme_file = "README.rdoc"
-  self.extra_deps = [['temperature', '>= 1.0.0'], 'rest-client', 'happymapper']
+  self.extra_deps = [['temperature', '>= 1.0.0'], ['rest-client', '>=0'], ['happymapper','>=0'] ]
   # self.extra_deps         = [['activesupport','>= 2.0.2']]
 
 end

data/lib/weather-underground.rb

@@ -10,5 +10,5 @@ require "weather-underground/geo_lookup"
 require "weather-underground/uploader"
 
 module WeatherUnderground
-  VERSION = '1.1.0'
+  VERSION = '1.1.1'
 end

data/lib/weather-underground/alerts.rb

@@ -0,0 +1,61 @@
+# Weather Underground API subject to TOS at http://www.wunderground.com/members/tos.asp#api
+
+module WeatherUnderground
+
+    class AlertExpires
+        include HappyMapper
+
+        tag 'expires'
+
+        attribute 'epoch',      Integer
+        content   'text'
+
+        def text
+            @text
+        end
+
+        def datetime
+            Time.at( @epoch )
+        end
+    end
+
+    class AlertDate
+        include HappyMapper
+
+        tag 'date'
+
+        attribute 'epoch',      Integer
+        content   'text'
+
+        def text
+            @text
+        end
+
+        def datetime
+            Time.at( @epoch )
+        end
+    end
+
+    class Alert
+        include HappyMapper
+
+        tag 'AlertItem'
+
+        element :type,          String
+        element :description,   String
+        has_one :date,          AlertDate
+        has_one :expires,       AlertExpires
+        element :message,       String
+        element :phenomena,     String
+        element :significance,  String
+    end
+
+
+    class Alerts
+        include HappyMapper
+
+        tag 'alerts'
+        
+        has_many :alerts,       Alert
+    end
+end

data/lib/weather-underground/base.rb

@@ -0,0 +1,120 @@
+require 'happymapper'
+require 'rest_client'
+
+module WeatherUnderground
+
+    # This is an data retriever for the weather underground personal weather
+    # station service, as found at http://wunderground.com.   
+    #
+    # It is build from the documentation provided at
+    # http://wiki.wunderground.com/index.php/API_-_XML 
+    class Base
+        include Utils
+
+    
+        def initialize
+        end
+
+        # Return the current observed weather data from location for +loc+
+        #
+        # +loc+ can be:
+        # * zipcode (US or Canadian)
+        # * city state; city, state
+        # * city
+        # * state
+        # * country
+        # * airport code (3-letter or 4-letter)
+        # * lat,lon
+        def CurrentObservations( loc )
+            WXCurrentObXML( loc ) 
+        end
+
+        # Return the forecast weather data from location for +loc+
+        #
+        # A +SimpleForecast+ contains more detailed data for each day than
+        # a +TextForcase+ of the same location.
+        #
+        # +loc+ can be:
+        # * zipcode (US or Canadian)
+        # * city state; city, state
+        # * city
+        # * state
+        # * country
+        # * airport code (3-letter or 4-letter)
+        # * lat,lon
+        def SimpleForecast( loc )
+            f = ForecastXML( loc )
+            f.simple_forecast
+        end
+
+        # Return the forecast weather data from location for +loc+
+        #
+        # A +TextForecast+ contains basic data in sentence form for the
+        # location queried. If you need more detailed data use
+        # a +SimpleForecast+
+        #
+        # +loc+ can be:
+        # * zipcode (US or Canadian)
+        # * city state; city, state
+        # * city
+        # * state
+        # * country
+        # * airport code (3-letter or 4-letter)
+        # * lat,lon
+        def TextForecast( loc )
+            f = ForecastXML( loc )
+            f.text_forecast
+        end
+
+        #--
+        # TODO: Implement GeoLookup
+        #++ 
+        def GeoLookup( loc )
+
+        end
+
+        # Return any active weather alerts for +loc+
+        #
+        # +loc+ can be:
+        # * zipcode (US or Canadian)
+        # * city state; city, state
+        # * city
+        # * state
+        # * country
+        # * airport code (3-letter or 4-letter)
+        # * lat,lon
+        def Alerts( loc )
+            AlertsXML( loc )
+        end
+
+    private
+
+        def GeoLookupXML( loc )
+            #TODO: Build Out
+            puts "GeoLookup not yet implemented"
+            
+            #base_url = "http://api.wunderground.com/auto/wui/geo/GeoLookupXML/index.xml"
+            #location_xml = RestClient.get base_url, {:params => {:query => loc}}
+            #GeoLookup.parse( location_xml )
+        end
+
+        def AlertsXML( loc )
+            base_url = "http://api.wunderground.com/auto/wui/geo/AlertsXML/index.xml"
+            alert_xml = RestClient.get base_url, {:params => {:query => loc}}
+            Alerts.parse( alert_xml )
+        end
+
+        def WXCurrentObXML( loc )
+            base_url = "http://api.wunderground.com/auto/wui/geo/WXCurrentObXML/index.xml"
+            current_observations_xml = RestClient.get base_url, {:params => {:query => loc}}
+            CurrentObservation::Base.parse( current_observations_xml )
+        end
+
+        def ForecastXML( loc )
+            base_url = "http://api.wunderground.com/auto/wui/geo/ForecastXML/index.xml"
+            
+            forecast_xml = RestClient.get base_url, {:params => {:query => loc}}
+            Forecast::Base.parse( forecast_xml )
+        end
+    end
+end

data/lib/weather-underground/current_observation.rb

@@ -0,0 +1,115 @@
+module WeatherUnderground
+    module CurrentObservation
+
+        class IconSet
+            include HappyMapper
+            
+            tag 'icon_set'
+
+            attribute :name,        String
+            element   :icon_url,    String
+        end
+
+        class Icons
+            include HappyMapper
+            
+            tag 'icons'
+
+            has_many :icon_sets,    IconSet
+        end
+       
+        class ObservationLocation
+            include HappyMapper
+            
+            tag 'observation_location'
+
+            element :full,          String
+            element :city,          String
+            element :state,         String
+            element :country,       String
+            element :latitude,      String
+            element :longitude,     String
+            element :elevation,     String
+        end
+        
+        class DisplayLocation
+            include HappyMapper
+            
+            tag 'display_location'
+
+            element :full,          String
+            element :city,          String
+            element :state,         String
+            element :state_name,    String
+            element :country,       String
+            element :zip,           String
+            element :latitude,      String
+            element :longitude,     String
+            element :elevation,     String
+        end
+        
+        class Image
+            include HappyMapper
+            
+            tag 'image'
+
+            element :url,           String
+            element :title,         String
+            element :link,          String
+        end
+
+        class Base
+            include HappyMapper
+
+            tag 'current_observation'
+
+            element :credit,                    String 
+            element :credit_URL,                String
+            element :station_id,                String
+            element :image,                     Image
+            element :display_location,          DisplayLocation
+            element :observation_location,      ObservationLocation
+
+            element :station_id,                String
+            element :observation_time,          String
+            element :observation_time_rfc822,   String
+            element :observation_epoch,         String
+            element :local_time,                String
+            element :local_time_rfc822,         String
+            element :local_epoch,               String
+            element :weather,                   String
+            element :temperature_string,        String
+            element :temp_f,                    String
+            element :temp_c,                    String
+            element :relative_humidity,         String
+            element :wind_string,               String
+            element :wind_dir,                  String
+            element :wind_degrees,              String
+            element :wind_mph,                  String
+            element :wind_gust_mph,             String
+            element :pressure_string,           String
+            element :pressure_mb,               String
+            element :pressure_in,               String
+            element :dewpoint_string,           String
+            element :dewpoint_f,                String
+            element :dewpoint_c,                String
+            element :heat_index_string,         String
+            element :heat_index_f,              String
+            element :heat_index_c,              String
+            element :windchill_string,          String
+            element :windchill_f,               String
+            element :windchill_c,               String
+            element :visibility_mi,             String
+            element :visibility_km,             String
+
+            element :icons,                     Icons
+
+            element :icon_url_base,             String
+            element :icon_url_name,             String
+            element :icon,                      String
+            element :forecast_url,              String
+            element :history_url,               String
+            element :ob_url,                    String
+        end
+    end
+end

data/lib/weather-underground/forecast.rb

@@ -0,0 +1,124 @@
+# Weather Underground API subject to TOS at http://www.wunderground.com/members/tos.asp#api
+module WeatherUnderground
+    module Forecast
+        class High
+            include HappyMapper
+
+            tag 'high'
+
+            element :fahrenheit,        Float
+            element :celsius,           Float
+
+            def f
+                @fahrenheit
+            end
+
+            def c
+                @celsius
+            end
+        end
+
+        class Low
+            include HappyMapper
+
+            tag 'low'
+            
+            element :fahrenheit,        Float
+            element :celsius,           Float
+
+            def f
+                @fahrenheit
+            end
+
+            def c
+                @celsius
+            end
+        end
+
+        class Date
+            include HappyMapper
+            
+            tag 'date'
+
+            element :epoch,             Integer
+            element :pretty_short,      String
+            element :pretty,            String
+            element :day,               Integer
+            element :month,             Integer
+            element :year,              Integer
+            element :yday,              Integer
+            element :hour,              Integer
+            element :min,               Integer
+            element :sec,               Integer
+            element :isdst,             Boolean
+            element :monthname,         String
+            element :weekday_short,     String
+            element :weekday,           String
+            element :ampm,              String
+            element :tz_short,          String
+            element :tz_long,           String
+        end
+
+        class SimpleForecastDay
+            include HappyMapper
+            
+            tag 'forecastday'
+
+            element :period,            Integer
+            element :icon,              String
+            element :conditions,        String
+            element :icon,              String
+            element :skyicon,           String
+            has_one :date_info,         Date
+            has_one :high,              High
+            has_one :low,               Low
+
+            attr_accessor :datetime
+
+            after_parse { |o|
+                o.datetime  = Time.at( o.date_info.epoch ) if o.date_info
+                o.date_info = nil
+            }
+        end
+
+        class TextForecastDay
+            include HappyMapper
+            
+            tag 'forecastday'
+
+            element :period,            Integer
+            element :icon,              String
+            element :title,             String
+            element :text,              String,     :tag => 'fcttext'
+
+        end
+        
+        class TextForecast
+            include HappyMapper
+
+            tag 'txt_forecast'
+            element :date,              Time
+            element :number,            Integer
+            has_many :days,             TextForecastDay
+        end
+        
+        class SimpleForecast
+            include HappyMapper
+
+            tag 'simpleforecast'
+            
+            has_many :days,             SimpleForecastDay
+        end
+        
+        class Base
+            include HappyMapper
+
+            tag 'forecast'
+
+            has_one :simple_forecast, SimpleForecast
+            has_one :text_forecast,   TextForecast
+        end
+    end
+end
+
+

data/lib/weather-underground/geo_lookup.rb

@@ -0,0 +1,7 @@
+# Weather Underground API subject to TOS at http://www.wunderground.com/members/tos.asp#api
+# TODO: Build out
+module WeatherUnderground
+    class GeoLookup 
+    end
+end
+

data/lib/weather-underground/utils.rb

@@ -0,0 +1,5 @@
+#Any helpers of sorts go here. Used as a mixin
+module WeatherUnderground
+    module Utils
+    end
+end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: weather-underground
 version: !ruby/object:Gem::Version 
-  hash: 19
+  hash: 17
   prerelease: false
   segments: 
   - 1
   - 1
-  - 0
-  version: 1.1.0
+  - 1
+  version: 1.1.1
 platform: ruby
 authors: 
 - Sean Dague
@@ -125,13 +125,20 @@ extra_rdoc_files:
 - PostInstall.txt
 - README.rdoc
 files: 
+- Gemfile
 - History.txt
 - Manifest.txt
 - PostInstall.txt
 - README.rdoc
 - Rakefile
 - lib/weather-underground.rb
+- lib/weather-underground/alerts.rb
+- lib/weather-underground/base.rb
+- lib/weather-underground/current_observation.rb
+- lib/weather-underground/forecast.rb
+- lib/weather-underground/geo_lookup.rb
 - lib/weather-underground/uploader.rb
+- lib/weather-underground/utils.rb
 - script/console
 - script/destroy
 - script/generate