aiolimburgnet
Async Python client for the public limburg.net waste
collection calendar API. It has no dependency on Home Assistant — it's a
plain aiohttp-based library, usable standalone or as the backing library
for the limburg_net Home Assistant integration.
Installation
pip install aiolimburgnet
Usage
import asyncio
import aiohttp
from aiolimburgnet import LimburgNetClient
async def main() -> None:
async with aiohttp.ClientSession() as session:
client = LimburgNetClient(session)
city = await client.find_city("Genk")
street = await client.find_street(city, "Stationsstraat")
events = await client.get_upcoming_events(
city, street, house_number="12", suffix=""
)
for event in events:
print(event.date, event.waste_type)
asyncio.run(main())
API
LimburgNetClient(session: aiohttp.ClientSession)await client.find_city(query: str) -> Cityawait client.find_street(city: City, query: str) -> Streetawait client.get_upcoming_events(city, street, house_number, suffix="", months_ahead=3) -> list[CollectionEvent]
City, Street, and CollectionEvent are frozen dataclasses. All lookup
failures raise a subclass of LimburgNetError:
CityNotFoundError— no city matched the search queryStreetNotFoundError— no street matched the search query within that cityLimburgNetConnectionError— the API could not be reached or returned an error
Development
pip install -e ".[test]"
pytest
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file aiolimburgnet-0.1.0.tar.gz.
File metadata
- Download URL: aiolimburgnet-0.1.0.tar.gz
- Upload date:
- Size: 5.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
23bae02869437e619ee5d0d79835cf559973a16bb08cabd01bd532fa23b33afe
|
|
| MD5 |
ceac5eac5a278ed148e53c016fc2fd3e
|
|
| BLAKE2b-256 |
d1747fd03df7cabb57cc9447a799fa73f18cc84412f92a8e864a840e8626813e
|
Provenance
The following attestation bundles were made for aiolimburgnet-0.1.0.tar.gz:
Publisher:
publish-aiolimburgnet.yml on marcelhoffs/ha-limburg-net
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
aiolimburgnet-0.1.0.tar.gz -
Subject digest:
23bae02869437e619ee5d0d79835cf559973a16bb08cabd01bd532fa23b33afe - Sigstore transparency entry: 2520411128
- Sigstore integration time:
-
Permalink:
marcelhoffs/ha-limburg-net@a1878b3f400edadc8d3f321457005eca42ee3515 -
Branch / Tag:
refs/tags/aiolimburgnet-v0.1.0 - Owner: https://github.com/marcelhoffs
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-aiolimburgnet.yml@a1878b3f400edadc8d3f321457005eca42ee3515 -
Trigger Event:
push
-
Statement type:
File details
Details for the file aiolimburgnet-0.1.0-py3-none-any.whl.
File metadata
- Download URL: aiolimburgnet-0.1.0-py3-none-any.whl
- Upload date:
- Size: 5.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9638159167110db176c5b348f507dcf45968f3c8317d13a7a5a0d00ff9e19269
|
|
| MD5 |
6de14e8437e819556860fc46d094c56a
|
|
| BLAKE2b-256 |
6ba799f680a72f3af1d898b02692ffdebf4e8b3bfe1c667c855935c6615831ea
|
Provenance
The following attestation bundles were made for aiolimburgnet-0.1.0-py3-none-any.whl:
Publisher:
publish-aiolimburgnet.yml on marcelhoffs/ha-limburg-net
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
aiolimburgnet-0.1.0-py3-none-any.whl -
Subject digest:
9638159167110db176c5b348f507dcf45968f3c8317d13a7a5a0d00ff9e19269 - Sigstore transparency entry: 2520413529
- Sigstore integration time:
-
Permalink:
marcelhoffs/ha-limburg-net@a1878b3f400edadc8d3f321457005eca42ee3515 -
Branch / Tag:
refs/tags/aiolimburgnet-v0.1.0 - Owner: https://github.com/marcelhoffs
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-aiolimburgnet.yml@a1878b3f400edadc8d3f321457005eca42ee3515 -
Trigger Event:
push
-
Statement type:
