Pyowm

New features
[380](https://github.com/csparpa/pyowm/issues/380) Implemented [National Weather Alerts](https://openweathermap.org/api/one-call-api#listsource) support
[376](https://github.com/csparpa/pyowm/issues/376) Now PyOWM uses SQLite instead of files to internally store city data. `CityIDRegistry` interface has changed but in a retrocompatible way


Enhancements
[381](https://github.com/csparpa/pyowm/issues/381) Now it is possible to specify how many times to retry an API call


Bugfixes
[379](https://github.com/csparpa/pyowm/issues/379) Experimental fix for `404` errors on Agromonitor API satellite image search
[387](https://github.com/csparpa/pyowm/issues/387) Fixed lat/lon swap bug on Airpollution API
[389](https://github.com/csparpa/pyowm/pull/389) Fixed wrong city name in City ID database

- **New features**
- Support for new [AirPollution API](https://openweathermap.org/api/air-pollution) encompassing current, historical and forecast air pollution indicators and air quality index
- Support for new [Geocoding API](https://openweathermap.org/api/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`

3.1.1bis

----------------------------
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](https://openweathermap.org/api/one-call-api)
- 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](https://github.com/csparpa/pyowm/issues/248)
- [added support for OneCall endpoints](https://github.com/csparpa/pyowm/issues/301)
- [renamed a few weather forecast functions](https://github.com/csparpa/pyowm/issues/42)
- 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](https://github.com/csparpa/pyowm/issues/233)
- dropped caches: pyowm won't feature any caching mechanism, that shall be done on the client code
- [added timezone to Weather objects](https://github.com/csparpa/pyowm/issues/293)
- [added more units of measurement for winds](https://github.com/csparpa/pyowm/issues/188)
- 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](https://github.com/csparpa/pyowm/issues/262) and corresponding integration tests
- [documented PyOWM 2 maintenance timeline](https://github.com/csparpa/pyowm/issues/265)

**Bugfixes**
- [on CityIDRegistyr now US cities have their actual US state attached](https://github.com/csparpa/pyowm/issues/309) 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](https://github.com/csparpa/pyowm/issues/303) for all API calls
- HTTP calls timeout is increased to 5 seconds (to allow download of satellite images)
- finalized deprecations foreseen for v3

freeze-2.9-LTS

Notably, introducing support for **Agro API free features**!

- New features:
- Support for [editing polygons](https://agromonitoring.com/api/polygons) (Agro API)
- Support for [current soil data](https://agromonitoring.com/api/current-soil) (Agro API)
- Support for [satellite imagery search, download and statistics](https://agromonitoring.com/api/images) (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](https://openweathermap.org/api/weathermaps) 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