1 package CPANPLUS::Dist::Gentoo::Atom;
8 CPANPLUS::Dist::Gentoo::Version - Gentoo atom object.
16 our $VERSION = '0.08';
20 This class models Gentoo atoms.
28 '<=>' => \&_spaceship,
33 use CPANPLUS::Dist::Gentoo::Version;
35 my $version_rx = $CPANPLUS::Dist::Gentoo::Version::version_rx;
39 =head2 C<< new category => $category, name => $name [, version => $version, range => $range, ebuild => $ebuild ] >>
41 Creates a new L<CPANPLUS::Dist::Gentoo::Atom> object from the supplied C<$category>, C<$name>, C<$version>, C<$range> and C<$ebuild>.
47 $class = ref($class) || $class;
51 my ($category, $name, $version);
52 if (defined $args{name}) {
53 ($category, $name, $version) = @args{qw/category name version/};
54 Carp::confess('Category unspecified') unless defined $category;
55 /[^\w-]/ and Carp::confess('Invalid argument') for $name, $category;
56 } elsif (defined $args{atom}) {
57 my $atom = $args{atom};
58 $atom =~ m{^([\w-]+)/([\w-]+)-v?($version_rx)$}
59 or Carp::confess('Invalid atom');
60 ($category, $name, $version) = ($1, $2, $3);
62 Carp::confess('Not enough information for building an atom object');
65 if (defined $version) {
66 unless (Scalar::Util::blessed($version)
67 and $_->isa('CPANPLUS::Dist::Gentoo::Version')) {
68 $version = CPANPLUS::Dist::Gentoo::Version->new($version);
72 my $range = $args{range};
73 if (defined $version) {
75 Carp::confess("Invalid range $range")
76 unless grep $range eq $_, qw|< <= = >= >|;
81 Carp::confess('Range atoms require a valid version')
82 if defined $range and length $range;
86 category => $category,
90 ebuild => $args{ebuild},
94 =head2 C<new_from_ebuild $ebuild>
96 Creates a new L<CPANPLUS::Dist::Gentoo::Atom> object by inferring the category, name and version from the given C<$ebuild>
100 sub new_from_ebuild {
102 $class = ref($class) || $class;
105 $ebuild = '' unless defined $ebuild;
107 $ebuild =~ m{/([\w-]+)/([\w-]+)/\2-v?($version_rx)\.ebuild$}
108 or Carp::confess('Invalid ebuild');
109 my ($category, $name, $version) = ($1, $2, $3);
112 category => $category,
120 eval "sub $_ { \$_[0]->{$_} }" for qw/category name version range ebuild/;
125 Read-only accessor to the atom category.
129 Read-only accessor to the atom name.
133 Read-only accessor to the L<CPANPLUS::Dist::Gentoo::Version> object associated with the atom.
137 Read-only accessor to the atom range.
141 Read-only accessor to the path of an optional ebuild associated with the atom.
143 =head2 C<qualified_name>
145 Returns the qualified name for the atom, i.e. C<$category/$name>.
149 sub qualified_name { join '/', $_[0]->category, $_[0]->name }
152 my ($a1, $a2, $r) = @_;
154 my $v1 = $a1->version;
157 if (Scalar::Util::blessed($a2) and $a2->isa(__PACKAGE__)) {
158 Carp::confess('Can\'t compare atoms of different packages')
159 if $a1->category ne $a2->category or $a1->name ne $a2->name;
165 ($v1, $v2) = ($v2, $v1) if $r;
171 my ($a1, $a2, $r) = @_;
173 my $s1 = $a1->qualified_name;
174 my $v1 = $a1->version;
175 $s1 .= "-$v1" if defined $v1;
178 if (Scalar::Util::blessed($a2) and $a2->isa(__PACKAGE__)) {
179 $s2 = $a2->qualified_name;
180 my $v2 = $a2->version;
181 $s2 .= "-$v2" if defined $v2;
192 my $atom = $a->qualified_name;
194 my $version = $a->version;
195 $atom = $a->range . $atom . '-' . $version if defined $version;
210 Compute the ranged atom representing the logical AND between C<@atoms> with the same category and name.
215 shift unless length ref $_[0];
218 return $a1 unless @_;
221 $a2 = $a2->and(@_) if @_;
223 my $p1 = $a1->qualified_name;
224 my $p2 = $a2->qualified_name;
225 Carp::confess("Atoms for different packages $p1 and $p2") unless $p1 eq $p2;
227 my $v1 = $a1->version;
228 return $a2 unless defined $v1;
229 my $r1 = $a1->range; # Defined if $v1 is defined
231 my $v2 = $a2->version;
232 return $a1 unless defined $v2;
233 my $r2 = $a2->range; # defined if $v2 is defined
235 my $o1 = $order{$r1};
236 my $o2 = $order{$r2};
238 Carp::confess("Incompatible ranges $r1$p1 and $r2$p2") if $o1 * $o2 < 0;
241 ($a1, $a2) = ($a2, $a1);
242 ($v1, $v2) = ($v2, $v1);
243 ($r1, $r2) = ($r2, $r1);
244 ($o1, $o2) = ($o2, $o1);
248 my $r = $r2 eq '=' ? '==' : $r2;
249 Carp::confess("Version mismatch $v1 $r $v2") unless eval "\$a1 $r \$a2";
252 return $a1 < $a2 ? $a2 : $a1;
254 return $a1 < $a2 ? $a1 : $a2;
258 =head2 C<fold @atoms>
260 Returns a list built from C<@atoms> but where there's only one atom for a given category and name.
265 shift unless length ref $_[0];
269 my $key = $atom->qualified_name;
271 my $cur = $seen{$key};
272 $seen{$key} = defined $cur ? $cur->and($atom) : $atom;
280 This class provides overloaded methods for numerical comparison, string comparison and strigification.
284 L<CPANPLUS::Dist::Gentoo>, L<CPANPLUS::Dist::Gentoo::Version>.
288 Vincent Pit, C<< <perl at profvince.com> >>, L<http://www.profvince.com>.
290 You can contact me by mail or on C<irc.perl.org> (vincent).
294 Please report any bugs or feature requests to C<bug-cpanplus-dist-gentoo at rt.cpan.org>, or through the web interface at L<http://rt.cpan.org/NoAuth/ReportBug.html?Queue=CPANPLUS-Dist-Gentoo>. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.
298 You can find documentation for this module with the perldoc command.
300 perldoc CPANPLUS::Dist::Gentoo
302 =head1 COPYRIGHT & LICENSE
304 Copyright 2009 Vincent Pit, all rights reserved.
306 This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
310 1; # End of CPANPLUS::Dist::Gentoo::Atom