[Http-webtest-commits] CVS: HTTP-WebTest/lib/HTTP WebTest.pm,1.22,1.23

SourceForge Headquarters 225 Broadway Suite 1600 San Diego, CA 92101 +1 (858) 422-6466

Update of /cvsroot/http-webtest/HTTP-WebTest/lib/HTTP
In directory usw-pr-cvs1:/tmp/cvs-serv32731/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.22
retrieving revision 1.23
diff -C2 -d -r1.22 -r1.23
*** WebTest.pm	22 Jun 2002 20:07:37 -0000	1.22
--- WebTest.pm	2 Jul 2002 22:48:37 -0000	1.23
***************
*** 234,239 ****
  =back

! Parameters are either scalar (single-valued) or lists (single or
! multi-valued).

  You can specify scalar parameters using forms such as:
--- 234,239 ----
  =back

! Parameters are either scalar (single-valued) or lists (single-valued,
! multi-valued or nested).

  You can specify scalar parameters using forms such as:
***************
*** 268,271 ****
--- 268,286 ----
             )

+ Lists can be nested. For example:
+ 
+     name = ( ( first value
+                second value ) )
+ 
+     name = ( 'third value'
+              ( fourth value => fifth value ) )
+ 
+     name = (
+              ( first value
+                second value )
+              third value
+              ( fourth value => fifth value )
+            )
+ 
  You can specify a null (placeholder) value using '' or "".  Within
  single or double quotes, the usual Perl string quoting rules apply.
***************
*** 283,287 ****
  brackets are used to denote Perl code inside wtscript files.
  C<HTTP::WebTest> compiles this Perl code as anonymous subroutines
! which are called when value of corresponding test
  parameters are required.  These subroutines are called in an object-oriented
  fashion, so the
--- 298,302 ----
  brackets are used to denote Perl code inside wtscript files.
  C<HTTP::WebTest> compiles this Perl code as anonymous subroutines
! which are called when values of corresponding test
  parameters are required.  These subroutines are called in an object-oriented
  fashion, so the
***************
*** 293,297 ****
      name = { 1 + 1 }

!     # element of a list 
      name = (
               'first value'
--- 308,312 ----
      name = { 1 + 1 }

!     # element of a list
      name = (
               'first value'
***************
*** 377,381 ****
  passed in a hash passed as the second argument.

! Subroutine references can be specified instead of test parameter values.  
  Referenced subroutines are called during test run when
  values of corresponding test parameters are required.  These subroutines are
--- 392,396 ----
  passed in a hash passed as the second argument.

! Subroutine references can be specified instead of test parameter values.
  Referenced subroutines are called during test run when
  values of corresponding test parameters are required.  These subroutines are
***************
*** 652,675 ****
  Synonym to C<cookies>.

  =head2 cookies

! Specifies a cookie(s) to send to the web server.

  Each cookie is specified by following list:

!     ( version
!       name
!       value
!       path
!       domain
!       port
!       path_spec
!       secure
!       maxage
!       discard
!       name1
!       value1
!       name2
!       value2
        ...
      )
--- 667,850 ----
  Synonym to C<cookies>.

+ It is deprecated parameter and may be removed in future versions of
+ L<HTTP::WebTest|HTTP::WebTest>.
+ 
  =head2 cookies

! This is a list parameter that specifies cookies to send to the web
! server:
! 
!     cookies = ( cookie1_spec
!                 cookie2_spec
!                 ...
!                 cookieN_spec )
! 
! Currently there are two ways to specify a cookie.
! 
! =over 4
! 
! =item * Named style
! 
! A cookie is specified by a set of C<param =E<gt> value> pairs:
! 
!     (
!       param => value
!       ...
!     )
! 
! List of all supported C<param =E<gt> value> pairs:
! 
! =over 4
! 
! =item version => VERSION
! 
! Version number of cookie spec to use, usually 0.
! 
! =item name => NAME (REQUIRED)
! 
! Name of cookie.  Cannot begin with a $ character.
! 
! =item value => VALUE (REQUIRED)
! 
! Value of cookie.
! 
! =item path => PATH (REQUIRED)
! 
! URL path name for which this cookie applies.  Must begin with a /
! character.  See also path_spec.
! 
! =item domain => DOMAIN (REQUIRED)
! 
! Domain for which cookie is valid.  Must either contain two periods or
! be equal to C<.local>.
! 
! =item port => PORT
! 
! List of allowed port numbers that the cookie may be returned to.  If
! not specified, cookie can be returned to any port.  Must be specified
! using the format C<N> or C<N, N, ..., N> where N is one or more
! digits.
! 
! =item path_spec => PATH_SPEC
! 
! Ignored if version is less than 1.  Option to ignore the value of
! path.  Default value is 0.
! 
! =over 4
! 
! =item * 1
! 
! Use the value of path.
! 
! =item * 0
! 
! Ignore the specified value of path.
! 
! =back
! 
! =item secure => SECURE
! 
! Option to require secure protocols for cookie transmission.  Default
! value is 0.
! 
! =over 4
! 
! =item * 1
! 
! Use only secure protocols to transmit this cookie.
! 
! =item * 0
! 
! Secure protocols are not required for transmission.
! 
! =back
! 
! =item maxage => MAXAGE
! 
! Number of seconds until cookie expires.
! 
! =item discard => DISCARD
! 
! Option to discard cookie when the program finishes.  Default is 0.
! (The cookie will be discarded regardless of the value of this
! element.)
! 
! =over 4
! 
! =item * 1
! 
! Discard cookie when the program finishes.
! 
! =item * 0
! 
! Don't discard cookie.
! 
! =back
! 
! =item rest => NAME_VALUE_LIST
! 
! Defines additional cookie attributes.
! 
! Zero, one or several name/value pairs may be specified.  The name
! parameters are words such as Comment or CommentURL and the value
! parameters are strings that may contain embedded blanks.
! 
! =back
! 
! Example (wtscript file):
! 
!     cookies = ( ( name   => Cookie1
!                   value  => cookie value )
! 
!                 ( name   => Cookie2
!                   value  => cookie value
!                   path   => /
!                   domain => .company.com ) )
! 
!                 ( name   => Cookie2
!                   value  => cookie value
!                   rest   => ( Comment => this is a comment ) )
! 
! Example (Perl script):
! 
!     my $tests = [
!                   ...
!                   {
!                     test_name => 'cookie',
!                     cookies   => [ [
!                                      name  => 'Cookie1',
!                                      value => 'Value',
!                                    ],
!                                    [
!                                      name  => 'Cookie2',
!                                      value => 'Value',
!                                      path  => '/',
!                                    ] ],
!                     ...
!                   }
!                   ...
!                 ]
! 
! =item * Row list style
! 
! This style of cookie specification is deprecated and may be removed in
! future versions of L<HTTP::WebTest|HTTP::WebTest>.

  Each cookie is specified by following list:

!     ( VERSION
!       NAME
!       VALUE
!       PATH
!       DOMAIN
!       PORT
!       PATH_SPEC
!       SECURE
!       MAXAGE
!       DISCARD
!       NAME1
!       VALUE1
!       NAME2
!       VALUE2
        ...
      )
***************
*** 681,707 ****
  =over 4

! =item * version (REQUIRED)

  Version number of cookie spec to use, usually 0.

! =item * name (REQUIRED)

  Name of cookie.  Cannot begin with a $ character.

! =item * value (REQUIRED)

  Value of cookie.

! =item * path (REQUIRED)

  URL path name for which this cookie applies.  Must begin with a /
  character.  See also path_spec.

! =item * domain (REQUIRED)

! Domain for which cookie is valid.  (REQUIRED).  Should begin with a
! period.  Must either contain two periods or be equal to C<.local>.

! =item * port

  List of allowed port numbers that the cookie may be returned to.  If
--- 856,882 ----
  =over 4

! =item * VERSION (REQUIRED)

  Version number of cookie spec to use, usually 0.

! =item * NAME (REQUIRED)

  Name of cookie.  Cannot begin with a $ character.

! =item * VALUE (REQUIRED)

  Value of cookie.

! =item * PATH (REQUIRED)

  URL path name for which this cookie applies.  Must begin with a /
  character.  See also path_spec.

! =item * DOMAIN (REQUIRED)

! Domain for which cookie is valid.  Must either contain two periods or
! be equal to C<.local>.

! =item * PORT

  List of allowed port numbers that the cookie may be returned to.  If
***************
*** 710,714 ****
  digits.

! =item * path_spec

  Ignored if version is less than 1.  Option to ignore the value of
--- 885,889 ----
  digits.

! =item * PATH_SPEC

  Ignored if version is less than 1.  Option to ignore the value of
***************
*** 727,731 ****
  =back

! =item * secure

  Option to require secure protocols for cookie transmission.  Default
--- 902,906 ----
  =back

! =item * SECURE

  Option to require secure protocols for cookie transmission.  Default
***************
*** 744,752 ****
  =back

! =item * maxage

  Number of seconds until cookie expires.

! =item * discard

  Option to discard cookie when the program finishes.  Default is 0.
--- 919,927 ----
  =back

! =item * MAXAGE

  Number of seconds until cookie expires.

! =item * DISCARD

  Option to discard cookie when the program finishes.  Default is 0.
***************
*** 776,805 ****
  An example cookie would look like:

!     ( 0
!       WebTest cookie #1
!       expires&2592000&type&consumer
!       /
!       .mycompany.com
!       ''
!       0
!       0
!       200
!       1
!     )
! 
! See RFC 2965 for details (ftp://ftp.isi.edu/in-notes/rfc2965.txt).
! 
! =head3 Usage in wtscript files
! 
! You may specify multiple cookies within each test block by specifying
! multiple instances of the C<cookies> parameter.
! 
! =head3 Usage in Perl scripts

! Use an arrayref of arrayrefs containing cookies to pass with the HTTP
! request.

! Each array must have at least 5 elements; if the number of elements is
! over 10 it must have an even number of elements.

  =head2 default_report
--- 951,969 ----
  An example cookie would look like:

!     cookies = ( ( 0
!                   WebTest cookie #1
!                   cookie value
!                   /
!                   .mycompany.com
!                   ''
!                   0
!                   0
!                   200
!                   1
!                 ) )

! =back

! See RFC 2965 for details (ftp://ftp.isi.edu/in-notes/rfc2965.txt).

  =head2 default_report
***************
*** 1322,1326 ****

  This module have been tested only on Unix (e.g., Solaris, Linux, AIX,
! etc.) but it should work on Win32 systems.  (Exception: local file tests 
  don't work on Win32 systems.)
  The module's HTTP requests time out after 3 minutes (the default value
--- 1486,1490 ----

  This module have been tested only on Unix (e.g., Solaris, Linux, AIX,
! etc.) but it should work on Win32 systems.  (Exception: local file tests
  don't work on Win32 systems.)
  The module's HTTP requests time out after 3 minutes (the default value
***************
*** 1345,1349 ****
  You can sign up at
  http://lists.sourceforge.net/lists/listinfo/http-webtest-general.
! The email address is C<htt...@li...>.  

  =head1 COPYRIGHT
--- 1509,1513 ----
  You can sign up at
  http://lists.sourceforge.net/lists/listinfo/http-webtest-general.
! The email address is C<htt...@li...>.

  =head1 COPYRIGHT