New features

380 Implemented National Weather Alerts support 376 Now PyOWM uses SQLite instead of files to internally store city data. CityIDRegistry interface has changed but in a retrocompatible way

Enhancements

381 Now it is possible to specify how many times to retry an API call

Bugfixes

379 Experimental fix for 404 errors on Agromonitor API satellite image search 387 Fixed lat/lon swap bug on Airpollution API 389 Fixed wrong city name in City ID database

• New features

  • Support for new AirPollution API encompassing current, historical and forecast air pollution indicators and air quality index
  • Support for new Geocoding API
  • Python 3.9 supported
  • New matching method for CityIDRegistry: startswith

• Enhancements

  • added probability of precipitation in OneCall API responses

• Bugfixes

  • fixed many typos in the documentation (code recipes)

• Security

  • Automatic fixes nailed by Dependabot

• Deprecations introduced

  • will be removed in version 4.0.0:
    • AirPollutionManager.coindex_around_coords
    • AirPollutionManager.ozone_around_coords
    • AirPollutionManager.no2index_around_coords
    • AirPollutionManager.so2index_around_coords

What's new in Release 3.1.1

Bugfixes:

• Minutely rain data on OneCall calls were not read by PyOWM
• Fixed bugs in code recipes

New features:

• Support for OneCall minutely forecast data

Enhancements:

• OneCall calls now support units and exclude parameters
• queries to weather objects now support new visibility distance (miles) and barometric pressure (InHG) units
• now it is possible to obtain weather icons in 2 sizes (2x, 4x)
• all PyOWM timestamps are now timezone-aware
• now PyOWM exposes a list of OWM supported languages (pyowm.constants.LANGUAGES)
• added an FAQ page to the documentation

Bugfixes:

• tons on the documentation
• removed dependency version pinning on PySocks
• patched wrong subdomains for paid API calls

This is a major release.

This means that no retrocompatibility is offered, as many high-level PyOWM interface functions have been modified or removed: this might result in your client code breaking.

But fear not! Patching your code is very likely a breeze: please verify the "migration guide" in the documentation about how to patch.

New and modified features

• dict configuration
• added support for OneCall endpoints
• renamed a few weather forecast functions
• dropped old OWM history retrieval features as today they're usable only with OWM paid plans
• renamed all "Java-style" getter methods (eg. get_temperature) so to allow Pythonic access to object attributes
• added HTTP/SOCKS proxies support
• dropped caches: pyowm won't feature any caching mechanism, that shall be done on the client code
• added timezone to Weather objects
• added more units of measurement for winds
• dropped XML schemas and XML dumps for entities
• dropped JSON dumps for entities: only Python dict dumps are now in place

Platforms Support

• dropped legacy support for Python2 and support for Python 3.4 - only supports Python 3.7+ now
• dropped support for Docker (no more Dockerfiles and Docker images)

Enhancements

• all entities now have dunder methods: __repr__, from_dict, to_dict
• added code recipes and corresponding integration tests
• documented PyOWM 2 maintenance timeline

Bugfixes

• on CityIDRegistyr now US cities have their actual US state attached and are therefore more easily searchable

Internals

• gave the weatherapi module exactly the same dignity as other api modules...
• PollutionAPI and UVIndexAPI: both will feature a Manager object, which will be instantiated by the new OWM entry point
• made Exceptions hierarchy more consistent

Security

• Now using SSL as the default option for all API calls
• HTTP calls timeout is increased to 5 seconds (to allow download of satellite images)
• finalized deprecations foreseen for v3

Notably, introducing support for Agro API free features!

• New features:

  • Support for editing polygons (Agro API)
  • Support for current soil data (Agro API)
  • Support for satellite imagery search, download and statistics (Agro API)
  • Support for searching current weather on cities inside a bounding box via the new owm25.weather_at_stations_in_bbox function
  • Now it is possible to download Map Tiles provided by OpenWeatherMap using the new dedicated pyowm.tiles.tile_manager.TileManager client

• Enhancements:

  • Refactored Weather API code to a dedicated package
  • Implemented an automated integration and release pipeline

• Bugfixes:

  • fixed wrong object to JSON dumping when calling send_measurements() on Stations API
  • relaxing hard upper limit on dependency geojson: from geojson>=2.3.0,<2.4 to geojson>=2.3.0,<3

• Security:

  • upgraded version for dependencies requests and urllib3 as known security issues were raised on them

• Python Versions Support:

  • dropped Python 3.3 support as it has reached end of life

Python 2.7 is now officially deprecated

Bugfixing support for it will be granted on the dedicated v2.9-LTS branch that will be killed off on Jan 1st, 2020

Please check out the drop timeline for details.

• New features:

  • Support for Weather Alerts
  • Support for UV Index Forecast and History
  • Logos for the project have been introduced! :)
  • Support for Python 3.7
  • Support for Pipfile

• Enhancements:

  • Heavily improved readthedocs documentation
  • Now PyOWM talks to OWM APIs over SSL
  • Refactored out one single consistent HTTP base client, based on requests
  • Refactored UV API and Air Pollution API code to dedicated packages

• Bugfixes:

  • issue on requests==2.19.1 incompatibility
  • now printing on console the detailed weather status (language-sensitive) instead of generic english-based weather status
  • fixed broken links in a few Markdown docs

• Deprecations introduced:

  • will be removed on 3.0.0: OWM25.weather_at_stations_in_bbox, OWM25.weather_at_station

• New features:

  • introduced support for Stations API 3.0
  • new methods for Forecaster class: will_have_clear, when_clear, will_be_clear_at
  • new light Docker images based on Alpine Linux

• Enhancements:

  • In the moment Forecast objects are created, their Weather objects having reference timestamps prior to that moment are discarded (this means: you only get real forecasts!)
  • Introduced requests as only PyOWM dependency: requests>=2.18.2,<2.19

• Bugfixes:

  • issue on city_id_registry read behaviour on Windows
  • issue on parsing Location objects

• Deprecations introduced:

  • will be removed on 3.0.0: forecaster.Forecaster.will_have_sun, forecaster.Forecaster.when_sun and forecaster.Forecaster.will_be_sunny_at

Takes place of 2.7.0