NAME
    HTTP::WebTest - Test remote URLs or local web files

DESCRIPTION
  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 has plugin based architecture. Plugins can define test types and
    provide various report capabilities. This module comes with a set of
    default plugins but can be easily extended with third party plugins.

    The test specifications can be read from a parameter file (wtscript) 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 module can display the test results via report plugin(s).
    Default report plugin can output them on the terminal, directs them to a
    file or scalar variable and/or email them.

    Data flow for "HTTP::WebTest" using a remote URL:

              --------------              -------------
              |            |              |           |
              | Input      |------------->|  WebTest  |
              | parameters |              |           |
              |            |              -------------
              --------------                  |   ^
                                              |   |
                                              V   |
              -------------               ------------
              |           |    request    |          |
              | Remote    |<--------------|   HTTP   |
              | webserver |-------------->|   user   |
              |           |    response   |   agent  |
              -------------               |          |
                                          ------------

    Data flow diagram for "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  ----------------------
              ------------

RESTRICTIONS / BUGS
    This module have been tested only on Unix (e.g., Solaris, Linux, AIX,
    etc.) but it should work on Win32 systems.

    Local file tests don't work on Win32 systems.

    The module's HTTP requests time out after 3 minutes (the default value for
    LWP::UserAgent). If the file_path parameter is specified, Apache must be
    installed.

AUTHOR
    Richard Anderson <Richard.Anderson@unixscripts.com> have wrote
    "HTTP::WebTest 1.xx".

    Ilya Martynov <ilya@martynov.org> made rewrite of "HTTP::WebTest". He is
    maintaining "HTTP::WebTest" now. Please email him bug reports,
    suggestions, questions, etc.

COPYRIGHT
    Copyright (c) 2000-2001 Richard Anderson. All rights reserved.

    Copyright (c) 2001,2002 Ilya Martynov. All rights reserved.

    This module is free software. It may be used, redistributed and/or
    modified under the terms of the Perl Artistic License.
