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.