[Jifty-commit] r3809 - in Test-WWW-Declare: lib/Test/WWW

[jifty-commit at lists.jifty.org]

Author: sartak
Date: Mon Aug  6 14:04:05 2007
New Revision: 3809

Modified:
   Test-WWW-Declare/   (props changed)
   Test-WWW-Declare/lib/Test/WWW/Declare.pm

Log:
 r29957 at caladan:  sartak | 2007-08-06 14:03:55 -0400
 Why this module is a Good Thing


Modified: Test-WWW-Declare/lib/Test/WWW/Declare.pm
==============================================================================
--- Test-WWW-Declare/lib/Test/WWW/Declare.pm	(original)
+++ Test-WWW-Declare/lib/Test/WWW/Declare.pm	Mon Aug  6 14:04:05 2007
@@ -32,6 +32,20 @@
     Test::More->export_to_level(2);
 }
 
+=head2 DESCRIPTION
+
+Often in web apps, tests are very dependent. If one test fails (e.g. "follow the
+link to the admin page") then it's likely there will be many more failures. This
+module aims to alleviate this problem, as well as provide a nicer interface to
+L<Test::WWW::Mechanize>.
+
+The central idea is that of flow. Each flow is a sequence of commands ("fill in
+this form") and assertions ("content should contain 'testuser'"). If any of these
+commands or assertions fail then the flow is aborted. Only that one failure is
+reported to the user.
+
+=cut
+
 # DSLey functions
 sub _args {
     my $args = shift;