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:
Jeremy Stanley
2008-07-13 07:49:02 +00:00
parent eb249a0ae2
commit 8349654b7c
9 changed files with 434 additions and 263 deletions

35
README
View File

@@ -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.