🚀

README.md

@@ -0,0 +1,35 @@
+# Forecast Workflow for Alfred
+
+![screenshot][screenshot]
+
+[screenshot]: http://i.imgur.com/enspDWu.png
+
+# Requirements
+
+- [Alfred](http://www.alfredapp.com/)
+- [Alfred Powerpack](http://www.alfredapp.com/powerpack/)
+- OS X Mavericks
+
+# Installation
+
+Install the workflow. Edit the script filter to add your location and API keys:
+
+- FORECAST_API_KEY: Get an API key [here][forecast-api-key].
+- GOOGLE_API_KEY: Get an API key [here][google-api-key]. Only required if
+  getting the forecast for an arbitrary location.
+- DEFAULT_LOCATION
+- DEFAULT_LAT_LONG: Required if GOOGLE_API_KEY is not used. Format: `lat,long`.
+
+[forecast-api-key]: https://developer.forecast.io/register
+[google-api-key]: https://developers.google.com/maps/documentation/geocoding/#api_key
+
+# TODO
+
+- Sparklines for precipitation?
+- Make installation easier
+- Handle errors gracefully
+- Caching? (Probably unnecessary...)
+
+# Attributions
+
+- Icons from [Climacons](http://adamwhitcroft.com/climacons/)

alfred.rb

@@ -0,0 +1,44 @@
+class Items < DelegateClass(Array)
+  attr_reader :items
+
+  def initialize
+    @items = []
+    super(@items)
+  end
+
+  def to_s
+    ERB.new(<<-XML).result(binding)
+<?xml version="1.0"?>
+<items>
+  <%= items.map {|item| item.to_s.split("\n").map {|line| '  ' << line }}.join("\n").strip %>
+</items>
+    XML
+  end
+end
+
+class Item
+  attr_reader *%i[ uid arg valid
+                   title subtitle icon ]
+  def initialize(**kwargs)
+    @uid = kwargs.fetch(:uid).to_s.encode(xml: :attr)
+    @arg = kwargs[:arg].to_s.encode(xml: :attr)
+    @valid = kwargs.fetch(:valid, false) ? 'yes' : 'no'
+    @title = kwargs.fetch(:title).encode(xml: :text)
+    @subtitle = kwargs[:subtitle] && kwargs[:subtitle].encode(xml: :text)
+    @icon = kwargs[:icon] && kwargs[:icon].encode(xml: :text)
+  end
+
+  def to_s
+    ERB.new(<<-XML, nil, '%>').result(binding)
+<item arg=<%= arg %> uid=<%= uid %> valid="<%= valid %>">
+  <title><%= title %></title>
+% if subtitle
+  <subtitle><%= subtitle %></subtitle>
+% end
+% if icon
+  <icon><%= icon %></icon>
+% end
+</item>
+    XML
+  end
+end

forecast.rb

@@ -0,0 +1,108 @@
+require 'delegate'
+require 'erb'
+require 'yaml'
+
+require_relative 'alfred'
+require_relative 'forecaster'
+require_relative 'location'
+
+ICONS = {
+  'clear-day' => 'Sun',
+  'clear-night' => 'Moon',
+  'rain' => 'Cloud-Rain',
+  'snow' => 'Cloud-Snow',
+  'sleet' => 'Cloud-Snow-Alt',
+  'wind' => 'Wind',
+  'fog' => 'Cloud-Fog',
+  'cloudy' => 'Cloud',
+  'partly-cloudy-day' => 'Cloud-Sun',
+  'partly-cloudy-night' => 'Cloud-Moon',
+}
+
+Precipitation = Struct.new(:intensity, :probability) do
+  def self.from_forecast(forecast)
+    self.new(*forecast.values_at('precipIntensity', 'precipProbability'))
+  end
+
+  def human_intensity
+    case intensity
+    when 0...0.002
+      'no'
+    when 0.002...0.017
+      'very light'
+    when 0.017...0.1
+      'light'
+    when 0.1...0.4
+      'moderate'
+    else
+      'heavy'
+    end
+  end
+
+  def to_s
+    "#{(probability*100).to_i}% chance of #{human_intensity} rain."
+  end
+end
+
+query = ARGV.shift || ''
+location = if query.empty?
+             lat, long = ENV.fetch('DEFAULT_LAT_LONG', '').split(?,)
+             Location.new(ENV['DEFAULT_LOCATION'], lat, long)
+           else
+             Location.new(query)
+           end
+forecast = Forecaster.forecast(location)
+
+items = Items.new
+
+items << Item.new(
+  uid: :location,
+  arg: "#{location.lat.round(4)},#{location.long.round(4)}",
+  valid: true,
+  title: location.name,
+  icon: 'icons/forecast.ico',
+)
+
+currently = forecast['currently']
+precip = Precipitation.from_forecast(currently)
+subtitle = [ "#{currently['temperature'].round}°" ]
+subtitle << "Feels like #{currently['apparentTemperature'].round}°"
+subtitle << precip.to_s if precip.probability > 0
+items << Item.new(
+  uid: :currently,
+  title: currently['summary'],
+  subtitle: subtitle.join(' · '),
+  icon: "icons/#{ICONS[currently['icon']]}.png",
+)
+
+minutely = forecast['minutely']
+items << Item.new(
+  uid: :minutely,
+  title: minutely['summary'],
+  icon: "icons/#{ICONS[minutely['icon']]}.png",
+)
+
+hourly = forecast['hourly']
+items << Item.new(
+  uid: :hourly,
+  title: hourly['summary'],
+  icon: "icons/#{ICONS[hourly['icon']]}.png",
+)
+
+forecast['daily']['data'][1..6].each do |data|
+  wday = Time.at(data['time']).strftime('%A')
+  precip = Precipitation.from_forecast(data)
+
+  subtitle = [ "Low: #{data['apparentTemperatureMin'].round}°",
+               "High: #{data['apparentTemperatureMax'].round}°" ]
+  subtitle << precip.to_s if precip.probability > 0
+
+  items << Item.new(
+    uid: wday,
+    title: "#{wday} - #{data['summary']}",
+    subtitle: subtitle.join(' · '),
+    icon: "icons/#{ICONS[data['icon']]}.png",
+  )
+end
+
+puts items.to_s

forecaster.rb

@@ -0,0 +1,21 @@
+require 'json'
+require 'open-uri'
+
+Forecaster = Struct.new(:api_key) do
+  def self.forecast(location)
+    forecaster.forecast(location)
+  end
+
+  def self.forecaster
+    return @forecaster if defined?(@forecaster)
+
+    @forecaster = self.new(ENV['FORECAST_API_KEY'])
+  end
+
+  def forecast(location)
+    lat, long = location.lat, location.long
+    url = "https://api.forecast.io/forecast/#{api_key}/#{lat},#{long}"
+    response = JSON.load(open(url))
+  end
+end
+

geocoder.rb

@@ -0,0 +1,28 @@
+require 'json'
+require 'open-uri'
+require 'uri'
+
+Geocoder = Struct.new(:api_key) do
+  def self.geocode(location)
+    geocoder.geocode(location)
+  end
+
+  def self.geocoder
+    return @geocoder if defined?(@geocoder)
+
+    @geocoder = self.new(ENV['GOOGLE_API_KEY'])
+  end
+
+  def geocode(location)
+    url = 'https://maps.googleapis.com/maps/api/geocode/json'
+    query = URI.encode_www_form(address: location, api_key: api_key)
+    response = JSON.load(open("#{url}?#{query}"))
+    result = response['results'][0]
+
+    name = result['formatted_address']
+    location = result['geometry']['location']
+    lat, long = location.values_at('lat', 'lng')
+
+    [name, lat, long]
+  end
+end

info.plist

@@ -0,0 +1,100 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>bundleid</key>
+	<string>com.kejadlen.forecast</string>
+	<key>category</key>
+	<string>Internet</string>
+	<key>connections</key>
+	<dict>
+		<key>2A5C0A87-204E-49EA-94A7-8E62BB4EFD8A</key>
+		<array>
+			<dict>
+				<key>destinationuid</key>
+				<string>5E2D96BA-31B2-4800-9A2B-B999285680A0</string>
+				<key>modifiers</key>
+				<integer>0</integer>
+				<key>modifiersubtext</key>
+				<string></string>
+			</dict>
+		</array>
+	</dict>
+	<key>createdby</key>
+	<string>Alpha Chen</string>
+	<key>description</key>
+	<string></string>
+	<key>disabled</key>
+	<false/>
+	<key>name</key>
+	<string>Forecast</string>
+	<key>objects</key>
+	<array>
+		<dict>
+			<key>config</key>
+			<dict>
+				<key>plusspaces</key>
+				<false/>
+				<key>url</key>
+				<string>http://forecast.io/#/f/{query}</string>
+				<key>utf8</key>
+				<true/>
+			</dict>
+			<key>type</key>
+			<string>alfred.workflow.action.openurl</string>
+			<key>uid</key>
+			<string>5E2D96BA-31B2-4800-9A2B-B999285680A0</string>
+			<key>version</key>
+			<integer>0</integer>
+		</dict>
+		<dict>
+			<key>config</key>
+			<dict>
+				<key>argumenttype</key>
+				<integer>1</integer>
+				<key>escaping</key>
+				<integer>127</integer>
+				<key>keyword</key>
+				<string>forecast</string>
+				<key>runningsubtext</key>
+				<string>Retriving location/weather...</string>
+				<key>script</key>
+				<string>export FORECAST_API_KEY=
+export GOOGLE_API_KEY=
+export DEFAULT_LOCATION="Seattle, WA"
+
+ruby forecast.rb {query}</string>
+				<key>title</key>
+				<string>Forecast</string>
+				<key>type</key>
+				<integer>0</integer>
+				<key>withspace</key>
+				<true/>
+			</dict>
+			<key>type</key>
+			<string>alfred.workflow.input.scriptfilter</string>
+			<key>uid</key>
+			<string>2A5C0A87-204E-49EA-94A7-8E62BB4EFD8A</string>
+			<key>version</key>
+			<integer>0</integer>
+		</dict>
+	</array>
+	<key>readme</key>
+	<string></string>
+	<key>uidata</key>
+	<dict>
+		<key>2A5C0A87-204E-49EA-94A7-8E62BB4EFD8A</key>
+		<dict>
+			<key>ypos</key>
+			<real>10</real>
+		</dict>
+		<key>5E2D96BA-31B2-4800-9A2B-B999285680A0</key>
+		<dict>
+			<key>ypos</key>
+			<real>10</real>
+		</dict>
+	</dict>
+	<key>webaddress</key>
+	<string>http://github.com/kejadlen/forecast.workflow</string>
+</dict>
+</plist>

location.rb

@@ -0,0 +1,16 @@
+require_relative 'geocoder'
+
+class Location
+  attr_accessor :name, :lat, :long, :geocoder
+
+  def initialize(name, lat=nil, long=nil, geocoder=Geocoder)
+    @name, @lat, @long, @geocoder = name, lat, long, geocoder
+
+    geocode! unless lat && long
+  end
+
+  def geocode!
+    self.name, self.lat, self.long = geocoder.geocode(name)
+  end
+end
+

spark.rb

@@ -0,0 +1,17 @@
+class Spark
+  TICKS = %w[▁ ▂ ▃ ▄ ▅ ▆ ▇ █]
+
+  attr_reader :data
+
+  def initialize(*data)
+    @data = data
+  end
+
+  def to_s
+    min = data.min
+    max = data.max
+    range = (max - min).to_f
+    graph = data.map {|i| TICKS[(TICKS.size - 1) * (i - min) / range] }.join
+    "#{min} #{graph} #{max}"
+  end
+end