Home

What is PyOWM?

PyOWM is a client Python wrapper library for the OpenWeatherMap (OWM) web API.

It allows quick and easy consumption of OWM weather data (either observations and forecast) from Python applications via a simple object model.

PyOWM is released under the MIT license.

PyOWM does not require any additional library to the standard Python library modules.

Current PyOWM version

0.1.1

Currently supported Python versions

2.6, 2.7

Currently supported OWM API version

2.5

Currently supported platforms

Windows, Linux

Installation

You will need setuptools installed - read here how to do it. Just run (superuser privileges might be needed):

python setup.py install

and you'll be done.

Test the codebase

The full test battery can be issued by moving into the library installation folder and executing:

python setup.py test

The integration tests battery can be launched by moving into the library installation folder and executing:

cd tests/functional
python -m unittest discover  

Integration testing needs time and a network connectivity in order to reach the real OWM web API.

API documentation

The library API documentation is available on Read the Docs.

Usage examples

Usage examples are available here.