NAME

Test::Code::TidyAll - Check that all your files are tidy and valid according to tidyall

VERSION

version 0.84

SYNOPSIS

  In a file like 't/tidyall.t':

    #!/usr/bin/perl
    use Test::Code::TidyAll;
    tidyall_ok();

DESCRIPTION

Uses Code::TidyAll's check_only mode to check that all the files in your project are in a tidied and valid state, i.e. that no plugins throw errors or would change the contents of the file. Does not actually modify any files.

By default, we look for the config file tidyall.ini or .tidyallrc in the current directory and parent directories, which is generally the right place if you are running prove.

When invoking Code::TidyAll, we pass mode => 'test' by default; see modes.

EXPORTS

This module exports one subroutine, which is exported by default:

tidyall_ok(...)

Most options given to this subroutine will be passed along to the Code::TidyAll constructor. For example, if you don't want to use the tidyall cache and instead check all files every time:

    tidyall_ok( no_cache => 1 );

or if you need to specify the config file:

    tidyall_ok( conf_file => '/path/to/conf/file' );

By default, this subroutine will test every file that matches the config you specify. However, you can pass a files parameter as an array reference to override this, in which case only the files you specify will be tested. These files are still filtered based on the select and exclude rules defined in your config.

SEE ALSO

tidyall

SUPPORT

Bugs may be submitted at https://github.com/houseabsolute/perl-code-tidyall/issues.

SOURCE

The source code repository for Code-TidyAll can be found at https://github.com/houseabsolute/perl-code-tidyall.

AUTHORS

  • Jonathan Swartz <swartz@pobox.com>

  • Dave Rolsky <autarch@urth.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2011 - 2023 by Jonathan Swartz.

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

The full text of the license can be found in the LICENSE file included with this distribution.