About
=====

weather is a Python program for receiving the weather forecast from the US
National Weather Service. This program only supports US-based addresses, due
to the use of the NWS weather API, which does not provide global data.

Usage
=====

weather [-v] zipcode
   Retrieves the weather for the given zipcode.
weather [-v] latitude longitude
   Retrieves the weather for the given latitude and longitude, if within the US.
weather [-v] 'location string'
   Retrieves the weather for the given text location. The text location could be
   a city name or any other location name supported by the NWS.

-v prints verbose descriptions of weather data.

Requirements
============
 * Python
 * lxml
 * SOAPpy

Known Issues
============
 * Only US-based addresses are supported.
 * Error handling for changes in the NWS XML structure is minimal and not
   verbose.
 * If a given location string cooresponds to more than one location, the
   program will not be able to find the weather.

Possible Future Improvements
============================
 * Better error handling.
 * A disk-based cache of coordinates for locations, instead of hard-coded
   zipcodes.
 * A better system for resolving location strings to coordinates.

License
=======

Copyright (c) 2012, Brandon Vargo
All rights reserved.

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:
    * Redistributions of source code must retain the above copyright
      notice, this list of conditions and the following disclaimer.
    * Redistributions in binary form must reproduce the above copyright
      notice, this list of conditions and the following disclaimer in the
      documentation and/or other materials provided with the distribution.
    * Neither the name of the <organization> nor the
      names of its contributors may be used to endorse or promote products
      derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL BRANDON VARGO BE LIABLE FOR ANY DIRECT,
INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.