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.