lemon24 / reader

A Python feed reader library.
https://reader.readthedocs.io
BSD 3-Clause "New" or "Revised" License
456 stars 38 forks source link

I can't see the feed description #223

Closed lemon24 closed 3 years ago

lemon24 commented 3 years ago

... because it's not exposed at all.

lemon24 commented 3 years ago

I'll add the feed version in this issue as well, since they're pretty similar.

To do:

lemon24 commented 3 years ago

For version, I think version is OK, per https://feedparser.readthedocs.io/en/latest/version-detection.html.

There was an attempt to add JSON Feed support to feedparser, but it was abandoned (? as of 2021-10, it is on develop, but not on master; https://github.com/kurtmckee/feedparser/issues/103). It uses json1 and json11 as versions.

However, json10 may fit better with the existing versions (e.g. rss20, atom10)...


For description, RSS has description ("Phrase or sentence describing the channel.") and Atom has subtitle ("Contains a human-readable description or subtitle for the feed."); they're accesible by either name on the object returned by feedparser (d.feed.{description,subtitle}).

JSON Feed has description ("provides more detail, beyond the title, on what the feed is about. A feed reader may display this text.").

FWIW, here's the subtitle word length for my feeds:

Per #153, we'll use the Atom name, subtitle, as the attribute name.