Metadata-Version: 1.1
Name: openweathermap-requests
Version: 0.0.5
Summary: openweathermap requests fetch weather history Pandas DataFrame
Home-page: https://github.com/scls19fr/openweathermap_requests
Author: Sebastien Celles
Author-email: s.celles@gmail.com
License: BSD
Description: |Latest Version| |Supported Python versions| |Wheel format| |License|
        |Development Status| |Downloads monthly| |Documentation Status|
        |Sourcegraph| |Gitter| |Code Health| |Build Status|
        
        OpenWeatherMap Requests
        =======================
        
        `Python <https://www.python.org/>`__ package to fetch data from
        `OpenWeatherMap.org <http://openweathermap.org/>`__ using
        `Requests <http://docs.python-requests.org/>`__ and
        `Requests-cache <https://requests-cache.readthedocs.org>`__ and get
        `Pandas DataFrame <http://pandas.pydata.org/>`__ with weather history.
        
        Command Line Interface Usage
        ----------------------------
        
        Current weather
        ~~~~~~~~~~~~~~~
        
        Get current weather data
        
        ::
        
            $ python openweathermap_requests.py --lon 0.34189 --lat 46.5798114
        
        Historical weather data
        ~~~~~~~~~~~~~~~~~~~~~~~
        
        Fetch historical weather data from nearest weather station of
        coordinates (lon=0.34189, lat=46.5798114) from 2014/01/01 to 2014/12/01
        using:
        
        ::
        
            $ python openweathermap_requests.py --lon 0.34189 --lat 46.5798114 --range 20140101:20141201
        
        Library Usage
        -------------
        
        ::
        
            import datetime
            import logging
            logger = logging.getLogger()
            logger.setLevel(logging.DEBUG)
            from openweathermap_requests import OpenWeatherMapRequests
        
            ow = OpenWeatherMapRequests(api_key='', cache_name='cache-openweathermap', expire_after=5*60)
        
            (lon, lat) = (0.34189, 46.5798114) # Poitiers
        
            data = ow.get_weather(lon=lon, lat=lat)  # display current weather data
            print(data)
        
            stations = ow.find_stations_near(lon=lon, lat=lat, cnt=10) # get 10 nearest stations from coordinates (lon, lat)
        
            station_id = stations.iloc[0]['station.id'] # get station_id of nearest station
        
            start_date = datetime.datetime(2014, 1, 1)
            end_date = datetime.datetime(2014, 6, 1)
        
            data = ow.get_historic_weather(station_id, start_date, end_date) # get historic weather from start date to end date
            print(data)
        
        Install
        -------
        
        From Python package index
        ~~~~~~~~~~~~~~~~~~~~~~~~~
        
        ::
        
            $ pip install openweathermap_requests
        
        From source
        ~~~~~~~~~~~
        
        Get latest version using Git
        
        ::
        
            $ git clone https://github.com/scls19fr/openweathermap_requests.git
            $ cd openweathermap_requests
            $ python setup.py install
        
        Links
        -----
        
        -  Documentation can be found at `Read The
           Docs <http://openweathermap-requests.readthedocs.org/>`__ ;
        -  Source code and issue tracking can be found at
           `GitHub <https://github.com/scls19fr/openweathermap_requests>`__.
        -  Feel free to `tip me <https://gratipay.com/scls19fr/>`__!
        
        .. |Latest Version| image:: https://img.shields.io/pypi/v/openweathermap_requests.svg
           :target: https://pypi.python.org/pypi/openweathermap_requests/
        .. |Supported Python versions| image:: https://img.shields.io/pypi/pyversions/openweathermap_requests.svg
           :target: https://pypi.python.org/pypi/openweathermap_requests/
        .. |Wheel format| image:: https://img.shields.io/pypi/wheel/openweathermap_requests.svg
           :target: https://pypi.python.org/pypi/openweathermap_requests/
        .. |License| image:: https://img.shields.io/pypi/l/openweathermap_requests.svg
           :target: https://pypi.python.org/pypi/openweathermap_requests/
        .. |Development Status| image:: https://img.shields.io/pypi/status/openweathermap_requests.svg
           :target: https://pypi.python.org/pypi/openweathermap_requests/
        .. |Downloads monthly| image:: https://img.shields.io/pypi/dm/openweathermap_requests.svg
           :target: https://pypi.python.org/pypi/openweathermap_requests/
        .. |Documentation Status| image:: https://readthedocs.org/projects/openweathermap-requests/badge/?version=latest
           :target: http://openweathermap-requests.readthedocs.org/en/latest/
        .. |Sourcegraph| image:: https://sourcegraph.com/api/repos/github.com/scls19fr/openweathermap_requests/.badges/status.png
           :target: https://sourcegraph.com/github.com/scls19fr/openweathermap_requests
        .. |Gitter| image:: https://badges.gitter.im/Join%20Chat.svg
           :target: https://gitter.im/scls19fr/openweathermap_requests?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge
        .. |Code Health| image:: https://landscape.io/github/scls19fr/openweathermap_requests/master/landscape.svg?style=flat
           :target: https://landscape.io/github/scls19fr/openweathermap_requests/master
        .. |Build Status| image:: https://travis-ci.org/scls19fr/openweathermap_requests.svg
           :target: https://travis-ci.org/scls19fr/openweathermap_requests
        
Keywords: data weather temperature history
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Science/Research
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Cython
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Topic :: Scientific/Engineering
Classifier: License :: OSI Approved :: BSD License
