X-Git-Url: http://git.vpit.fr/?a=blobdiff_plain;f=README;h=8ece675236afba73fbc9ff552fee60b166fbc767;hb=8e236cf7f5ac06829edb65527fcdf12716ecd159;hp=acbd863cb62d0428c47f1f438205bdac9cd089a0;hpb=41a4b907f4846f2d35b170f517fb83ceb13f298c;p=perl%2Fmodules%2FTest-Valgrind.git diff --git a/README b/README index acbd863..8ece675 100644 --- a/README +++ b/README @@ -1,13 +1,13 @@ NAME - Test::Valgrind - Test your code through valgrind. + Test::Valgrind - Test Perl code through valgrind. VERSION - Version 0.01 + Version 0.02 SYNOPSIS use Test::More; eval 'use Test::Valgrind'; - plan skip_all => 'Test::Valgrind is required to test your distribution with valgrind'; + plan skip_all => 'Test::Valgrind is required to test your distribution with valgrind' if $@; # Code to inspect for memory leaks/errors. @@ -20,6 +20,10 @@ DESCRIPTION parent then parses the report output by valgrind and pass or fail tests accordingly. + You can also use it from the command-line to test a given script : + + perl -MTest::Valgrind leaky.pl + CONFIGURATION You can pass parameters to "import" as a list of key / value pairs, where valid keys are : @@ -46,15 +50,25 @@ CONFIGURATION CAVEATS You can't use this module to test code given by the "-e" command-line - switch. This module is not really secure. It's definitely not taint - safe. That shouldn't be a problem for test files. If your tests output - to STDERR, everything will be eaten in the process. + switch. + + Results will most likely be better if your perl is built with debugging + enabled. Using the latest valgrind available will also help. + + This module is not really secure. It's definitely not taint safe. That + shouldn't be a problem for test files. + + If your tests output to STDERR, everything will be eaten in the process. + In particular, running this module against test files will obliterate + their original test results. DEPENDENCIES Valgrind 3.1.0 (). Carp, POSIX (core modules since perl 5) and Test::More (since 5.6.2). + Perl::Destruct::Level. + AUTHOR Vincent Pit, "", . @@ -73,6 +87,13 @@ SUPPORT perldoc Test::Valgrind +ACKNOWLEDGEMENTS + Rafaël Garcia-Suarez, for writing and instructing me about the + existence of Perl::Destruct::Level (Elizabeth Mattijsen is a close + second). + + H.Merijn Brand, for daring to test this thing. + COPYRIGHT & LICENSE Copyright 2008 Vincent Pit, all rights reserved.