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
|
use strict;
use warnings;
package URI::cpan::distfile 1.009;
# ABSTRACT: cpan:///distfile/AUTHOR/Dist-1.234.tar.gz
use parent qw(URI::cpan);
use Carp ();
use CPAN::DistnameInfo;
#pod =head1 SYNOPSIS
#pod
#pod This URL refers to a file in an author directory on the CPAN, and expects the
#pod format AUTHOR/DISTFILE
#pod
#pod =head1 METHODS
#pod
#pod =cut
sub validate {
my ($self) = @_;
my (undef, undef, $author, $filename) = split m{/}, $self->path, 4;
Carp::croak "invalid cpan URI: invalid author part in $self"
unless $author =~ m{\A[A-Z][-0-9A-Z]*\z};
}
#pod =head1 dist_name
#pod
#pod This returns the name of the dist, like F<CGI.pm> or F<Acme-Drunk>.
#pod
#pod =cut
sub dist_name {
my ($self) = @_;
my $dist = CPAN::DistnameInfo->new($self->_p_rel);
my $name = $dist->dist;
$name =~ s/-undef$// if ! defined $dist->version;
return $name;
}
#pod =head1 dist_version
#pod
#pod This returns the version of the dist, or undef if the version can't be found or
#pod is the string "undef"
#pod
#pod =cut
sub dist_version {
my ($self) = @_;
CPAN::DistnameInfo->new($self->_p_rel)->version;
}
#pod =head1 dist_filepath
#pod
#pod This returns the path to the dist file. This is the whole URL after the
#pod C<distfile> part.
#pod
#pod =cut
sub dist_filepath {
my ($self) = @_;
$self->_p_rel;
}
#pod =head1 author
#pod
#pod This returns the name of the author whose file is referred to.
#pod
#pod =cut
sub author {
my ($self) = @_;
my ($author) = $self->_p_rel =~ m{^([A-Z]+)/};
return $author;
}
1;
__END__
=pod
=encoding UTF-8
=head1 NAME
URI::cpan::distfile - cpan:///distfile/AUTHOR/Dist-1.234.tar.gz
=head1 VERSION
version 1.009
=head1 SYNOPSIS
This URL refers to a file in an author directory on the CPAN, and expects the
format AUTHOR/DISTFILE
=head1 PERL VERSION
This library should run on perls released even a long time ago. It should
work on any version of perl released in the last five years.
Although it may work on older versions of perl, no guarantee is made that the
minimum required version will not be increased. The version may be increased
for any reason, and there is no promise that patches will be accepted to
lower the minimum required perl.
=head1 METHODS
=head1 dist_name
This returns the name of the dist, like F<CGI.pm> or F<Acme-Drunk>.
=head1 dist_version
This returns the version of the dist, or undef if the version can't be found or
is the string "undef"
=head1 dist_filepath
This returns the path to the dist file. This is the whole URL after the
C<distfile> part.
=head1 author
This returns the name of the author whose file is referred to.
=head1 AUTHOR
Ricardo SIGNES <cpan@semiotic.systems>
=head1 COPYRIGHT AND LICENSE
This software is copyright (c) 2009 by Ricardo SIGNES.
This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.
=cut
|
