8349654b7c
* 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.
54 lines
2.0 KiB
Plaintext
54 lines
2.0 KiB
Plaintext
GENERAL INFORMATION ABOUT THE WEATHER UTILITY
|
|
|
|
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?
|
|
|
|
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 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 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 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
|
|
that met my basic requirements:
|
|
|
|
* retrieve current data on-demand
|
|
* provide both current conditions and short-term forecasts
|
|
* simple, human-readable output
|
|
* easy to configure and use
|
|
* flexible command-line switches and options
|
|
|
|
|
|
WHERE?
|
|
|
|
A tarball for the most recent version of the weather utility can
|
|
be had here:
|
|
|
|
http://fungi.yuggoth.org/weather/src/
|
|
|
|
Alternatively, Debian users can install the weather-util package
|
|
from any mirror.
|