test::eol(3) [centos man page]

Test::EOL(3)						User Contributed Perl Documentation					      Test::EOL(3)

NAME

       Test::EOL - Check the correct line endings in your project

SYNOPSIS

       "Test::EOL" lets you check for the presence of trailing whitespace and/or windows line endings in your perl code. It reports 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
	 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"

       Valid "\%options" currently are:

       o   trailing_whitespace

	   By default Test::EOL only looks for Windows (CR/LF) line-endings. Set this to true to raise errors if any kind of trailing whitespace
	   is present in the file.

       o   all_reasons

	   Normally Test::EOL reports only the first error in every file (given that a text file originated on Windows will fail every single
	   line). Set this a true value to register a test failure for every line with an error.

       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
	 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. $text is the diagnostic
       label emited after the "ok"/"not ok" TAP output. "\%options" takes the same values as described in "all_perl_files_ok".

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

       o   Arthur Axel 'fREW' Schmidt <frioux@gmail.com>

       o   Florian Ragwitz <rafl@debian.org>

       o   Kent Fredric <kentfredric@gmail.com>

       o   Peter Rabbitson <ribasushi@cpan.org>

       o   Tomas Doran <bobtfish@bobtfish.net>

COPYRIGHT AND LICENSE

       This software is copyright (c) 2012 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.16.3							    2012-06-15							      Test::EOL(3)

Check Out this Related Man Page

Test::Requires(3)					User Contributed Perl Documentation					 Test::Requires(3)

NAME

       Test::Requires - Checks to see if the module can be loaded

SYNOPSIS

	   # in your Makefile.PL
	   use inc::Module::Install;
	   test_requires 'Test::Requires';

	   # in your test
	   use Test::More tests => 10;
	   use Test::Requires {
	       'HTTP::MobileAttribute' => 0.01, # skip all if HTTP::MobileAttribute doesn't installed
	   };
	   isa_ok HTTP::MobileAttribute->new, 'HTTP::MobileAttribute::NonMobile';

	   # or
	   use Test::More tests => 10;
	   use Test::Requires qw(
	       HTTP::MobileAttribute
	   );
	   isa_ok HTTP::MobileAttribute->new, 'HTTP::MobileAttribute::NonMobile';

	   # or
	   use Test::More tests => 10;
	   use Test::Requires;
	   test_requires 'Some::Optional::Test::Required::Modules';
	   isa_ok HTTP::MobileAttribute->new, 'HTTP::MobileAttribute::NonMobile';

DESCRIPTION

       Test::Requires checks to see if the module can be loaded.

       If this fails rather than failing tests this skips all tests.

       Test::Requires can also be used to require a minimum version of Perl:

	   use Test::Requires "5.010";	# quoting is necessary!!

	   # or
	   use Test::Requires "v5.10";

AUTHOR

       Tokuhiro Matsuno <tokuhirom @*(#RJKLFHFSDLJF gmail.com>

THANKS TO

	   kazuho++ # some tricky stuff
	   miyagawa++ # original code from t/TestPlagger.pm
	   tomyhero++ # reported issue related older test::builder
	   tobyink++ # documented that Test::Requires "5.010" works

ENVIRONMENT

       If the "RELEASE_TESTING" environment variable is true, then instead of skipping tests, Test::Requires bails out.

SEE ALSO

       "TestPlagger.pm" in t

LICENSE

       This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

perl v5.18.2							    2017-10-06							 Test::Requires(3)

Linux and UNIX Man Pages

test::eol(3) [centos man page]

Check Out this Related Man Page