[Http-webtest-commits] CVS: HTTP-WebTest/lib/HTTP WebTest.pm,1.15,1.16

[Ilya M. <m_...@us...>]

Update of /cvsroot/http-webtest/HTTP-WebTest/lib/HTTP
In directory usw-pr-cvs1:/tmp/cvs-serv9021/lib/HTTP

Modified Files:
	WebTest.pm 
Log Message:
Regenerated


Index: WebTest.pm
===================================================================
RCS file: /cvsroot/http-webtest/HTTP-WebTest/lib/HTTP/WebTest.pm,v
retrieving revision 1.15
retrieving revision 1.16
diff -C2 -d -r1.15 -r1.16
*** WebTest.pm	12 May 2002 14:55:36 -0000	1.15
--- WebTest.pm	15 May 2002 19:30:38 -0000	1.16
***************
*** 273,281 ****
             )
  
! You can specify a null (placeholder) value using '' or "".  Within single
! or double quotes, the usual Perl string quoting rules apply.  Thus, single
! quotes mean that all enclosed characters are interpreted literally: '\n'
! is backslash-n rather than a newline character.  Double quotes mean that
! Perl metasymbols are interpreted: "\n\t" is a newline and a tab.
  
  Also it is possible to specify Perl code instead of scalar, instead of
--- 273,285 ----
             )
  
! You can specify a null (placeholder) value using '' or "".  Within
! single or double quotes, the usual Perl string quoting rules apply.
! Thus, single quotes mean that all enclosed characters are interpreted
! literally: '\n' is backslash-n rather than a newline character.
! Double quotes mean that Perl metasymbols are interpreted: "\n\t" is a
! newline and a tab.  Double quoted strings can also contain Perl
! variables to be expanded: "$var" is string which contains value of
! Perl variable C<$var>.  Perl variables can be defined by plugin
! modules or in code sections described below.
  
  Also it is possible to specify Perl code instead of scalar, instead of
***************
*** 501,505 ****
  =back
  
! See documentation on these modules for more information.
  
  =head2 Writting Plugin Modules
--- 505,510 ----
  =back
  
! Information about test parameters supported by add-on plugin modules
! is summarized below in section L<TEST PARAMETERS|TEST PARAMETERS>.
  
  =head2 Writting Plugin Modules
***************
*** 520,523 ****
--- 525,532 ----
  and it cannot be overriden in test blocks.
  
+ Parameters marked as I<NON-CORE PARAMETER> are defined in add-on
+ plugin modules which must be loaded explicitly using test parameter
+ C<plugins>.
+ 
  =head2 accept_cookies
  
***************
*** 611,614 ****
--- 620,650 ----
  for web page access authorization.
  
+ =head2 click_button
+ 
+ I<NON-CORE PARAMETER> from L<HTTP::WebTest::Plugin::Click>
+ 
+ Given name of submit button (i.e. C<<input type="submit"E<gt>> tag
+ inside of C<<formE<gt>> tag) on previosly requested HTML page builds
+ test request to the submitted page.
+ 
+ Note that you still need to pass all form parameters yourself using
+ C<params> test parameter.
+ 
+ =head3 Example
+ 
+ See example in L<HTTP::WebTest::Cookbook|HTTP::WebTest::Cookbook>.
+ 
+ =head2 click_link
+ 
+ I<NON-CORE PARAMETER> from L<HTTP::WebTest::Plugin::Click>
+ 
+ Given name of link (i.e. C<<aE<gt>> tag) on previosly requested HTML
+ page builds test request to the linked page.
+ 
+ =head3 Example
+ 
+ See example in L<HTTP::WebTest::Cookbook|HTTP::WebTest::Cookbook>.
+ 
+ 
  =head2 cookie
  
***************
*** 1002,1005 ****
--- 1038,1076 ----
  Any number less than C<max_rtime> (if C<max_rtime> is specified).
  
+ =head2 on_request
+ 
+ I<NON-CORE PARAMETER> from L<HTTP::WebTest::Plugin::Hooks>
+ 
+ Value of this test parameter is ignored.  However it is evaluted
+ before L<HTTP::WebTest> does a request to web page so it is useful to
+ do some initalization before the request.
+ 
+ =head2 on_response
+ 
+ I<NON-CORE PARAMETER> from L<HTTP::WebTest::Plugin::Hooks>
+ 
+ This is list parameter which is treated as test result.  It is
+ evaluted when L<HTTP::WebTest> gets a response for the test request.
+ 
+ It can be useful to define custom tests without writting new plugins
+ and/or it can be useful to run some code when L<HTTP::WebTest> got
+ some a response for the test request.
+ 
+ =head3 Allowed values
+ 
+     ( YESNO1, COMMENT1
+       YESNO2, COMMENT2
+       ....
+       YESNON, COMMENTN )
+ 
+ Here C<YESNO>, C<COMMENT> - is a test result.  C<YESNO> - is either
+ C<yes> if test is successful or C<no> if it is not.  C<COMMENT> is a
+ text of comment associated with this test.
+ 
+ =head3 Example
+ 
+ See example in L<HTTP::WebTest::Cookbook|HTTP::WebTest::Cookbook>.
+ 
+ 
  =head2 output_ref
  
***************
*** 1047,1055 ****
  C<::> prepends it with C<HTTP::WebTest::Plugin>.  So
  
!     plugins = ( ::ValidateHTML )
  
  is equal to
  
!     plugins = ( HTTP::WebTest::Plugin::ValidateHTML )
  
  
--- 1118,1126 ----
  C<::> prepends it with C<HTTP::WebTest::Plugin>.  So
  
!     plugins = ( ::Click )
  
  is equal to
  
!     plugins = ( HTTP::WebTest::Plugin::Click )