]> git.vpit.fr Git - perl/modules/Test-Leaner.git/commitdiff
Document differences
authorVincent Pit <vince@profvince.com>
Tue, 28 Dec 2010 11:06:15 +0000 (12:06 +0100)
committerVincent Pit <vince@profvince.com>
Tue, 28 Dec 2010 14:33:01 +0000 (15:33 +0100)
lib/Test/Leaner.pm

index 92f386f6402913e7bfd40a71d3e8a2ac5870c507..d11c4e212cbe22f298ea38f2026880160484fed7 100644 (file)
@@ -30,6 +30,24 @@ our $VERSION = '0.01';
 When profiling some L<Test::More>-based test script that contained about 10 000 unit tests, I realized that 60% of the time was spent in L<Test::Builder> itself, even though every single test actually involved a costly C<eval STRING>.
 
 This module aims to be a partial replacement to L<Test::More> in those situations where you want to run a large number of simple tests.
+Its functions behave the same as their L<Test::More> counterparts, except for the following differences :
+
+=over 4
+
+=item *
+
+Stringification isn't forced on the test operands.
+However, L</ok> honors C<'bool'> overloading, L</is> honors C<'eq'> overloading and L</cmp_ok> honors whichever overloading category corresponds to the specified operator.
+
+=item *
+
+L</pass>, L</fail>, L</ok>, L</is>, L</isnt>, L</like>, L</unlike> and L</cmp_ok> are all guaranteed to return the truth value of the test.
+
+=item *
+
+C<use_ok>, C<require_ok>, C<can_ok>, C<isa_ok>, C<new_ok>, C<subtest>, C<explain>, C<TODO> blocks and C<todo_skip> are not implemented.
+
+=back
 
 =cut
 
@@ -495,9 +513,6 @@ END {
 
 =pod
 
-L</pass>, L</fail>, L</ok>, L</is>, L</isnt>, L</like>, L</unlike> and L</cmp_ok> are all guaranteed to return the truth value of the test.
-Their L<Test::More> counterparts behave the same, but it is not documented anywhere.
-
 L<Test::Leaner> also provides some functions of its own, which are never exported.
 
 =head2 C<tap_stream [ $fh ]>