/usr/share/perl5/Feed/Find.pm is in libfeed-find-perl 0.07-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 | package Feed::Find;
use strict;
use 5.008_001;
use base qw( Class::ErrorHandler );
use LWP::UserAgent;
use HTML::Parser;
use URI;
use vars qw( $VERSION );
$VERSION = '0.07';
use constant FEED_MIME_TYPES => [
'application/x.atom+xml',
'application/atom+xml',
'application/xml',
'text/xml',
'application/rss+xml',
'application/rdf+xml',
];
our $FEED_EXT = qr/\.(?:rss|xml|rdf)$/;
our %IsFeed = map { $_ => 1 } @{ FEED_MIME_TYPES() };
sub find {
my $class = shift;
my($uri) = @_;
my $ua = LWP::UserAgent->new;
$ua->env_proxy;
$ua->agent(join '/', $class, $class->VERSION);
$ua->parse_head(0); ## We're already basically doing this ourselves.
my $req = HTTP::Request->new(GET => $uri);
my $p = HTML::Parser->new(api_version => 3,
start_h => [ \&_find_links, 'self,tagname,attr' ]);
$p->{base_uri} = $uri;
$p->{feeds} = [];
my $res = $ua->request($req, sub {
my($chunk, $res, $proto) = @_;
if ($IsFeed{$res->content_type}) {
push @{ $p->{feeds} }, $uri;
die "Done parsing";
}
$p->parse($chunk) or die "Done parsing";
});
return $class->error($res->status_line) unless $res->is_success;
@{ $p->{feeds} };
}
sub find_in_html {
my $class = shift;
my($html, $base_uri) = @_;
my $p = HTML::Parser->new(api_version => 3,
start_h => [ \&_find_links, 'self,tagname,attr' ]);
$p->{base_uri} = $base_uri;
$p->{feeds} = [];
$p->parse($$html);
@{ $p->{feeds} };
}
sub _find_links {
my($p, $tag, $attr) = @_;
my $base_uri = $p->{base_uri};
if ($tag eq 'link') {
return unless $attr->{rel};
my %rel = map { $_ => 1 } split /\s+/, lc($attr->{rel});
(my $type = lc $attr->{type}) =~ s/^\s*//;
$type =~ s/\s*$//;
push @{ $p->{feeds} }, URI->new_abs($attr->{href}, $base_uri)->as_string
if $IsFeed{$type} &&
($rel{alternate} || $rel{'service.feed'});
} elsif ($tag eq 'base') {
$p->{base_uri} = $attr->{href} if $attr->{href};
} elsif ($tag =~ /^(?:meta|isindex|title|script|style|head|html)$/) {
## Ignore other valid tags inside of <head>.
} elsif ($tag eq 'a') {
my $href = $attr->{href} or return;
my $uri = URI->new($href);
push @{ $p->{feeds} }, URI->new_abs($href, $base_uri)->as_string
if $uri->path =~ /$FEED_EXT/io;
} else {
## Anything else indicates the start of the <body>,
## so we stop parsing.
$p->eof if @{ $p->{feeds} };
}
}
1;
__END__
=head1 NAME
Feed::Find - Syndication feed auto-discovery
=head1 SYNOPSIS
use Feed::Find;
my @feeds = Feed::Find->find('http://example.com/');
=head1 DESCRIPTION
I<Feed::Find> implements feed auto-discovery for finding syndication feeds,
given a URI. It (currently) passes all of the auto-discovery tests at
I<http://diveintomark.org/tests/client/autodiscovery/>.
I<Feed::Find> will discover the following feed formats:
=over 4
=item * RSS 0.91
=item * RSS 1.0
=item * RSS 2.0
=item * Atom
=back
=head1 USAGE
=head2 Feed::Find->find($uri)
Given a URI I<$uri>, use a variety of techniques to find the feeds associated
with that page. If I<$uri> itself points to a feed (i.e., if the
I<Content-Type> of the response is a recognized feed type), returns I<$uri>.
Returns a list of feed URIs.
The following techniques are used:
=over 4
=item 1. I<E<lt>linkE<gt>> tag auto-discovery
If the page contains any I<E<lt>linkE<gt>> tags in the I<E<lt>headE<gt>>
section, these tags are examined for recognized feed content types. The
following content types are treated as feeds: I<application/x.atom+xml>,
I<application/atom+xml>, I<application/xml>, I<text/xml>,
I<application/rss+xml>, and I<application/rdf+xml>.
=item 2. Scanning I<E<lt>aE<gt>> tags
If the page does not contain any known I<E<lt>linkE<gt>> tags, the page is
then scanned for I<E<lt>aE<gt>> tags for links to URIs with certain file
extensions. The following extensions are treated as feeds: F<.rss>, F<.xml>,
and F<.rdf>.
Note that this technique is employed B<only> if the first technique returns
no results.
=back
=head2 Feed::Find->find_in_html(\$html [, $base_uri ])
Given a reference to a string I<$html> containing an HTML page, uses the
same techniques as described above in I<find> to find the feeds associated
with that page.
If you know the URI of the page, you should provide it in I<$base_uri>, so
that relative links can be properly made absolute. I<Feed::Find> will attempt
to determine the correct base URI, but unless that URI is specified in the
HTML itself (in a C<E<lt>metaE<gt>> tag), you'll need to supply it yourself.
Returns a list of feed URIs.
=head1 LICENSE
I<Feed::Find> is free software; you may redistribute it and/or modify it
under the same terms as Perl itself.
=head1 AUTHOR & COPYRIGHT
Except where otherwise noted, I<Feed::Find> is Copyright 2004 Benjamin
Trott, ben+cpan@stupidfool.org. All rights reserved.
=cut
|