peridot-php / webdriver-manager
Library and command line tool for managing Selenium WebDriver
Installs: 33 542
Dependents: 2
Suggesters: 0
Security: 0
Stars: 35
Watchers: 5
Forks: 7
Open Issues: 3
Requires
- php: >=5.4.0
- evenement/evenement: ~2.0
- splitbrain/php-archive: ~1.0
- symfony/console: ~2.6
Requires (Dev)
This package is not auto-updated.
Last update: 2024-11-01 22:38:19 UTC
README
The perfect companion for projects with functional tests. Heavily inspired by the webdriver-manager
that ships with protractor. WebDriver Manager allows you to keep Selenium Server binaries up to date. It also provides a packaged solution for easily starting Selenium Server.
In addition to an easy to use command line application, WebDriver Manager provides a library for managing Selenium binaries in your own apps and tools.
Installation
WebDriver Manager is meant to be a drop in installation for any project using Selenium WebDriver for functional tests.
$ composer require --dev peridot-php/webdriver-manager
Once installed, you can operate Selenium Server from the comfort of your project:
$ vendor/bin/manager start
Usage
clean
Remove all installed binaries.
status
List all available binaries and their installed status. Status shows if the binary is installed, out of date, or missing.
update
The update command downloads current binaries and deletes old ones.
start
Starts Selnium Server with all drivers managed by WebDriver Manager. The start command will run an update at start to make sure drivers are available and up to date.
Library Usage
WebDriver manager exposes a really simple interface that makes it easy to leverage in your own applications and tools:
use Peridot\WebDriverManager\Manager; $manager = new Manager(); $manager->update(); //update all binaries $manager->update('selenium'); //only update selenium $manager->clean(); //remove installed binaries $manager->startInForeground(); //start selenium in the foreground on port 4444 $manager->startInForeground(9999); //start selenium in the foreground on port 9999 $manager->startInBackground(); //start selenium in the background on port 4444 $manager->startInBackground(9999); //start in the background on port 9999 $path = $manager->getInstallPath(); //where binaries are installed $manager->setInstallPath(__DIR__); //set the path to install binaries $manager->addBinary(new MyCustomDriver()); //add a binary to manage $manager->removeBinary('chromdedriver'); //remove a managed binary $binaries = $manager->getBinaries(); //get a collection of managed binaries
A note on starting Selenium in the background
WebDriver Manager does not block when starting a background process. This makes it difficult to see if Selenium encountered any errors (perhaps a corrupt binary?). The SeleniumProcess
class provides a method for checking the status of the process. If you want to check that Selenium Server started in the background ok, you might try something like this:
$process = $manager->startInBackground(); usleep(250000); //give Selenium a quarter of a second to validate input if (! $process->isRunning()) { //Selenium encountered an error print $process->getError(); $process->close(); return; } //do rad Selenium things
For more information, see the API docs;
Examples
The API has been used to create a custom Behat listener capable of starting the server before Mink tests are run. This tool is included as part of a demo project known as behavior driven todos.
Running Tests
WebDriver Manager's tests were written using the Peridot test framework.
Unit tests can be run like so:
$ vendor/bin/peridot
And integration tests can be run like this:
$ vendor/bin/peridot --grep *.it.php
Contributing
Please feel free to open issues or pull requests.