python-yr 1.4.7.post2
Get the forecast from the norwegian wheather service yr.no in python

=========
python-yr
=========

Library for the norwegian weather service YR.no_ in Python_.

Install (easiest way)
=====================

.. code:: bash

    pip3 install python-yr

Usage
=====

.. code:: python

    from yr.libyr import Yr

    weather = Yr(location_name='Norge/Telemark/Skien/Skien')
    now = weather.now(as_json=True)

    print(now)

This returns
============

.. code:: json

    {
        "@from": "2014-06-04T08:00:00", 
        "@to": "2014-06-04T12:00:00", 
        "@period": "1", 
        "symbol": {
            "@number": "3", 
            "@numberEx": "3", 
            "@name": "Partly cloudy", 
            "@var": "03d"
        }, 
        "precipitation": {
            "@value": "0", 
            "@minvalue": "0", 
            "@maxvalue": "0.1"
        }, 
        "windDirection": {
            "@deg": "159.4", 
            "@code": "SSE", 
            "@name": "South-southeast"
        }, 
        "windSpeed": {
            "@mps": "1.3", 
            "@name": "Light air"
        }, 
        "temperature": {
            "@unit": "celsius", 
            "@value": "13"
        }, 
        "pressure": {
            "@unit": "hPa", 
            "@value": "1012.1"
        }
    }

For more usage examples visit folder examples_ or project wiki_

Pull requests
=============

Please everyone involved to generate demands and plans (pull requests), so we could set targets for next version 1.5 ;)

Branches
========

* develop_, the main (default) branch for development on GitHub_
* master_, branch for the stable release published on PyPi_
* python2_, branch with support for Python2
* csv-support_, branch with support for CSV export forecasts
* ...

.. _YR.no: http://www.yr.no/
.. _Python: http://www.python.org/
.. _examples: https://github.com/wckd/python-yr/blob/master/yr/examples
.. _wiki: https://github.com/wckd/python-yr/wiki
.. _develop: https://github.com/wckd/python-yr/tree/develop
.. _GitHub: https://github.com/wckd/python-yr/
.. _master: https://github.com/wckd/python-yr/tree/master
.. _PyPi: https://pypi.python.org/pypi/python-yr/
.. _python2: https://github.com/wckd/python-yr/tree/python2
.. _csv-support: https://github.com/wckd/python-yr/tree/csv-support

Changelog
=========
1.4.7 (2020 July 28)

* Now using version 2.0 of the met.no's locationforecast

1.4.5 (2016 May 19)

* Parse the 'nextrun' field from the cache file as UTC time (API_Locationforecast)

1.4.4 (2016 May 06)

* switched API_Locationforecast to https://api.met.no - fixing #34

1.4.2 (2015 Apr 21)

* add remove function to Cache
* add explicit installation of language-specific JSON files to setup ~> thanx to kurisuke_
* check the freshness of cache based on nextupdate tag in meta ~> thanx to knightsamar_

1.4.1 (2014 Dec 11)

* add logging support
* mod some variables
* mod catching exceptions
* rewrite LocationXYZ functionality to API_Locationforecast
    * swap longitude and latitude
    * add self.coordinates
    * add self.location_name ~> not ideal, so it will probably change in future
* add LocationXYZ wrapper over API_Locationforecast for backward compatibility
* mod hash names for temporary files
* improve setup.py
* mod README from Markdown to reStructuredText

1.4.0 (2014 Sep 12)

* add support for yr.no api service ~> thanks to lucadelu_
* add hourly forecast ~> thanks to antorweep1987_

1.3.2 (2014 Jul 11)

* improve exception-handling ~> thanks to mbambas_

1.3.1.1 (2014 Jul 10)

* bugfix: pypi/pip installer in 'setup.py'

1.3.1 (2014 Jul 10)

* bugfix: caching mechanism in 'is_fresh' function ~> thanks to antorweep1987_
* improve examples

.. _antorweep1987: https://github.com/antorweep1987
.. _mbambas: https://github.com/mbambas
.. _lucadelu: https://github.com/lucadelu
.. _kurisuke: https://github.com/kurisuke
.. _knightsamar: https://github.com/knightsamar