Selenium-Remote-Driver/README

NOTE: Currently, I don't use Perl for my day job & support for this module is falling behind. If you want to take over 
      maintenance of this module, please contact me.

========================================================================================================================



*** NOTE: Most of the JSON Wire Protocol http://code.google.com/p/selenium/wiki/JsonWireProtocol
*** 	  has been implemented. This is still beta quality code.

Perl Bindings for Selenium 2.0 Remote WebDriver

This is a Perl Binding for Selenium 2.0 Remote WebDriver, which you should download
from http://code.google.com/p/selenium; look for selenium-server-standalone.jar.
This binding will not work with the 1.0 version of Selenium. Please use
WWW::Selenium from CPAN if you're interested in 1.0 bindings. 

The unit tests provide varioud examples on how to invoke & use the module.

INSTALLATION

To install this module, run the following commands:

	perl Makefile.PL
	make
	make test
	make install

UNIT TESTS

This module uses LWP::Protocol::PSGI to facilitate unit tests. LWP::Protocol::PSGI
overrides the LWP HTTP/HTTPS & this allows us to "mock" the interaction with
WebDriver Server. In regular instances you should be running the tests against
the mocked recording, which are stored in t/mock-recordings. If you want to run
the tests live against the WebDriver server, set an environment variable
WD_MOCKING_RECORD to 1. This will force the unit tests to run tests against the
WebDriver server & also save the traffic (request/response) in t/mock-recordings.
Either reset the environment variable or set it to 0 to revert to mocking the
traffic. 

SUPPORT AND DOCUMENTATION

After installing, you can find documentation for this module with the
perldoc command.

    perldoc Selenium::Remote::Driver
    perldoc Selenium::Remote::WebElement

Please file all bugs for this module at:
    
	https://github.com/aivaturi/Selenium-Remote-Driver/issues

You can also find some supporting docs at:

    https://github.com/aivaturi/Selenium-Remote-Driver/wiki

LICENSE AND COPYRIGHT

Copyright (c) 2010-2011 Aditya Ivaturi, Gordon Child

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

     http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.