Skip to main content

CI codecov GitHub Release PyPI PyPI - Downloads Buy me a coffee PayPal_Me Revolut.Me

imgw-pib

Python async wrapper for IMGW-PIB API.

Installation

You can install the library with pip:

pip install imgw-pib

How to use the library

"""Example of usage IMGW-PIB."""

import asyncio
import logging

from aiohttp import ClientError, ClientSession

from imgw_pib import ApiError, ImgwPib

logging.basicConfig(level=logging.DEBUG)

WEATHER_STATION_ID = "12200"
HYDROLOGICAL_STATION_ID = "154190050"


async def main() -> None:
    """Run main function."""
    async with ClientSession() as websession:
        try:
            imgwpib = await ImgwPib.create(
                websession,
                weather_station_id=WEATHER_STATION_ID,
                hydrological_station_id=HYDROLOGICAL_STATION_ID,
            )
            weather_data = await imgwpib.get_weather_data()
            hydrological_data = await imgwpib.get_hydrological_data()
        except ApiError as error:
            print(f"API Error: {error.status}")
        except ClientError as error:
            print(f"ClientError: {error}")
        except TimeoutError as error:
            print(f"TimeoutError: {error}")
        else:
            print(f"Weather stations: {imgwpib.weather_stations}")
            print(f"Weather data: {weather_data}")
            print(f"Hydrological stations: {imgwpib.hydrological_stations}")
            print(f"Hydrological data: {hydrological_data}")


loop = asyncio.new_event_loop()
loop.run_until_complete(main())
loop.close()

Error handling

The library raises ApiError when the IMGW-PIB API returns an error, ClientError for network-related errors, and TimeoutError when a request times out.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

How to create a dev environment

git clone https://github.com/bieniu/imgw-pib.git
cd imgw-pib
./scripts/setup-local-env.sh

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

imgw_pib-2.5.0.tar.gz (32.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

imgw_pib-2.5.0-py3-none-any.whl (28.0 kB view details)

Uploaded Python 3

File details

Details for the file imgw_pib-2.5.0.tar.gz.

File metadata

  • Download URL: imgw_pib-2.5.0.tar.gz
  • Upload date:
  • Size: 32.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for imgw_pib-2.5.0.tar.gz
Algorithm Hash digest
SHA256 46e7cbfabfb1cf5233e4696073eb2dfb5cfd9827eb3ba0ad6c5eb821023fff9e
MD5 03d160cbea71a2745b17afb4239f317b
BLAKE2b-256 85d16b7d3a08ba1a8519aa2912911fefb48bb73a00d9c76b47d2dc05647c2385

See more details on using hashes here.

Provenance

The following attestation bundles were made for imgw_pib-2.5.0.tar.gz:

Publisher: publish.yml on bieniu/imgw-pib

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file imgw_pib-2.5.0-py3-none-any.whl.

File metadata

  • Download URL: imgw_pib-2.5.0-py3-none-any.whl
  • Upload date:
  • Size: 28.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for imgw_pib-2.5.0-py3-none-any.whl
Algorithm Hash digest
SHA256 40e601fd3e2996e2d0ae87c5ac85ae9411b9e5f460f65fb49ac2731df2327e8e
MD5 c11630b82c05cdebbc1186251ed74461
BLAKE2b-256 e06f42e58d43d41c528c7d37448db86062e7a699995cf5993d70c8207d15dc7b

See more details on using hashes here.

Provenance

The following attestation bundles were made for imgw_pib-2.5.0-py3-none-any.whl:

Publisher: publish.yml on bieniu/imgw-pib

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page