2 # ABSTRACT: Check the correct line endings in your project
12 use vars qw( $PERL $UNTAINT_PATTERN $PERL_PATTERN);
14 $PERL = $^X || 'perl';
15 $UNTAINT_PATTERN = qr|^([-+@\w./:\\]+)$|;
16 $PERL_PATTERN = qr/^#!.*perl/;
18 my %file_find_arg = ($] <= 5.006) ? () : (
20 untaint_pattern => $UNTAINT_PATTERN,
24 my $Test = Test::Builder->new;
25 my $updir = File::Spec->updir();
32 *{$caller.'::eol_unix_ok'} = \&eol_unix_ok;
33 *{$caller.'::all_perl_files_ok'} = \&all_perl_files_ok;
35 $Test->exported_to($caller);
40 my @all_files = _all_files(@_);
41 return grep { _is_perl_module($_) || _is_perl_script($_) } @all_files;
45 my @base_dirs = @_ ? @_ : File::Spec->catdir($Bin, $updir);
48 return if ($File::Find::dir =~ m![\\/]?CVS[\\/]|[\\/]?.svn[\\/]!); # Filter out cvs or subversion dirs/
49 return if ($File::Find::dir =~ m![\\/]?blib[\\/]libdoc$!); # Filter out pod doc in dist
50 return if ($File::Find::dir =~ m![\\/]?blib[\\/]man\d$!); # Filter out pod doc in dist
51 return if ($File::Find::name =~ m!Build$!i); # Filter out autogenerated Build script
52 return unless (-f $File::Find::name && -r _);
53 push @found, File::Spec->no_upwards( $File::Find::name );
60 find( $find_arg, @base_dirs);
64 # Formats various human invisible symbols
65 # to similar visible ones.
66 # Perhaps ^M or something like that
67 # would be more appropriate?
69 sub _show_whitespace {
71 $string =~ s/\r/[\\r]/g;
72 $string =~ s/\t/[\\t]/g;
73 $string =~ s/ /[\\s]/g;
77 # Format a line record for diagnostics.
80 my ( $options, $line ) = @_;
81 $line->[2] =~ s/\n\z//g;
82 return "line $line->[1]: $line->[0] " . (
83 $options->{show_lines} ? qq{: } . _show_whitespace( $line->[2] ) : q{}
90 $test_txt = shift if !ref $_[0];
91 $test_txt ||= "No incorrect line endings in '$file'";
92 my $options = shift if ref $_[0] eq 'HASH';
94 trailing_whitespace => 0,
97 $file = _module_to_path($file);
99 open my $fh, $file or do { $Test->ok(0, $test_txt); $Test->diag("Could not open $file: $!"); return; };
100 # Windows-- , default is :crlf, which hides \r\n -_-
101 binmode( $fh, ':raw' );
106 if ( !$options->{trailing_whitespace} && /(\r+)$/ ) {
108 push @fails, [ _show_whitespace( $match ) , $line , $_ ];
110 if ( $options->{trailing_whitespace} && /([ \t]*\r+|[ \t]+)$/ ) {
112 push @fails, [ _show_whitespace($match), $line , $_ ];
114 # Minor short-circuit for people who don't need the whole file scanned
115 # once there's an err.
116 last if( @fails > 0 && !$options->{all_reasons} );
119 $Test->ok( 0, $test_txt . " on " . _debug_line({ show_lines => 0 } , $fails[0] ) );
120 if ( $options->{all_reasons} || 1 ){
121 $Test->diag( " Problem Lines: ");
123 $Test->diag(_debug_line({ show_lines => 1 } , $_ ) );
128 $Test->ok(1, $test_txt);
131 sub all_perl_files_ok {
132 my $options = shift if ref $_[0] eq 'HASH';
133 my @files = _all_perl_files( @_ );
135 foreach my $file ( @files ) {
136 eol_unix_ok($file, $options);
140 sub _is_perl_module {
141 $_[0] =~ /\.pm$/i || $_[0] =~ /::/;
144 sub _is_perl_script {
146 return 1 if $file =~ /\.pl$/i;
147 return 1 if $file =~ /\.t$/;
148 open (my $fh, $file) or return;
150 return 1 if defined $first && ($first =~ $PERL_PATTERN);
154 sub _module_to_path {
156 return $file unless ($file =~ /::/);
157 my @parts = split /::/, $file;
158 my $module = File::Spec->catfile(@parts) . '.pm';
159 foreach my $dir (@INC) {
160 my $candidate = File::Spec->catfile($dir, $module);
161 next unless (-e $candidate && -f _ && -r _);
168 unless ($Test->has_plan) {
169 $Test->plan( 'no_plan' );
171 $Test->expected_tests;
175 my @untainted = map { ($_ =~ $UNTAINT_PATTERN) } @_;
176 return wantarray ? @untainted : $untainted[0];
183 C<Test::EOL> lets you check the presence of windows line endings in your
185 report its results in standard C<Test::Simple> fashion:
187 use Test::EOL tests => 1;
188 eol_unix_ok( 'lib/Module.pm', 'Module is ^M free');
190 and to add checks for trailing whitespace:
192 use Test::EOL tests => 1;
193 eol_unix_ok( 'lib/Module.pm', 'Module is ^M and trailing whitespace free', { trailing_whitespace => 1 });
195 Module authors can include the following in a t/eol.t and have C<Test::EOL>
196 automatically find and check all perl files in a module distribution:
204 all_perl_files_ok( @mydirs );
206 and if authors would like to check for trailing whitespace:
209 all_perl_files_ok({ trailing_whitespace => 1 });
214 all_perl_files_ok({ trailing_whitespace => 1 }, @mydirs );
218 This module scans your project/distribution for any perl files (scripts,
219 modules, etc) for the presence of windows line endings.
223 A list of functions that can be exported. You can delete this section
224 if you don't export anything, such as for a purely object-oriented module.
226 =func all_perl_files_ok( [ \%options ], [ @directories ] )
228 Applies C<eol_unix_ok()> to all perl files found in C<@directories> (and sub
229 directories). If no <@directories> is given, the starting point is one level
230 above the current running script, that should cover all the files of a typical
231 CPAN distribution. A perl file is *.pl or *.pm or *.t or a file starting
234 If the test plan is defined:
236 use Test::EOL tests => 3;
239 the total number of files tested must be specified.
241 =func eol_unix_ok( $file [, $text] [, \%options ] )
243 Run a unix EOL check on C<$file>. For a module, the path (lib/My/Module.pm) or the
244 name (My::Module) can be both used.
246 =head1 ACKNOWLEDGEMENTS
248 Shamelessly ripped off from L<Test::NoTabs>.
252 L<Test::More>, L<Test::Pod>. L<Test::Distribution>, L<Test:NoWarnings>,
253 L<Test::NoTabs>, L<Module::Install::AuthorTests>.