NAME

HTML::RSSAutodiscovery - methods for retreiving RSS-ish information from an HTML document.

SYNOPSIS

 use HTML::RSSAutodiscovery;
 use Data::Dumper;

 my $url = "http://www.diveintomark.org/";

 my $html = HTML::RSSAutodiscovery->new();
 print &Dumper($html->parse($url));

 # Mark's gone a bit nuts with this and
 # the list is too long to include here...

 # see the POD for the 'parse' method for
 # details of what it returns.

DESCRIPTION

Methods for retreiving RSS-ish information from an HTML document.

PACKAGE METHODS

__PACKAGE__->new()

Object constructor. Returns an object. Woot!

OBJECT METHODS

$obj->parse($arg)

Parse an HTML document and return RSS-ish <link> information.

$arg may be either:

• An HTML string, passed as a scalar reference.

• A URI.

Returns an array reference of hash references whose keys are :

• title

• type

• rel

• href

$obj->locate($uri,\%args)

Like the parse method, but will perform additional lookups, if necessary or specified.

Valid arguments are

• uri

  String. A live, breathing URI to slurp and parse.

  Required

• Hash ref whose keys may be

  • noparse

    Boolean. Don't bother parsing the document, this will also prevent you from checking for embedded links.

    I don't know why you want to do this, but you can.

    False, by default.

  • embedded

    Boolean. Check all embedded links ending in '.xml', '.rss' or '.rdf' (and then 'xml', 'rss' or 'rdf') for RSS-ness.

    False, by default, unless the initial parsing of the URI returns no RSS links.

  • embedded_and_remote

    Boolean.

    Boolean. Check all embedded links whose root is not the same as $uri for RSS-ness.

    False, by default.

  • syndic8

    Boolean. Check the syndic8 servers for sites matching $uri

    False, by default, unless the initial parsing of the URI and any embedded links returns no RSS links.

Returns an array reference of hash references whose keys are :

• title

• type

• rel

• href

VERSION

1.21

DATE

$Date: 2004/10/17 04:13:06 $

AUTHOR

Aaron Straup Cope

SEE ALSO

Because you shouldn't need all that white space to do cool stuff ;-)

http://diveintomark.org/archives/2002/05/30.html#rss_autodiscovery

http://diveintomark.org/archives/2002/08/15.html

http://diveintomark.org/projects/misc/rssfinder.py.txt

REQUIREMENTS

BASIC

These packages are required to actually parse an HTML document or URI.

• HTML::Parser

• LWP::UserAgent

• HTTP::Request

EMBEDDED

These packages are required to check the embedded links in a URI for RSS files. They are not loaded until run-time so they are not required for doing basic parsing

• XML::RSS

SYNDIC8

These packages are required to query the syndic8 servers for RSS files associated with a URI. They are not loaded until run-time so they are not required for doing basic parsing

• XMLRPC::Lite

LICENSE

Copyright (c) 2002-2004, Aaron Straup Cope. All Rights Reserved.

This is free software, you may use it and distribute it under the same terms as Perl itself.

cpanm HTML::RSSAutodiscovery

perl -MCPAN -e shell
install HTML::RSSAutodiscovery