Imported from archive.
* Release 1.4. * (all): Updated the copyright years for 2008 on some of the files in the current release and added a copyright statement to any files previously lacking one. * LICENSE: Replaced the previous BSD-like license with the one used by the OpenBSD project (modeled after the Internet Software Consortium's, a two-clause BSD license removing language made unnecessary by the Berne convention); this new license is functionally identical to the old one, just more terse and openly recognized. * weather: Clarified function parameters in calls from the wrapper script to ease future ABI changes in the underlying module. * weather, weather.py: Some extra comments were added to the source, indentation style was updated from tab characters to three-space, and lines longer than 79 columns were refactored or otherwise split. * weather.1, weather.5, weather.py: Added an flines option to allow the maximum number of forecast output lines to be shortened. Added furl and murl options to allow overriding of the default current conditions and forecast data retrieval URLs. Added a headers option to allow overriding the default list of header names for current conditions data filtering. Added a quiet option to suppress the preamble lines and indentation for both current conditions and forecast output. * weather.py: Replaced the hardcoded fallback default METAR station ID and forecast city/state abbreviation with error messages to minimize confusion when necessary values are omitted. Adjusted a couple of hard-coded error message strings to be consistent with the output format of the option_parser module. Switched from urllib to urllib2 for retrieving data, providing a simpler means to detect and report retrieval errors. Upped the version to 1.4.
This commit is contained in:
35
README
35
README
@@ -1,7 +1,9 @@
|
||||
GENERAL INFORMATION ABOUT THE WEATHER UTILITY
|
||||
|
||||
Copyright (c) 2006 Jeremy Stanley <fungi@yuggoth.org>, all rights reserved.
|
||||
Licensed per terms in the LICENSE file distributed with this software.
|
||||
Copyright (c) 2006-2008 Jeremy Stanley <fungi@yuggoth.org>.
|
||||
Permission to use, copy, modify, and distribute this software is
|
||||
granted under terms provided in the LICENSE file distributed with
|
||||
this software.
|
||||
|
||||
|
||||
WHAT?
|
||||
@@ -10,24 +12,24 @@ This command-line utility is intended to provide quick access to
|
||||
current weather conditions and forecasts. Presently, it is
|
||||
capable of returning data for localities throughout the USA by
|
||||
retrieving and formatting decoded METARs (Meteorological
|
||||
Aerodrome Reports) from NOAA (the National Oceanic and
|
||||
Atmospheric Administration) and forecasts from the NWS (National
|
||||
Weather Service). The tool is written to function in the same
|
||||
spirit as other command-line informational utilities like cal(1),
|
||||
calendar(1) and dict(1). It can retrieve arbitrary weather data
|
||||
via specific command-line switches (station ID, city, state), or
|
||||
aliases can be configured system wide and on a per-user basis. It
|
||||
can be freely used and redistributed under the terms of the BSD
|
||||
License.
|
||||
Aerodrome Reports) from NOAA (the USA National Oceanic and
|
||||
Atmospheric Administration) and forecasts from NWS (the USA
|
||||
National Weather Service). The tool is written to function in the
|
||||
same spirit as other command-line informational utilities like
|
||||
cal(1), calendar(1) and dict(1). It can retrieve arbitrary weather
|
||||
data via specific command-line switches (station ID, city, state),
|
||||
or aliases can be configured system wide and on a per-user basis.
|
||||
It can be freely used and redistributed under the terms of a
|
||||
BSD-like License.
|
||||
|
||||
|
||||
WHY?
|
||||
|
||||
My girlfriend has a long commute to/from work and school, and
|
||||
often wants to check the weather both for home and her office.
|
||||
My girlfriend had a long commute to/from work and school, and
|
||||
often wanted to check the weather both for home and her office.
|
||||
Unfortunately, starting a Web browser, pulling up a weather site,
|
||||
entering multiple ZIP codes and waiting for them to load is
|
||||
time-consuming for the marginally-impatient. Since she tends to
|
||||
time-consuming for the marginally-impatient. Since she tended to
|
||||
stay logged into a shell server most of the time, I figured I'd
|
||||
install a quick command-line tool to retrieve weather info for
|
||||
her commute, but to my surprise, a quick search turned up little
|
||||
@@ -47,6 +49,5 @@ be had here:
|
||||
|
||||
http://fungi.yuggoth.org/weather/src/
|
||||
|
||||
Alternatively, Debian Etch (testing) and Sid (unstable) users can
|
||||
install the weather-util package from any mirror.
|
||||
|
||||
Alternatively, Debian users can install the weather-util package
|
||||
from any mirror.
|
||||
|
||||
Reference in New Issue
Block a user