Benjamin Trott > Feed-Find-0.03 > Feed::Find

Download:
Feed-Find-0.03.tar.gz

Dependencies

Annotate this POD

CPAN RT

New  2
Open  0
View Bugs
Report a bug
Module Version: 0.03   Source   Latest Release: Feed-Find-0.06

NAME ^

Feed::Find - Syndication feed auto-discovery

SYNOPSIS ^

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

DESCRIPTION ^

Feed::Find implements feed auto-discovery for finding syndication feeds, given a URI. It (currently) passes all of the auto-discovery tests at http://diveintomark.org/tests/client/autodiscovery/.

Feed::Find will discover the following feed formats:

USAGE ^

Feed::Find->find($uri)

Given a URI $uri, use a variety of techniques to find the feeds associated with that page. If $uri itself points to a feed (i.e., if the Content-Type of the response is a recognized feed type), returns $uri.

Returns a list of feed URIs.

The following techniques are used:

1. <link> tag auto-discovery

If the page contains any <link> tags in the <head> section, these tags are examined for recognized feed content types. The following content types are treated as feeds: application/x.atom+xml, application/atom+xml, text/xml, application/rss+xml, and application/rdf+xml.

2. Scanning <a> tags

If the page does not contain any known <link> tags, the page is then scanned for <a> tags for links to URIs with certain file extensions. The following extensions are treated as feeds: .rss, .xml, and .rdf.

Note that this technique is employed only if the first technique returns no results.

LICENSE ^

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

AUTHOR & COPYRIGHT ^

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