package Test::WWW::Selenium::More::Manual;


__END__
=pod

=head1 NAME

Test::WWW::Selenium::More::Manual

=head1 VERSION

version 0.001

=head1 NAME

Test::WWW::Selenium::More::Manual - Testing with Selenium

=head1 INSTALL THE SELENIUM SERVER

Selenium is written in Java.  So you need Java.  Then download the latest jar
file from http://seleniumhq.org/download.  Put it anywhere.

=head1 WRITE A BASIC SELENIUM TEST

    # in the file t/test.t write the following code:
    use HHoldings::Core::Selenium;
    my $s = HHoldings::Core::Selenium->new; 
    $s->note('this is a test.  this is only a test.')
      ->open_ok("/");

=head1 RUNNING SELENIUM TESTS

This section describes setting up and running Selenium tests on the command
line.

Basic setup

    # Start your web server on localhost (port 80)
    ...

    # Start the Selenium server
    java -jar selenium-server.jar -port 4444 -trustAllSSLCertificates -browserSessionReuse

    # Run your tests against localhost (port 80)
    prove -lrv t/test.t

Headless server setup

    # Start Xvfb so you can run a web browser without X Windows
    Xvfb :99

    # Start the Selenium server
    DISPLAY=:99 java -jar selenium-server.jar -port 4444 -trustAllSSLCertificates -browserSessionReuse

    # Run your tests: 
    prove -lrv t/test.t

Run Selenium tests against a remote website

    SELENIUM_BROWSER_URL=http://example.com prove -lrv t/test.t

Run tests against a remote Selenium server

    # Start the Selenium server on the remote host (lets say 99.99.99.99).  
    # Then run your tests locally like this:
    SELENIUM_HOST=99.99.99.99 prove -lrv t/test.t

Running tests slowly

    # Test fly by too fast sometimes.  This slows things down.  It basically
    # calls sleep after every call to the Selenium server
    SELENIUM_SLEEP=1 prove -lrv t/test.t

Also see the ENVIRONMENT VARIABLES section of HHoldings::Core::Selenium
documentation.

=head1 WRITING MORE ADVANCED TESTS

TODO

=head1 AUTHOR

Eric Johnson <kablamo at iijo dot nospamthanks dot org>

=head1 COPYRIGHT AND LICENSE

This software is copyright (c) 2012 by Foxtons.

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

=cut

