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.4.3.tar.gz (31.7 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.4.3-py3-none-any.whl (27.9 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: imgw_pib-2.4.3.tar.gz
  • Upload date:
  • Size: 31.7 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.4.3.tar.gz
Algorithm Hash digest
SHA256 4b7f5b4ed43b03d98e6f420a54cbf994f3fd46c13a3c2f42bae34d946ae0b739
MD5 e8caddff80e061289b090abb62044aab
BLAKE2b-256 e5486f352c98163818e5e1c3b3bccd03d9183b5064564f82ca9ce333236a58bd

See more details on using hashes here.

Provenance

The following attestation bundles were made for imgw_pib-2.4.3.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.4.3-py3-none-any.whl.

File metadata

  • Download URL: imgw_pib-2.4.3-py3-none-any.whl
  • Upload date:
  • Size: 27.9 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.4.3-py3-none-any.whl
Algorithm Hash digest
SHA256 27d4b927a07706f5e9d99d6a6537cb40f1ff23497beda1845b63f94c9b64209a
MD5 b53ca0a4a235671c85309e41ed24c4a0
BLAKE2b-256 093d41f6d701abd92c4d8c7a4e4be1e1e8ede6d0397f7c93c4836dafadc0d44f

See more details on using hashes here.

Provenance

The following attestation bundles were made for imgw_pib-2.4.3-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