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

25
FAQ
View File

@@ -1,7 +1,9 @@
FREQUENTLY ASKED QUESTIONS 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.
Table of Contents:
@@ -44,8 +46,10 @@ state abbreviation to get to a list of cities in that state).
4. I live outside the USA--can this be made to work for me
anyway?
If you have any recommendations for similar forecast data in
other countries, I will be happy to try and find a way to
METAR station IDs can be found for cities and airports worldwide,
but forecast data is harder to come by. If you have any
recommendations of forecast data for other countries available in a
format like NOAA's, I will be happy to try and find a way to
integrate it into the weather utility, but I suspect that some
serious modification would be necessary given that the data is
likely to be published in a non-English language, requiring some
@@ -59,10 +63,9 @@ The -i or --id switch (or the id parameter in an alias definition),
only tells weather(1) what current conditions to retrieve. If you
specify -f or --forecast on the command line (or forecast=True in
an alias) without providing a city name and state abbreviation
(-c/--city and -s/--st, or city and st in an alias), you will
instead see the forecast for the built-in default location (or the
city and st defined in the default alias, if you have one). See
question 3 above for information on figuring out what city name and
state abbreviation to use, and the manual for weatherrc(5) for
information on defining aliases.
(-c/--city and -s/--st, or city and st in an alias) and are seeing
an actual forecast, then you probably have a default city and state
abbreviation set in your config. See question 3 above for
information on figuring out what city name and state abbreviation
to use, and the manual for weatherrc(5) for information on defining
aliases.