Test::EOL(3) User Contributed Perl Documentation Test::EOL(3)NAMETest::EOL - Check the correct line endings in your project
SYNOPSIS
"Test::EOL" lets you check the presence of windows line endings in your
perl code. It report its results in standard "Test::Simple" fashion:
use Test::EOL tests => 1;
eol_unix_ok( 'lib/Module.pm', 'Module is ^M free');
and to add checks for trailing whitespace:
use Test::EOL tests => 1;
eol_unix_ok( 'lib/Module.pm', 'Module is ^M and trailing whitespace free', { trailing_whitespace => 1 });
Module authors can include the following in a t/eol.t and have
"Test::EOL" automatically find and check all perl files in a module
distribution:
use Test::EOL;
all_perl_files_ok();
or
use Test::EOL;
all_perl_files_ok( @mydirs );
and if authors would like to check for trailing whitespace:
use Test::EOL;
all_perl_files_ok({ trailing_whitespace => 1 });
or
use Test::EOL;
all_perl_files_ok({ trailing_whitespace => 1 }, @mydirs );
DESCRIPTION
This module scans your project/distribution for any perl files
(scripts, modules, etc) for the presence of windows line endings.
FUNCTIONS
all_perl_files_ok( [ \%options ], [ @directories ] )
Applies "eol_unix_ok()" to all perl files found in @directories (and
sub directories). If no <@directories> is given, the starting point is
one level above the current running script, that should cover all the
files of a typical CPAN distribution. A perl file is *.pl or *.pm or
*.t or a file starting with "#!...perl"
If the test plan is defined:
use Test::EOL tests => 3;
all_perl_files_ok();
the total number of files tested must be specified.
eol_unix_ok( $file [, $text] [, \%options ] )
Run a unix EOL check on $file. For a module, the path
(lib/My/Module.pm) or the name (My::Module) can be both used.
EXPORT
A list of functions that can be exported. You can delete this section
if you don't export anything, such as for a purely object-oriented
module.
ACKNOWLEDGEMENTS
Shamelessly ripped off from Test::NoTabs.
SEE ALSO
Test::More, Test::Pod. Test::Distribution, <Test:NoWarnings>,
Test::NoTabs, Module::Install::AuthorTests.
AUTHORS
· Tomas Doran <bobtfish@bobtfish.net>
· Arthur Axel 'fREW' Schmidt <frioux@gmail.com>
· Kent Fredric <kentfredric@gmail.com>
· Florian Ragwitz <rafl@debian.org>
COPYRIGHT AND LICENSE
This software is copyright (c) 2010 by Tomas Doran.
This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.
perl v5.14.1 2011-06-30 Test::EOL(3)