README
1NAME
2 HTTP::WebTest - Testing static and dynamic web content
3
4DESCRIPTION
5 Introduction
6 This module runs tests on remote URLs containing
7 Perl/JSP/HTML/JavaScript/etc. and generates a detailed test report. This
8 module can be used "as-is" or its functionality can be extended using
9 plugins. Plugins can define test types and provide additional report
10 capabilities. This module comes with a set of default plugins but can be
11 easily extended with third party plugins.
12
13 The wt script is provided for running "HTTP::WebTest" from the command
14 line.
15
16 The test specifications can be read from a parameter file in wtscript
17 format or input as method arguments. The test results can be displayed on
18 the terminal, directed to a file, stored in a scalar variable. The test
19 results can also be emailed. The report can be modified and extended using
20 report plugins.
21
22 Each URL/web file is tested by fetching it from the web server using a
23 local instance of an HTTP user agent. The basic test is simply whether or
24 not the fetch was successful. You may also test using literal strings or
25 regular expressions that are either required to exist or forbidden to
26 exist in the fetched page. You may also specify tests for the minimum and
27 maximum number of bytes in the returned page. You may also specify tests
28 for the minimum and maximum web server response time.
29
30 Data flow for "HTTP::WebTest":
31
32 -------------- -------------
33 | | | |
34 | Input |------------->| WebTest |
35 | parameters | | |
36 | | -------------
37 -------------- | ^
38 | |
39 V |
40 ------------- ------------
41 | | request | |
42 | Remote |<--------------| HTTP |
43 | webserver |-------------->| user |
44 | | response | agent |
45 ------------- | |
46 ------------
47
48RESTRICTIONS / BUGS
49 This module have been tested only on Unix (e.g., Solaris, Linux, AIX,
50 etc.) but it should work on Win32 systems.
51
52 If you want to test https:// web sites you may have to install additional
53 modules to enable SSL support in LWP. In short you may have to install
54 Crypt::SSLeay module. For details see README.SSL file in LWP distro.
55
56AUTHORS
57 Richard Anderson <richard@richard-anderson.org> wrote "HTTP::WebTest
58 1.xx", using some ideas from the CPAN Monkeywrench module.
59
60 Ilya Martynov <ilya@martynov.org> implemented the plug-in concept, the
61 extended API and completely rewrote "HTTP::WebTest".
62
63 Please don't email authors directly. Use the SourceForge "HTTP::WebTest"
64 mail list (see SUPPORT, next section).
65
66SUPPORT
67 Please email bug reports, suggestions, questions, etc. to the SourceForge
68 "HTTP::WebTest" maillist. You can sign up at
69 http://lists.sourceforge.net/lists/listinfo/http-webtest-general . The
70 email address is "http-webtest-general@lists.sourceforge.net".
71
72COPYRIGHT
73 Copyright (c) 2000-2001 Richard Anderson. All rights reserved.
74
75 Copyright (c) 2001-2003 Ilya Martynov. All rights reserved.
76
77 This program is free software; you can redistribute it and/or modify it
78 under the same terms as Perl itself.
79