X-Git-Url: http://git.maemo.org/git/?a=blobdiff_plain;ds=sidebyside;f=dev%2Fi386%2Flibperl-critic-perl%2Flibperl-critic-perl-1.088%2Flib%2FPerl%2FCritic%2FPolicy%2FBuiltinFunctions%2FProhibitReverseSortBlock.pm;fp=dev%2Fi386%2Flibperl-critic-perl%2Flibperl-critic-perl-1.088%2Flib%2FPerl%2FCritic%2FPolicy%2FBuiltinFunctions%2FProhibitReverseSortBlock.pm;h=cdb4f5e91e2d73d3f59a5f1961bd723a29e6ad33;hb=da95c414033799c3a62606f299c3c00b5c77ca11;hp=0000000000000000000000000000000000000000;hpb=2d38e14bacbb15b98e539843a40b3c52a225f493;p=dh-make-perl diff --git a/dev/i386/libperl-critic-perl/libperl-critic-perl-1.088/lib/Perl/Critic/Policy/BuiltinFunctions/ProhibitReverseSortBlock.pm b/dev/i386/libperl-critic-perl/libperl-critic-perl-1.088/lib/Perl/Critic/Policy/BuiltinFunctions/ProhibitReverseSortBlock.pm new file mode 100644 index 0000000..cdb4f5e --- /dev/null +++ b/dev/i386/libperl-critic-perl/libperl-critic-perl-1.088/lib/Perl/Critic/Policy/BuiltinFunctions/ProhibitReverseSortBlock.pm @@ -0,0 +1,135 @@ +############################################################################## +# $URL: http://perlcritic.tigris.org/svn/perlcritic/trunk/Perl-Critic/lib/Perl/Critic/Policy/BuiltinFunctions/ProhibitReverseSortBlock.pm $ +# $Date: 2008-07-03 10:19:10 -0500 (Thu, 03 Jul 2008) $ +# $Author: clonezone $ +# $Revision: 2489 $ +############################################################################## + +package Perl::Critic::Policy::BuiltinFunctions::ProhibitReverseSortBlock; + +use 5.006001; +use strict; +use warnings; +use Readonly; + +use Perl::Critic::Utils qw{ :severities :classification }; +use base 'Perl::Critic::Policy'; + +our $VERSION = '1.088'; + +#----------------------------------------------------------------------------- + +Readonly::Scalar my $DESC => q{Forbid $b before $a in sort blocks}; ## no critic (Interpolation) +Readonly::Scalar my $EXPL => [ 152 ]; + +#----------------------------------------------------------------------------- + +sub supported_parameters { return () } +sub default_severity { return $SEVERITY_LOWEST } +sub default_themes { return qw(core pbp cosmetic) } +sub applies_to { return 'PPI::Token::Word' } + +#----------------------------------------------------------------------------- + +sub violates { + my ($self, $elem, $doc) = @_; + + return if $elem ne 'sort'; + return if ! is_function_call($elem); + + my $sib = $elem->snext_sibling(); + return if !$sib; + + my $arg = $sib; + if ( $arg->isa('PPI::Structure::List') ) { + $arg = $arg->schild(0); + # Forward looking: PPI might change in v1.200 so schild(0) is a PPI::Statement::Expression + if ( $arg && $arg->isa('PPI::Statement::Expression') ) { + $arg = $arg->schild(0); + } + } + return if !$arg || !$arg->isa('PPI::Structure::Block'); + + # If we get here, we found a sort with a block as the first arg + + # Look at each statement in the block separately. + # $a is +1, $b is -1, sum should always be >= 0. + # This may go badly if there are conditionals or loops or other + # sub-statements... + for my $statement ($arg->children) { + my @sort_vars = $statement =~ m/\$([ab])\b/gxms; + my $count = 0; + for my $sort_var (@sort_vars) { + if ($sort_var eq 'a') { + $count++; + } else { + $count--; + if ($count < 0) { + # Found too many C<$b>s too early + my $sev = $self->get_severity(); + return $self->violation( $DESC, $EXPL, $elem, $sev ); + } + } + } + } + return; #ok +} + +1; + +#----------------------------------------------------------------------------- + +__END__ + +=pod + +=head1 NAME + +Perl::Critic::Policy::BuiltinFunctions::ProhibitReverseSortBlock - Forbid $b before $a in sort blocks. + +=head1 AFFILIATION + +This Policy is part of the core L distribution. + + +=head1 DESCRIPTION + +Conway says that it is much clearer to use C than to flip C<$a> and +C<$b> around in a C block. He also suggests that, in newer perls, +C is specifically looked for and optimized, and in the case of a +simple reversed string C, using C with a C with no block +is faster even in old perls. + + my @foo = sort { $b cmp $a } @bar; #not ok + my @foo = reverse sort @bar; #ok + + my @foo = sort { $b <=> $a } @bar; #not ok + my @foo = reverse sort { $a <=> $b } @bar; #ok + + +=head1 CONFIGURATION + +This Policy is not configurable except for the standard options. + + +=head1 AUTHOR + +Chris Dolan + +=head1 COPYRIGHT + +Copyright (C) 2006 Chris Dolan. All rights reserved. + +This program is free software; you can redistribute it and/or modify +it under the same terms as Perl itself. + +=cut + +# Local Variables: +# mode: cperl +# cperl-indent-level: 4 +# fill-column: 78 +# indent-tabs-mode: nil +# c-indentation-style: bsd +# End: +# ex: set ts=8 sts=4 sw=4 tw=78 ft=perl expandtab shiftround :