/usr/share/perl5/WWW/Mechanize/Link.pm is in libwww-mechanize-perl 1.73-2.
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 | package WWW::Mechanize::Link;
use strict;
use warnings;
=head1 NAME
WWW::Mechanize::Link - Link object for WWW::Mechanize
=head1 SYNOPSIS
Link object to encapsulate all the stuff that Mech needs but nobody
wants to deal with as an array.
=head1 Constructor
=head2 new()
my $link = WWW::Mechanize::Link->new( {
url => $url,
text => $text,
name => $name,
tag => $tag,
base => $base,
attr => $attr_href,
} );
For compatibility, this older interface is also supported:
new( $url, $text, $name, $tag, $base, $attr_href )
Creates and returns a new C<WWW::Mechanize::Link> object.
=cut
sub new {
my $class = shift;
my $self;
# The order of the first four must stay as they are for
# compatibility with older code.
if ( ref $_[0] eq 'HASH' ) {
$self = [ @{$_[0]}{ qw( url text name tag base attrs ) } ];
}
else {
$self = [ @_ ];
}
return bless $self, $class;
}
=head1 Accessors
=head2 $link->url()
URL from the link
=head2 $link->text()
Text of the link
=head2 $link->name()
NAME attribute from the source tag, if any.
=head2 $link->tag()
Tag name (one of: "a", "area", "frame", "iframe" or "meta").
=head2 $link->base()
Base URL to which the links are relative.
=head2 $link->attrs()
Returns hash ref of all the attributes and attribute values in the tag.
=cut
sub url { return ($_[0])->[0]; }
sub text { return ($_[0])->[1]; }
sub name { return ($_[0])->[2]; }
sub tag { return ($_[0])->[3]; }
sub base { return ($_[0])->[4]; }
sub attrs { return ($_[0])->[5]; }
=head2 $link->URI()
Returns the URL as a L<URI::URL> object.
=cut
sub URI {
my $self = shift;
require URI::URL;
my $URI = URI::URL->new( $self->url, $self->base );
return $URI;
}
=head2 $link->url_abs()
Returns a L<URI::URL> object for the absolute form of the string.
=cut
sub url_abs {
my $self = shift;
return $self->URI->abs;
}
=head1 SEE ALSO
L<WWW::Mechanize> and L<WWW::Mechanize::Image>
=head1 COPYRIGHT & LICENSE
Copyright 2004-2010 Andy Lester.
This program is free software; you can redistribute it and/or modify
it under the terms of either:
=over 4
=item * the GNU General Public License as published by the Free
Software Foundation; either version 1, or (at your option) any later
version, or
=item * the Artistic License version 2.0.
=back
=cut
# vi:et:sw=4 ts=4
1;
|