Skip to main content

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.

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

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

Metadata

Release files for aio-podcast 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for aio-podcast 0.1.0
File Size Uploaded Provenance Actions
aio_podcast-0.1.0.tar.gz 14.2 kB With provenance Details for aio_podcast-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for aio-podcast 0.1.0
File Interpreter ABI Platform Actions
aio_podcast-0.1.0-py3-none-any.whl Python 3 none any Details for aio_podcast-0.1.0-py3-none-any.whl

Total release size: 26.3 kB

Release files / aio_podcast-0.1.0.tar.gz

Download URL aio_podcast-0.1.0.tar.gz
Size 14.2 kB
Tags Source
SHA-256 checksum
How to use checksums
d8e0328fa59e9a5e0f5e4bfc6680efb0086bb7ba2607fa4f41c855a12016bed4
BLAKE2b-256 checksum
How to use checksums
ecb60ee417978eca094b8c4566666e9f9292f6ac5c6ea168da8af99da5ab14cd
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Aug 4, 2026.

Transparency log

Release files / aio_podcast-0.1.0-py3-none-any.whl

Download URL aio_podcast-0.1.0-py3-none-any.whl
Size 12.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
cd3a8e57f36d8828ef854a00e2c7e4ddb7acc601b00f892739c41af9f553034a
BLAKE2b-256 checksum
How to use checksums
73228c20eaab1cbacc59fd3d81ad95d8512830b099530636e6058369a2f514f1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Aug 4, 2026.

Transparency log

Security for aio-podcast 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for aio_podcast-0.1.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Aug 4, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page