|
From: Ilya M. <m_...@us...> - 2002-10-19 23:14:19
|
Update of /cvsroot/http-webtest/HTTP-WebTest/lib/HTTP
In directory usw-pr-cvs1:/tmp/cvs-serv31029/lib/HTTP
Modified Files:
WebTest.pm.in WebTest.pm
Log Message:
Various doc updates
Index: WebTest.pm.in
===================================================================
RCS file: /cvsroot/http-webtest/HTTP-WebTest/lib/HTTP/WebTest.pm.in,v
retrieving revision 1.24
retrieving revision 1.25
diff -C2 -d -r1.24 -r1.25
*** WebTest.pm.in 19 Oct 2002 23:00:55 -0000 1.24
--- WebTest.pm.in 19 Oct 2002 23:14:16 -0000 1.25
***************
*** 14,18 ****
=head1 NAME
! HTTP::WebTest - Testing web applications and static web content
=head1 SYNOPSIS
--- 14,18 ----
=head1 NAME
! HTTP::WebTest - Testing static and dynamic web content
=head1 SYNOPSIS
Index: WebTest.pm
===================================================================
RCS file: /cvsroot/http-webtest/HTTP-WebTest/lib/HTTP/WebTest.pm,v
retrieving revision 1.29
retrieving revision 1.30
diff -C2 -d -r1.29 -r1.30
*** WebTest.pm 19 Oct 2002 22:37:55 -0000 1.29
--- WebTest.pm 19 Oct 2002 23:14:16 -0000 1.30
***************
*** 26,30 ****
package HTTP::WebTest;
! $VERSION = '1.99_09';
# workaround for warning caused by underscore char in $VERSION
$VERSION = eval $VERSION;
--- 26,30 ----
package HTTP::WebTest;
! $VERSION = '2.00';
# workaround for warning caused by underscore char in $VERSION
$VERSION = eval $VERSION;
***************
*** 35,39 ****
=head1 NAME
! HTTP::WebTest - Test remote URLs or local web files
=head1 SYNOPSIS
--- 35,39 ----
=head1 NAME
! HTTP::WebTest - Testing static and dynamic web content
=head1 SYNOPSIS
***************
*** 53,57 ****
=head2 Introduction
! This module runs tests on remote URLs or local web files containing
Perl/JSP/HTML/JavaScript/etc. and generates a detailed test report.
This module can be used "as-is" or its functionality can be extended
--- 53,57 ----
=head2 Introduction
! This module runs tests on remote URLs containing
Perl/JSP/HTML/JavaScript/etc. and generates a detailed test report.
This module can be used "as-is" or its functionality can be extended
***************
*** 64,74 ****
The test specifications can be read from a parameter file in wtscript
! format or input as method arguments. If you are testing a local file,
! Apache is started on a private/dynamic port with a configuration file
! in a temporary directory.
!
! The test results can be displayed on the terminal, directed to a file,
! stored in a scalar variable. The test results can also be emailed.
! The report can be modified and extended using report plugins.
Each URL/web file is tested by fetching it from the web server using a
--- 64,71 ----
The test specifications can be read from a parameter file in wtscript
! format or input as method arguments. The test results can be
! displayed on the terminal, directed to a file, stored in a scalar
! variable. The test results can also be emailed. The report can be
! modified and extended using report plugins.
Each URL/web file is tested by fetching it from the web server using a
***************
*** 81,85 ****
server response time.
! Data flow for C<HTTP::WebTest> using a remote URL:
-------------- -------------
--- 78,82 ----
server response time.
! Data flow for C<HTTP::WebTest>:
-------------- -------------
***************
*** 99,131 ****
------------
! Data flow diagram for C<HTTP::WebTest> using a local web file:
!
! -------------- ---------------------
! | | | |
! | Input | | Web page code |
! | parameters | | (Perl/HTML/etc.) |
! | | | |
! -------------- ---------------------
! | |
! | -----------------------------
! | |
! V V ------------------------
! ------------- | |
! | |---------->| Temporary Apache |
! | WebTest | | directories (htdocs, |
! | |<----------| conf, logs) |
! ------------- | |
! | ^ ------------------------
! | | | ^
! V | V |
! ------------ ----------------------
! | | request | |
! | HTTP |------------>| Temporary local |
! | user | | instance of Apache |
! | agent |<------------| |
! | | response ----------------------
! ------------
!
! =head2 Getting Started
This module has complex functionality, but using it to run simple
--- 96,100 ----
------------
! =head2 Getting started
This module has complex functionality, but using it to run simple
***************
*** 321,330 ****
=head3 Examples of wtscript files
! The parameters below specify tests of a local file and a remote URL.
! The tests specified by the C<text_forbid> parameter apply to both the
! "MyCompany home page" and the "Yahoo home page" tests. Hence, if
! either returned page contains one of the case-insensitive strings in
! text_forbid, the test fails. If any test fails or the fetch of the URL
! fails, an e-mail will be sent to te...@my....
--- 290,299 ----
=head3 Examples of wtscript files
! The parameters below specify tests. The tests specified by the
! C<text_forbid> parameter apply to both the "MyCompany home page" and
! the "Yahoo home page" tests. Hence, if either returned page contains
! one of the case-insensitive strings in text_forbid, the test fails.
! If any test fails or the fetch of the URL fails, an e-mail will be
! sent to te...@my....
***************
*** 355,384 ****
end_test
- The parameters below specify a test of a local file containing Perl
- code using the L<Apache::ASP|Apache::ASP> module. The C<includes.htm>
- file requires five include files and two Perl modules, which are
- copied using the C<include_file_path> parameter.
-
- apache_exec = /usr/sbin/apache
- ignore_case = yes
- include_file_path = ( footer.inc => htdocs/apps/myapp/inc
- header.inc => htdocs/apps/myapp/inc
- head.inc => htdocs/apps/myapp/inc
- go.script => htdocs/shared/includes
- go.include => htdocs/shared/includes
- ../utils/DBconn.pm => lib/perl/utils
- ../utils/Window.pm => lib/perl/utils
- )
-
- test_name = includes.htm
- file_path = ( includes.htm => apps/myapp )
- min_bytes = 33000
- max_bytes = 35000
- text_require = ( input type=hidden name=control value= )
- text_forbid = ( Premature end of script headers
- an error occurred while processing this directive
- )
- end_test
-
=head2 Calling HTTP::WebTest from a Perl program
--- 324,327 ----
***************
*** 386,393 ****
can be defined as an array of hashes.
! Each hash in the array defines tests for one URL or local web file. Keys
! in the hashes are test parameter names and values in hashes are values of
! test parameters. Optional global test parameters can be
! passed in a hash passed as the second argument.
Subroutine references can be specified instead of test parameter values.
--- 329,336 ----
can be defined as an array of hashes.
! Each hash in the array defines tests for one URL. Keys in the hashes
! are test parameter names and values in hashes are values of test
! parameters. Optional global test parameters can be passed in a hash
! passed as the second argument.
Subroutine references can be specified instead of test parameter values.
***************
*** 441,445 ****
=head1 PLUGIN MODULES
! =head2 Core Plugin Modules
C<HTTP::WebTest> is implemented in a modular structure that allows programmers
--- 384,388 ----
=head1 PLUGIN MODULES
! =head2 Core plugin modules
C<HTTP::WebTest> is implemented in a modular structure that allows programmers
***************
*** 451,458 ****
=over 4
- =item L<HTTP::WebTest::Plugin::Apache|HTTP::WebTest::Plugin::Apache>
-
- This plugin supports testing web files using a local instance of Apache.
-
=item L<HTTP::WebTest::Plugin::ContentSizeTest|HTTP::WebTest::Plugin::ContentSizeTest>
--- 394,397 ----
***************
*** 493,497 ****
summarized below in the section L<TEST PARAMETERS|TEST PARAMETERS>.
! =head2 Other Plugin Modules Bundled With HTTP::WebTest
Following plugin modules come with HTTP::WebTest but they are not
--- 432,436 ----
summarized below in the section L<TEST PARAMETERS|TEST PARAMETERS>.
! =head2 Other plugin modules bundled with HTTP::WebTest
Following plugin modules come with HTTP::WebTest but they are not
***************
*** 526,530 ****
is summarized below in section L<TEST PARAMETERS|TEST PARAMETERS>.
! =head2 Writing Plugin Modules
See L<perldoc HTTP::WebTest::Plugins|HTTP::WebTest::Plugins> for
--- 465,482 ----
is summarized below in section L<TEST PARAMETERS|TEST PARAMETERS>.
! =head2 Plugin modules released separately from HTTP::WebTest
!
! Following additional C<HTTP::WebTest> plugins are avialable separately
! from CPAN.
!
! =over 4
!
! =item L<HTTP::WebTest::Plugin::Apache|HTTP::WebTest::Plugin::Apache>
!
! This plugin supports testing web files using a local instance of Apache.
!
! =back
!
! =head2 Writing plugin modules
See L<perldoc HTTP::WebTest::Plugins|HTTP::WebTest::Plugins> for
***************
*** 1425,1434 ****
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
! for L<LWP::UserAgent|LWP::UserAgent>). If the C<file_path> parameter is
! specified, Apache must be installed.
If you want to test https:// web sites you may have to install
--- 1377,1384 ----
This module have been tested only on Unix (e.g., Solaris, Linux, AIX,
! etc.) but it should work on Win32 systems.
The module's HTTP requests time out after 3 minutes (the default value
! for L<LWP::UserAgent|LWP::UserAgent>).
If you want to test https:// web sites you may have to install
|
