Metadata-Version: 2.4
Name: aio-podcast
Version: 0.1.0
Summary: Typed asynchronous podcast feed client
Project-URL: Source, https://github.com/armilancode/aio-podcast
Project-URL: Issues, https://github.com/armilancode/aio-podcast/issues
License-Expression: Apache-2.0
License-File: LICENSE
Classifier: Development Status :: 3 - Alpha
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Typing :: Typed
Requires-Python: >=3.11
Requires-Dist: aiohttp>=3.11
Description-Content-Type: text/markdown

# aio-podcast

`aio-podcast` is a typed asynchronous client for podcast RSS and Atom feeds.
It accepts an existing `aiohttp.ClientSession`, parses responses incrementally,
and returns immutable normalized models.

```shell
python -m pip install aio-podcast
```

## Features

- RSS 2.0 and Atom podcast feeds
- Apple Podcasts and Media RSS metadata
- Injected `aiohttp.ClientSession`
- Incremental parsing with configurable response and chunk limits
- Relative enclosure, artwork, and website URL resolution
- Typed exceptions and PEP 561 type information
- DTD and entity declaration rejection

## Usage

```python
import aiohttp

from aiopodcast import PodcastClient


async def load_podcast(url: str) -> None:
    async with aiohttp.ClientSession() as session:
        podcast = await PodcastClient(session).async_fetch(url)
        print(podcast.title)
        for episode in podcast.episodes:
            print(episode.title, episode.enclosure.url)
```

Applications that already manage an `aiohttp.ClientSession` should pass that
session to `PodcastClient`. The client never closes an injected session.

## Requirements

- Python 3.11 or newer
- aiohttp 3.11 or newer

## License

Apache License 2.0
