PyOWM version 3

This is meant to be a manifest for PyOWM version 3

Supported OWM APIs

• Agro APIs
  • Polygons
  • Soil
  • Satellite Imagery
  • MORE TBD
• Weather API
• Stations API
• UV Index API
• Air Pollution API
• Weather Alerts API
• Map tiles

Supported Python versions

• drops legacy support for Python2 and support for Python 3.4
• only supports py37+ (therefore also the new py38)

Global library features

• on CityIDRegistyr now US cities have their actual US state attached and are therefore more easily searchable
• give the weatherapi module exactly the same dignity as other api modules...
• finalize deprecations already foreseen for v3
• dict configuration
• remove caches: pyowm won't feature any caching mechanism, that will be on the client's
• make a consistent Exceptions hierarchy and use it
• HTTP/SOCKS proxies support
• No more Dockerfiles or Docker images
• HTTP calls timeout is increased to 5 seconds (to allow to safely download satellite images)
• Use SSL is the default option

PollutionAPI and UVIndexAPI new features

• both will feature a Manager object, which will be instantiated by the new OWM entry point

WeatherAPI features

• Added support for OneCall endpoints
• dropped old PyOWM history retrieval features as today they're usable only with OWM paid plans
• rename weather forecast functions
• Refactor CityIDRegistry to commons
• Add timezone to Weather objects
• More wind units conversions

Companion docs

• migration guide from V2 to V3
• remove most of the development-oriented docs: users tipically don't care about it
• add code recipes and corresponding integration tests
• document PyOWM 2 maintenance timeline

Wiki

• Wiki pages must NOT serve as documentation sources! Therefore docs-like pages must be removed and links to them shall be replaced to links to the actual Readthedocs documentation pages

Diffs with respect v2

• write an automation script to generate boilerplate code for new entities
• remove XML schemas and XML dumps for entities
• remove JSON dumps for entities (only Python dict dumps will be allowed)
• remove all Java style getter methods (eg. get_temperature), so to allow Pythonic access to obj attributes
• all entities shall have methods: __repr__, from_dict, to_dict
• do we really need parsers when we have from_dict methods??? If not, these can be dropped
• clean modules style: add shebangs, file econding, order imports alphabetically