yahoo_weather 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 24bef4f8f4cdfeacb288198d866be0eda9109e71
+  data.tar.gz: b240e2f2fdee92fda21242f9aa9671de6803f60e
+SHA512:
+  metadata.gz: 0124bcaf4ba8d5f92393a8f03091ef50eb7330175684398f48a1c25a1088217c1e0c27222bcc38d47cf48077db87f1b90000f78131b68db9817e7c524dee17a0
+  data.tar.gz: 48d2b86838ae5d757a59d2a2f261b27bb7244a8b6c292e5a04f6aca834e24ccf201555e052fb3139057732bca7d03887569dd4f851b62a48e0441f8865ed7bc8

data/.gitignore

@@ -0,0 +1,3 @@
+/test/dummy/log/test.log
+/test/dummy/tmp/
+.DS_Store

data/.travis.yml

@@ -0,0 +1,4 @@
+language: ruby
+rvm:
+  - 2.0.0
+  - 1.9.3

data/Gemfile

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

data/Gemfile.lock

@@ -0,0 +1,94 @@
+PATH
+  remote: .
+  specs:
+    yahoo_weather (1.0.0)
+      nokogiri
+      rails (~> 4.0.0)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    actionmailer (4.0.0)
+      actionpack (= 4.0.0)
+      mail (~> 2.5.3)
+    actionpack (4.0.0)
+      activesupport (= 4.0.0)
+      builder (~> 3.1.0)
+      erubis (~> 2.7.0)
+      rack (~> 1.5.2)
+      rack-test (~> 0.6.2)
+    activemodel (4.0.0)
+      activesupport (= 4.0.0)
+      builder (~> 3.1.0)
+    activerecord (4.0.0)
+      activemodel (= 4.0.0)
+      activerecord-deprecated_finders (~> 1.0.2)
+      activesupport (= 4.0.0)
+      arel (~> 4.0.0)
+    activerecord-deprecated_finders (1.0.3)
+    activesupport (4.0.0)
+      i18n (~> 0.6, >= 0.6.4)
+      minitest (~> 4.2)
+      multi_json (~> 1.3)
+      thread_safe (~> 0.1)
+      tzinfo (~> 0.3.37)
+    arel (4.0.0)
+    atomic (1.1.13)
+    builder (3.1.4)
+    erubis (2.7.0)
+    fakeweb (1.3.0)
+    hike (1.2.3)
+    i18n (0.6.5)
+    mail (2.5.4)
+      mime-types (~> 1.16)
+      treetop (~> 1.4.8)
+    mime-types (1.24)
+    mini_portile (0.5.1)
+    minitest (4.7.5)
+    multi_json (1.7.9)
+    nokogiri (1.6.0)
+      mini_portile (~> 0.5.0)
+    polyglot (0.3.3)
+    rack (1.5.2)
+    rack-test (0.6.2)
+      rack (>= 1.0)
+    rails (4.0.0)
+      actionmailer (= 4.0.0)
+      actionpack (= 4.0.0)
+      activerecord (= 4.0.0)
+      activesupport (= 4.0.0)
+      bundler (>= 1.3.0, < 2.0)
+      railties (= 4.0.0)
+      sprockets-rails (~> 2.0.0)
+    railties (4.0.0)
+      actionpack (= 4.0.0)
+      activesupport (= 4.0.0)
+      rake (>= 0.8.7)
+      thor (>= 0.18.1, < 2.0)
+    rake (10.1.0)
+    sprockets (2.10.0)
+      hike (~> 1.2)
+      multi_json (~> 1.0)
+      rack (~> 1.0)
+      tilt (~> 1.1, != 1.3.0)
+    sprockets-rails (2.0.0)
+      actionpack (>= 3.0)
+      activesupport (>= 3.0)
+      sprockets (~> 2.8)
+    sqlite3 (1.3.8)
+    thor (0.18.1)
+    thread_safe (0.1.2)
+      atomic
+    tilt (1.4.1)
+    treetop (1.4.15)
+      polyglot
+      polyglot (>= 0.3.1)
+    tzinfo (0.3.37)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  fakeweb (~> 1.3)
+  sqlite3
+  yahoo_weather!

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright 2013 Ildar Manzhikov
+
+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.md

@@ -0,0 +1,51 @@
+# yahoo_weather
+
+A Ruby object-oriented interface to the Yahoo! Weather feed.
+
+It supports caching and i18n.
+
+## Installation
+
+    $ gem install yahoo_weather
+
+
+Include in your Gemfile:
+
+```ruby
+gem 'yahoo_weather'
+```
+
+## API
+
+http://developer.yahoo.com/weather/
+
+## Example
+
+```ruby
+client = YahooWeather::Client.new
+response = client.fetch(12797168)
+response.units.temperature   # "F"
+response.condition.temp      # 60
+response.wind.direction      # 110
+response.wind.direction('string') # "ESE"
+response.condition.code # 29
+response.condition.code('string') # "Partly cloudy (night)"
+```
+
+## Locales
+
+Copy locale command:
+
+```ruby
+rails g yahoo_weather:copy_locale en
+```
+
+## Available Locales
+
+Available locales are:
+
+> en, ru
+
+## License
+
+MIT License. Copyright 2013 Ildar Manzhikov <manzhikov@gmail.com>. http://manzhikov.com

data/Rakefile

@@ -0,0 +1,32 @@
+begin
+  require 'bundler/setup'
+rescue LoadError
+  puts 'You must `gem install bundler` and `bundle install` to run rake tasks'
+end
+
+require 'rdoc/task'
+
+RDoc::Task.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'YahooWeather'
+  rdoc.options << '--line-numbers'
+  rdoc.rdoc_files.include('README.rdoc')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+
+
+
+Bundler::GemHelper.install_tasks
+
+require 'rake/testtask'
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib'
+  t.libs << 'test'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = false
+end
+
+
+task default: :test

data/config/locales/en.yml

@@ -0,0 +1,69 @@
+en:
+  yahoo_weather:
+    wind:
+      n: N
+      nne: NNE
+      ne: NE
+      ene: ENE
+      e: E
+      ese: ESE
+      se: SE
+      sse: SSE
+      s: S
+      ssw: SSW
+      sw: SW
+      wsw: WSW
+      w: W
+      wnw: WNW
+      nw: NW
+      nnw: NNW
+    code:
+      '0': 'Tornado'
+      '1': 'Tropical storm'
+      '2': 'Hurricane'
+      '3': 'Severe thunderstorms'
+      '4': 'Thunderstorms'
+      '5': 'Mixed rain and snow'
+      '6': 'Mixed rain and sleet'
+      '7': 'Mixed snow and sleet'
+      '8': 'Freezing drizzle'
+      '9': 'Drizzle'
+      '10': 'Freezing rain'
+      '11': 'Showers'
+      '12': 'Showers'
+      '13': 'Snow flurries'
+      '14': 'Light snow showers'
+      '15': 'Blowing snow'
+      '16': 'Snow'
+      '17': 'Hail'
+      '18': 'Sleet'
+      '19': 'Dust'
+      '20': 'Foggy'
+      '21': 'Haze'
+      '22': 'Smoky'
+      '23': 'Blustery'
+      '24': 'Windy'
+      '25': 'Cold'
+      '26': 'Cloudy'
+      '27': 'Mostly cloudy (night)'
+      '28': 'Mostly cloudy (day)'
+      '29': 'Partly cloudy (night)'
+      '30': 'Partly cloudy (day)'
+      '31': 'Clear (night)'
+      '32': 'Sunny'
+      '33': 'Fair (night)'
+      '34': 'Fair (day)'
+      '35': 'Mixed rain and hail'
+      '36': 'Hot'
+      '37': 'Isolated thunderstorms'
+      '38': 'Scattered thunderstorms'
+      '39': 'Scattered thunderstorms'
+      '40': 'Scattered showers'
+      '41': 'Heavy snow'
+      '42': 'Scattered snow showers'
+      '43': 'Heavy snow'
+      '44': 'Partly cloudy'
+      '45': 'Thundershowers'
+      '46': 'Snow showers'
+      '47': 'Isolated thundershowers'
+      '3200': 'Not available'

data/config/locales/ru.yml

@@ -0,0 +1,69 @@
+ru:
+  yahoo_weather:
+    wind:
+      n: С
+      nne: ССВ
+      ne: СВ
+      ene: ВСВ
+      e: В
+      ese: ВЮВ
+      se: ЮВ
+      sse: ЮЮВ
+      s: Ю
+      ssw: ЮЮЗ
+      sw: ЮЗ
+      wsw: ЗЮЗ
+      w: З
+      wnw: ЗСЗ
+      nw: СЗ
+      nnw: ССЗ
+    code:
+      '0': 'Торнадо'
+      '1': 'Тропический шторм'
+      '2': 'Ураган'
+      '3': 'Сильный шторм'
+      '4': 'Шторм'
+      '5': 'Мокрый снег'
+      '6': 'Дождь с градом'
+      '7': 'Дождь со снегом и градом'
+      '8': 'Мороз'
+      '9': 'Изморось'
+      '10': 'Мороз'
+      '11': 'Дождь'
+      '12': 'Дождь'
+      '13': 'Хлопья снега'
+      '14': 'Небольшой снег'
+      '15': 'Метель'
+      '16': 'Снег'
+      '17': 'Град'
+      '18': 'Град'
+      '19': 'Пыль'
+      '20': 'Туман'
+      '21': 'Туман'
+      '22': 'Туман'
+      '23': 'Сильный ветер'
+      '24': 'Ветренно'
+      '25': 'Холодно'
+      '26': 'Облачно'
+      '27': 'Ночью переменная облачность'
+      '28': 'Переменная облачность'
+      '29': 'Ночью ясно'
+      '30': 'Ясно'
+      '31': 'Облачно'
+      '32': 'Солнечно'
+      '33': 'Ясно'
+      '34': 'Ясно'
+      '35': 'Переменный дождь с градом'
+      '36': 'Жарко'
+      '37': 'Местами сильный ветер'
+      '38': 'Переменный сильный ветер'
+      '39': 'Переменный сильный ветер'
+      '40': 'Кратковременные дожди'
+      '41': 'Обильный снегопад'
+      '42': 'Снег'
+      '43': 'Обильный снегопад'
+      '44': 'Ясно'
+      '45': 'Шторм'
+      '46': 'Снег'
+      '47': 'Местами дожди'
+      '3200': 'Нет сведений'

data/lib/generators/yahoo_weather/copy_locale_generator.rb

@@ -0,0 +1,11 @@
+module YahooWeather
+  module Generators
+    class CopyLocaleGenerator < Rails::Generators::Base
+      source_root File.expand_path(__FILE__)
+      argument :locale, type: :string, default: 'en'
+      def copy_locale
+        copy_file "../../../../config/locales/#{locale.underscore}.yml", "config/locales/yahoo_weather.#{locale.underscore}.yml"
+      end
+    end
+  end
+end

data/lib/yahoo_weather/astronomy.rb

@@ -0,0 +1,8 @@
+class YahooWeather::Astronomy
+  attr_reader :sunrise, :sunset
+
+  def initialize(payload)
+    @sunrise = Time.parse(payload['sunrise'])
+    @sunset  = Time.parse(payload['sunset'])
+  end
+end

data/lib/yahoo_weather/atmosphere.rb

@@ -0,0 +1,29 @@
+class YahooWeather::Atmosphere
+  class Barometer
+    STEADY = 'steady'
+    RISING = 'rising'
+    FALLING = 'falling'
+
+    # lists all possible barometer constants
+    ALL = [ STEADY, RISING, FALLING ]
+  end
+
+  attr_reader :humidity, :visibility, :pressure, :barometer
+
+  def initialize(payload)
+    @humidity = payload['humidity'].to_i
+    @visibility = payload['visibility'].to_f
+    @pressure = payload['pressure'].to_f
+
+    # map barometric pressure direction to appropriate constant
+    @barometer = nil
+    case payload['rising'].to_i
+    when 0
+      @barometer = Barometer::STEADY
+    when 1
+      @barometer = Barometer::RISING
+    when 2
+      @barometer = Barometer::FALLING
+    end
+  end
+end

data/lib/yahoo_weather/client.rb

@@ -0,0 +1,42 @@
+class YahooWeather::Client
+  attr_reader :units, :woeid
+
+  def fetch(woeid, units = YahooWeather::Units::FAHRENHEIT)
+    @units = units
+    @woeid = woeid
+    doc = Nokogiri::XML(read_xml)
+    YahooWeather::Response.new(doc)
+  end
+
+private
+  def get_url
+    "http://weather.yahooapis.com/forecastrss?w=#{@woeid}&u=#{@units}"
+  end
+
+  def read_xml
+    save_cache unless Rails.cache.exist? cache_key
+    read_cache
+  end
+
+  def fetch_xml
+    begin
+      response = open(get_url)
+    rescue OpenURI::HTTPError => e
+      raise RuntimeError.new("Failed to get weather. Got a bad status code #{e.message}")
+    end
+
+    response.read
+  end
+
+  def save_cache
+    Rails.cache.write(cache_key, fetch_xml, expires_in: 1.minute)
+  end
+
+  def read_cache
+    Rails.cache.read cache_key
+  end
+
+  def cache_key
+    "yahoo_weather_#{@woeid}_#{@units}"
+  end
+end

data/lib/yahoo_weather/condition.rb

@@ -0,0 +1,15 @@
+class YahooWeather::Condition
+  attr_reader :text, :temp, :date
+
+  def initialize(payload)
+    @text = payload['text']
+    @code = payload['code'].to_i
+    @temp = payload['temp'].to_i
+    @date = Time.parse(payload['date'])
+  end
+
+  def code(u='integer')
+    return @code if u == 'integer'
+    YahooWeather.code_string(@code)
+  end
+end

data/lib/yahoo_weather/forecast.rb

@@ -0,0 +1,17 @@
+class YahooWeather::Forecast
+  attr_reader :date, :high, :low, :text, :day
+
+  def initialize(payload)
+    @date = Date.parse(payload['date'])
+    @text = payload['text']
+    @day  = payload['day']
+    @code = payload['code'].to_i
+    @high = payload['high'].to_i
+    @low  = payload['low'].to_i
+  end
+
+  def code(u='integer')
+    return @code if u == 'integer'
+    YahooWeather.code_string(@code)
+  end
+end

data/lib/yahoo_weather/location.rb

@@ -0,0 +1,9 @@
+class YahooWeather::Location
+  attr_reader :city, :region, :country
+
+  def initialize(payload)
+    @city    = payload['city']
+    @region  = payload['region']
+    @country = payload['country']
+  end
+end

data/lib/yahoo_weather/response.rb

@@ -0,0 +1,54 @@
+class YahooWeather::Response
+  attr_reader :doc, :title, :link, :description,
+              :language, :last_build_date, :ttl,
+              :lat, :long
+
+  def initialize(doc)
+    @doc = doc
+    @title            = get_text('item/title')
+    @link             = get_text('link')
+    @description      = get_text('description')
+    @language         = get_text('language')
+    @last_build_date  = Time.parse(get_text('lastBuildDate'))
+    @ttl              = get_text('ttl').to_i
+    @lat              = get_text('item/geo|lat').to_f
+    @long             = get_text('item/geo|long').to_f
+  end
+
+  def location
+    YahooWeather::Location.new(@doc.at('yweather|location'))
+  end
+
+  def units
+    YahooWeather::Units.new(@doc.at('yweather|units'))
+  end
+
+  def astronomy
+    YahooWeather::Astronomy.new(@doc.at('yweather|astronomy'))
+  end
+
+  def atmosphere
+    YahooWeather::Atmosphere.new(@doc.at('yweather|atmosphere'))
+  end
+
+  def condition
+    YahooWeather::Condition.new(@doc.at('item/yweather|condition'))
+  end
+
+  def wind
+    YahooWeather::Wind.new(@doc.at('yweather|wind'))
+  end
+
+  def forecasts
+    forecasts = []
+    @doc.search('item/yweather|forecast').each do |forecast|
+      forecasts << YahooWeather::Forecast.new(forecast)
+    end
+    forecasts
+  end
+
+private
+  def get_text(tag_name)
+    @doc.at(tag_name).children.text
+  end
+end

data/lib/yahoo_weather/units.rb

@@ -0,0 +1,13 @@
+class YahooWeather::Units
+  FAHRENHEIT = 'f'
+  CELSIUS = 'c'
+
+  attr_reader :temperature, :distance, :pressure, :speed
+
+  def initialize(payload)
+    @temperature = payload['temperature']
+    @distance    = payload['distance']
+    @pressure    = payload['pressure']
+    @speed       = payload['speed']
+  end
+end

data/lib/yahoo_weather/version.rb

@@ -0,0 +1,3 @@
+module YahooWeather
+  VERSION = '1.0.0'.freeze
+end

data/lib/yahoo_weather/wind.rb

@@ -0,0 +1,55 @@
+class YahooWeather::Wind
+  attr_reader :chill, :speed
+
+  def initialize(payload)
+    @chill     = payload['chill'].to_i
+    @direction = payload['direction'].to_i
+    @speed     = payload['speed'].to_f
+  end
+
+  def direction(u='integer')
+    return @direction if u == 'integer'
+
+    case @direction
+    when 0..11
+      direction_string(:n)
+    when 12..33
+      direction_string(:nne)
+    when 34..56
+      direction_string(:ne)
+    when 57..78
+      direction_string(:ene)
+    when 79..101
+      direction_string(:e)
+    when 102..123
+      direction_string(:ese)
+    when 124..146
+      direction_string(:se)
+    when 147..168
+      direction_string(:sse)
+    when 169..191
+      direction_string(:s)
+    when 192..213
+      direction_string(:ssw)
+    when 214..236
+      direction_string(:sw)
+    when 237..258
+      direction_string(:wsw)
+    when 259..281
+      direction_string(:w)
+    when 282..303
+      direction_string(:wnw)
+    when 304..326
+      direction_string(:nw)
+    when 327..348
+      direction_string(:nnw)
+    when 349..360
+      direction_string(:n)
+    end
+  end
+
+private
+  def direction_string(name)
+    I18n.t name, scope: [:yahoo_weather, :wind], default: name.to_s.upcase
+  end
+end

data/lib/yahoo_weather.rb

@@ -0,0 +1,18 @@
+require 'nokogiri'
+require 'open-uri'
+
+require 'yahoo_weather/client'
+require 'yahoo_weather/response'
+require 'yahoo_weather/wind'
+require 'yahoo_weather/atmosphere'
+require 'yahoo_weather/astronomy'
+require 'yahoo_weather/condition'
+require 'yahoo_weather/forecast'
+require 'yahoo_weather/location'
+require 'yahoo_weather/units'
+
+module YahooWeather
+  def self.code_string(id)
+    I18n.t id, scope: [:yahoo_weather, :code]
+  end
+end

data/test/dummy/README.rdoc

@@ -0,0 +1,28 @@
+== README
+
+This README would normally document whatever steps are necessary to get the
+application up and running.
+
+Things you may want to cover:
+
+* Ruby version
+
+* System dependencies
+
+* Configuration
+
+* Database creation
+
+* Database initialization
+
+* How to run the test suite
+
+* Services (job queues, cache servers, search engines, etc.)
+
+* Deployment instructions
+
+* ...
+
+
+Please feel free to use a different markup language if you do not plan to run
+<tt>rake doc:app</tt>.

data/test/dummy/Rakefile

@@ -0,0 +1,6 @@
+# Add your own tasks in files placed in lib/tasks ending in .rake,
+# for example lib/tasks/capistrano.rake, and they will automatically be available to Rake.
+
+require File.expand_path('../config/application', __FILE__)
+
+Dummy::Application.load_tasks