1 package CPANPLUS::Dist::Gentoo::Atom;
8 CPANPLUS::Dist::Gentoo::Version - Gentoo atom object.
16 our $VERSION = '0.09';
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 ($range, $category, $name, $version);
52 if (defined $args{name}) {
53 ($range, $category, $name, $version) = @args{qw/range 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 ($range, $category, $name, $version) = ($1, $2, $3, $4);
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 if (defined $version) {
74 Carp::confess("Invalid range $range")
75 unless grep $range eq $_, qw|< <= = >= >|;
80 Carp::confess('Range atoms require a valid version')
81 if defined $range and length $range;
85 category => $category,
89 ebuild => $args{ebuild},
93 =head2 C<new_from_ebuild $ebuild>
95 Creates a new L<CPANPLUS::Dist::Gentoo::Atom> object by inferring the category, name and version from the given C<$ebuild>
101 $class = ref($class) || $class;
104 $ebuild = '' unless defined $ebuild;
106 $ebuild =~ m{/([\w-]+)/([\w-]+)/\2-v?($version_rx)\.ebuild$}
107 or Carp::confess('Invalid ebuild');
108 my ($category, $name, $version) = ($1, $2, $3);
111 category => $category,
119 eval "sub $_ { \$_[0]->{$_} }" for qw/category name version range ebuild/;
124 Read-only accessor to the atom category.
128 Read-only accessor to the atom name.
132 Read-only accessor to the L<CPANPLUS::Dist::Gentoo::Version> object associated with the atom.
136 Read-only accessor to the atom range.
140 Read-only accessor to the path of an optional ebuild associated with the atom.
142 =head2 C<qualified_name>
144 Returns the qualified name for the atom, i.e. C<$category/$name>.
148 sub qualified_name { join '/', $_[0]->category, $_[0]->name }
151 my ($a1, $a2, $r) = @_;
153 my $v1 = $a1->version;
156 my $blessed = Scalar::Util::blessed($a2);
157 unless ($blessed and $a2->isa(__PACKAGE__)) {
158 if ($blessed and $a2->isa('CPANPLUS::Dist::Gentoo::Version')) {
162 my $maybe_atom = eval { __PACKAGE__->new(atom => $a2) };
164 $v2 = eval { CPANPLUS::Dist::Gentoo::Version->new($a2) };
165 Carp::confess("Can't compare an atom against something that's not an atom, an atom string ($err), a version or a version string ($@)") if $@;
176 my $p1 = $a1->qualified_name;
177 my $p2 = $a2->qualified_name;
178 Carp::confess("Atoms for different packages $p1 and $p2") unless $p1 eq $p2;
181 ($v1, $v2) = ($v2, $v1) if $r;
183 return (defined $v1 or 0) <=> (defined $v2 or 0) unless defined $v1
190 my ($a1, $a2, $r) = @_;
192 my $s1 = $a1->qualified_name;
193 my $v1 = $a1->version;
194 $s1 .= "-$v1" if defined $v1;
197 if (Scalar::Util::blessed($a2) and $a2->isa(__PACKAGE__)) {
198 $s2 = $a2->qualified_name;
199 my $v2 = $a2->version;
200 $s2 .= "-$v2" if defined $v2;
211 my $atom = $a->qualified_name;
213 my $version = $a->version;
214 $atom = $a->range . $atom . '-' . $version if defined $version;
229 Compute the ranged atom representing the logical AND between C<@atoms> with the same category and name.
234 shift unless length ref $_[0];
237 return $a1 unless @_;
240 $a2 = $a2->and(@_) if @_;
242 my $p1 = $a1->qualified_name;
243 my $p2 = $a2->qualified_name;
244 Carp::confess("Atoms for different packages $p1 and $p2") unless $p1 eq $p2;
246 my $v1 = $a1->version;
247 return $a2 unless defined $v1;
248 my $r1 = $a1->range; # Defined if $v1 is defined
250 my $v2 = $a2->version;
251 return $a1 unless defined $v2;
252 my $r2 = $a2->range; # defined if $v2 is defined
254 my $o1 = $order{$r1};
255 my $o2 = $order{$r2};
257 Carp::confess("Incompatible ranges $r1$p1 and $r2$p2") if $o1 * $o2 < 0;
260 ($a1, $a2) = ($a2, $a1);
261 ($v1, $v2) = ($v2, $v1);
262 ($r1, $r2) = ($r2, $r1);
263 ($o1, $o2) = ($o2, $o1);
267 my $r = $r2 eq '=' ? '==' : $r2;
268 Carp::confess("Version mismatch $v1 $r $v2") unless eval "\$a1 $r \$a2";
271 return $a1 < $a2 ? $a2 : $a1;
273 return $a1 < $a2 ? $a1 : $a2;
277 =head2 C<fold @atoms>
279 Returns a list built from C<@atoms> but where there's only one atom for a given category and name.
284 shift unless length ref $_[0];
288 my $key = $atom->qualified_name;
290 my $cur = $seen{$key};
291 $seen{$key} = defined $cur ? $cur->and($atom) : $atom;
299 This class provides overloaded methods for numerical comparison, string comparison and strigification.
303 L<CPANPLUS::Dist::Gentoo>, L<CPANPLUS::Dist::Gentoo::Version>.
307 Vincent Pit, C<< <perl at profvince.com> >>, L<http://www.profvince.com>.
309 You can contact me by mail or on C<irc.perl.org> (vincent).
313 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.
317 You can find documentation for this module with the perldoc command.
319 perldoc CPANPLUS::Dist::Gentoo
321 =head1 COPYRIGHT & LICENSE
323 Copyright 2009 Vincent Pit, all rights reserved.
325 This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
329 1; # End of CPANPLUS::Dist::Gentoo::Atom