forecast_io-cache 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: ef116f597c9ede4482828322869a00aa395b6393
+  data.tar.gz: ad798a1fe9c3277bbba85b9d5491bacf9dae46c3
+SHA512:
+  metadata.gz: c7cc51e0c2d98fae59f8b8b93d15272ae44e1c9c57c9ba5904043a248dacc007c20a058b2f81c010f36364693a50846aea47d39c36c258bd60aec8cf586319f8
+  data.tar.gz: 3d22fc5b23f791948db6277bcadd6ac6a7b085feef49ea093680a27df3bb327806966c721ca9c7c6294bd5c279266ef04d0fdd8b0c51cbae60f6450c1e7d8ca5

checksums.yaml.gz.sig

@@ -0,0 +1 @@
+����_�h#(��M�/}�Tl�BRc��S��/��Z���aNj��oDgi�R)�IH]�g�Ξ��V#FGJ����Vwϑ�:�"�e<L>���%�u_�덲��x ��,P���X`(���Xĝ�0����U����" P�k~�nԭ9!^�qX	1.����s!�ŧ�ȫd���3���`-��˓%#�� 0��5�/��o��K��o�f����g��L>�7�5���b�b���s��;9��B�J�B>

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Jon Rowe
+
+MIT License
+
+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,35 @@
+# Forecast::IO::Cache
+
+A local caching setup for [Forecast.IO](https://developer.forecast.io)
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'forecast_io-cache'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install forecast_io-cache
+
+## Usage
+
+Load the gem and then rackup the service.
+
+    use ForecastIO::Cache
+
+or
+
+    run ForecastIO::Cache
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/features/accessing_a_forecast.feature

@@ -0,0 +1,32 @@
+Feature: Accessing a forecast
+  In order to provide weather information to my users
+  I want to access a forecast for a specific location
+
+  @time-frozen
+  Scenario: Not cached
+    When I request '/forecast/API_KEY/-33.857444,151.238823'
+    Then I am given the forecast as returned from forecast.io
+
+  @time-frozen
+  Scenario: Cached
+    Given I have cached this forecast recently
+    When I request '/forecast/API_KEY/-33.857444,151.238823'
+    Then I am given the cached forecast
+
+  @time-frozen
+  Scenario: Cached nearby
+    Given I have a cache result nearby
+    When I request '/forecast/API_KEY/-33.857444,151.238823'
+    Then I am given the cached forecast
+
+  @time-frozen
+  Scenario: Cached close but beyond radius
+    Given I have a cache result for close by
+    When I request '/forecast/API_KEY/-33.857444,151.238823'
+    Then I am given the forecast as returned from forecast.io
+
+  @time-frozen
+  Scenario: Cache expired
+    Given I have a cached result but for a time beyond the threshold
+    When I request '/forecast/API_KEY/-33.857444,151.238823'
+    Then I am given the forecast as returned from forecast.io

data/features/accessing_a_forecast_at_a_specific_time.feature

@@ -0,0 +1,27 @@
+Feature: Accessing a forecast for a specific time
+  In order to provide weather information to my users
+  I want to access a forecast for a specific location at a specific time
+
+  Scenario: Not cached
+    When I request '/forecast/API_KEY/-33.857444,151.238823,123456789'
+    Then I am given the forecast as returned from forecast.io
+
+  Scenario: Cached
+    Given I have cached this forecast recently
+    When I request '/forecast/API_KEY/-33.857444,151.238823,123456789'
+    Then I am given the cached forecast
+
+  Scenario: Cached nearby
+    Given I have a cache result nearby
+    When I request '/forecast/API_KEY/-33.857444,151.238823,123456789'
+    Then I am given the cached forecast
+
+  Scenario: Cached close but beyond radius
+    Given I have a cache result for close by
+    When I request '/forecast/API_KEY/-33.857444,151.238823,123456789'
+    Then I am given the forecast as returned from forecast.io
+
+  Scenario: Cache expired
+    Given I have a cached result but for a time beyond the threshold
+    When I request '/forecast/API_KEY/-33.857444,151.238823,123456789'
+    Then I am given the forecast as returned from forecast.io

data/features/accessing_the_api.feature

@@ -0,0 +1,17 @@
+Feature: Accessing the api
+  In order to provide information about the api
+  When I access the root of the api I want to receive hypermedia information
+
+  Scenario: Access /
+    When I request '/'
+    Then I am given the json response detailing the available actions:
+      """
+        {
+          "actions":
+          {
+            "forecast":         "/forecast/:key/:latitude,:longitude",
+            "forecast_at_time": "/forecast/:key/:latitude,:longitude,:time"
+          },
+          "status": "Not Found"
+        }
+      """

data/features/step_definitions/api_steps.rb

@@ -0,0 +1,8 @@
+When /^I request '(.*)'$/ do |path|
+  @path = path
+end
+
+Then /^I am given the json response.*$/ do |string|
+  get @path
+  expect(parsed_response).to eq parsed(string)
+end

data/features/step_definitions/cache_steps.rb

@@ -0,0 +1,18 @@
+Given "I have cached this forecast recently" do
+  @position = [151.238823,-33.857444]
+  setup "position" => @position, "time" => 123456789
+end
+
+Given "I have a cache result nearby" do
+  @position = [151.238823,-33.857333]
+  setup "position" => @position, "time" => 123456789
+end
+
+Given "I have a cache result for close by" do
+  @position = [151.238823,-33.957333]
+  setup "position" => @position, "time" => 123456789
+end
+
+Given "I have a cached result but for a time beyond the threshold" do
+  setup "position" => [151.238823,-33.757444], "time" => 1234567890
+end

data/features/step_definitions/forecast_steps.rb

@@ -0,0 +1,33 @@
+require 'forecast_io'
+
+Then "I am given the forecast as returned from forecast.io" do
+  VCR.use_cassette 'forecast_for_latitude_and_longitude' do
+    expect_ok { get @path }
+  end
+  expect(parsed_response).to eq({
+    "time"         => 123456789,
+    "latitude"     => -33.857444,
+    "longitude"    => 151.238823,
+    "wind_speed"   => 1.87,
+    "wind_bearing" => 186,
+    "humidity"     => 0.7,
+    "pressure"     => 1013.1,
+    "visibility"   => 10,
+    "temperature"  => 68.47,
+  })
+end
+
+Then "I am given the cached forecast" do
+  expect_ok { get @path }
+  expect(parsed_response).to eq({
+    "time"         => 123456789,
+    "latitude"     => @position[1],
+    "longitude"    => @position[0],
+    "wind_speed"   => 6.66,
+    "wind_bearing" => 200,
+    "humidity"     => 0.9,
+    "pressure"     => 1015.1,
+    "visibility"   => 13,
+    "temperature"  => 68.72
+  })
+end

data/features/support/api.rb

@@ -0,0 +1,13 @@
+require 'forecast_io-cache'
+require 'rack/test'
+
+module API
+  include Rack::Test::Methods
+
+  def app
+    Forecast::IO::Cache
+  end
+
+end
+
+World API

data/features/support/cassettes/forecast_for_latitude_and_longitude.yml

@@ -0,0 +1,60 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://api.forecast.io/forecast/API_KEY/-33.857444,151.238823,123456789
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      User-Agent:
+      - Faraday v0.8.7
+  response:
+    status:
+      code: 200
+      message: 
+    headers:
+      server:
+      - nginx/1.1.19
+      date:
+      - Thu, 02 May 2013 09:51:16 GMT
+      content-type:
+      - application/json; charset=utf-8
+      transfer-encoding:
+      - chunked
+      connection:
+      - close
+      x-powered-by:
+      - Express
+      cache-control:
+      - max-age=86400
+      expires:
+      - Fri, 03 May 2013 09:51:16 +0000
+      etag:
+      - '"-102868148"'
+      x-response-time:
+      - 113ms
+    body:
+      encoding: UTF-8
+      string: '{"latitude":-33.857444,"longitude":151.238823,"timezone":"Australia/Sydney","offset":11,"currently":{"time":123456789,"summary":"Partly
+        Cloudy","icon":"partly-cloudy-day","precipType":"rain","temperature":68.47,"dewPoint":58.01,"windSpeed":1.87,"windBearing":186,"cloudCover":0.25,"humidity":0.7,"pressure":1013.1,"visibility":10},"hourly":{"summary":"Partly
+        cloudy throughout the day.","icon":"partly-cloudy-day","data":[{"time":123426000,"summary":"Clear","icon":"clear-night","precipType":"rain","temperature":64.24,"dewPoint":53.66,"windSpeed":6.74,"windBearing":299,"cloudCover":0,"humidity":0.69},{"time":123429600,"summary":"Clear","icon":"clear-night","precipType":"rain","temperature":63.69,"dewPoint":53.33,"windSpeed":4.99,"windBearing":269,"cloudCover":0,"humidity":0.69},{"time":123433200,"summary":"Clear","icon":"clear-night","precipType":"rain","temperature":63.49,"dewPoint":52.61,"windSpeed":3.49,"windBearing":210,"cloudCover":0,"humidity":0.68},{"time":123436800,"summary":"Clear","icon":"clear-night","precipType":"rain","temperature":62.99,"dewPoint":52.07,"windSpeed":2.24,"windBearing":180,"cloudCover":0,"humidity":0.68},{"time":123440400,"summary":"Clear","icon":"clear-night","precipType":"rain","temperature":59,"dewPoint":52.15,"windSpeed":0,"cloudCover":0,"humidity":0.78,"pressure":1011.4,"visibility":10},{"time":123444000,"summary":"Clear","icon":"clear-night","precipType":"rain","temperature":59.58,"dewPoint":54.04,"windSpeed":0.62,"windBearing":293,"cloudCover":0.02,"humidity":0.82,"pressure":1011.4,"visibility":10},{"time":123447600,"summary":"Clear","icon":"clear-day","precipType":"rain","temperature":60.26,"dewPoint":55.72,"windSpeed":1.34,"windBearing":293,"cloudCover":0.07,"humidity":0.85},{"time":123451200,"summary":"Partly
+        Cloudy","icon":"partly-cloudy-day","precipType":"rain","temperature":57,"dewPoint":54.09,"windSpeed":0,"cloudCover":0.31,"humidity":0.9,"pressure":1013.1,"visibility":10},{"time":123454800,"summary":"Partly
+        Cloudy","icon":"partly-cloudy-day","precipType":"rain","temperature":64.24,"dewPoint":56.64,"windSpeed":1.12,"windBearing":186,"cloudCover":0.29,"humidity":0.78,"pressure":1013.1,"visibility":10},{"time":123458400,"summary":"Partly
+        Cloudy","icon":"partly-cloudy-day","precipType":"rain","temperature":71.89,"dewPoint":59.11,"windSpeed":2.48,"windBearing":186,"cloudCover":0.21,"humidity":0.64},{"time":123462000,"summary":"Clear","icon":"clear-day","precipType":"rain","temperature":72,"dewPoint":56.88,"windSpeed":3,"windBearing":210,"cloudCover":0,"humidity":0.59,"pressure":1016,"visibility":10},{"time":123465600,"summary":"Clear","icon":"clear-day","precipType":"rain","temperature":74,"dewPoint":56.54,"windSpeed":5.89,"windBearing":152,"cloudCover":0.14,"humidity":0.55,"pressure":1016,"visibility":10},{"time":123469200,"summary":"Partly
+        Cloudy","icon":"partly-cloudy-day","precipType":"rain","temperature":75.87,"dewPoint":56.21,"windSpeed":8.07,"windBearing":90,"cloudCover":0.31,"humidity":0.51},{"time":123472800,"summary":"Partly
+        Cloudy","icon":"partly-cloudy-day","precipType":"rain","temperature":75,"dewPoint":53.96,"windSpeed":3,"windBearing":90,"cloudCover":0.31,"humidity":0.48,"pressure":1016.1,"visibility":10},{"time":123476400,"summary":"Partly
+        Cloudy","icon":"partly-cloudy-day","precipType":"rain","temperature":75.28,"dewPoint":56.24,"windSpeed":8.45,"windBearing":88,"cloudCover":0.31,"humidity":0.52,"pressure":1016.1,"visibility":10},{"time":123480000,"summary":"Partly
+        Cloudy","icon":"partly-cloudy-day","precipType":"rain","temperature":75.82,"dewPoint":58.6,"windSpeed":13.8,"windBearing":86,"cloudCover":0.31,"humidity":0.55},{"time":123483600,"summary":"Partly
+        Cloudy","icon":"partly-cloudy-day","precipType":"rain","temperature":77,"dewPoint":56.92,"windSpeed":8,"windBearing":80,"cloudCover":0.31,"humidity":0.5,"pressure":1015.6,"visibility":10},{"time":123487200,"summary":"Partly
+        Cloudy","icon":"partly-cloudy-day","precipType":"rain","temperature":75.2,"dewPoint":57.66,"windSpeed":9.92,"windBearing":87,"cloudCover":0.31,"humidity":0.55,"pressure":1015.6,"visibility":10},{"time":123490800,"summary":"Partly
+        Cloudy","icon":"partly-cloudy-day","precipType":"rain","temperature":73,"dewPoint":59.2,"windSpeed":11.98,"windBearing":90,"cloudCover":0.31,"humidity":0.62},{"time":123494400,"summary":"Partly
+        Cloudy","icon":"partly-cloudy-day","precipType":"rain","temperature":72.15,"dewPoint":60.69,"windSpeed":10.94,"windBearing":78,"cloudCover":0.31,"humidity":0.67},{"time":123498000,"summary":"Partly
+        Cloudy","icon":"partly-cloudy-night","precipType":"rain","temperature":71.52,"dewPoint":62.46,"windSpeed":8.93,"windBearing":59,"cloudCover":0.31,"humidity":0.73},{"time":123501600,"summary":"Partly
+        Cloudy","icon":"partly-cloudy-night","precipType":"rain","temperature":71,"dewPoint":63.87,"windSpeed":7.23,"windBearing":45,"cloudCover":0.31,"humidity":0.78},{"time":123505200,"summary":"Partly
+        Cloudy","icon":"partly-cloudy-night","precipType":"rain","temperature":70.6,"dewPoint":64.68,"windSpeed":6.49,"windBearing":43,"cloudCover":0.31,"humidity":0.81},{"time":123508800,"summary":"Partly
+        Cloudy","icon":"partly-cloudy-night","precipType":"rain","temperature":70.31,"dewPoint":65.15,"windSpeed":6.04,"windBearing":41,"cloudCover":0.31,"humidity":0.84}]},"daily":{"data":[{"time":123426000,"summary":"Partly
+        cloudy throughout the day.","icon":"partly-cloudy-day","sunriseTime":123446333,"sunsetTime":123497495,"temperatureMin":57,"temperatureMinTime":123451200,"temperatureMax":77,"temperatureMaxTime":123483600,"dewPoint":57.19,"windSpeed":5.62,"windBearing":100,"cloudCover":0.2,"humidity":0.67,"pressure":1014.44,"visibility":10}]},"flags":{"sources":["isd"],"isd-stations":["947650-99999","947670-99999","947675-99999","947680-99999","949999-00242"],"units":"us"}}'
+    http_version: 
+  recorded_at: Thu, 02 May 2013 09:51:16 GMT
+recorded_with: VCR 2.4.0

data/features/support/config.rb

@@ -0,0 +1,9 @@
+require 'bson'
+
+Forecast::IO.configure do |config|
+  config.api_key = ENV['API_KEY']
+end
+
+Forecast::IO::Cache.configure do |config|
+  config.mongo_uri 'mongodb://localhost/forecast-test'
+end

data/features/support/env.rb

@@ -0,0 +1,2 @@
+ENV['RACK_ENV'] = 'test'
+ENV['API_KEY']  = 'API_KEY'

data/features/support/expect.rb

@@ -0,0 +1,9 @@
+module Expectation
+
+  def expect_ok
+    yield
+    expect(last_response.status).to eq 200
+  end
+
+end
+World Expectation

data/features/support/fixtures.rb

@@ -0,0 +1,20 @@
+require './features/support/mongo'
+module Fixtures
+
+  def setup attrs = {}
+    MongoAdaptor.db.collection('forecasts').insert(
+      {
+        "time"         => 123456789,
+        "position"     => [151.238823,-33.857444],
+        "wind_speed"   => 6.66,
+        "wind_bearing" => 200,
+        "humidity"     => 0.9,
+        "pressure"     => 1015.1,
+        "visibility"   => 13,
+        "temperature"  => 68.72
+      }.merge(attrs)
+    )
+  end
+
+end
+World Fixtures

data/features/support/mongo.rb

@@ -0,0 +1,5 @@
+require 'mongo-configure'
+
+After do
+  Mongo::Configure.current.load.collections.select { |c| c.name !~ /^system\./ }.each &:remove
+end

data/features/support/parse.rb

@@ -0,0 +1,14 @@
+module Parse
+
+  def parsed string
+    JSON.parse string
+  rescue JSON::ParserError
+    raise "Expected [#{string}] to be valid json"
+  end
+
+  def parsed_response
+    parsed last_response.body
+  end
+
+end
+World Parse

data/features/support/time.rb

@@ -0,0 +1,17 @@
+class Time
+  class << self
+    attr_accessor :stub_to
+
+    alias __now now
+    def now
+      stub_to || __now
+    end
+
+  end
+end
+
+Around '@time-frozen' do |scenario, block|
+  Time.stub_to = Time.at(123456789)
+  block.call
+  Time.stub_to = nil
+end

data/features/support/vcr.rb

@@ -0,0 +1,7 @@
+require 'vcr'
+
+VCR.configure do |c|
+  c.cassette_library_dir = "./features/support/cassettes"
+  c.hook_into :faraday
+  c.allow_http_connections_when_no_cassette = false
+end

data/forecast_io-cache.gemspec

@@ -0,0 +1,36 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'forecast_io/cache/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "forecast_io-cache"
+  spec.version       = Forecast::IO::Cache::VERSION
+  spec.authors       = ["Jon Rowe"]
+  spec.email         = ["hello@jonrowe.co.uk"]
+  spec.description   = %q{Caching layer for forecast_io}
+  spec.summary       = %q{Caching layer for forecast_io}
+  spec.homepage      = "https://github.com/Tacktical/forecast_io-cache"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files lib/** spec/** features/** LICENSE.txt README.md forecast_io-cache.gemspec`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_runtime_dependency "forecast_io"
+  spec.add_runtime_dependency "sinatra"
+  spec.add_runtime_dependency "mongo_adaptor"
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "rspec"
+  spec.add_development_dependency "cucumber"
+  spec.add_development_dependency "rack-test"
+  spec.add_development_dependency "vcr"
+
+  spec.add_development_dependency "mongo"
+  spec.add_development_dependency "bson"
+  spec.add_development_dependency "bson_ext"
+
+end

data/lib/forecast_io/cache/app.rb

@@ -0,0 +1,35 @@
+require 'json'
+require 'sinatra/base'
+
+module Forecast
+  module IO
+    module Cache
+      class App < Sinatra::Base
+        LATITUDE = LONGITUDE = /(-?\d+(?:.\d+))/
+        TIME = /(\d+)/
+
+        get %r[/forecast/#{ENV['API_KEY']}/#{LATITUDE},#{LONGITUDE}(?:,#{TIME})?], provides: :json do |latitude,longitude,time|
+          respond_as_json 200, Forecast.new.for(latitude.to_f, longitude.to_f, (time || Time.now).to_i).to_json
+        end
+
+        not_found do
+          respond_as_json 404, status: 'Not Found', actions: actions
+        end
+
+        private
+
+          def respond_as_json code, body
+            [code, { "Content-Type" => "application/json" }, JSON.dump(body) ]
+          end
+
+          def actions
+            {
+              forecast:         "/forecast/:key/:latitude,:longitude",
+              forecast_at_time: "/forecast/:key/:latitude,:longitude,:time"
+            }
+          end
+
+      end
+    end
+  end
+end

data/lib/forecast_io/cache/configuration.rb

@@ -0,0 +1,25 @@
+require 'mongo-configure'
+
+module Forecast
+  module IO
+    module Cache
+      class Configuration
+
+        attr_writer :radius, :timeframe
+
+        def radius
+          @radius ||= 5
+        end
+
+        def timeframe
+          @timeframe ||= 60
+        end
+
+        def mongo_uri uri
+          Mongo::Configure.from_uri uri
+        end
+
+      end
+    end
+  end
+end

data/lib/forecast_io/cache/forecast.rb

@@ -0,0 +1,26 @@
+module Forecast
+  module IO
+    module Cache
+      class Forecast
+
+        def initialize cache = Store.new, generate = Generate
+          @cache, @generate = cache, generate
+        end
+
+        def for lat, lon, time
+          cached(lat, lon, time) or fetch_and_store(lat, lon, time)
+        end
+
+        private
+          def cached lat, lon, time
+            @cache.fetch lat, lon, time
+          end
+
+          def fetch_and_store lat, lon, time
+            @generate.for lat, lon, time, @cache
+          end
+
+      end
+    end
+  end
+end

data/lib/forecast_io/cache/forecast_data.rb

@@ -0,0 +1,37 @@
+module Forecast
+  module IO
+    module Cache
+      class ForecastData < Struct.new(:position, :time, :wind_speed, :wind_bearing,
+                                      :humidity, :pressure, :visibility, :temperature)
+
+        def self.generate lat, lon, time, forecast
+          new.tap do |data|
+            data.time     = time
+            data.position = [lon,lat].map(&:to_f)
+            data.wind_speed       = forecast['windSpeed']
+            data.wind_bearing     = forecast['windBearing']
+            data.humidity         = forecast['humidity']
+            data.pressure         = forecast['pressure']
+            data.visibility       = forecast['visibility']
+            data.temperature      = forecast['temperature']
+          end
+        end
+
+        def to_json
+          {
+            time:         time,
+            latitude:     position[1],
+            longitude:    position[0],
+            wind_speed:   wind_speed,
+            wind_bearing: wind_bearing,
+            humidity:     humidity,
+            pressure:     pressure,
+            visibility:   visibility,
+            temperature:  temperature
+          }
+        end
+
+      end
+    end
+  end
+end

data/lib/forecast_io/cache/generate.rb

@@ -0,0 +1,42 @@
+require 'forecast_io/cache/forecast_data'
+
+module Forecast
+  module IO
+    module Cache
+      class Generate
+
+        def self.for lat, lon, time, cache
+          new(lat, lon, time, cache).forecasts.first
+        end
+
+        def initialize lat, lon, time, cache, api = ::Forecast::IO
+          @lat, @lon, @time, @cache, @api = lat, lon, time, cache, api
+        end
+
+        def forecasts
+          ([current] + hourly).map do |forecast|
+            @cache.store generate forecast
+          end
+        end
+
+        private
+          def current
+            forecast["currently"]
+          end
+
+          def hourly
+            forecast["hourly"]["data"]
+          end
+
+          def forecast
+            @forecast ||= @api.forecast @lat, @lon, time: @time
+          end
+
+          def generate data
+            ForecastData.generate @lat, @lon, @time, data
+          end
+
+      end
+    end
+  end
+end

data/lib/forecast_io/cache/store.rb

@@ -0,0 +1,50 @@
+require 'mongo_adaptor'
+require 'forecast_io/cache/forecast_data'
+
+module Forecast
+  module IO
+    module Cache
+      class Store
+
+        def initialize config = Cache.configuration
+          @config = config
+          @backend = MongoAdaptor.new('forecasts',ForecastData)
+        end
+
+        def fetch lat, lon, time
+          @backend.fetch 'position' => { '$near' => [lon,lat], '$maxDistance' => radius },
+                         'time' => { '$lt' => time+offset, '$gt' => time-offset }
+        rescue Mongo::OperationFailure => error
+          if index_error? error
+            ensure_index!
+            retry
+          else
+            raise
+          end
+        end
+
+        def store forecast
+          @backend.insert forecast
+          forecast
+        end
+
+        private
+          def radius
+            @config.radius * (1/111.694)
+          end
+
+          def offset
+            @config.timeframe*60
+          end
+
+          def index_error? error
+            error.message =~ /can't find any special indices/
+          end
+
+          def ensure_index!
+            MongoAdaptor.db.collection('forecasts').ensure_index position: Mongo::GEO2D
+          end
+      end
+    end
+  end
+end

data/lib/forecast_io/cache/version.rb

@@ -0,0 +1,7 @@
+module Forecast
+  module IO
+    module Cache
+      VERSION = "0.0.1"
+    end
+  end
+end

data/lib/forecast_io/cache.rb

@@ -0,0 +1,32 @@
+require 'forecast_io'
+require "forecast_io/cache/version"
+require "forecast_io/cache/configuration"
+require "forecast_io/cache/forecast"
+require "forecast_io/cache/store"
+require "forecast_io/cache/generate"
+require "forecast_io/cache/app"
+
+module Forecast
+  module IO
+    module Cache
+
+      def self.configure
+        yield configuration
+      end
+      def self.configuration
+        @config ||= Configuration.new
+      end
+
+
+      def self.initialize!
+        @app ||= App.new
+      end
+
+      def self.call env
+        initialize!
+        @app.call env
+      end
+
+    end
+  end
+end

data/lib/forecast_io-cache.rb

@@ -0,0 +1 @@
+require 'forecast_io/cache'

data/spec/forecast_io/cache/configuration_spec.rb

@@ -0,0 +1,30 @@
+require 'forecast_io/cache/configuration'
+
+describe 'service configuration' do
+
+  let(:config) { Forecast::IO::Cache::Configuration.new }
+
+  it 'has a radius default of 5' do
+    expect(config.radius).to eq 5
+  end
+
+  it 'has a configurable radius' do
+    config.radius = 12
+    expect(config.radius).to eq 12
+  end
+
+  it 'has a default timeframe of 60' do
+    expect(config.timeframe).to eq 60
+  end
+
+  it 'has a configurable timeframe' do
+    config.timeframe = 12
+    expect(config.timeframe).to eq 12
+  end
+
+  it 'loads mongo config urls' do
+    Mongo::Configure.should_receive(:from_uri).with 'mongodb://example.com'
+    config.mongo_uri 'mongodb://example.com'
+  end
+
+end

data/spec/forecast_io/cache/forecast_data_spec.rb

@@ -0,0 +1,32 @@
+require 'forecast_io/cache/forecast_data'
+
+describe 'representing data from the api' do
+  subject { Forecast::IO::Cache::ForecastData.generate "1.1", "-1.2", time, data }
+
+  let(:data) do
+    {
+      'windSpeed'       => wind_speed,
+      'windBearing'     => wind_bearing,
+      'humidity'        => humidity,
+      'temperature'     => temperature,
+      'pressure'        => pressure,
+      'visibility'      => visibility,
+      'percipIntensity' => percip_intensity
+    }
+  end
+
+  %W[time wind_speed wind_bearing humidity temperature pressure visibility percip_intensity].each do |name|
+    let(name) { double name }
+  end
+
+  its(:time)             { should eq time }
+  its(:position)         { should eq [-1.2,1.1] }
+  its(:wind_speed)       { wind_speed }
+  its(:wind_bearing)     { wind_bearing }
+  its(:humidity)         { humidity }
+  its(:temperature)      { temperature }
+  its(:pressure)         { pressure }
+  its(:visibility)       { visibility }
+  its(:precip_intensity) { percip_intensity }
+
+end

data/spec/forecast_io/cache/forecast_spec.rb

@@ -0,0 +1,41 @@
+require 'forecast_io/cache/forecast'
+
+describe 'producing a forecast' do
+
+  let(:forecast) { Forecast::IO::Cache::Forecast.new store, generate }
+
+  %w[generate lat lon time data store].map do |name|
+    let(name) { double name }
+  end
+
+  context 'when cached data exists' do
+    before { store.stub(:fetch).and_return data }
+
+    it 'checks the store for a previous cached result' do
+      store.should_receive(:fetch).with(lat, lon, time)
+      forecast.for lat, lon, time
+    end
+
+    it 'returns the cached result when it exists' do
+      expect(forecast.for lat, lon, time).to eq data
+    end
+  end
+
+  context 'when cached data doesnt exist' do
+    before do
+      generate.stub(:for).and_return data
+      store.stub(:fetch)
+    end
+
+    it 'checks the store for a previous cached result but then calls the generate' do
+      store.should_receive(:fetch).with(lat, lon, time)
+      generate.should_receive(:for).with(lat, lon, time, store)
+      forecast.for lat, lon, time
+    end
+
+    it 'returns the stored result' do
+      expect(forecast.for lat, lon, time).to eq data
+    end
+  end
+
+end

data/spec/forecast_io/cache/generate_spec.rb

@@ -0,0 +1,34 @@
+require 'forecast_io/cache/generate'
+
+describe 'generating new cached results' do
+
+  let(:generate) { Forecast::IO::Cache::Generate.new lat, lon, time, cache, api }
+  let(:api)      { double "api", forecast: data }
+  let(:data)     { { "currently" => "data_1", "hourly" => { "data" => ["data_2","data_3"] } } }
+
+  %w[lat lon time data_1 data_2 data_3 cache].each do |name|
+    let(name) { double name }
+  end
+
+  before do
+    Forecast::IO::Cache::ForecastData.stub(:generate) { |lat,lon,time,data| send data }
+    cache.stub(:store) { |data| data }
+  end
+
+  it 'gets the forecast from the api' do
+    api.should_receive(:forecast).with(lat,lon,time: time)
+    generate.forecasts
+  end
+
+  it 'stores the current forecast and all the hourlies' do
+    cache.should_receive(:store).with(data_1)
+    cache.should_receive(:store).with(data_2)
+    cache.should_receive(:store).with(data_3)
+    generate.forecasts
+  end
+
+  it 'returns the forecasts' do
+    expect(generate.forecasts).to eq [data_1,data_2,data_3]
+  end
+
+end

data/spec/forecast_io/cache/store_spec.rb

@@ -0,0 +1,37 @@
+require 'support/mongo'
+require 'forecast_io/cache/store'
+
+describe database: true do
+  let(:config) { double radius: 1, timeframe: 3 }
+  let(:store)  { Forecast::IO::Cache::Store.new config }
+  let(:data)   { Forecast::IO::Cache::ForecastData }
+
+  describe 'retrieving forecasts from the store' do
+    let(:forecast_1) { data.new [151.23775,-33.858264], 1 }
+    let(:forecast_2) { data.new [151.23675,-33.858664], 3 }
+
+    before do
+      store.store forecast_1
+      store.store forecast_2
+    end
+
+    it 'will return the closet forecast' do
+      expect(store.fetch -33.858254, 151.23775, 3).to eq forecast_1
+    end
+    it 'will return a forecast nearby' do
+      expect(store.fetch -33.858254, 151.23780, 2).to eq forecast_1
+    end
+    it 'will not return a forecast outside the time params' do
+      expect(store.fetch -33.858254, 151.23780, 200).to eq nil
+    end
+  end
+
+  describe 'inserting forecasts into the store' do
+    let(:forecast) { data.new [151.23775,-33.858264], 1 }
+
+    it 'returns the forecast' do
+      expect(store.store forecast).to eq forecast
+    end
+  end
+
+end

data/spec/forecast_io/cache_spec.rb

@@ -0,0 +1,15 @@
+require 'forecast_io/cache'
+
+describe 'Forecast::IO caching service' do
+
+  it 'is configurable by a block' do
+    Forecast::IO::Cache.configure { |config| @config = config }
+    expect(@config).to be_a Forecast::IO::Cache::Configuration
+  end
+
+  it 'is retrievable' do
+    Forecast::IO::Cache.configure { |config| @config = config }
+    expect(Forecast::IO::Cache.configuration).to eq @config
+  end
+
+end

data/spec/support/mongo.rb

@@ -0,0 +1,11 @@
+require 'mongo-configure'
+
+Mongo::Configure.from_database 'forecast-test-spec'
+
+RSpec.configure do |config|
+
+  config.after :each, database: true do
+    Mongo::Configure.current.load.collections.select { |c| c.name !~ /^system\./ }.each &:remove
+  end
+
+end

metadata

@@ -0,0 +1,291 @@
+--- !ruby/object:Gem::Specification
+name: forecast_io-cache
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Jon Rowe
+autorequire: 
+bindir: bin
+cert_chain:
+- |
+  -----BEGIN CERTIFICATE-----
+  MIIDVjCCAj6gAwIBAgIBADANBgkqhkiG9w0BAQUFADBRMQ4wDAYDVQQDDAVoZWxs
+  bzEXMBUGCgmSJomT8ixkARkWB2pvbnJvd2UxEjAQBgoJkiaJk/IsZAEZFgJjbzES
+  MBAGCgmSJomT8ixkARkWAnVrMB4XDTEzMDIwMzA4MTgwNloXDTE0MDIwMzA4MTgw
+  NlowUTEOMAwGA1UEAwwFaGVsbG8xFzAVBgoJkiaJk/IsZAEZFgdqb25yb3dlMRIw
+  EAYKCZImiZPyLGQBGRYCY28xEjAQBgoJkiaJk/IsZAEZFgJ1azCCASIwDQYJKoZI
+  hvcNAQEBBQADggEPADCCAQoCggEBAMhs6ng/SRrYfG7RtQx8liJTZs8tpz7PBnlH
+  qyOwuU0weJc7nh6C9C8LGyJzpkbjJJo1rfTMg7huDyL14Py82dfMDomApif8jNNI
+  8KtviAgB1DrWq0fCDLtu/M77+yuVV3OhDdrAFaBkT/euvdJ8cAKrLxbJ+klgvrcB
+  FK+c4PUV3/zBKghe0l7FuDhyQCsuLNDbWyFvDS97tPjeN6yWuszwg22vZMDdsuzN
+  Cj3M4LLSkbrt+AOUcysEJxI4t6uv2U1bRzHsDfAF0RI/Q7OMtUr+Dtz/2YJ47KKs
+  51ZRjLLGHd10XrIfFSfGyJj1dMbDgLsEBj1sFH4e6dy7gau8TaUCAwEAAaM5MDcw
+  CQYDVR0TBAIwADAdBgNVHQ4EFgQULu5JH2g7RAjoXaZt+fbrfNDI9IkwCwYDVR0P
+  BAQDAgSwMA0GCSqGSIb3DQEBBQUAA4IBAQAf5A4kB769DPKGjPZ++v42FwVi7X7v
+  RpufPs6R4YHyzHXaJmAqnhleZhVJijBgsdb2SigNRbg+IK8XYHg7jkonMgO8OS3D
+  C6w8VB5bI0PqyDOwCGcQkYHYlZZWCghAyBTSBowHAekMb9V3QjJtJ8XkizjshETO
+  ZCVI2AObjlJi8I10aK2tSo9sv2riCKZ92BVSM13zYWn+C/eCP/m9BDiw37UQtuQq
+  2feWfO4gCNmvfFjULOAYHq9JHEjN5SLSXvj5HdSnDcCyIfJKn5Ya3JahWQaWIsXf
+  /NPE/mB57TOwj+d7XUa2NC4HUadF8R51IYEcIB0PpIEzJlKtfXFcOZxO
+  -----END CERTIFICATE-----
+date: 2013-05-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: forecast_io
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: sinatra
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: mongo_adaptor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: cucumber
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rack-test
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: vcr
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: mongo
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bson
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bson_ext
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Caching layer for forecast_io
+email:
+- hello@jonrowe.co.uk
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.txt
+- README.md
+- features/accessing_a_forecast.feature
+- features/accessing_a_forecast_at_a_specific_time.feature
+- features/accessing_the_api.feature
+- features/step_definitions/api_steps.rb
+- features/step_definitions/cache_steps.rb
+- features/step_definitions/forecast_steps.rb
+- features/support/api.rb
+- features/support/cassettes/forecast_for_latitude_and_longitude.yml
+- features/support/config.rb
+- features/support/env.rb
+- features/support/expect.rb
+- features/support/fixtures.rb
+- features/support/mongo.rb
+- features/support/parse.rb
+- features/support/time.rb
+- features/support/vcr.rb
+- forecast_io-cache.gemspec
+- lib/forecast_io-cache.rb
+- lib/forecast_io/cache.rb
+- lib/forecast_io/cache/app.rb
+- lib/forecast_io/cache/configuration.rb
+- lib/forecast_io/cache/forecast.rb
+- lib/forecast_io/cache/forecast_data.rb
+- lib/forecast_io/cache/generate.rb
+- lib/forecast_io/cache/store.rb
+- lib/forecast_io/cache/version.rb
+- spec/forecast_io/cache/configuration_spec.rb
+- spec/forecast_io/cache/forecast_data_spec.rb
+- spec/forecast_io/cache/forecast_spec.rb
+- spec/forecast_io/cache/generate_spec.rb
+- spec/forecast_io/cache/store_spec.rb
+- spec/forecast_io/cache_spec.rb
+- spec/support/mongo.rb
+homepage: https://github.com/Tacktical/forecast_io-cache
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.3
+signing_key: 
+specification_version: 4
+summary: Caching layer for forecast_io
+test_files:
+- features/accessing_a_forecast.feature
+- features/accessing_a_forecast_at_a_specific_time.feature
+- features/accessing_the_api.feature
+- features/step_definitions/api_steps.rb
+- features/step_definitions/cache_steps.rb
+- features/step_definitions/forecast_steps.rb
+- features/support/api.rb
+- features/support/cassettes/forecast_for_latitude_and_longitude.yml
+- features/support/config.rb
+- features/support/env.rb
+- features/support/expect.rb
+- features/support/fixtures.rb
+- features/support/mongo.rb
+- features/support/parse.rb
+- features/support/time.rb
+- features/support/vcr.rb
+- spec/forecast_io/cache/configuration_spec.rb
+- spec/forecast_io/cache/forecast_data_spec.rb
+- spec/forecast_io/cache/forecast_spec.rb
+- spec/forecast_io/cache/generate_spec.rb
+- spec/forecast_io/cache/store_spec.rb
+- spec/forecast_io/cache_spec.rb
+- spec/support/mongo.rb