test::www::selenium(3pm) [debian man page]

Test::WWW::Selenium(3pm)				User Contributed Perl Documentation				  Test::WWW::Selenium(3pm)

NAME

       Test::WWW::Selenium - Test applications using Selenium Remote Control

VERSION

       version 1.33

SYNOPSIS

       Test::WWW::Selenium is a subclass of WWW::Selenium that provides convenient testing functions.

	   use Test::More tests => 5;
	   use Test::WWW::Selenium;

	   # Parameters are passed through to WWW::Selenium
	   my $sel = Test::WWW::Selenium->new( host => "localhost",
					       port => 4444,
					       browser => "*firefox",
					       browser_url => "http://www.google.com",
					       default_names => 1,
					       error_callback => sub { ... },
					     );

	   # use special test wrappers around WWW::Selenium commands:
	   $sel->open_ok("http://www.google.com", undef, "fetched G's site alright");
	   $sel->type_ok( "q", "hello world");
	   $sel->click_ok("btnG");
	   $sel->wait_for_page_to_load_ok(5000);
	   $sel->title_like(qr/Google Search/);
	   $sel->error_callback(sub {...});

DESCRIPTION

       This module is a WWW::Selenium subclass providing some methods useful for writing tests. For each Selenium command (open, click, type, ...)
       there is a corresponding "<command>_ok" method that checks the return value (open_ok, click_ok, type_ok).

       For each Selenium getter (get_title, ...) there are four autogenerated methods ("<getter>_is", "<getter>_isnt", "<getter>_like",
       "<getter>_unlike") to check the value of the attribute.

       By calling the constructor with "default_names" set to a true value your tests will be given a reasonable name should you choose not to
       provide one of your own.  The test name should always be the third argument.

NAME

       Test::WWW::Selenium - Test applications using Selenium Remote Control

REQUIREMENTS

       To use this module, you need to have already downloaded and started the Selenium Server.  (The Selenium Server is a Java application.)

ADDITIONAL METHODS

       Test::WWW::Selenium also provides some other handy testing functions that wrap WWW::Selenium commands:

       get_location
	   Returns the relative location of the current page.  Works with _is, _like, ... methods.

       error_callback
	   Sets the method to use when a corresponding selenium test is called and fails.  For example if you call text_like(...) and it fails the
	   sub defined in the error_callback will be called. This allows you to perform various tasks to obtain additional details that occured
	   when obtianing the error. If this is set to undef then the callback will not be issued.

AUTHORS

       o   Maintained by: Matt Phillips <mattp@cpan.org>, Luke Closs <lukec@cpan.org>

       o   Originally by Mattia Barbon <mbarbon@cpan.org>

CONTRIBUTORS

       Dan Dascalescu

       Scott McWhirter

COPYRIGHT AND LICENSE

       Copyright (c) 2011 Matt Phillips <mattp@cpan.org>

       Copyright (c) 2006 Luke Closs <lukec@cpan.org>

       Copyright (c) 2005, 2006 Mattia Barbon <mbarbon@cpan.org>

       This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

perl v5.14.2							    2012-04-25						  Test::WWW::Selenium(3pm)

Test::WWW::Mechanize::CGIApp(3pm)			User Contributed Perl Documentation			 Test::WWW::Mechanize::CGIApp(3pm)

NAME

       Test::WWW::Mechanize::CGIApp - Test::WWW::Mechanize for CGI::Application

SYNOPSIS

	 # We're in a t/*.t test script...
	 use Test::WWW::Mechanize::CGIApp;

	 my $mech = Test::WWW::Mechanize::CGIApp->new;

	 # test a class that uses CGI::Application calling semantics.
	 # (in this case we'll new up an instance of the app and call
	 # its ->run() method)
	 #
	 $mech->app("My::WebApp");
	 $mech->get_ok("?rm=my_run_mode&arg1=1&arg2=42");

	 # test a class that uses CGI::Application::Dispatch
	 # to locate the run_mode
	 # (in this case we'll just call the ->dispatch() class method).
	 #
	 my $dispatched_mech = Test::WWW::Mechanize::CGIApp->new;
	 $dispatched_mech->app("My::DispatchApp");
	 $mech->get_ok("/WebApp/my_run_mode?arg1=1&arg2=42");

	 # create an anonymous sub that this class will use to
	 # handle the request.
	 #
	 # this could be useful if you need to do something novel
	 # after creating an instance of your class (e.g. the
	 # fiddle_with_stuff() below) or maybe you have a unique
	 # way to get the app to run.
	 #
	 my $custom_mech = Test::WWW::Mechanize::CGIApp->new;
	 $custom_mech->app(
	    sub {
	      require "My::WebApp";
	      my $app = My::WebApp->new();
	      $app->fiddle_with_stuff();
	      $app->run();
	    });
	 $mech->get_ok("?rm=my_run_mode&arg1=1&arg2=42");

	 # at this point you can play with all kinds of cool
	 # Test::WWW::Mechanize testing methods.
	 is($mech->ct, "text/html");
	 $mech->title_is("Root", "On the root page");
	 $mech->content_contains("This is the root page", "Correct content");
	 $mech->follow_link_ok({text => 'Hello'}, "Click on Hello");
	 # ... and all other Test::WWW::Mechanize methods

DESCRIPTION

       This package makes testing CGIApp based modules fast and easy.  It takes advantage of Test::WWW::Mechanize to provide functions for common
       web testing scenarios. For example:

	 $mech->get_ok( $page );
	 $mech->title_is( "Invoice Status",
			  "Make sure we're on the invoice page" );
	 $mech->content_contains( "Andy Lester", "My name somewhere" );
	 $mech->content_like( qr/(cpan|perl).org/,
			     "Link to perl.org or CPAN" );

       For applications that inherit from CGI::Application it will handle requests by creating a new instance of the class and calling its "run"
       method.	For applications that use CGI::Application::Dispatch it will call the "dispatch" class method.	If neither of these options are
       the right thing, you can set a reference to a sub that will be used to handle the request.

       This module supports cookies automatically.

       Check out Test::WWW::Mechanize for more information about all of the cool things you can test!

CONSTRUCTOR

       new

       Behaves like, and calls, Test::WWW::Mechanize's "new" method.  It optionally uses an "app" parameter (see below), any other parameters get
       passed to Test::WWW::Mechanize's constructor. Note that you can either pass the name of the CGI::Application into the constructor using the
       "app" parameter or set it later using the "app" method.

	 use Test::WWW::Mechanize::CGIApp;
	 my $mech = Test::WWW::Mechanize::CGIApp->new;

	 # or

	 my $mech = Test::WWW::Mechanize::CGIApp->new(app => 'TestApp');

METHODS

       $mech->app($app_handler)

       This method provides a mechanism for informing Test::WWW::Mechanize::CGIApp how it should go about executing your run_mode.  If you set it
       to the name of a class, then it will load the class and either create an instance and ->run() it (if it's CGI::Application based), invoke
       the ->dispatch() method if it's CGI::Application::Dispatch based, or call the supplied anonymous subroutine and let it do all of the heavy
       lifting.

SEE ALSO

       Related modules which may be of interest: Test::WWW::Mechanize, WWW::Mechanize.

       Various implementation tricks came from Test::WWW::Mechanize::Catalyst.

AUTHOR

       George Hartzell, "<hartzell@alerce.com>"

       based on Test::WWW::Mechanize::Catalyst by Leon Brocard, "<acme@astray.com>".

COPYRIGHT

       Copyright (C) 2007, George Hartzell

       This module is free software; you can redistribute it or modify it under the same terms as Perl itself.

perl v5.8.8							    2008-03-12					 Test::WWW::Mechanize::CGIApp(3pm)