Skip to content

Changelog

Jump to bottom
Claudio Sparpaglione edited this page Dec 23, 2017 · 28 revisions

What's new in Release 2.8.0

  • 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

What's new in Release 2.7.1

  • New features:

    • introduced support for Sulphur Dioxide (SO2) and Nitric Dioxide (NO2): new methods owm25.no2index_around_coords and owm25.so2index_around_coords
    • implemented wind speed units specification (imperial/metric)

  • Bugfixes:

    • updated weather history endpoint (was broken)
    • fix bug about data parsing at station_at_coords and weather_at_station methods
    • now the deg attribute is correctly parsed from 16 day forecast weather data items
    • fix bug on printing Unicode upon library exceptions
    • fix handling of Weather objects parsing (it was failing whenever some data wasn't provided by OWM)

  • Enhancements:

    • shrinked city ID files size by 60% (via compression)
    • reported in the Wiki a list of known projects that use PyOWM
    • integrated the Say Thanks! hook
    • introduced CONTRIBUTING.md and CODE_OF_CONDUCT.md files, thus welcoming GitHub's suggested best practices for building better open source communities
    • introduced installation tests
    • improved integrations tests organization and running

  • Breaking changes:

    • OWM decided to change the syntax of API endpoint for fetching UV data and its format in a non-retrocompatible manner. This results into UVIndex object entity fields changing, as well as the corresponding OWM25 method signature (owm25.uvindex_around_coords).

What's new in Release 2.6.1

  • Bugfixes:
    • 2.6.0 was not packaging resource files (eg. city IDs text files)

What's new in Release 2.6.0

  • New features:
    • new method owm25.weather_at_zip_code
    • new methods CityIDRegistry.ids_for and CityIDRegistry.locations_for
    • introduced deprecation decorators to mark methods that will be removed/modified in future versions
    • Python 3.6 support
  • Bugfixes:
  • Enhancements:
    • reorganized project Wiki
    • embedded PyOWM usage examples as markdown file into the distribution package
  • Deprecations introduced:
    • will be removed on 3.0.0: webapi25.cityidregistry.id_for and webapi25.cityidregistry.location_for
    • will be modified on 3.0.0: webapi25.owm25.get_version and webapi25.owm25.get_API_version

What's new in Release 2.5.0

  • New features:
  • Bugfixes:
    • fixed OWM25.is_API_online method (was not working)
    • more robust support for querying data on Unicode place names
  • Enhancements: now datetime objects across all library are timezone-aware
  • PyOWM Slack team is live!

What's new in Release 2.4.0

  • New features:
    • weather_at_ids
    • weather_history_at_coords
    • introduced support for Python 3.4 and 3.5
  • Bugfixes: full support for Unicode place names
  • Enhancements:
    • datetime representation of reception/reference times in Weather, Forecast, History objects
    • better exception hierarchy
  • Updated city ID registry files

What's new in Release 2.3.2

  • Bugfix: no crashes when data about wind, snow and rain in JSON API responses are null

What's new in Release 2.3.1

  • Bugfix: always send an API key to OWM API

What's new in Release 2.3.0

  • New feature: can now specify wether to use the pro OWM API version or not:
    owm = OWM(subscription_type='pro', API_key='my-pro-api-key')
  • Better support for Python 3 on CityIDRegistry
  • Bug fixes on parsing of humidity, wind and visibility

What's new in Release 2.2.1

  • Fixed bug on visibility distance parsing

What's new in Release 2.2.0

  • New entity Station: represents a meteostation recording weather data
    Station(name, station_ID, station_type, status, lat, lon, distance=None, last_weather=None)
  • New feature: search for meteostations around a lat/lon couple
    owm25.station_at_coords(42.4, 13.9)
  • New feature: retrieve weather currently measured by a meteostation
    owm25.weather_at_station(916)
  • New feature: retrieve weathers currently measured by meteostations within a bounding box
    owm25.weather_at_stations_in_bbox(lat_top_left, lon_top_left, lat_bottom_right, lon_bottom_right, cluster=False, limit=None)
  • Can now query for weather forecasts based on geographical coordinates
    three_hours_forecast_at_coords(42.4, 13.9)
    daily_forecast_at_coords(42.4, 13.9, limit=4)
  • Can now query for weather forecasts based on city ID
    three_hours_forecast_at_id(7768)
    daily_forecast_at_id(7768, limit=4)
  • Support querying of extreme weather conditions in Forecaster convenience methods
    when_storm()
    will_have_storm()
    will_be_stormy_at()

    when_tornado()
    will_have_tornado()
    will_be_tornado_at()

    when_hurricane()
    will_have_hurricane()
    will_be_hurricane_at()
  • Enriched Weather class with methods to support data fields retrieved from meteostations
    get_dewpoint()
    get_humidex()
    get_heatindex()
    get_visibility_distance()

  • Now supporting Unicode strings as parameters for all PyOWM public methods

  • Increased test coverage

Release 2.0.0

  • Renaming of some functions in PyOWM public interface (breaking change!)
    owm25.API_online             -> owm25.is_API_online
    owm25.weather_at             -> owm25.weather_at_place
    owm25.find_weather_by_name   -> owm25.weather_at_places
    owm25.find_weather_by_coords -> owm25.weather_around_coords
    owm25.weather_history        -> owm25.weather_history_at_place
  • Multilingual support for weather data descriptions
    owm = OWM(language='ru')
    obs = owm.weather_at('Moscow')
    obs.get_weather().get_detailed_status()  # "ясно"
  • Can now retrieve current weather from city IDs
    owm.weather_at_id(5128581)
  • Can now retrieve weather history from city IDs
    owm.weather_history_at_id(5128581)
  • Can now do toponyms to city IDs conversions using a registry
    registry = owm.city_id_registry()
    registry.id_for("New York,US")  # 5128581
  • Added more human-friendly utilities in Historian and timeutils modules
    Historian.max_temperature()
    Historian.max_humidity()
    Historian.max_pressure()
    Historian.max_rain()
    Historian.min_temperature()
    Historian.min_humidity()
    Historian.min_pressure()
    Historian.min_rain()
    Historian.average_temperature()
    Historian.average_humidity()
    Historian.average_pressure()
    Historian.average_rain()

    timeutils.next_week()
    timeutils.last_week()
    timeutils.next_hour()
    timeutils.last_hour()
  • Now checking code coverage via coveralls.io

Older Releases

Release 1.2.0

  • Ported to Python 3 while maintaining Python 2.7+ compatibility
  • Python 2.6 is now unsupported (please update to 2.7)
  • Bug fixes

Release 1.0.0

  • Users can inject configuration when instantiating the library
  • Code is now compliant to PEP-8 guidelines
  • Added XMLNS support to printed XML
  • Refactoring of low-level utility functions
  • Bug fixes

PyOWM API docs  |  csparpa

Clone this wiki locally