Metadata-Version: 1.1
Name: wxcast
Version: 1.2.0
Summary: A CLI utility for retrieving weather information.
Home-page: https://github.com/smarlowucf/wxcast
Author: Sean Marlow
Author-email: UNKNOWN
License: GPLv3+
Description-Content-Type: UNKNOWN
Description: # wxcast
        
        A CLI utility for retrieving weather information.
        
        image:https://travis-ci.org/smarlowucf/wxcast.svg?branch=master["Build Status", link="https://travis-ci.org/smarlowucf/wxcast"]
        
        image:images/metar.gif[wxcast metar]
        
        == overview
        
        Provides weather information in terminal:
        
        * Weather text information from NWS API.
        * METAR info from AVWX API.
        * Seven day forecasts based on location using geopy and NWS API.
        
        == Installation
        
        ----
        pip install wxcast
        ----
        
        == Requirements
        
        * certifi
        * Click>=6.0
        * geopy
        * requests
        
        == Test Requirements
        
        * flake8
        * pytest
        * pytest-cov
        * vcrpy
        
        == Usage
        
        === METAR
        
        Provides the METAR information for a given airport ICAO:
        
        ----
        >>> wxcast metar kden
        KDEN 250100Z 06011KT 1/2SM -DZ BR OVC005 09/07 A2999 RMK AO2 SFC VIS 1 1/2 P0001 T00890072
        ----
        
        The data can be decoded and pretty printed to terminal using the -d/--decoded option.
        
        ----
        >>> wxcast metar -d kden
        At 250100Z the conditions for KDEN are LIFR
        
          Altimeter:  29.99inHg (1016hPa)
             Clouds:  Overcast layer at 500ft - Reported AGL
           Dewpoint:  07C (45F)
              Other:  Light Drizzle, Mist
        Temperature:  09C (48F)
         Visibility:  0.5sm (0.8km)
               Wind:  ENE-060 at 11kt
        
               City:  Denver
            Country:  USA
          Elevation:  5433ft (1656m)
               IATA:  DEN
               ICAO:  KDEN
           Latitude:  39.86165639
          Longitude:  -104.6731775
               Name:  International Airport
           Priority:  0
              State:  CO
        ----
        
        === Products
        
        Provides the available text products for a given WFO (weather forecast office).
        
        ----
        >>> wxcast products bou
        AFD:  Area Forecast Discussion
        CAP:  Common Alerting Protocol
        FDI:  Fire Danger Indices
        FWF:  Routine Fire Wx Fcst (With/Without 6-10 Day Outlook)
        FWL:  Land Management Forecasts
        FWM:  Miscellaneous Fire Weather Product
        FWN:  Fire Weather Notification
        FWO:  Fire Weather Observation
        FWS:  Suppression Forecast
        HML:  AHPS XML
        HRR:  Weather Roundup
        HWO:  Hazardous Weather Outlook
        OSO:  Other Surface Observations
        PFM:  Point Forecast Matrices
        PNS:  Public Information Statement
        RFW:  Red Flag Warning
        RR2:  Hydro-Met Data Report Part 2
        RR3:  Hydro-Met Data Report Part 3
        RR9:  Hydro-Met Data Report Part 9
        RRS:  HADS Data
        RTP:  Regional Max/Min Temp and Precipitation Table
        SRG:  Soaring Guidance
        STQ:  Spot Forecast Request
        SYN:  Regional Weather Synopsis
        TVL:  Travelers Forecast
        VFT:  Terminal Aerodrome Forecast (TAF) Verification
        ZFP:  Zone Forecast Product
        ----
        
        === Text Product
        
        Provides the text information for the given product and WFO.
        Displays text in a pager window for easier reading and scrolling.
        
        ----
        >>> wxcast text bou afd
        ----
        
        === Forecast
        
        Provides the seven day NWS forecast for the given location.
        
        ----
        >>> wxcast forecast denver
                Tonight:  Rain showers likely. Cloudy. Low around 42, with temperatures
                          rising to around 45 overnight. North northeast
                          wind around 7 mph. Chance of precipitation is
                          60%. New rainfall amounts less than a tenth of an
                          inch possible.
                 Monday:  A chance of rain showers. Mostly cloudy, with a high near 53.
                          North northeast wind around 7 mph. Chance of
                          precipitation is 30%. New rainfall amounts less
                          than a tenth of an inch possible.
           Monday Night:  A slight chance of showers and thunderstorms before midnight.
                          Mostly cloudy, with a low around 41. South
                          southeast wind around 3 mph. Chance of
                          precipitation is 20%. New rainfall amounts less
                          than a tenth of an inch possible.
        ...
        ----
        
        The location can be a city, address or zip/postal code.
        
        ----
        >>> wxcast forecast 80303
        ...
        ----
        
        If there are spaces in the location it must be surrounded by quotes.
        
        ----
        >>> wxcast forecast "325 Broadway Boulder, CO"
        ...
        ----
        
        == Issues/Enhancements
        
        Please submit issues and requests to
        link:https://github.com/smarlowucf/wxcast/issues[Github].
        
        == Contributing
        
        Contributions to *wxcast* are welcome and encouraged.
        See link:CONTRIBUTING.adoc[CONTRIBUTING] for info on getting started.
        
        == License
        
        Copyright (c) 2017 Sean Marlow.
        
        Distributed under the terms of GPL-3.0+ license, see
        link:LICENSE[LICENSE] for details.
        
        
        # Changes
        
        == v1.2.0 (2018-02-18)
        
        * Remove asserts.
        * Account for dictionary values in decoded metar.
        
        == v1.1.0 (2017-12-01)
        
        * Update readme.
        * Cleanup exception handling.
        * Add unit and integration tests with vcrpy.
        * Cleanup flake8 warnings.
        * Add config for travis integration testing.
        
        == v1.0.6 (2017-09-24)
        
        * Remove docs directory.
        * Fix manifest.
        
        == v1.0.5 (2017-09-24)
        
        == v1.0.4 (2017-09-24)
        
        * Fix license trove classifier.
        
        == v1.0.3 (2017-09-24)
        
        * Remove universal flag from setup config.
        
        == v1.0.2 (2017-09-24)
        
        * Fix doc extensions in setup.
        
        == v1.0.1 (2017-09-24)
        
        * Fix manifest.
        
        == v1.0.0 (2017-09-24)
        
        * Cleanup flake8 warnings.
        * Remove config in favor of geopy to get location for seven day forecast.
        * Migrate to f'{strings}'
        * Migrate to adoc from rst.
        * Cleanup code.
        * Update readme and docs.
        
        
        == v0.3.0 (2017-08-09)
        
        * Remove cert and use certifi for NWS API.
        * Convert elevation to feet.
        
        == v0.2.1 (2017-08-09)
        
        * Attempt to fix cert.
        
        == v0.2.0 (2017-08-08)
        
        * Attempt to fix cert.
        
        == v0.1.0 (2017-01-14)
        
        * First release on PyPI.
        
Keywords: wxcast
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
