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 from Python applications via a simple object model and in a human-friendly fashion.

PyOWM is released under the MIT license.

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

Current PyOWM version

1.0.0

Currently supported Python versions

2.7, 3.2, 3.3

Currently supported OWM API versions

2.5

Currently supported platforms

Windows, Linux, MacOS X

Installation

There are many ways to install.

You can use the pip installer with: pip install pyowm

You can install from source with setuptools: first, download your release either from GitHub or from the from the Python Package Index and then install with

unzip pywom-x.y.z
cd pywom-x.y.z
python setup.py install

Windows users may also install PyOWM using a specific .exe binary which is available on the Python Package Index

Test the codebase

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

python setup.py test

this will also run integration tests (which need time and a network connectivity in order to reach the real OWM web API). If you just want to run unit tests, move into the library installation folder and launch with:

python setup.py test -s tests.unit

API documentation

The library API documentation is available on Read the Docs.

Usage examples

Usage examples are available on the wiki page.