FastFeedParser

0.6.0 verified Fri May 01 auth: no python

High performance RSS, Atom, JSON and RDF feed parser in Python. Current version 0.6.0, actively developed on GitHub by kagisearch.

pip install fastfeedparser

Common errors

error AttributeError: 'NoneType' object has no attribute 'title' ↓

cause The returned object is None (parsing failed) but code tries to access `.title`.

fix

Check if the result is None: if result is not None: print(result.title)

error ImportError: cannot import name 'FastFeedParser' from 'fastfeedparser' ↓

cause Incorrect import; there is no class with that name.

fix

Use from fastfeedparser import parse.

error TypeError: parse() got an unexpected keyword argument 'raw' ↓

cause Using deprecated `raw` parameter removed in newer versions.

fix

Remove raw=True from the parse call.

Warnings

gotcha The `parse` function returns a `Feed` object, not a dict. Access attributes directly (e.g., `result.title`) rather than using `result['title']`. ↓

fix Use dot notation: `result.title`, `entry.link`, etc.

deprecated The `raw` parameter in `parse` is deprecated and will be removed in a future version. ↓

fix Remove the `raw` parameter; the library now always returns parsed objects.

gotcha If the feed URL returns non-UTF-8 content, parsing may fail. Ensure the server returns UTF-8 or handle encoding manually. ↓

fix Use requests to fetch content and pass bytes to `parse` with explicit encoding.

Imports

parse
```
from fastfeedparser import parse
```
Main parsing function, not a class.

Quickstart

Minimal example to parse a feed and print title, link, and entries.

from fastfeedparser import parse

feed_url = 'https://example.com/feed.xml'
result = parse(feed_url)
print(result.title, result.link)
for entry in result.entries:
    print(entry.title, entry.link, entry.published)