Imported from archive.

* Release 2.0: Heavy rewrite with too many new features to enumerate
here in the ChangeLog file.

* NEWS: List of important changes since 1.x releases.

* weather, weather.py: Implemented support for Python 3000 as
requested by ptchinster on behalf of Arch Linux, conditions/forecast
searches by latitude/longitude requested by Brandt Daniels, support
for newer NOAA forecasts pointed out by Darryl Mouck and Richard
Dooling, custom URIs requested by Michel Pelzer, international
weather stations requested by Milton Hubsher, and fixed a metric
conversion issue with negative values reported by Jochen Keil,
Michiel Appelman and Stefan Metzlaff. Thanks to everyone for your
input and assistance!

FAQ

@@ -2,67 +2,55 @@
  Frequently Asked Questions About the Weather Utility
 ======================================================
 
-:Copyright: (c) 2006-2010 Jeremy Stanley <fungi@yuggoth.org>. Permission to
+:Copyright: (c) 2006-2012 Jeremy Stanley <fungi@yuggoth.org>. Permission
-            use, copy, modify, and distribute this software is granted under
+            to use, copy, modify, and distribute this software is
-            terms provided in the LICENSE file distributed with this software.
+            granted under terms provided in the LICENSE file distributed
+            with this software.
 
 .. contents::
 
 1. Can I help?
 --------------
-Sure! Bug reports and feature suggestions are always welcome, but fixes and
+Sure! Bug reports and feature suggestions are always welcome, but fixes
-patches are of course preferred. Contact fungi@yuggoth.org if desired, but
+and patches are of course preferred. Contact fungi@yuggoth.org if
-please read this FAQ and the included manuals for weather(1) and weatherrc(5)
+desired, but please read this FAQ and the included manuals for
-before asking questions that might be answered therein. One big way anyone can
+weather(1) and weatherrc(5) before asking questions that might be
-help is to provide me with some additional mappings of METAR station ID, city
+answered therein.
-name and state abbreviation for inclusion in the default /etc/weatherrc file.
 
 2. How do I figure out my local METAR station ID?
 -------------------------------------------------
-The list of stations is found at http://weather.noaa.gov/data/nsd_cccc.gz (it's
+The list of stations included in the "stations" file is comprised of
-thousands of lines long, so I recommend keyword searching in your browser or
+thousands of entries, so if you're within the USA it's recommended to
-using grep(1) to find what you're looking for). From time to time, the
+use weather's built-in Census place name and ZCTA (postal ZIP code)
-compression on their site seems to be failing, resulting in zero-byte files. If
+searching capabilities. Otherwise, using its latitude,longitude
-you run into this issue, you can get uncompressed and zip-compressed versions
+coordinate search feature is probably your best bet. See the weather(1)
-by replacing the "gz" suffix in the URL with "txt" or "zip" respectively. The
+manual for examples.
-list can also be obtained from the following URLs in a pinch, though they are
-not guaranteed to be up to date (thanks Celejar!):
-
- * http://www.rap.ucar.edu/weather/surface/stations.txt
- * http://aviationweather.gov/adds/metars/stations.txt
 
 3. How do I figure out my local city name and state abbreviation?
 -----------------------------------------------------------------
-The forecasts can be located starting from
+As of the 2.0 release, this is no longer necessary. In Spring of 2011
-http://weather.noaa.gov/pub/data/forecasts/city/ (choose the state abbreviation
+the NWS switched away from city-named forecast zone IDs to the numeric
-to get to a list of cities in that state).
+state zone IDs also used for alerts. As a result, weather now comes with
+pregenerated correlations between airports/stations and zones along with
+USA Census (FIPS and ZCTA/ZIP code) and global latitude,longitude
+coordinates and can search among them in a flexible and intuitive
+manner. See the weather(1) manual for examples.
 
 4. I live outside the USA--can this be made to work for me anyway?
 ------------------------------------------------------------------
-METAR station IDs can be found for cities and airports worldwide, but forecast
+ICAO codes for METAR stations can be found for cities and airports
-data is harder to come by. If you have any recommendations of forecast data for
+worldwide, but forecast and alert data is harder to come by. If you have
-other countries available in a format like NOAA's, I will be happy to try and
+any recommendations of plaintext data for other countries available in a
-find a way to integrate it into the weather utility, but I suspect that some
+format like NOAA's, I will be happy to start incorporating it into the
-serious modification would be necessary given that the data is likely to be
+weather utility. If the data is published in a non-English language,
-published in a non-English language, requiring some additional input from
+I'll require some additional input from speakers of that language for
-speakers of that language for how to handle filtering and formatting of the
+how to handle filtering and formatting of the text.
-text.
 
 5. Why do I get the wrong forecast when specifying -i or --id?
 --------------------------------------------------------------
-The -i or --id switch (or the id parameter in an alias definition), only tells
+As of the 2.0 release, this question is no longer relevant.
-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)
-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.
 
 6. Where can I get a list of the NWS advisory zones for alerts?
 ---------------------------------------------------------------
-The lists of advisory zones by region are found aggregated at
+As of the 2.0 release, this is no longer necessary. See FAQ entries #2
-http://weather.noaa.gov/pub/data/zonecatalog.curr.tar (it's several thousand
+and #3 for more detail.
-files totalling well over a hundred thousand lines of text, so I recommend
-downloading, unpacking and using a recursive grep(1) to find what you're
-looking for).

INSTALL

@@ -2,24 +2,29 @@
  Basic Unix Installation Instructions for the Weather Utility
 ==============================================================
 
-:Copyright: (c) 2006-2010 Jeremy Stanley <fungi@yuggoth.org>. Permission to
+:Copyright: (c) 2006-2012 Jeremy Stanley <fungi@yuggoth.org>. Permission
-            use, copy, modify, and distribute this software is granted under
+            to use, copy, modify, and distribute this software is
-            terms provided in the LICENSE file distributed with this software.
+            granted under terms provided in the LICENSE file distributed
+            with this software.
 
 .. contents::
 
 Prerequisites
 -------------
-You need the Python interpreter installed somewhere in your path (most modern
+You need the Python interpreter installed somewhere in your path (most
-UNIX derivatives come with one already). If you need to get Python, it can be
+modern UNIX derivatives come with one already). If you need to get
-obtained from http://www.python.org/ (but chances are your operating system at
+Python, it can be obtained from http://www.python.org/ but chances are
-least provides some sort of native package for it, which you should probably
+your operating system at least provides some sort of native package for
-install in whatever means is recommended by your OS vendor/distributor).
+it, which you should probably install in whatever means is recommended
+by your OS vendor/distributor. The script is tested with recent 2.x and
+3.x Python versions, attempting to maintain forward/backward
+compatability with the interpreter, so bug reports or patches to ensure
+this continues to be the case are most welcome.
 
 Running in Place
 ----------------
-An easy way to try it out is to unpack the tarball and change to the resulting
+An easy way to try it out is to unpack the tarball and change to the
-directory::
+resulting directory::
 
    tar xzf weather-*.tar.gz
    cd weather-*
@@ -27,30 +32,37 @@ directory::
    ./weather --help
    man ./weather.1
    man ./weatherrc.5
-   ./weather --forecast --no-conditions --city=charlotte --st=nc
+   ./weather --forecast rdu
-   ./weather ord sea
+   ./weather clt gso
 
-...and so on. The weather utility, included Python module and documentation are
+...and so on. The weather utility, included Python module and
-all fully functional when kept together in one directory, if somewhat
+documentation are all fully functional when kept together in one
-inconvenient.
+directory, without needing to install these components to other
+locations within the filesystem hierarchy.
 
 Installing the Utility
 ----------------------
-The file named weather should be made executable and put somewhere in your path
+The file named weather should be made executable and put somewhere in
-(/usr/local/bin/ or ~/bin/ for example). Similarly, weather.py needs to be
+your path (/usr/local/bin/ or ~/bin/ for example). Similarly, weather.py
-somewhere in Python's include path. You can see your Python interpreter's
+needs to be somewhere in Python's include path. You can see your Python
-default include path by running::
+interpreter's default include path by running::
 
    python -c "import sys ; print sys.path"
 
+If the correlation data files are to be used (airports, places,
+stations, zctas, zones), they need to be in your current working
+directory or a directory mentioned within the "default" section's
+"datapath" option of the weatherrc file.
+
 Configuration
 -------------
-The weatherrc file should go in /etc/ or you can save it in your home directory
+The weatherrc file should go in /etc/ or /etc/weather/ for global
-as a dotfile (~/.weatherrc) to support user-specific alias configuration and
+configuration. You can save it in your home directory as a dotfile
-overrides of the global /etc/weatherrc file.
+(~/.weather/weatherrc or ~/.weatherrc) to support user-specific alias
+configuration and overrides of the global weatherrc file.
 
 Manuals
 -------
-Optionally, the weather.1 and weatherrc.5 files can be placed in sane locations
+Optionally, the weather.1 and weatherrc.5 files can be placed in sane
-for TROFF/NROFF manual files on your system (for example, /usr/local/share/man/
+locations for TROFF/NROFF manual files on your system (for example,
-or ~/man/).
+/usr/local/share/man/ or ~/man/).

LICENSE

@@ -2,27 +2,39 @@
  Weather License
 =================
 
-The weather project employs the ISC license, a permissive free software license
+The weather project employs the ISC license, a permissive free software
-written by the Internet Systems Consortium and functionally equivalent to the
+license written by the Internet Systems Consortium and functionally
-2-clause BSD license. Initially used for the ISC's own software releases, it
+equivalent to the 2-clause BSD license. Initially used for the ISC's own
-has since become the preferred license of many projects (OpenBSD, for example).
+software releases, it has since become the preferred license of many
+other projects.
+
+The correlation data provided is augmented by manual research but built
+primarily by aggregating sources within the USA Public Domain (U.S.
+Census Bureau Gazetteer and publications of the National Oceanic and
+Atmospheric Administration's National Climatic Data Center and National
+Weather Service including its National Centers for Environmental
+Prediction and Office of Science and Technology/Systems Engineering
+Center Geographic Information Systems Map Group). Copies of the original
+external data sources have been provided with this software for
+reference, but are not covered by the copyright or permission notices
+which follow.
 
 Copyright Notice
 ----------------
-Copyright (c) 2006-2010 Jeremy Stanley <fungi@yuggoth.org>
+Copyright (c) 2006-2012 Jeremy Stanley <fungi@yuggoth.org>
 
 Permission Notice
 -----------------
-Permission to use, copy, modify, and distribute this software for any purpose
+Permission to use, copy, modify, and distribute this software for any
-with or without fee is hereby granted, provided that the above copyright notice
+purpose with or without fee is hereby granted, provided that the above
-and this permission notice appear in all copies.
+copyright notice and this permission notice appear in all copies.
 
 Disclaimer
 ----------
-The software is provided "as is" and the author disclaims all warranties with
+The software is provided "as is" and the author disclaims all warranties
-regard to this software including all implied warranties of merchantability and
+with regard to this software including all implied warranties of
-fitness. In no event shall the author be liable for any special, direct,
+merchantability and fitness. In no event shall the author be liable for
-indirect, or consequential damages or any damages whatsoever resulting from
+any special, direct, indirect, or consequential damages or any damages
-loss of use, data or profits, whether in an action of contract, negligence or
+whatsoever resulting from loss of use, data or profits, whether in an
-other tortious action, arising out of or in connection with the use or
+action of contract, negligence or other tortious action, arising out of
-performance of this software.
+or in connection with the use or performance of this software.

NEWS

@@ -0,0 +1,51 @@
+=================================================
+ New Version Information for the Weather Utility
+=================================================
+
+:Copyright: (c) 2006-2012 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.
+
+.. contents::
+
+2.0 Release
+-----------
+The 2.0 release involves a major rewrite of the underlying code and
+addition of large volumes of previously-unneeded location correlation
+data. In the Spring of 2011 the USA NOAA/NWS made significant changes to
+the way they organized and published forecast data such that it could
+no longer be supported by design assumptions inherent within this
+utility. Attempts were made to preserve backward compatability with 1.x
+command-line usage and configuration file formats where possible, but
+some regressions are unfortunately unavoidable. The aurl, city, flines,
+furl, id, murl, st and zones options have been removed. Minimal logic
+was retained to recognize and continue supporting limited use of city,
+id and st in configuration files, though these are deprecated for
+eventual removal in a future release.
+
+On a positive note, this provided an opportunity to design out
+some reported bugs and add in numerous requested features. Highlights
+include:
+
+ * Because NOAA/NWS now treats forecast data in the same way as alerts,
+   the alert reporting features are now much better integrated and no
+   longer considered a beta test.
+
+ * The lack of memorable alert/forecast zone coding in the new scheme
+   drove development of intelligent search functionality, allowing users
+   to find stations and zones through a variety of methods like place
+   names, IATA/FAA/ICAO/FIPS/ZIP codes and even raw coordinates.
+
+ * To reduce unnecessary load on NOAA/NWS servers, the utility now
+   caches retrieved data for a configurable period of time.
+
+ * Airport code lists are no longer maintained in configuration (though
+   they are still easily overridden through configuration), and are
+   instead now separately managed in a manner similar to the other
+   pregenerated correlation data.
+
+Worth noting, however, is that the new forecast data publication format
+(now essentially identical to the alert format) is all-caps freeform
+prose, and not easily parsed as a result. Due to the lengthy nature of
+this output, piping it through a pager is highly recommended.

README

@@ -2,35 +2,38 @@
  General Information About the Weather Utility
 ===============================================
 
-:Copyright: (c) 2006-2010 Jeremy Stanley <fungi@yuggoth.org>. Permission to
+:Copyright: (c) 2006-2012 Jeremy Stanley <fungi@yuggoth.org>. Permission
-            use, copy, modify, and distribute this software is granted under
+            to use, copy, modify, and distribute this software is
-            terms provided in the LICENSE file distributed with this software.
+            granted under terms provided in the LICENSE file distributed
+            with this software.
 
 .. contents::
 
 What?
 -----
 This command-line utility is intended to provide quick access to current
-weather conditions and forecasts. Presently, it is capable of returning data
+weather conditions and forecasts. Presently, it is capable of returning
-for localities throughout the USA by retrieving and formatting decoded METARs
+data for localities throughout the USA and some select locations
-(Meteorological Aerodrome Reports) from NOAA (the USA National Oceanic and
+globally by retrieving and formatting decoded METARs (Meteorological
-Atmospheric Administration) and forecasts from NWS (the USA National Weather
+Aerodrome Reports) from NOAA (the USA National Oceanic and Atmospheric
+Administration) and forecasts/alerts 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
+command-line informational utilities like cal(1), calendar(1) and
-can retrieve arbitrary weather data via specific command-line switches (station
+dict(1). It retrieves arbitrary weather data via precompiled
-ID, city, state), or aliases can be configured system wide and on a per-user
+correlations or custom-tailored aliases (system-wide or on a per-user
-basis. It can be freely used and redistributed under the terms of a BSD-like
+basis). It can be freely used and redistributed under the terms of a
-License.
+BSD-like License.
 
 Why?
 ----
-My girlfriend had a long commute to/from work and school, and often wanted to
+My girlfriend had a long commute to/from work and school, and often
-check the weather both for home and her office. Unfortunately, starting a Web
+wanted to check the weather both for home and her office. Unfortunately,
-browser, pulling up a weather site, entering multiple ZIP codes and waiting for
+starting a Web browser, pulling up a weather site, entering multiple ZIP
-them to load is time-consuming for the marginally-impatient. Since she tended
+codes and waiting for them to load is time-consuming for the
-to stay logged into a shell server most of the time, I figured I'd install a
+marginally-impatient. Since she tended to stay logged into a shell
-quick command-line tool to retrieve weather info for her commute, but to my
+server most of the time, I figured I'd install a quick command-line tool
-surprise, a quick search turned up little that met my basic requirements:
+to retrieve weather info for her commute. 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
@@ -40,9 +43,10 @@ surprise, a quick search turned up little that met my basic requirements:
 
 Where?
 ------
-A tarball for the most recent version of the weather utility can be had here:
+A tarball for the most recent version of the weather utility can be had
+here:
 
  * http://fungi.yuggoth.org/weather/src/
 
-Alternatively, Debian and Ubuntu users can install the weather-util package
+Alternatively, Debian and Ubuntu users can install the weather-util
-from any mirror.
+package from any mirror.

overrides.log

@@ -0,0 +1,683 @@
+added airport abs (+1 options)
+added airport aby (+1 options)
+added airport agh (+1 options)
+added airport ajr (+1 options)
+added airport amv (+1 options)
+added airport ane (+1 options)
+added airport ang (+1 options)
+added airport aor (+1 options)
+added airport aqa (+1 options)
+added airport aru (+1 options)
+added airport atk (+1 options)
+added airport avn (+1 options)
+added airport azs (+1 options)
+added airport bdj (+1 options)
+added airport bfv (+1 options)
+added airport bgw (+1 options)
+added airport bhk (+1 options)
+added airport bji (+1 options)
+added airport bjn (+1 options)
+added airport bkd (+1 options)
+added airport bkg (+1 options)
+added airport bkl (+1 options)
+added airport bld (+1 options)
+added airport blr (+1 options)
+added airport bml (+1 options)
+added airport bpn (+1 options)
+added airport bqs (+1 options)
+added airport bsg (+1 options)
+added airport bsr (+1 options)
+added airport bth (+1 options)
+added airport bus (+1 options)
+added airport bvc (+1 options)
+added airport bxk (+1 options)
+added airport cac (+1 options)
+added airport caj (+1 options)
+added airport ccj (+1 options)
+added airport ccm (+1 options)
+added airport cei (+1 options)
+added airport cfb (+1 options)
+added airport ciw (+1 options)
+added airport cjc (+1 options)
+added airport ckh (+1 options)
+added airport cmx (+1 options)
+added airport cni (+1 options)
+added airport cnw (+1 options)
+added airport cod (+1 options)
+added airport cok (+1 options)
+added airport cso (+1 options)
+added airport csy (+1 options)
+added airport ctj (+1 options)
+added airport cty (+1 options)
+added airport cxj (+1 options)
+added airport dgw (+1 options)
+added airport dol (+1 options)
+added airport dps (+1 options)
+added airport dsa (+1 options)
+added airport dwc (+1 options)
+added airport dzn (+1 options)
+added airport ebl (+1 options)
+added airport ego (+1 options)
+added airport eps (+1 options)
+added airport esc (+1 options)
+added airport evn (+1 options)
+added airport fmm (+1 options)
+added airport fod (+1 options)
+added airport fog (+1 options)
+added airport fsz (+1 options)
+added airport gai (+1 options)
+added airport gcc (+1 options)
+added airport gcj (+1 options)
+added airport gdt (+1 options)
+added airport gel (+1 options)
+added airport get (+1 options)
+added airport ghg (+1 options)
+added airport gmz (+1 options)
+added airport gov (+1 options)
+added airport gpb (+1 options)
+added airport gur (+1 options)
+added airport guw (+1 options)
+added airport hak (+1 options)
+added airport hcr (+1 options)
+added airport hgu (+1 options)
+added airport hid (+1 options)
+added airport hlp (+1 options)
+added airport hmv (+1 options)
+added airport hsk (+1 options)
+added airport htg (+1 options)
+added airport hti (+1 options)
+added airport hua (+1 options)
+added airport huf (+1 options)
+added airport iaa (+1 options)
+added airport ifj (+1 options)
+added airport igg (+1 options)
+added airport ild (+1 options)
+added airport ioa (+1 options)
+added airport iph (+1 options)
+added airport isu (+1 options)
+added airport iwa (+1 options)
+added airport jad (+1 options)
+added airport jbq (+1 options)
+added airport jct (+1 options)
+added airport jhs (+1 options)
+added airport joi (+1 options)
+added airport jqa (+1 options)
+added airport jsu (+1 options)
+added airport juv (+1 options)
+added airport kbv (+1 options)
+added airport kdh (+1 options)
+added airport kfp (+1 options)
+added airport kgk (+1 options)
+added airport kgp (+1 options)
+added airport kja (+1 options)
+added airport klg (+1 options)
+added airport kmo (+1 options)
+added airport knw (+1 options)
+added airport koe (+1 options)
+added airport kop (+1 options)
+added airport krw (+1 options)
+added airport ksz (+1 options)
+added airport kut (+1 options)
+added airport kvc (+1 options)
+added airport lae (+1 options)
+added airport lbd (+1 options)
+added airport lcj (+1 options)
+added airport ldk (+1 options)
+added airport lop (+1 options)
+added airport lrd (+1 options)
+added airport lsq (+1 options)
+added airport lwn (+1 options)
+added airport mcx (+1 options)
+added airport mdl (+1 options)
+added airport mdw (+1 options)
+added airport mgc (+1 options)
+added airport mii (+1 options)
+added airport mji (+1 options)
+added airport mll (+1 options)
+added airport mni (+1 options)
+added airport mou (+1 options)
+added airport mpw (+1 options)
+added airport mqf (+1 options)
+added airport mqp (+1 options)
+added airport mqs (+1 options)
+added airport mrf (+1 options)
+added airport mvq (+1 options)
+added airport mwx (+1 options)
+added airport myp (+1 options)
+added airport mzl (+1 options)
+added airport naj (+1 options)
+added airport naq (+1 options)
+added airport naw (+1 options)
+added airport nbw (+1 options)
+added airport ncy (+1 options)
+added airport ngb (+1 options)
+added airport nib (+1 options)
+added airport nkx (+1 options)
+added airport nlg (+1 options)
+added airport nsk (+1 options)
+added airport nst (+1 options)
+added airport ntl (+1 options)
+added airport ntq (+1 options)
+added airport nty (+1 options)
+added airport nux (+1 options)
+added airport nvi (+1 options)
+added airport nvt (+1 options)
+added airport nym (+1 options)
+added airport nza (+1 options)
+added airport obn (+1 options)
+added airport ook (+1 options)
+added airport org (+1 options)
+added airport orv (+1 options)
+added airport osd (+1 options)
+added airport oss (+1 options)
+added airport osw (+1 options)
+added airport ovb (+1 options)
+added airport oza (+1 options)
+added airport pao (+1 options)
+added airport pbh (+1 options)
+added airport ped (+1 options)
+added airport pes (+1 options)
+added airport pga (+1 options)
+added airport pgu (+1 options)
+added airport phs (+1 options)
+added airport pie (+1 options)
+added airport pip (+1 options)
+added airport pkv (+1 options)
+added airport pmw (+1 options)
+added airport pnt (+1 options)
+added airport ppk (+1 options)
+added airport pqi (+1 options)
+added airport prv (+1 options)
+added airport pwq (+1 options)
+added airport pze (+1 options)
+added airport qgy (+1 options)
+added airport rai (+1 options)
+added airport rby (+1 options)
+added airport riw (+1 options)
+added airport riy (+1 options)
+added airport rmf (+1 options)
+added airport rmg (+1 options)
+added airport roi (+1 options)
+added airport rsh (+1 options)
+added airport rue (+1 options)
+added airport sbo (+1 options)
+added airport scm (+1 options)
+added airport shg (+1 options)
+added airport sig (+1 options)
+added airport sjc (+1 options)
+added airport sjw (+1 options)
+added airport skk (+1 options)
+added airport skt (+1 options)
+added airport sku (+1 options)
+added airport skv (+1 options)
+added airport slo (+1 options)
+added airport sly (+1 options)
+added airport smk (+1 options)
+added airport smv (+1 options)
+added airport sno (+1 options)
+added airport snu (+1 options)
+added airport sny (+1 options)
+added airport sob (+1 options)
+added airport sqo (+1 options)
+added airport sry (+1 options)
+added airport stk (+1 options)
+added airport sub (+1 options)
+added airport sus (+1 options)
+added airport taz (+1 options)
+added airport tbs (+1 options)
+added airport tca (+1 options)
+added airport tdx (+1 options)
+added airport tef (+1 options)
+added airport tgg (+1 options)
+added airport ths (+1 options)
+added airport tjm (+1 options)
+added airport tro (+1 options)
+added airport ukb (+1 options)
+added airport ukk (+1 options)
+added airport ulh (+1 options)
+added airport ulv (+1 options)
+added airport und (+1 options)
+added airport urs (+1 options)
+added airport usm (+1 options)
+added airport vai (+1 options)
+added airport vak (+1 options)
+added airport vav (+1 options)
+added airport vil (+1 options)
+added airport vkt (+1 options)
+added airport vsg (+1 options)
+added airport vts (+1 options)
+added airport wmo (+1 options)
+added airport wwr (+1 options)
+added airport wya (+1 options)
+added airport xfl (+1 options)
+added airport xsp (+1 options)
+added airport xtl (+1 options)
+added airport yny (+1 options)
+added airport yoo (+1 options)
+added airport yra (+1 options)
+added airport ysp (+1 options)
+added airport zmt (+1 options)
+added airport zos (+1 options)
+changed station cyab (+2 options)
+changed station cybq (+2 options)
+changed station daef (+2 options)
+changed station daen (+2 options)
+changed station egno (+2 options)
+changed station ehak (+2 options)
+changed station ehdv (+2 options)
+changed station ehfd (+2 options)
+changed station ehfz (+2 options)
+changed station ehja (+2 options)
+changed station ehjr (+2 options)
+changed station ehkv (+2 options)
+changed station ehma (+2 options)
+changed station ehmg (+2 options)
+changed station ehpg (+2 options)
+changed station ehqe (+2 options)
+changed station ehsa (+2 options)
+changed station ehsc (+2 options)
+changed station fdjr (+2 options)
+changed station fdmy (+2 options)
+changed station fdnd (+2 options)
+changed station fdny (+2 options)
+changed station fdot (+2 options)
+changed station fdpp (+2 options)
+changed station fdvv (+2 options)
+changed station fyab (+2 options)
+changed station fyan (+2 options)
+changed station fybg (+2 options)
+changed station fybp (+2 options)
+changed station fyen (+2 options)
+changed station fyhd (+2 options)
+changed station fykb (+2 options)
+changed station fymh (+2 options)
+changed station fymp (+2 options)
+changed station fynd (+2 options)
+changed station fyoh (+2 options)
+changed station fyom (+2 options)
+changed station fyos (+2 options)
+changed station fyot (+2 options)
+changed station fyoy (+2 options)
+changed station fyrh (+2 options)
+changed station fyrn (+2 options)
+changed station fytm (+2 options)
+changed station gmae (+2 options)
+changed station gmmo (+2 options)
+changed station gmto (+2 options)
+changed station gqno (+2 options)
+changed station gqon (+2 options)
+changed station gqqp (+2 options)
+changed station hkms (+2 options)
+changed station hknh (+2 options)
+changed station huak (+2 options)
+changed station huka (+2 options)
+changed station huwn (+2 options)
+changed station k05u (+2 options)
+changed station k19a (+2 options)
+changed station k2i0 (+2 options)
+changed station k3r7 (+2 options)
+changed station k5w8 (+2 options)
+changed station k6a2 (+2 options)
+changed station kajz (+2 options)
+changed station kbgf (+2 options)
+changed station kcni (+2 options)
+changed station kd25 (+2 options)
+changed station kd95 (+2 options)
+changed station kded (+2 options)
+changed station ke11 (+2 options)
+changed station ke16 (+2 options)
+changed station kedj (+2 options)
+changed station kfot (+2 options)
+changed station kfwz (+2 options)
+changed station kfyg (+2 options)
+changed station kggp (+2 options)
+changed station kgic (+2 options)
+changed station kgoo (+2 options)
+changed station kgxa (+2 options)
+changed station khhw (+2 options)
+changed station khzr (+2 options)
+changed station ki35 (+2 options)
+changed station kinf (+2 options)
+changed station kiob (+2 options)
+changed station kiya (+2 options)
+changed station kjpd (+2 options)
+changed station kjvw (+2 options)
+changed station kk22 (+2 options)
+changed station klsb (+2 options)
+changed station klua (+2 options)
+changed station km40 (+2 options)
+changed station km63 (+2 options)
+changed station kmgc (+2 options)
+changed station ko86 (+2 options)
+changed station kqbu (+2 options)
+changed station kqea (+2 options)
+changed station kqeb (+2 options)
+changed station kqei (+2 options)
+changed station kqej (+2 options)
+changed station kqel (+2 options)
+changed station kqen (+2 options)
+changed station kqep (+2 options)
+changed station kqeq (+2 options)
+changed station kqer (+2 options)
+changed station kqes (+2 options)
+changed station kqev (+2 options)
+changed station kqew (+2 options)
+changed station kqex (+2 options)
+changed station kqey (+2 options)
+changed station kqfb (+2 options)
+changed station kqft (+2 options)
+changed station kqfu (+2 options)
+changed station kqfv (+2 options)
+changed station kqfw (+2 options)
+changed station kqfx (+2 options)
+changed station kqka (+2 options)
+changed station kqms (+2 options)
+changed station kqsn (+2 options)
+changed station kqth (+2 options)
+changed station kqts (+2 options)
+changed station kqvp (+2 options)
+changed station kqz4 (+2 options)
+changed station krts (+2 options)
+changed station ksrb (+2 options)
+changed station ksyf (+2 options)
+changed station kt35 (+2 options)
+changed station ktbx (+2 options)
+changed station ktdr (+2 options)
+changed station ktha (+2 options)
+changed station ktoc (+2 options)
+changed station lebt (+2 options)
+changed station leec (+2 options)
+changed station lszl (+2 options)
+changed station lubm (+2 options)
+changed station mdab (+2 options)
+changed station mgmm (+2 options)
+changed station mgmt (+2 options)
+changed station mgpc (+2 options)
+changed station mgtu (+2 options)
+changed station mhcl (+2 options)
+changed station mlrm (+2 options)
+changed station mppa (+2 options)
+changed station nmmg (+2 options)
+changed station oihs (+2 options)
+changed station oimq (+2 options)
+changed station oine (+2 options)
+changed station omam (+2 options)
+changed station omdl (+2 options)
+changed station omdm (+2 options)
+changed station omlw (+2 options)
+changed station ommz (+2 options)
+changed station omsn (+2 options)
+changed station omth (+2 options)
+changed station opfa (+2 options)
+changed station ormb (+2 options)
+changed station orn1 (+2 options)
+changed station orni (+2 options)
+changed station oysd (+2 options)
+changed station pawm (+2 options)
+changed station prni (+2 options)
+changed station scir (+2 options)
+changed station sgaj (+2 options)
+changed station sgbn (+2 options)
+changed station sggr (+2 options)
+changed station sglv (+2 options)
+changed station sgpc (+2 options)
+changed station sgpg (+2 options)
+changed station sgpi (+2 options)
+changed station sgpj (+2 options)
+changed station sgsj (+2 options)
+changed station sgsp (+2 options)
+changed station sgvr (+2 options)
+changed station slbj (+2 options)
+changed station slsr (+2 options)
+changed station slti (+2 options)
+changed station spwt (+2 options)
+changed station svs0 (+2 options)
+changed station tcna (+2 options)
+changed station tnnc (+2 options)
+changed station tpdp (+2 options)
+changed station tvsc (+2 options)
+changed station ubbq (+2 options)
+changed station ugms (+2 options)
+changed station urmo (+2 options)
+changed station utfa (+2 options)
+changed station utff (+2 options)
+changed station uudl (+2 options)
+changed station vapr (+2 options)
+changed station vqpr (+2 options)
+changed station wadl (+2 options)
+changed station yrmd (+2 options)
+changed station zswz (+2 options)
+changed zone akz017 (+1 options)
+changed zone akz018 (+1 options)
+changed zone akz019 (+1 options)
+changed zone akz020 (+1 options)
+changed zone akz021 (+1 options)
+changed zone akz022 (+1 options)
+changed zone akz023 (+1 options)
+changed zone akz152 (+23 options)
+changed zone akz227 (+23 options)
+changed zone asz001 (+23 options)
+changed zone asz002 (+23 options)
+changed zone asz003 (+24 options)
+changed zone azz501 (+23 options)
+changed zone azz502 (+23 options)
+changed zone azz503 (+23 options)
+changed zone azz504 (+23 options)
+changed zone azz505 (+23 options)
+changed zone azz506 (+23 options)
+changed zone azz507 (+23 options)
+changed zone azz508 (+23 options)
+changed zone azz509 (+23 options)
+changed zone azz510 (+23 options)
+changed zone azz511 (+23 options)
+changed zone azz512 (+23 options)
+changed zone azz513 (+23 options)
+changed zone azz514 (+23 options)
+changed zone azz515 (+23 options)
+changed zone caz093 (+1 options)
+changed zone caz519 (+23 options)
+changed zone caz520 (+23 options)
+changed zone caz521 (+23 options)
+changed zone caz522 (+23 options)
+changed zone caz523 (+23 options)
+changed zone caz524 (+24 options)
+changed zone caz525 (+23 options)
+changed zone caz526 (+23 options)
+changed zone caz527 (+23 options)
+changed zone caz528 (+23 options)
+changed zone caz529 (+23 options)
+changed zone caz530 (+23 options)
+changed zone caz547 (+23 options)
+changed zone caz548 (+23 options)
+changed zone flz051 (+1 options)
+changed zone flz108 (+23 options)
+changed zone flz112 (+23 options)
+changed zone flz114 (+23 options)
+changed zone flz115 (+23 options)
+changed zone flz118 (+23 options)
+changed zone flz127 (+23 options)
+changed zone flz128 (+23 options)
+changed zone flz134 (+23 options)
+changed zone flz168 (+23 options)
+changed zone flz172 (+23 options)
+changed zone flz173 (+23 options)
+changed zone flz174 (+23 options)
+changed zone gaz047 (!1 options)
+changed zone idz001 (!1 options)
+changed zone idz033 (+23 options)
+changed zone laz069 (+1 options)
+changed zone laz071 (+23 options)
+changed zone laz072 (+23 options)
+changed zone laz073 (+23/!1 options)
+changed zone laz074 (+23/!1 options)
+changed zone mdz501 (+23 options)
+changed zone mdz502 (+23 options)
+changed zone mtz001 (!1 options)
+changed zone ncz105 (+23 options)
+changed zone ncz106 (+23 options)
+changed zone ncz107 (+23 options)
+changed zone ncz108 (+23 options)
+changed zone ncz109 (+23 options)
+changed zone ncz110 (+23 options)
+changed zone ncz501 (+23 options)
+changed zone ncz502 (+23 options)
+changed zone ncz503 (+23 options)
+changed zone ncz504 (+23 options)
+changed zone ncz505 (+23 options)
+changed zone ncz506 (+23 options)
+changed zone ncz507 (+23 options)
+changed zone ncz508 (+23 options)
+changed zone ncz509 (+23 options)
+changed zone ncz510 (+23 options)
+changed zone nez095 (+23 options)
+changed zone nez096 (+23 options)
+changed zone nhz004 (!1 options)
+changed zone njz103 (+23 options)
+changed zone njz104 (+23 options)
+changed zone njz105 (+23 options)
+changed zone njz106 (+23 options)
+changed zone njz107 (+23 options)
+changed zone njz108 (+23 options)
+changed zone nmz401 (+24 options)
+changed zone nmz402 (+24 options)
+changed zone nmz403 (+24 options)
+changed zone nmz404 (+24 options)
+changed zone nmz405 (+24 options)
+changed zone nmz406 (+24 options)
+changed zone nmz407 (+24 options)
+changed zone nmz408 (+24 options)
+changed zone nmz409 (+24 options)
+changed zone nmz410 (+24 options)
+changed zone nmz411 (+24 options)
+changed zone nmz412 (+24 options)
+changed zone nmz413 (+24 options)
+changed zone nmz414 (+24 options)
+changed zone nmz415 (+24 options)
+changed zone nmz416 (+24 options)
+changed zone nmz417 (+24 options)
+changed zone nmz501 (+23 options)
+changed zone nmz502 (+23 options)
+changed zone nmz503 (+23 options)
+changed zone nmz504 (+23 options)
+changed zone nmz505 (+23 options)
+changed zone nmz506 (+23 options)
+changed zone nmz507 (+23 options)
+changed zone nmz508 (+23 options)
+changed zone nmz509 (+23 options)
+changed zone nmz510 (+23 options)
+changed zone nmz511 (+23 options)
+changed zone nmz512 (+23 options)
+changed zone nmz513 (+23 options)
+changed zone nmz514 (+23 options)
+changed zone nmz515 (+23 options)
+changed zone nmz516 (+23 options)
+changed zone nmz517 (+23 options)
+changed zone nmz518 (+23 options)
+changed zone nmz519 (+23 options)
+changed zone nmz520 (+23 options)
+changed zone nmz521 (+23 options)
+changed zone nmz522 (+23 options)
+changed zone nmz523 (+23 options)
+changed zone nmz524 (+23 options)
+changed zone nmz525 (+23 options)
+changed zone nmz526 (+23 options)
+changed zone nmz527 (+23 options)
+changed zone nmz528 (+23 options)
+changed zone nmz529 (+23 options)
+changed zone nmz530 (+23 options)
+changed zone nmz531 (+23 options)
+changed zone nmz532 (+23 options)
+changed zone nmz533 (+23 options)
+changed zone nmz534 (+23 options)
+changed zone nmz535 (+23 options)
+changed zone nmz536 (+23 options)
+changed zone nmz537 (+23 options)
+changed zone nmz538 (+23 options)
+changed zone nmz539 (+23 options)
+changed zone nmz540 (+23 options)
+changed zone nvz038 (+23 options)
+changed zone nvz039 (+23/!1 options)
+changed zone nvz040 (+23 options)
+changed zone nvz041 (+23 options)
+changed zone nyz176 (+23 options)
+changed zone nyz177 (+23 options)
+changed zone nyz178 (+23 options)
+changed zone nyz179 (+23 options)
+changed zone orz014 (+23 options)
+changed zone orz507 (+23 options)
+changed zone orz508 (+23 options)
+changed zone orz509 (+23 options)
+changed zone paz073 (+23 options)
+changed zone paz074 (+23 options)
+changed zone paz075 (+23 options)
+changed zone paz076 (+23 options)
+changed zone scz047 (!1 options)
+changed zone scz052 (+23 options)
+changed zone scz053 (+23 options)
+changed zone scz054 (+23 options)
+changed zone scz055 (+23 options)
+changed zone scz056 (+23 options)
+changed zone txz246 (+1 options)
+changed zone txz259 (+23 options)
+changed zone txz260 (+23 options)
+changed zone txz261 (+23 options)
+changed zone txz262 (+23 options)
+changed zone txz418 (+24 options)
+changed zone txz419 (+24 options)
+changed zone txz420 (+24 options)
+changed zone txz421 (+24 options)
+changed zone txz422 (+24 options)
+changed zone txz423 (+24 options)
+changed zone txz424 (+24 options)
+changed zone utz517 (+23 options)
+changed zone utz518 (+23 options)
+changed zone vaz501 (+23 options)
+changed zone vaz502 (+23 options)
+changed zone vaz503 (+23 options)
+changed zone vaz504 (+23 options)
+changed zone vtz004 (+1 options)
+changed zone waz503 (+23 options)
+changed zone waz504 (+23 options)
+changed zone waz505 (+23 options)
+changed zone waz506 (+23 options)
+changed zone waz507 (+23 options)
+changed zone waz508 (+23 options)
+changed zone waz509 (+23 options)
+changed zone waz510 (+23 options)
+changed zone waz511 (+23 options)
+changed zone waz512 (+23 options)
+changed zone waz513 (+23 options)
+changed zone waz514 (+23 options)
+changed zone waz515 (+23 options)
+changed zone waz516 (+23 options)
+changed zone waz517 (+23 options)
+changed zone waz518 (+23 options)
+changed zone waz519 (+23 options)
+changed zone waz520 (+23 options)
+changed zone waz521 (+23 options)
+changed zone wvz501 (+23 options)
+changed zone wvz502 (+23 options)
+changed zone wvz503 (+23 options)
+changed zone wvz504 (+23 options)
+changed zone wvz505 (+23 options)
+changed zone wvz506 (+23 options)
+changed zone wyz001 (!1 options)
+changed zone wyz101 (+23 options)
+changed zone wyz102 (+23 options)
+changed zone wyz103 (+23 options)
+changed zone wyz104 (+23 options)
+changed zone wyz105 (+23 options)
+changed zone wyz106 (+23 options)
+changed zone wyz107 (+23 options)
+changed zone wyz108 (+23 options)
+changed zone wyz109 (+23 options)
+changed zone wyz110 (+23 options)
+changed zone wyz111 (+23 options)
+changed zone wyz112 (+23 options)
+changed zone wyz113 (+23 options)
+changed zone wyz114 (+23 options)
+changed zone wyz115 (+23 options)
+changed zone wyz116 (+23 options)
+changed zone wyz117 (+23 options)
+changed zone wyz118 (+23 options)
+changed zone wyz119 (+23 options)

weather

@@ -2,7 +2,7 @@
 # distributions may wish to edit the above to refer to a specific interpreter
 # path, such as #!/usr/bin/python
 
-# Copyright (c) 2006-2010 Jeremy Stanley <fungi@yuggoth.org>. Permission to
+# Copyright (c) 2006-2012 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.
 
@@ -11,67 +11,105 @@
 # added so distributors can consistently specify a private module location
 private_module_path = None
 if private_module_path:
-   import sys
+    import sys
-   sys.path.insert(1, private_module_path)
+    sys.path.insert(1, private_module_path)
 
 import weather
 
 # initialize options and configs
 selections = weather.Selections()
-get = selections.get
-get_bool = selections.get_bool
 
 # this mode just lists the aliases defined in the config
-if get_bool("list"): print weather.list_aliases(selections.config)
+if selections.get_bool("list"):
+    print( weather.list_aliases(selections.config) )
+
+# this mode lists details of aliases defined in the config
+elif selections.get_bool("longlist"):
+    print( weather.list_aliases(selections.config, detail=True) )
+
+# this mode builds the correlation data files
+elif selections.get_bool("build_sets"):
+    weather.correlate()
+
+# if no arguments were provided
+elif not selections.arguments:
+    import sys
+
+    # substitute defaults if we have any
+    if selections.config.has_option("default", "defargs"):
+        sys.argv += selections.config.get("default", "defargs").split(",")
+        selections = weather.Selections()
+
+    # otherwise be helpful
+    else:
+        sys.argv += ("--help",)
+        selections = weather.Selections()
+
+# these modes analyze correlations
+if selections.get_bool("info"):
+    weather.guess(
+        selections.arguments[0],
+        path=selections.get("setpath"),
+        info=selections.get_bool("info"),
+        cache_search=(
+            selections.get_bool("cache") \
+                and selections.get_bool("cache_search")
+        ),
+        cacheage=selections.getint("cacheage"),
+        cachedir=selections.get("cachedir")
+    )
 
 # normal operation
 else:
-   output = ""
+    output = ""
-   for argument in selections.arguments:
+    for argument in selections.arguments:
-      if get_bool("conditions", argument) or not (
+        if selections.get_bool("conditions", argument) or not (
-         get_bool("alert", argument) or get_bool("forecast", argument)
+            selections.get_bool("alert", argument) \
-      ):
+                or selections.get_bool("forecast", argument)
-         partial = weather.get_metar(
+            ):
-            id=get("id", argument),
+            partial = weather.get_metar(
-            verbose=get_bool("verbose", argument),
+                uri=selections.get("metar", argument),
-            quiet=get_bool("quiet", argument),
+                verbose=selections.get_bool("verbose", argument),
-            headers=get("headers", argument),
+                quiet=selections.get_bool("quiet", argument),
-            murl=get("murl", argument),
+                headers=selections.get("headers", argument),
-            imperial=get_bool("imperial", argument),
+                imperial=selections.get_bool("imperial", argument),
-            metric=get_bool("metric", argument)
+                metric=selections.get_bool("metric", argument),
-         )
+                cache_data=(
-         if partial: output += partial + "\n"
+                    selections.get_bool("cache") \
-      if get_bool("forecast", argument) or not (
+                        and selections.get_bool("cache_data")
-         get_bool("alert", argument) or get_bool("conditions", argument)
+                ),
-      ):
+                cacheage=selections.getint("cacheage"),
-         partial = weather.get_forecast(
+                cachedir=selections.get("cachedir")
-            city=get("city", argument),
+            )
-            st=get("st", argument),
+            if partial: output += partial + "\n"
-            verbose=get_bool("verbose", argument),
+        if selections.get_bool("forecast", argument) \
-            quiet=get_bool("quiet", argument),
+            or selections.get_bool("alert", argument):
-            flines=get("flines", argument),
+            alert_text = ""
-            furl=get("furl", argument),
+            if selections.get_bool("alert", argument):
-            imperial=get_bool("imperial", argument),
+                atypes = selections.get("atypes", argument).split(",")
-            metric=get_bool("metric", argument)
+            else:
-         )
+                atypes = []
-         if partial: output += partial + "\n"
+            if selections.get_bool("forecast", argument):
-      if get_bool("alert", argument) or not (
+                atypes = ["zone_forecast"] + atypes
-         get_bool("conditions", argument) or get_bool("forecast", argument)
+            for atype in atypes:
-      ):
+                partial = weather.get_alert(
-         alert_text = ""
+                    uri=selections.get(atype, argument),
-         for atype in get("atypes", argument).split(","):
+                    verbose=selections.get_bool("verbose", argument),
-            for zone in get("zones", argument).split(","):
+                    quiet=selections.get_bool("quiet", argument),
-               partial = weather.get_alert(
+                    cache_data=(
-                  zone=zone,
+                        selections.get_bool("cache") \
-                  verbose=get_bool("verbose", argument),
+                            and selections.get_bool("cache_data")
-                  quiet=get_bool("quiet", argument),
+                    ),
-                  atype=atype,
+                    cacheage=selections.getint("cacheage"),
-                  aurl=get("aurl", argument),
+                    cachedir=selections.get("cachedir")
-                  imperial=get_bool("imperial", argument),
+                )
-                  metric=get_bool("metric", argument)
+                if partial:
-               )
+                    alert_text += "***** %s *****\n%s\n" % (
-               if partial: alert_text += partial + "\n"
+                        atype.replace("_", " ").title(),
-         if not alert_text: alert_text = "(no current alerts for your zones)\n"
+                        partial
-         output += alert_text
+                    )
-      output = output.strip()
+            if not alert_text:
-      if output: print( output )
+                alert_text = "(no current alerts for this zone)\n"
+            output += alert_text
+    output = output.strip()
+    if output: print( output )

weather.1

@@ -1,127 +1,215 @@
-.TH WEATHER 1 "March 15, 2010" "" \" -*- nroff -*-
+.TH weather 1 "2012\-06\-24" "2.0" \" -*- nroff -*-
-\" Copyright (c) 2006-2010 Jeremy Stanley <fungi@yuggoth.org>.
+\" Copyright (c) 2006-2012 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.
 .SH NAME
-weather \- command\-line tool to obtain weather conditions and forecasts
+weather \- command-line tool to obtain weather conditions and forecasts
 .SH SYNOPSIS
-.B weather [ options ] [ alias [ alias [...] ] ]
+.B weather
+[
+.I options
+] [
+.I alias1
+|
+.I search1
+[
+.I alias2
+|
+.I search2
+[...]]]
 .SH DESCRIPTION
-This utility is intended to provide quick access to current weather
+.
-conditions and forecasts. Presently, it is capable of providing data for
+This command-line utility is intended to provide quick access to current
-localities throughout the United States of America by retrieving and
+weather conditions and forecasts.
-processing METAR data from the National Oceanic and Atmospheric
+.
-Administration and forecasts from the National Weather Service. Behavior
+Presently, it is capable of returning data for localities throughout the
-can be determined by command\-line options and specification of zero or
+USA and some select locations globally by retrieving and formatting
-more aliases. Aliases are defined in weatherrc files, as a convenient
+decoded METARs (Meteorological Aerodrome Reports) from NOAA (the USA
-means of grouping option combinations together using a short name.
+National Oceanic and Atmospheric Administration) and forecasts/alerts
-Specifying multiple aliases on the command line causes the utility to
+from NWS (the USA National Weather Service).
-output data for each, as if it had been invoked multiple times. If no
+.
-alias is specified, then an alias of "default" is used (assuming it has
+The tool is written to function in the same spirit as other command-line
-been defined) or the built\-in default values are chosen (if it has not).
+informational utilities like \fIcal\fR(1), \fIcalendar\fR(1) and
+\fIdict\fR(1).
+.
+It retrieves arbitrary weather data via precompiled correlations or
+custom-tailored aliases (system-wide or on a per-user basis).
+
+Behavior can be determined by command-line options and specification of
+zero or more location aliases and search terms.
+
+Aliases are defined in \fIweatherrc\fR(5) files, as a convenient means
+of grouping URIs together using a short name.
+.
+Specifying multiple aliases or location search terms on the command line
+causes the utility to output data for each, as if it had been invoked
+multiple times.
+.
+If none are specified, then an alias of \fIdefault\fR is checked for a
+\fIdefargs\fR option and any alias names listed within it
+(comma-separated) are applied instead.
+
+Searches utilize location correlation sets in INI-style text files named
+\fIairports\fR, \fIplaces\fR, \fIstations\fR, \fIzctas\fR and
+\fIzones\fR.
+.
+A precomputed copy is distributed with the source, but can be rebuilt
+from updated data sources as needed by placing them in the current
+working directory and running with the \fI\-\-build\-sets\fR option (see
+the comments at the top of any location correlation set file for
+instructions on where to find updated data sources).
+.
+Positive search results are cached and sourced as aliases on subsequent
+runs for as long as the correlation sets remain unchanged, and are
+cleared automatically once the correlation sets are updated.
+
+Retrieved data is also cached automatically for a short period of time,
+adjustable with the \fIcacheage\fR configuration option or
+\fI\-\-cacheage\fR command-line option.
+.
+This helps throttle load against NOAA/NWS servers in case the utility is
+repeatedly re-run requesting the same data, but can be overridden with
+the \fIcache_data\fR configuration option or \fI\-\-no\-cache\-data\fR
+command-line option.
+.
 .SH OPTIONS
 A summary of options is included below.
 .TP
-.B \-\-version
+.BR \-\-version
 show program's version number and exit
 .TP
-.B \-h, \-\-help
+.BR \-h ", " \-\-help
 show a help message and exit
 .TP
-.B \-a, \-\-alert
+.BR \-a ", " \-\-alert
 include local alert notices
 .TP
-.B \-\-atypes=ATYPES
+.BR \-\-atypes =\fIATYPES\fR
-alert notification types to display
+list of alert notification types to display (ex:
+.BR tornado_warning,urgent_weather_message )
 .TP
-.B \-\-aurl=AURL
+.BR \-\-build\-sets
-alert URL (including %atype% and %zone%)
+(re)build location correlation sets
 .TP
-.B \-c CITY, \-\-city=CITY
+.BR \-\-cacheage =\fICACHEAGE\fR
-the city name (ex: "Raleigh Durham")
+duration in seconds to refresh cached data (ex:
+.BR 900 )
 .TP
-.B \-\-flines=FLINES
+.BR \-\-cachedir =\fICACHEDIR\fR
-maximum number of forecast lines to show
+directory for storing cached searches and data (ex:
+.BR ~/.weather )
 .TP
-.B \-f, \-\-forecast
+.BR \-f ", " \-\-forecast
 include a local forecast
 .TP
-.B \-\-furl=FURL
+.BR \-\-headers =\fIHEADERS\fR
-forecast URL (including %city% and %st%)
+list of conditions headers to display (ex:
+.BR temperature,wind )
 .TP
-.B \-\-headers=HEADERS
+.BR \-\-imperial
-the conditions headers to display
+filter/convert conditions for US/UK units
 .TP
-.B \-i ID, \-\-id=ID
+.BR \-\-info
-the METAR station ID (ex: KRDU)
+output detailed information for your search
 .TP
-.B \-\-imperial
+.BR \-l ", " \-\-list
-filter/convert for US/UK units
+list all configured aliases and cached searches
 .TP
-.B \-l, \-\-list
+.BR \-\-longlist
-print a list of configured aliases
+display details of all configured aliases
 .TP
-.B \-m, \-\-metric
+.BR \-m ", " \-\-metric
-filter/convert for metric units
+filter/convert conditions for metric units
 .TP
-.B \-\-murl=MURL
+.BR \-n ", " \-\-no\-conditions
-METAR URL (including %id%)
+disable output of current conditions
 .TP
-.B \-n, \-\-no\-conditions
+.BR \-\-no\-cache
-disable output of current conditions (forces \-f)
+disable all caching (searches and data)
 .TP
-.B \-o, \-\-omit\-forecast
+.BR \-\-no\-cache\-data
-omit the local forecast (cancels \-f)
+disable retrieved data caching
 .TP
-.B \-\-quiet
+.BR \-\-no\-cache\-search
+disable search result caching
+.TP
+.BR \-q ", " \-\-quiet
 skip preambles and don't indent
 .TP
-.B \-s ST, \-\-st=ST
+.BR \-\-setpath =\fISETPATH\fR
-the state abbreviation (ex: NC)
+directory search path for correlation sets (ex:
+.BR .:~/.weather )
 .TP
-.B \-v, \-\-verbose
+.BR \-v ", " \-\-verbose
-show full decoded feeds (cancels \-q)
+show full decoded feeds
-.TP
-.B \-z ZONES, \-\-zones=ZONES
-alert zones (ex: nc/ncc183,nc/ncz041)
-.SH FILES
-.B weather
-may additionally obtain configuration data from a system\-wide
-configuration file, a per\-user configuration file, and a local
-directory configuration file. The file format and configuration options
-are described in
-.BR weatherrc (5) .
-They are aggregated in the following order:
-.TP
-.B /etc/weatherrc
-the system\-wide configuration
-.TP
-.B ~/.weatherrc
-the per\-user configuration (can be used to override the above)
-.TP
-.B ./weatherrc
-the local directory configuration (can be used to override the above)
 .SH EXAMPLES
 .TP
 .B weather
-View output for the defined default alias, or the built-in default values
+View output for the default alias, if one has been defined (otherwise
-if there is no default alias defined in the configuration files.
+display usage/syntax similar to \-\-help)
 .TP
-.B weather -i kavl
+.BR weather " " rdu
-Display current conditions at the KAVL METAR station.
+Display weather conditions at the airport with IATA/FAA code \fIRDU\fR.
 .TP
-.B weather -n -c asheville -s nc
+.BR weather " " \-\-info " " raleigh
-See a forecast for the Asheville, NC area.
+Show a list of FIPS codes for United States Census Bureau places
+containing the word \fIraleigh\fR (or the proximity information if only
+one match was found).
 .TP
-.B weather -fv gso
+.BR weather " " \(dq ^ral[ie]{2}gh " " city.*nc$ \(dq
-Get the full decoded METAR for the station associated with the gso alias,
+Get the current weather conditions from the nearest station to the
-and the forecast data for the city/state associated with the gso alias,
+Census place name matching the regular expression provided.
-without filtering or fancy formatting.
 .TP
-.B weather home work
+.BR weather " " \-fv " " fips3755000
-Show current conditions for both the home and work aliases in that order.
+Get the full decoded METAR from the nearest station, and the forecast
-.SH SEE ALSO
+data for the nearest zone to the Census place with FIPS code
-.BR weatherrc (5)
+\fI3755000\fR with no special filtering or formatting.
+.TP
+.BR weather " " \-\-forecast " " \-\-no\-cache\-data " " 27613
+Ignore any recent cached METAR or forecast data and display fresh output
+for the nearest station and zone to the Census ZCTA (essentially USPS
+ZIP code) \fI27613\fR.
+.TP
+.BR weather " " home " " work
+Show current conditions for both the \fIhome\fR and \fIwork\fR aliases
+in that order.
+.TP
+.BR weather " " 35.878573,\-78.727813
+.TP
+.BR weather " " 35\-52\-43n,78\-43\-40w
+.TP
+.BR weather " " \(dq 35\-52n, " " 78\-43w \(dq
+Display weather conditions for the nearest station to an arbitrary set
+of global coordinates in latitude,longitude order either in decimal
+format or degree, degree\-minute or degree\-minute\-second formats,
+optionally using signed or cardinal hemisphere designations with or
+without spacing.
+.
+Note that the cut-off for maximum acceptable distance is hard-coded at
+0.1 radians (roughly 637km or 396mi).
+.
+.SH INPUT FILES
+.
+.B weather
+may additionally obtain configuration data from a system-wide
+configuration file, a per-user configuration file, and a local
+directory configuration file.
+.
+The file format and configuration options are described in
+.IR weatherrc (5).
+.
+They are aggregated in the following order:
+.TP
+.I /etc/weatherrc
+the system-wide configuration
+.TP
+.IR ~/.weather/weatherrc " or " ~/.weatherrc
+the per-user configuration
+.TP
+.I ./weatherrc
+the local directory configuration
 .SH AUTHOR
 Utility and manual written by Jeremy Stanley <fungi@yuggoth.org>.
+.SH SEE ALSO
+.IR weatherrc (5)

weatherrc.5

@@ -1,5 +1,5 @@
-.TH WEATHERRC 5 "March 15, 2010" "" \" -*- nroff -*-
+.TH weatherrc 5 "2012\-06\-24" "2.0" \" -*- nroff -*-
-\" Copyright (c) 2006-2010 Jeremy Stanley <fungi@yuggoth.org>.
+\" Copyright (c) 2006-2012 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.
@@ -8,114 +8,109 @@ weatherrc \- configuration file format for the
 .BR weather (1)
 utility
 .SH DESCRIPTION
-The weatherrc file format is intended to specify a set of macros
+.
-by which to group a METAR station ID for current conditions data with a
+The \fIweatherrc\fR file format is intended to specify a set of aliases
-city/state combination for a forecast, but many of the other
+by which to group URIs for METAR station conditions and alert/forecast
-command\-line options and flags for the weather utility can be specified
+zones, but other command-line options and flags for the weather utility
-as well. The file is organized as an INI-format config, with the alias
+can be specified as well.
-name in [] brackets and the associated parameter/value pairs on following
+.
-lines. Parameters and their values as separated by = or : characters.
+The file is organized as an INI-format config, with the alias name in []
+brackets and the associated parameter/value pairs on following lines.
+.
+Parameters and their values are separated by = or : characters.
+.
 Multi-word values do not need quoting.
-.SH PARAMETERS
+.
 These parameters are supported...
 .TP
 .B alert
-include local alert notices
+include local alert notices (possible values are
+.BR False " and " True " or " 0 " and " 1 )
 .TP
 .B atypes
-alert notification types to display
+list of alert notification types to display (ex:
+.BR tornado_warning,urgent_weather_message )
 .TP
-.B aurl
+.B cache
-alert URL (including %atype% and %zone%)
+control all caching (possible values are
+.BR False " and " True " or " 0 " and " 1 )
 .TP
-.B city
+.B cache_data
-the city name (ex: Raleigh Durham)
+control retrieved data caching (possible values are
+.BR False " and " True " or " 0 " and " 1 )
+.TP
+.B cache_search
+control search result caching (possible values are
+.BR False " and " True " or " 0 " and " 1 )
+.TP
+.B cacheage
+duration in seconds to refresh cached data (ex:
+.BR 900 )
+.TP
+.B cachedir
+directory for storing cached searches and data (ex:
+.BR ~/.weather )
 .TP
 .B conditions
-output current conditions (possible values are False and True or 0 and 1)
+output current conditions (possible values are
+.BR False " and " True " or " 0 " and " 1 )
 .TP
-.B flines
+.B defargs
-maximum number of forecast lines to show (integer value, 0 means unlimited)
+list of default command-line arguments (ex:
+.BR avl,rdu )
 .TP
 .B forecast
-include a local forecast (possible values are False and True or 0 and 1)
+include a local forecast (possible values are
-.TP
+.BR False " and " True " or " 0 " and " 1 )
-.B furl
-forecast URL (ex: http://forecast.org/%st%/%city%.txt)
 .TP
 .B headers
-the conditions headers to display (ex: temperature,wind)
+list of conditions headers to display (ex:
-.TP
+.BR temperature,wind )
-.B id
-the METAR station ID (ex: KRDU)
 .TP
 .B imperial
-filter/convert for US/UK units
+filter/convert conditions for US/UK units (possible values are
+.BR False " and " True " or " 0 " and " 1 )
 .TP
 .B metric
-filter/convert for metric units
+filter/convert conditions for metric units (possible values are
-.TP
+.BR False " and " True " or " 0 " and " 1 )
-.B murl
-METAR URL (ex: http://metar.org/%id%.txt)
 .TP
 .B quiet
-skip preambles and don't indent (possible values are False and True or 0 and 1)
+skip preambles and don't indent (possible values are
+.BR False " and " True " or " 0 " and " 1 )
 .TP
-.B st
+.B setpath
-the state abbreviation (ex: NC)
+directory search path for correlation sets (ex:
+.BR .:~/.weather )
 .TP
 .B verbose
-show full decoded feeds (possible values are False and True or 0 and 1)
+show full decoded feeds (possible values are
-.TP
+.BR False " and " True " or " 0 " and " 1 )
-.B zones
-alert zones (ex: nc/ncc183,nc/ncz041)
-.SH URL FORMAT
-The placeholders %city% and %st% in the furl URL and %id% in the murl URL
-will be replaced with the city, st and id definitions respectively. If the
-placeholder has all letters lowercased, the replacement will be forced to
-all lowercase. If the placeholder has all letters uppercased, the
-replacement will be forced to all uppercase. If the placeholder has its
-first letter uppercased and the remainder lowercased, then all words in the
-replacement will start with an uppercase letter and the rest will be
-lowercase. If the placeholder has its last letter uppercased and the
-remainder lowercased, then case will be preserved in the replacement. Also,
-after replacement, any spaces in the resulting URL will be converted to
-underscore characters prior to use.
 .SH EXAMPLES
-Following is an example
+The following is an example \fI~/.weather/weatherrc\fR defining a couple
-.B ~/.weatherrc
+aliases named home and work to be displayed when running the utility
-defining the default settings to be used when running the utility with no
+with no aliases specified...
-aliases specified, and a couple definitions for aliases named home and
-work...
 .P
-.RS
+.in 0
+.nf
 [default]
-.br
+defargs = home,work
-City = Asheville
+
-.br
-Forecast = True
-.br
-ID = KAVL
-.br
-St = NC
-.P
 [home]
-.br
+description = Conditions and Forecast at Home
-City = Raleigh Durham
+forecast = True
-.br
+metar = http://weather.noaa.gov/pub/data/observations/metar/decoded/KRDU.TXT
-ID = KRDU
+zone_forecast = http://weather.noaa.gov/pub/data/forecasts/zone/nc/ncz041.txt
-.br
+
-St = NC
-.P
 [work]
-.br
+description = Conditions at Work
-City = Greensboro
+metar = http://weather.noaa.gov/pub/data/observations/metar/decoded/KGSO.TXT
-.br
+.fi
-ID = KGSO
+.P
-.br
+Now if
-St = NC
+.B weather is invoked by itself on the command line, it will output
-.RE
+conditions for home and work, and also a forecast for home only.
-.SH SEE ALSO
-.BR weather (1)
 .SH AUTHOR
 Specification and manual written by Jeremy Stanley <fungi@yuggoth.org>.
+.SH SEE ALSO
+.BR weather (1)