Webinject(3pm)						User Contributed Perl Documentation					    Webinject(3pm)

NAME

       Webinject - Perl Module for testing web services

SYNOPSIS

	   use Webinject;
	   my $webinject = Webinject->new();
	   $webinject->engine();

DESCRIPTION

       WebInject is a free tool for automated testing of web applications and web services. It can be used to test individual system components
       that have HTTP interfaces (JSP, ASP, CGI, PHP, AJAX, Servlets, HTML Forms, XML/SOAP Web Services, REST, etc), and can be used as a test
       harness to create a suite of [HTTP level] automated functional, acceptance, and regression tests. A test harness allows you to run many
       test cases and collect/report your results.  WebInject offers real-time results display and may also be used for monitoring system response
       times.

CONSTRUCTOR

   new ( [ARGS] )
       Creates an "Webinject" object.

       reporttype
	   possible values are 'standard', 'nagios', 'nagios2', 'mrtg' or 'external:'

       nooutput
	   suppress all output to STDOUT, create only logilfes

       break_on_errors
	   stop after the first testcase fails, otherwise Webinject would go on and execute all tests regardless of the previous case.

       timeout
	   Default timeout is 180seconds. Timeout starts again for every testcase.

       useragent
	   Set the useragent used in HTTP requests. Default is 'Webinject'.

       max_redirect
	   Set maximum number of HTTP redirects. Default is 0.

       proxy
	   Sets a proxy which is then used for http and https requests.

       output_dir
	   Output directory where all logfiles will go to. Defaults to current directory.

       globalhttplog
	   Can be 'yes' or 'onfail'. Will log the http request and response to a http.log file.

       httpauth
	   Provides credentials for webserver authentications. The format is:

	     ['servername', 'portnumber', 'realm-name', 'username', 'password']

       baseurl
	   the value can be used as {BASEURL} in the test cases

       baseurl1
	   the value can be used as {BASEURL1} in the test cases

       baseurl2
	   the value can be used as {BASEURL2} in the test cases

       standaloneplot
	   can be "on" or "off". Default is off.  Create gnuplot graphs when enabled.

       graphtype
	   Defaults to 'lines'

       gnuplot
	   Defines the path to your gnuplot binary.

METHODS

   engine
       start the engine of webinject

EXAMPLES

   example test case
	 <testcases>
	   <case
	     id 	    = "1"
	     description1   = "Sample Test Case"
	     method	    = "get"
	     url	    = "{BASEURL}/test.jsp"
	     verifypositive = "All tests succeded"
	     warning	    = "5"
	     critical	    = "15"
	     label	    = "testpage"
	     errormessage   = "got error: {PARSERESPONSE}"
	   />
	 </testcases>

       detailed description about the syntax of testcases can be found on the Webinject homepage.

SEE ALSO

       For more information about webinject visit http://www.webinject.org

AUTHOR

       Corey Goldberg, <corey@goldb.org>

       Sven Nierlein, <nierlein@cpan.org>

COPYRIGHT AND LICENSE

       Copyright (C) 2010 by Sven Nierlein

       Copyright (C) 2004-2006 by Corey Goldberg

       This library is free software; you can redistribute it under the GPL2 license.

perl v5.14.2							    2012-05-12							    Webinject(3pm)