Feed::Find(3pm)

📦
version 0.13 · 5 versions
, in debian bookworm, debian trixie, ubuntu noble, ubuntu resolute, ubuntu stonking

💖 Feed::Find(3pm) 💖

okay bestie, welcome to Feed::Find — the Perl module that's literally a little detective for syndication feeds 🔍✨ it lives in your perl v5.36.0 world and it's here to sniff out feeds for you, no cap.

✨ NAME ✨

Feed::Find — Syndication feed auto-discovery 🦋

🌸 SYNOPSIS 🌸

use Feed::Find;
my @feeds = Feed::Find->find('http://example.com/');

like. that's it. that's the whole vibe. two lines and you're slaying 💅

🎀 DESCRIPTION 🎀

Feed::Find implements feed auto-discovery for finding syndication feeds, given a URI. bestie it currently passes all of the auto-discovery tests at http://diveintomark.org/tests/client/autodiscovery/ and honestly? we're obsessed. 👑

here's what Feed::Find will discover for you:

  • RSS 0.91
  • RSS 1.0
  • RSS 2.0
  • Atom

four formats, all iconic, no notes 🫶

🌈 USAGE 🌈

💜 Feed::Find->find($uri)

given a URI $uri, it uses a whole variety of techniques to find the feeds associated with that page. and here's the cute part: if $uri itself points to a feed (i.e., if the Content-Type of the response is a recognized feed type), it just returns $uri. main character energy, it already knew. ✨

returns a list of feed URIs.

the techniques it uses, in order:

  1. <link> tag auto-discovery — if the page contains any <link> tags in the <head> section, those tags get examined for recognized feed content types. these content types are treated as feeds: application/x.atom+xml, application/atom+xml, application/xml, text/xml, application/rss+xml, and application/rdf+xml. six of them. we counted. 💅
  2. Scanning <a> tags — if the page does not contain any known <link> tags, then the page gets scanned for <a> tags linking to URIs with certain file extensions. these extensions are treated as feeds: .rss, .xml, and .rdf.
heads up bestie: technique 2 is employed only if the first technique returns no results. it's giving backup plan. 🙈

🦋 Feed::Find->find_in_html(\$html [, $base_uri ])

give it a reference to a string $html containing an HTML page, and it uses the same techniques as described above in find to find the feeds associated with that page.

if you know the URI of the page, you should provide it in $base_uri, so that relative links can be properly made absolute. Feed::Find will attempt to determine the correct base URI, but unless that URI is specified in the HTML itself (in a <meta> tag), you'll need to supply it yourself. fr fr, don't skip this one. 😭

returns a list of feed URIs.

🌟 LICENSE 🌟

Feed::Find is free software; you may redistribute it and/or modify it under the same terms as Perl itself. iconic behavior honestly. 🫶

except where otherwise noted, Feed::Find is Copyright 2004 Benjamin Trott, ben+cpan@stupidfool.org. All rights reserved.

and that's the whole page, bestie!! this was Feed::Find(3pm) from the User Contributed Perl Documentation, generated by perl v5.36.0 on 2022-10-30 💖 thanks for reading my little manual-page essay, go forth and discover some feeds, periodt 🌸✨🎀

📦 where this page comes from