NAME

Test::Tabs - check the presence of tabs in your project

SYNOPSIS

use Test::Tabs tests => 1;
tabs_ok('lib/Module.pm', 'Module is indented sanely');

Or

use Test::Tabs;
all_perl_files_ok();

Or

use Test::Tabs;
all_perl_files_ok( @mydirs );

DESCRIPTION

This module scans your project/distribution for any perl files (scripts, modules, etc) for the presence of tabs.

In particular, it checks that all indentation is done using tabs, not spaces; alignment is done via spaces, not tabs; indentation levels never jump up (e.g. going from 1 tab indent to 3 tab indent without an intervening 2 tab indent); and there is no trailing whitespace on any line (though lines may consist entirely of whitespace).

Comment lines and pod are ignored. (A future version may also ignore heredocs.)

A trailing comment ##WS can be used to ignore all whitespace rules for that line. ## no Test::Tabs can be used to begin ignoring whitespace rules for all following lines until ## use Test::Tabs is seen. ## skip Test::Tabs tells Test::Tabs to skip the current file, but it must be used before the first whitespace rule violation.

Functions

all_perl_files_ok( @directories )

Applies tabs_ok() to all perl files found in @directories recursively. If no @directories are 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, *.pm, *.psgi, *.t, or a file starting with #!...perl.

tabs_ok( $file, $text )

Run a tab check on $file. For a module, either the path (lib/My/Module.pm) or the package name (My::Module) can be used.

$text is the optional test name.

BUGS

Please report any bugs to http://rt.cpan.org/Dist/Display.html?Queue=Test-Tabs.

SEE ALSO

Test::EOL, Test::More.

AUTHOR

Toby Inkster <tobyink@cpan.org>.

Large portions stolen from Test::NoTabs by Nick Gerakines.

COPYRIGHT AND LICENCE

This software is copyright (c) 2012-2013 by Toby Inkster.

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

DISCLAIMER OF WARRANTIES

THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.