initial commit, including theme

1 files changed, 67 insertions, 0 deletions

diff --git a/content/posts/2019-08-25-weather-sage.md b/content/posts/2019-08-25-weather-sage.md
new file mode 100644
index 0000000..1153bd6
--- /dev/null
+++ b/content/posts/2019-08-25-weather-sage.md
@@ -0,0 +1,67 @@
+---
+date: "2019-08-25T22:00:00Z"
+title: Weather Sage 0.1.2 Released
+---
+
+A couple days ago I released [Weather Sage][] 0.1.2.
+
+[Weather Sage][] is a command-line tool and [Ruby][] library to get the
+weather forecast and current weather observations for a domestic United
+States street address.
+
+It uses the [Census Bureau Geocoding API][census-api] to geocode street
+addresses, and the [National Weather Service Weather API][weather-api]
+to get weather forecasts and current weather observations.
+
+The command-line tool queries the [APIs][] above to obtain the requested
+information for the given street address, and then prints the results to
+standard output in [CSV][] format.
+
+Here's an example of using the `weather-sage` command-line tool to get
+the weather forecast for the address `1600 pennsylvania ave nw,
+washington dc`:
+
+```
+> weather-sage forecast '1600 pennsylvania ave nw washington dc'
+address,name,temperature,temperature_unit,wind_speed,wind_direction,short_forecast
+1600 pennsylvania ave washington dc,Today,97,F,7 mph,SW,Scattered Showers And Thunderstorms
+1600 pennsylvania ave washington dc,Tonight,76,F,2 to 7 mph,SW,Scattered Showers And Thunderstorms then Mostly Cloudy
+1600 pennsylvania ave washington dc,Tuesday,94,F,6 mph,E,Slight Chance Rain Showers then Chance Showers And Thunderstorms
+1600 pennsylvania ave washington dc,Tuesday Night,75,F,2 to 6 mph,S,Chance Showers And Thunderstorms
+1600 pennsylvania ave washington dc,Wednesday,94,F,3 to 9 mph,SW,Chance Showers And Thunderstorms
+1600 pennsylvania ave washington dc,Wednesday Night,76,F,5 to 8 mph,SW,Chance Showers And Thunderstorms
+...
+```
+
+And here's an example of using the `weather-sage` command-line tool to
+get the current weather observations from the weather station closest to
+the address `1600 pennsylvania ave nw, washington dc`:
+
+```
+> weather-sage now '1600 pennsylvania ave washington dc'
+address,name,type,value,unit,quality_control
+1600 pennsylvania ave washington dc,timestamp,time,2019-08-19T06:52:00+00:00
+1600 pennsylvania ave washington dc,textDescription,text,Mostly Cloudy
+1600 pennsylvania ave washington dc,temperature,value,26.700000000000045,unit:degC,qc:V
+1600 pennsylvania ave washington dc,relativeHumidity,value,81.65039907186703,unit:percent,qc:C
+...
+```
+
+You can install [Weather Sage][] via [RubyGems][] like this:
+
+```
+# install weather-sage with rubygems
+> gem install weather-sage
+```
+
+**Note:** This is the initial release, so the API documentation, test
+suite, and command-line interface are not yet complete.
+
+  [weather sage]: https://github.com/pablotron/weather-sage "Weather Sage"
+  [apis]: https://en.wikipedia.org/wiki/Application_programming_interface "Application Programming Interface"
+  [csv]: https://en.wikipedia.org/wiki/Comma-separated_values "Comma-separated Value format"
+  [ruby]: https://ruby-lang.org/ "Ruby programming language"
+  [rubygems]: https://rubygems.org/ "Ruby package manager"
+  [weather-api]: https://api.weather.gov/ "national Weather Service (NWS) Weather API"
+  [census-api]: https://geocoding.geo.census.gov/geocoder/ "Census Bureau Geocoding API"
+