weather-sage 0.1.0 → 0.1.1

data/lib/weather-sage/weather/period.rb

@@ -0,0 +1,44 @@
+#
+# Numerical weather forecast period.
+#
+class WeatherSage::Weather::Period
+  attr :data,
+       :name,
+       :start_time,
+       :end_time,
+       :is_daytime,
+       :temperature,
+       :temperature_unit,
+       :temperature_trend,
+       :wind_speed,
+       :wind_direction,
+       :icon,
+       :short_forecast,
+       :detailed_forecast
+
+  #
+  # Create new forecast period from given data.
+  #
+  def initialize(ctx, data)
+    @ctx = ctx
+    @data = data.freeze
+
+    # log data
+    @ctx.log.debug('Period#initialize') do
+      'data = %p' % [data]
+    end
+
+    @name = data['name']
+    @start_time = Time.parse(data['startTime'])
+    @end_time = Time.parse(data['endTime'])
+    @is_daytime = data['isDaytime']
+    @temperature = data['temperature']
+    @temperature_unit = data['temperatureUnit']
+    @temperature_trend = data['temperatureTrend']
+    @wind_speed = data['windSpeed']
+    @wind_direction = data['windDirection']
+    @icon = data['icon']
+    @short_forecast = data['shortForecast']
+    @detailed_forecast = data['detailedForecast']
+  end
+end

data/lib/weather-sage/weather/point.rb

@@ -0,0 +1,71 @@
+#
+# Thin wrapper around lat/long point in weather API.
+#
+class WeatherSage::Weather::Point < WeatherSage::Weather::BaseObject
+  attr :x, :y
+
+  #
+  # Create a new Point object at the given longitude +x+ and latitude
+  # +y+.
+  #
+  def initialize(ctx, x, y)
+    super(ctx)
+    @x, @y = x, y
+  end
+
+  #
+  # Returns a list of weather stations near this point.
+  #
+  def stations
+    # build request path
+    path = 'points/%2.4f%%2C%2.4f/stations' % [@y, @x]
+
+    get(path)['features'].map { |row|
+      WeatherSage::Weather::Station.from_json(@ctx, row)
+    }
+  end
+
+  #
+  # Returns a hash of properties for this point.
+  #
+  def properties
+    # build request path
+    path = 'points/%2.4f%%2C%2.4f' % [@y, @x]
+
+    # execute request, return properties
+    get(path)['properties']
+  end
+
+  #
+  # Returns a weather forecast for this point.
+  #
+  def forecast
+    forecast_by_type('forecast')
+  end
+
+  #
+  # Returns an hourly weather forecast for this point.
+  #
+  def hourly_forecast
+    forecast_by_type('forecastHourly')
+  end
+
+  private
+
+  #
+  # Get forecast type from properties.
+  #
+  # Remove the scheme, host, and leading slash from the URL provided
+  # in the properties.
+  #
+  def forecast_by_type(forecast_type)
+    # parse URI for given request type
+    uri = URI.parse(properties[forecast_type])
+
+    # strip scheme, host, and leading slash from URI to build path
+    path = uri.path.gsub(/^\//, '')
+
+    # request forecast and build a Forecast object from it
+    ::WeatherSage::Weather::Forecast.new(@ctx, get(path))
+  end
+end

data/lib/weather-sage/weather/station.rb

@@ -0,0 +1,43 @@
+#
+# Thin wrapper around weather station.
+#
+class WeatherSage::Weather::Station < ::WeatherSage::Weather::BaseObject
+  attr :id, :name, :x, :y, :elevation, :time_zone
+
+  #
+  # Create a new Station from the given Context +ctx+ and the JSON
+  # data +row+.
+  #
+  def self.from_json(ctx, row)
+    new(
+      ctx,
+      row['properties']['stationIdentifier'],
+      row['properties']['name'],
+      row['geometry']['coordinates'][0],
+      row['geometry']['coordinates'][1],
+      row['properties']['elevation']['value'],
+      row['properties']['timeZone']
+    )
+  end
+
+  #
+  # Create a new station instance.
+  #
+  def initialize(ctx, id, name, x, y, elevation, time_zone)
+    @ctx = ctx
+    @id = id
+    @name = name
+    @x = x
+    @y = y
+    @elevation = elevation
+    @time_zone = time_zone
+  end
+
+  #
+  # Return a hash of the latest observations from this station.
+  #
+  def latest_observations
+    path = 'stations/%s/observations/latest' % [@id]
+    get(path)['properties']
+  end
+end

data/lib/weather-sage/weather.rb

@@ -0,0 +1,11 @@
+#
+# Thin wrapper around weather.gov API.
+#
+module WeatherSage::Weather
+  autoload :BaseObject, File.join(__dir__, 'weather', 'base-object.rb')
+  autoload :Observation, File.join(__dir__, 'weather', 'observation.rb')
+  autoload :Point, File.join(__dir__, 'weather', 'point.rb')
+  autoload :Station, File.join(__dir__, 'weather', 'station.rb')
+  autoload :Forecast, File.join(__dir__, 'weather', 'forecast.rb')
+  autoload :Period, File.join(__dir__, 'weather', 'period.rb')
+end

data/lib/weather-sage.rb

@@ -10,7 +10,7 @@ module WeatherSage
   #
   # Release version.
   #
-  VERSION = '0.1.0'
+  VERSION = '0.1.1'
 
   # :nodoc:
   LIB_DIR = File.join(__dir__, 'weather-sage').freeze

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: weather-sage
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Paul Duncan
@@ -15,7 +15,8 @@ description: "\n    Ruby library and command-line tool to get the weather foreca
   Geocoding API to geocode street addresses,\n    and the National Weather Service
   Weather API to get weather\n    forecasts and current weather observations.\n  "
 email: pabs@pablotron.org
-executables: []
+executables:
+- weather-sage
 extensions: []
 extra_rdoc_files: []
 files:
@@ -23,8 +24,43 @@ files:
 - Rakefile
 - bin/weather-sage
 - lib/weather-sage.rb
+- lib/weather-sage/cache-entry.rb
+- lib/weather-sage/cache.rb
+- lib/weather-sage/census.rb
+- lib/weather-sage/census/geocoder.rb
+- lib/weather-sage/census/match.rb
+- lib/weather-sage/cli.rb
+- lib/weather-sage/cli/commands.rb
+- lib/weather-sage/cli/commands/base-forecast.rb
+- lib/weather-sage/cli/commands/command.rb
+- lib/weather-sage/cli/commands/forecast.rb
+- lib/weather-sage/cli/commands/geocode.rb
+- lib/weather-sage/cli/commands/help.rb
+- lib/weather-sage/cli/commands/hourly.rb
+- lib/weather-sage/cli/commands/now.rb
+- lib/weather-sage/cli/commands/stations.rb
+- lib/weather-sage/cli/env.rb
+- lib/weather-sage/cli/env/cache.rb
+- lib/weather-sage/cli/env/context.rb
+- lib/weather-sage/cli/env/env.rb
+- lib/weather-sage/cli/env/log.rb
+- lib/weather-sage/cli/env/vars.rb
+- lib/weather-sage/cli/forecast.rb
+- lib/weather-sage/cli/help.rb
+- lib/weather-sage/context.rb
+- lib/weather-sage/http.rb
+- lib/weather-sage/http/cache.rb
+- lib/weather-sage/http/error.rb
+- lib/weather-sage/http/fetcher.rb
+- lib/weather-sage/http/parser.rb
+- lib/weather-sage/weather.rb
+- lib/weather-sage/weather/base-object.rb
+- lib/weather-sage/weather/forecast.rb
+- lib/weather-sage/weather/observation.rb
+- lib/weather-sage/weather/period.rb
+- lib/weather-sage/weather/point.rb
+- lib/weather-sage/weather/station.rb
 - license.txt
-- test/make-csvs.sh
 - test/test-cache.rb
 - test/test-census-geocoder.rb
 - test/test-helpers.rb

data/test/make-csvs.sh

@@ -1,10 +0,0 @@
-#!/bin/sh
-
-# TODO: move to rake task
-ADDR='7309 carol ln falls church va 22042'
-
-bin/weather-sage hourly -f "$ADDR" > hourly-full.csv
-bin/weather-sage hourly -b "$ADDR" > hourly-brief.csv
-bin/weather-sage forecast -b "$ADDR" > forecast-brief.csv
-bin/weather-sage forecast -f "$ADDR" > forecast-full.csv
-bin/weather-sage now "$ADDR" > now.csv