georss-generic-client

What it is and what it does

This library wraps GeoRSS feed consumption with location-aware filtering and state tracking. You instantiate a feed class with coordinates and optional filters (radius in kilometers, category names), call update() to fetch and parse the feed, and receive a status code plus a list of entries. The Feed Manager layer tracks changes across updates, reporting new entries, updates to existing ones, and removals—useful for applications that need to react incrementally to feed changes rather than reprocessing everything each time.

It's designed for scenarios where you're monitoring geographic events (alerts, incidents, weather) from remote feeds and want to filter by proximity and category without writing your own GeoRSS parser. The library handles the HTTP fetch, XML parsing, and state bookkeeping; you provide the feed URL and filter criteria.

Use it for:

• Monitor bushfire or emergency alerts within a specified radius of a home location.
• Track geographic event feeds (earthquakes, weather warnings) filtered by distance and category.
• Build a feed aggregator that detects and reports only new or changed entries since the last poll.
• Integrate location-based feed updates into a home automation or alerting system.
• Filter multi-category GeoRSS feeds to show only events matching specific criteria.

Worth the install?

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

Provides generic access to GeoRSS feeds with location-based filtering and change tracking across feed updates.

Yes, if you need to consume GeoRSS feeds with location filtering. The library is actively maintained, has no known vulnerabilities, supports modern Python versions, and carries a permissive license. Install friction is low. The main unknown is the stability of its single runtime dependency; verify that georss_client itself meets your reliability requirements before committing.

Install

georss-generic-client on PyPI

pip install georss-generic-client

uv add georss-generic-client

poetry add georss-generic-client

Installing georss-generic-client

Before you install

Low install friction with a single runtime dependency. Active maintenance with a recent release (48 days old) and commits through July 2026. Supports current Python versions (3.11–3.14).

License in practice

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

Quickstart

pip install georss-generic-client

from georss_generic_client import GenericFeed
feed = GenericFeed((-27.5, 153.0), filter_radius=200,
                   url="https://example.com/feed.xml")
status, entries = feed.update()

Requires Python 3.11 or later.

Verify before relying

• Whether the single runtime dependency (georss_client) itself has stable maintenance and low friction.
• Performance characteristics when processing large feeds or frequent updates.
• Real-world reliability of the Feed Manager's change detection across different GeoRSS feed formats.

Package facts

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

Keywords: homeassistant, georss

Tags

More Internet packages