python-weather

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

Getting started

Run the following command in your terminal:

$ pip install python-weather

Example

For more information, please read the documentation.

# Import the module.
import python_weather

import asyncio
import os


async def main() -> 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')
    
    # Fetch the temperature for today.
    print(weather.temperature)
    
    # Fetch weather forecast for upcoming days.
    for daily in weather:
      print(daily)
    
      # Each daily forecast has their own 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(main())

Data source

This library depends on wttr.in, which uses data from the World Weather Online API.

Donations

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

Metadata

Release files for python-weather 2.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for python-weather 2.1.0
File	Size	Uploaded
python_weather-2.1.0.tar.gz	13.1 kB	May 30, 2025	Details

Built distribution (wheel)

Table of built distributions (wheels) for python-weather 2.1.0
File	Interpreter	ABI	Platform	Reset
python_weather-2.1.0-py3-none-any.whl 17.7 kB May 30, 2025	Python 3	none	any	Details

Total release size: 30.8 kB

Release files / python_weather-2.1.0.tar.gz

Download URL	python_weather-2.1.0.tar.gz
Size	13.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`352dfe73201874914da994989ae5d828b6e9fd10b35379386f89a7ac5a9e75f6`
BLAKE2b-256 checksum How to use checksums	`86c7055379b1055c4e98bc3bf75fb7e0e24d1c608d46d37e8ac349accc273230`
Upload date	May 30, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.13.3`

Release files / python_weather-2.1.0-py3-none-any.whl

Download URL	python_weather-2.1.0-py3-none-any.whl
Size	17.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`76d80c8a04ff40b35066ef48d67c73b72f947d28c0f1a3eb8bd22720e5a9e63e`
BLAKE2b-256 checksum How to use checksums	`fbf8f1e8bbe74d0528bdf1813742a912f89eba2f2cdb78c7b61d4894d5f403ad`
Upload date	May 30, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.13.3`