• NAME
• SYNOPSIS
• DESCRIPTION
• PACKAGE METHODS
• __PACKAGE__->new()
• OBJECT METHODS
• $obj->parse($arg)
• $obj->locate($uri,\%args)
• VERSION
• DATE
• AUTHOR
• SEE ALSO
• REQUIREMENTS
• BASIC
• EMBEDDED
• SYNDIC8
• LICENSE

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.