webinject(3pm) [debian man page]
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)
Check Out this Related Man Page
Plack::Test(3pm) User Contributed Perl Documentation Plack::Test(3pm) NAME
Plack::Test - Test PSGI applications with various backends SYNOPSIS
use Plack::Test; # named params test_psgi app => sub { my $env = shift; return [ 200, [ 'Content-Type' => 'text/plain' ], [ "Hello World" ] ], }, client => sub { my $cb = shift; my $req = HTTP::Request->new(GET => "http://localhost/hello"); my $res = $cb->($req); like $res->content, qr/Hello World/; }; use HTTP::Request::Common; # positional params (app, client) my $app = sub { return [ 200, [], [ "Hello "] ] }; test_psgi $app, sub { my $cb = shift; my $res = $cb->(GET "/"); is $res->content, "Hello"; }; DESCRIPTION
Plack::Test is a unified interface to test PSGI applications using HTTP::Request and HTTP::Response objects. It also allows you to run PSGI applications in various ways. The default backend is "Plack::Test::MockHTTP", but you may also use any Plack::Handler implementation to run live HTTP requests against at web server FUNCTIONS
test_psgi test_psgi $app, $client; test_psgi app => $app, client => $client; Runs the client test code $client against a PSGI application $app. The client callback gets one argument $cb, a callback that accepts an "HTTP::Request" object and returns an "HTTP::Response" object. Use HTTP::Request::Common to import shortcuts for creating requests for "GET", "POST", "DELETE", and "PUT" operations. For your convenience, the "HTTP::Request" given to the callback automatically uses the HTTP protocol and the localhost (127.0.0.1 by default), so the following code just works: use HTTP::Request::Common; test_psgi $app, sub { my $cb = shift; my $res = $cb->(GET "/hello"); }; Note that however, it is not a good idea to pass an arbitrary (i.e. user-input) string to "GET" or even "HTTP::Request->new" by assuming that it always represents a path, because: my $req = GET "//foo/bar"; would represent a request for a URL that has no scheme, has a hostname foo and a path /bar, instead of a path //foo/bar which you might actually want. OPTIONS
Specify the Plack::Test backend using the environment variable "PLACK_TEST_IMPL" or $Plack::Test::Impl package variable. The available values for the backend are: MockHTTP (Default) Creates a PSGI env hash out of HTTP::Request object, runs the PSGI application in-process and returns HTTP::Response. Server Runs one of Plack::Handler backends ("Standalone" by default) and sends live HTTP requests to test. ExternalServer Runs tests against an external server specified in the "PLACK_TEST_EXTERNALSERVER_URI" environment variable instead of spawning the application in a server locally. For instance, test your application with the "HTTP::Server::ServerSimple" server backend with: > env PLACK_TEST_IMPL=Server PLACK_SERVER=HTTP::Server::ServerSimple prove -l t/test.t AUTHOR
Tatsuhiko Miyagawa perl v5.14.2 2011-09-20 Plack::Test(3pm)