/usr/share/perl5/URI/Namespace.pm is in liburi-namespacemap-perl 1.00-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 | package URI::Namespace;
use Moo 1.006000;
use URI;
use IRI 0.003;
use Types::Namespace 0.004 qw( Iri );
use namespace::autoclean;
our $VERSION = '1.00';
=head1 NAME
URI::Namespace - A namespace URI/IRI class with autoload methods
=head1 SYNOPSIS
use URI::Namespace;
my $foaf = URI::Namespace->new( 'http://xmlns.com/foaf/0.1/' );
print $foaf->as_string;
print $foaf->name;
=head1 DESCRIPTION
This module provides an object with a URI/IRI attribute, typically used
prefix-namespace pairs, typically used in XML, RDF serializations,
etc. The local part can be used as a method, these are autoloaded.
=head1 METHODS
=over
=item C<< new ( $string | URI | IRI ) >>
This is the constructor. You may pass a string with a URI or a URI object.
=item C<< uri ( [ $local_part ] ) >>
Returns a L<URI> object with the namespace IRI. Optionally, the method
can take a local part as argument, in which case, it will return the
namespace URI with the local part appended.
=item C<< iri ( [ $local_part ] ) >>
Returns a L<IRI> object with the namespace IRI. Optionally, the method
can take a local part as argument, in which case, it will return the
namespace IRI with the local part appended.
=back
The following methods from L<URI> can be used on an URI::Namespace object: C<as_string>, C<as_iri>, C<canonical>, C<eq>, C<abs>, C<rel>.
One important usage for this module is to enable you to create L<URI>s for full URIs, e.g.:
print $foaf->Person->as_string;
will return
http://xmlns.com/foaf/0.1/Person
=head1 FURTHER DETAILS
See L<URI::NamespaceMap> for further details about authors, license, etc.
=cut
around BUILDARGS => sub {
my ($next, $self, @parameters) = @_;
return $self->$next(@_) if ((@parameters > 1) || (ref($parameters[0]) eq 'HASH'));
return { _uri => $parameters[0] };
};
has _uri => (
is => "ro",
isa => Iri,
coerce => 1,
required => 1,
handles => {
'as_string' => 'as_string',
'as_iri' => 'as_string',
}
);
sub iri {
my ($self, $name) = @_;
if (defined($name)) {
return IRI->new($self->_uri->as_string . "$name");
} else {
return $self->_uri;
}
}
sub uri {
my ($self, $name) = @_;
my $iri = $self->_uri->as_string;
if (defined($name)) {
return URI->new($iri . "$name");
} else {
return URI->new($iri);
}
}
for my $method (qw/ abs rel eq canonical /) {
eval qq[ sub $method { shift->uri->${method}(\@_) } ];
}
our $AUTOLOAD;
sub AUTOLOAD {
my $self = shift;
my ($name) = $AUTOLOAD =~ /::(\w+)$/;
return $self->uri($name);
}
1;
__END__
|