https://github.com/null8626/python-weather

A free and asynchronous weather API wrapper made in python, for python.
https://github.com/null8626/python-weather

data-science forecast python weather weather-api weather-forecast

Last synced: 1 day ago
JSON representation

A free and asynchronous weather API wrapper made in python, for python.

• Host: GitHub
• URL: https://github.com/null8626/python-weather
• Owner: null8626
• License: mit
• Created: 2021-01-10T08:19:24.000Z (almost 4 years ago)
• Default Branch: main
• Last Pushed: 2024-10-28T04:24:47.000Z (17 days ago)
• Last Synced: 2024-10-28T07:44:41.737Z (17 days ago)
• Topics: data-science, forecast, python, weather, weather-api, weather-forecast
• Language: Python
• Homepage: https://python-weather.rtfd.io
• Size: 390 KB
• Stars: 100
• Watchers: 2
• Forks: 31
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • Changelog: changelog.yml
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        
# [python-weather][pypi-url] [![pypi][pypi-image]][pypi-url] [![downloads][downloads-image]][pypi-url] [![codacy-badge][codacy-url]][codacy-image] [![ko-fi][ko-fi-brief-image]][ko-fi-url]

[pypi-image]: https://img.shields.io/pypi/v/python-weather.svg?style=flat-square

[pypi-url]: https://pypi.org/project/python-weather/

[downloads-image]: https://img.shields.io/pypi/dm/python-weather?style=flat-square

[ko-fi-brief-image]: https://img.shields.io/badge/donations-ko--fi-red?color=ff5e5b&style=flat-square

[codacy-url]: https://app.codacy.com/project/badge/Grade/0f7721b7e4314a748c75a04f0a7e0ce3

[codacy-image]: https://app.codacy.com/gh/null8626/python-weather/dashboard

[ko-fi-image]: https://ko-fi.com/img/githubbutton_sm.svg

[ko-fi-url]: https://ko-fi.com/null8626

A free and asynchronous weather Python API wrapper made in Python, for Python.

## Installation

```console

pip install python-weather

```

## Example

For more information, please read the [documentation](https://python-weather.readthedocs.io/en/latest/).

```py

# import the module

import python_weather

import asyncio

import os

async def getweather() -> None:

  # declare the client. the measuring unit used defaults to the metric system (celcius, km/h, etc.)

  async with python_weather.Client(unit=python_weather.IMPERIAL) as client:

    # fetch a weather forecast from a city

    weather = await client.get('New York')

    

    # returns the current day's forecast temperature (int)

    print(weather.temperature)

    

    # get the weather forecast for a few days

    for daily in weather:

      print(daily)

      

      # hourly forecasts

      for hourly in daily:

        print(f' --> {hourly!r}')

if __name__ == '__main__':

  # see https://stackoverflow.com/questions/45600579/asyncio-event-loop-is-closed-when-getting-loop

  # for more details

  if os.name == 'nt':

    asyncio.set_event_loop_policy(asyncio.WindowsSelectorEventLoopPolicy())

  

  asyncio.run(getweather())

```

## Data source

This library depends on [`wttr.in`](https://github.com/chubin/wttr.in), which uses data from the [World Weather Online API](https://www.worldweatheronline.com/weather-api/).

## Donations

If you want to support this project, consider donating! ❤

[![ko-fi][ko-fi-image]][ko-fi-url]