imgw-pib

What it is and what it does

This package provides an async Python client for querying weather and hydrological data from Poland's IMGW-PIB (Institute of Meteorology and Water Management) API. It wraps the HTTP API calls using aiohttp, allowing non-blocking requests suitable for integration into async applications. The library handles API errors, network timeouts, and client errors with specific exception types.

The package is built on aiofiles, aiohttp, orjson, and yarl for efficient async I/O and JSON parsing. It targets modern Python (3.13+) and is classified as production-stable. Use it when you need to fetch current or historical weather and water-level data for Polish monitoring stations in an async context.

Use it for:

• Fetch real-time weather data from Polish meteorological stations for a weather dashboard or alert system.
• Monitor hydrological station data (water levels, flow rates) for flood prediction or water resource management.
• Integrate IMGW-PIB data into an async IoT or home automation system that queries multiple APIs concurrently.
• Build a data pipeline that periodically collects weather and hydrological observations for analysis or archival.
• Create a weather API aggregator that combines IMGW-PIB with other regional data sources.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

An async Python wrapper for the IMGW-PIB API that fetches weather and hydrological station data from Poland's Institute of Meteorology and Water Management.

Yes, if you need Polish weather or hydrological data in an async Python application. The package is actively maintained, has no known vulnerabilities, and uses a permissive license. The Python 3.13+ requirement is restrictive but intentional; verify your target environment supports it. Low install friction and a clear API make it straightforward to adopt.

Install

imgw-pib on PyPI

pip install imgw-pib

uv add imgw-pib

poetry add imgw-pib

Installing imgw-pib

Before you install

Low install friction with a pure-Python wheel. Active maintenance with a release 18 days ago and recent commits. Requires Python 3.13 or later, which narrows compatibility to current versions only.

License in practice

Apache-2.0 permissive license allows commercial and private use with minimal restrictions.

Quickstart

import asyncio
from aiohttp import ClientSession
from imgw_pib import ImgwPib

async def main():
    async with ClientSession() as session:
        imgwpib = await ImgwPib.create(session, weather_station_id="12200")
        weather = await imgwpib.get_weather_data()
        print(weather)

asyncio.run(main())

Requires Python 3.13 or later; requires an active aiohttp ClientSession and valid IMGW-PIB station IDs.

Verify before relying

• Whether the package handles rate limiting or connection pooling for repeated API calls
• API availability and stability guarantees for the underlying IMGW-PIB service
• Whether station IDs are discoverable or must be known in advance

Package facts

Evidence: imgw_pib-2.5.1-py3-none-any.whl

Tags

More WWW/HTTP packages