txt: ## dist_github-azawawi-Selenium-WebDriver.md
  ## Selenium::WebDriver
  
  [![Actions
  Status](https://github.com/azawawi/raku-selenium-webdriver/workflows/test/badge.svg)](https://github.com/azawawi/raku-selenium-webdriver/actions)
  
  This module provides the [Raku](http://raku.org) bindings for the [Selenium WebDriver Wire Protocol](https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol).
  
  ***Note:*** This module is a work in progress. Please see its project status [here](https://github.com/azawawi/perl6-selenium-webdriver/blob/master/README.md#project-status).
  
  ## Example
  
  ```
  use v6;
  use Selenium::WebDriver::PhantomJS;
  
  my $driver = Selenium::WebDriver::PhantomJS.new;
  $driver.url("http://google.com");
  say "Title: "         ~ $driver.title;
  say "URL: "           ~ $driver.url;
  say "Source length: " ~ $driver.source.chars;
  $driver.save-screenshot('test.png');
  LEAVE {
    $driver.quit if $driver.defined
  };
  
  ```
  
  For more examples, please see the <examples> folder.
  
  ## PhantomJS Installation
  
  ### Linux/Debian
  
  To install phantomjs on Debian, please type the following:
  
  ```
  $ sudo apt-get install phantomjs
  
  ```
  
  **CAUTION**: Also there are [prebuilt binaries](https://bitbucket.org/ariya/phantomjs/downloads) for PhantomJS for Linux if the packaged version is a bit old.
  
  ### Mac OS X
  
  To install PhantomJS on Mac OS X, the simplest solution is to use brew:
  
  ```
  $ brew update
  $ brew install phantomjs
  
  ```
  
  ### Windows
  
  To install PhantomJS on windows, please download a copy from
  [Here](http://phantomjs.org/) and then make it available in your PATH environment
  variable.
  
  ### Travis CI
  
  Travis CI comes with [pre-installed PhantomJS](http://docs.travis-ci.com/user/gui-and-headless-browsers/#Using-PhantomJS).
  No special instructions are needed.
  
  ## Project Status
  
  | Web Driver | Status |
  | --- | --- |
  | PhantomJS | **DONE** but needs more tests |
  | Firefox | **DONE** |
  | Chrome | **DONE** but needs external [chromedriver](https://sites.google.com/a/chromium.org/chromedriver/) |
  | Safari | Pending |
  | Opera | Pending |
  | MSIE | Pending |
  | MSEdge | Pending |
  | BlackBerry | **DONE** |
  
  ## Installation
  
  To install it using zef (a module management tool bundled with Rakudo Star):
  
  ```
  $ zef install Selenium::WebDriver
  
  ```
  
  ## Testing
  
  * To run tests:
  
  ```
  $ prove --ext .rakutest -ve "raku -I."
  
  ```
  
  * To run all tests including author tests (Please make sure
    [Test::Meta](https://github.com/jonathanstowe/Test-META) is installed):
  
  ```
  $ zef install Test::META
  $ TEST_AUTHOR=1 prove --ext .rakutest -ve "raku -I."
  
  ```
  
  ## Author
  
  Ahmad M. Zawawi, [azawawi](https://github.com/azawawi/) on #raku
  
  ## License
  
  MIT License
  