aio-georss-client

What it is and what it does

aio-georss-client is an async Python library for consuming GeoRSS feeds—XML feeds that carry geographic data. It abstracts the mechanics of fetching and parsing GeoRSS data, exposing a simple update() call that returns a status code and a list of feed entries. The library handles three geometry types (Point, Polygon, Bounding Box) and is designed to be subclassed for specific feed sources.

The package includes a Feed Manager that tracks feed state across updates, reporting which entries are new, updated, or removed compared to the previous fetch. It distinguishes between the timestamp of any update attempt and the timestamp of successful updates, letting consumers handle intermittent failures gracefully. Built on aiohttp, haversine, xmltodict, and python-dateutil, it integrates into async Python applications.

Use it for:

• Monitor geographic feeds and track which entries are new, updated, or removed across successive updates.
• Build integrations that consume GeoRSS data and trigger actions based on feed state changes.
• Filter geographic feed data by geometry type before passing it downstream to other systems.
• Handle intermittent feed update failures by distinguishing successful updates from failed attempts.

Worth the install?

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

Provides async access to GeoRSS feeds with support for multiple geometry types and feed management tracking of new, updated, and removed entries.

Yes. The package is actively maintained, production-stable, has low install friction, carries a permissive license, and solves a specific problem (async GeoRSS consumption with state tracking). It is well-suited for applications that need to consume geographic feeds with reliable change tracking.

Install

aio-georss-client on PyPI

pip install aio-georss-client

uv add aio-georss-client

poetry add aio-georss-client

Installing aio-georss-client

Before you install

Low install friction with a pure Python wheel. Actively maintained as of 2026-07-21, marked production/stable, and requires Python 3.11 or later.

License in practice

Licensed under Apache-2.0 (permissive), allowing commercial use, modification, and distribution with minimal restrictions.

Quickstart

pip install aio-georss-client

import aiohttp
from aio_georss_client import GeoRssFeed

async with aiohttp.ClientSession() as session:
    feed = GeoRssFeed(session, feed_url)
    status, entries = await feed.update()

Requires Python 3.11 or later; aiohttp ClientSession must be provided.

Verify before relying

• Whether the library handles authentication for feeds that require it
• Performance characteristics when processing large feeds or many concurrent updates
• Whether custom geometry filtering is extensible beyond Point, Polygon, and Bounding Box

Package facts

Evidence: aio_georss_client-2026.6.0-py3-none-any.whl

Keywords: homeassistant, georss

Tags

More Internet packages