trusty (3) Test::Kwalitee.3pm.gz

Provided by: libtest-kwalitee-perl_1.17-1_all bug

NAME
       Test::Kwalitee - test the Kwalitee of a distribution before you release it


VERSION
       version 1.17


SYNOPSIS
         # in a separate test file

         BEGIN {
             unless ($ENV{RELEASE_TESTING})
             {
                 use Test::More;
                 plan(skip_all => 'these tests are for release candidate testing');
             }
         }

         use Test::Kwalitee;


DESCRIPTION
       Kwalitee is an automatically-measurable gauge of how good your software is.  That's very different from
       quality, which a computer really can't measure in a general sense.  (If you can, you've solved a hard
       problem in computer science.)

       In the world of the CPAN, the CPANTS project (CPAN Testing Service; also a funny acronym on its own)
       measures Kwalitee with several metrics.  If you plan to release a distribution to the CPAN -- or even
       within your own organization -- testing its Kwalitee before creating a release can help you improve your
       quality as well.

       "Test::Kwalitee" and a short test file will do this for you automatically.


USAGE
       Create a test file as shown in the synopsis.  Run it.  It will run all of the potential Kwalitee tests on
       the current distribution, if possible.  If any fail, it will report those as regular diagnostics.

       If you ship this test, it will not run for anyone else, because of the "RELEASE_TESTING" guard. (You can
       omit this guard if you move the test to xt/release/, which is not run automatically by other users.)

       To run only a handful of tests, pass their names to the module in the "test" argument (either in the
       "use" directive, or when calling "import" directly):

         use Test::Kwalitee tests => [ qw( use_strict has_tests ) ];

       To disable a test, pass its name with a leading minus ("-"):

         use Test::Kwalitee tests => [ qw( -use_strict has_readme ));

       The list of each available metric currently available on your system can be obtained with the
       "kwalitee-metrics" command (with descriptions, if you pass "--verbose" or "-v", but as of Test::Kwalitee
       1.09 and Module::CPANTS::Analyse 0.87, the tests include:

       •   buildtool_not_executable

           Build.PL/Makefile.PL should not have an executable bit

       •   has_buildtool

           Does the distribution have a build tool file?

       •   has_changelog

           Does the distribution have a changelog?

       •   has_manifest

           Does the distribution have a MANIFEST?

       •   has_meta_yml

           Does the distribution have a META.yml file?

       •   has_readme

           Does the distribution have a README file?

       •   has_tests

           Does the distribution have tests?

       •   no_symlinks

           Does the distribution have no symlinks?

       •   metayml_is_parsable

           Can the the META.yml be parsed?

       •   metayml_has_license

           Does the META.yml declare a license?

       •   proper_libs

           Does the distribution have proper libs?

       •   has_working_buildtool

           If using Module::Install, it is at least version 0.61?

       •   has_better_auto_install

           If using Module::Install, it is at least version 0.89?

       •   has_humanreadable_license

           Is there a "LICENSE" section in documentation, and/or a LICENSE file present?

       •   no_pod_errors

           Does the distribution have no POD errors?

       •   valid_signature

           If a SIGNATURE is present, can it be verified?

       •   use_strict

           Does the distribution files all use strict?

       •   no_cpants_errors

           Were there no errors encountered during CPANTS testing?


ACKNOWLEDGEMENTS
       With thanks to CPANTS and Thomas Klausner, as well as test tester Chris Dolan.


SEE ALSO
       •   script/kwalitee-metrics

       •   Module::CPANTS::Analyse

       •   Test::Kwalitee::Extra

       •   Dist::Zilla::Plugin::Test::Kwalitee


AUTHORS
       •   chromatic <chromatic@wgz.org>

       •   Karen Etheridge <ether@cpan.org>


       This software is copyright (c) 2005 by chromatic.

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


CONTRIBUTORS
       •   Gavin Sherlock <sherlock@cpan.org>

       •   Kenichi Ishigaki <ishigaki@cpan.org>

       •   Nathan Haigh <nathanhaigh@ukonline.co.uk>