|
From: Ilya M. <m_...@us...> - 2002-07-02 22:48:40
|
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
|
