Python Backwards-Incompatible Changes

• Drop support for Python 3.8, which has reached end-of-life status (2f60aa1)

Bug Fixes

• Separate One Call root URI and HTTPClient (35c0feb)
  • This fixes an issue introduced in #444 where other weather APIs besides One Call also were switched to using a non-existent 3.0 instead of 2.5 in their URI
• Allow empty sender and description strings in NationalWeatherAlert initialization (#399)
• Fallback to path argument instead of empty string in HTTPClient.get_png and HTTPClient.get_geotiff (#401)
• Fix sqlite3.OperationalError with NamedTemporaryFile on Windows (#398)
• Update urllib3.util.Retry parameter name from method_whitelist to allowed_methods (#437)
• Correct OWM.version return type to tuple again instead of string (70ddaf5)
• Correct types for forecast parameters for OneCall initialization (#400)

Misc

• Replace pkg_resources usage with importlib.resources functions (#435)
• Remove print in Tile.bounding_polygon (9d2076b)
• Remove old build and publish scripts (971004c)
• Correct grammar in timeout error message for HTTPClient.get_json (#396)
• Update and improve various documentation and tests

New Features

• Document support for Python 3.10, 3.11, 3.12, and 3.13 (f0938be)
• Add support for geojson >= 3, < 4 (#415)

API Backwards-Incompatible Changes

• Update to use One Call API 3.0, as One Call API 2.5 has been deprecated (#404, #444)

Python Backwards-Incompatible Changes

• Drop support for Python 3.7, which has reached end-of-life status (087bffe)

Misc

• Replace old Slack workspace with GitHub Discussions (1234289)
• Remove PYOWM_VERSION constant (05f227f)
• Remove version_tuple_to_str utility function (2082a3f)
• Use GitHub Actions workflow to publish to PyPI (ef26046)

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