Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ropensci/wdman
Webdriver/Selenium Binary Manager
https://github.com/ropensci/wdman
r r-package rselenium rstats selenium webdriver webdriver-manager
Last synced: 3 months ago
JSON representation
Webdriver/Selenium Binary Manager
- Host: GitHub
- URL: https://github.com/ropensci/wdman
- Owner: ropensci
- License: other
- Created: 2017-01-10T16:49:44.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2023-10-25T15:07:31.000Z (about 1 year ago)
- Last Synced: 2024-09-26T01:51:32.436Z (4 months ago)
- Topics: r, r-package, rselenium, rstats, selenium, webdriver, webdriver-manager
- Language: R
- Homepage: https://docs.ropensci.org/wdman
- Size: 240 KB
- Stars: 29
- Watchers: 6
- Forks: 12
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Codemeta: codemeta.json
Awesome Lists containing this project
README
# wdman
[](https://CRAN.R-project.org/package=wdman)
[](https://github.com/ropensci/wdman/actions)
[](https://app.codecov.io/gh/ropensci/wdman)
## Introduction
`wdman` (Webdriver Manager) is an R package that allows the user to manage the downloading/running of third party binaries relating to the webdriver/selenium projects. The package was inspired by a similar node package [webdriver-manager](https://www.npmjs.com/package/webdriver-manager).
The checking/downloading of binaries is handled by the [`binman`](https://github.com/ropensci/binman) package, and the running of the binaries as processes is handled by the [`subprocess`](https://github.com/lbartnik/subprocess) package.
The `wdman` package currently manages the following binaries:
* [Selenium standalone binary](http://selenium-release.storage.googleapis.com/index.html)
* [chromedriver](https://chromedriver.storage.googleapis.com/index.html)
* [PhantomJS binary](https://phantomjs.org/download.html)
* [geckodriver](https://github.com/mozilla/geckodriver/releases)
* [iedriver](https://github.com/SeleniumHQ/selenium/wiki/InternetExplorerDriver)
Associated with the above are five functions to download/manage the binaries:
* `selenium(...)`
* `chrome(...)`
* `phantomjs(...)`
* `gecko(...)`
* `iedriver(...)`
## Installation
You can install `wdman` from GitHub with:
```R
# install.packages("remotes")
remotes::install_github("ropensci/wdman")
```
The package can also be installed from CRAN:
```R
install.packages("wdman")
```
## Example
As an example, we show how one would run the Selenium standalone binary as a process:
### Running the Selenium binary
The binary takes a port argument which defaults to `port = 4567L`. There are a number of optional arguments to use a particular version of the binaries related to browsers selenium may control. By default, the `selenium` function will look to use the latest version of each.
```R
selServ <- selenium(verbose = FALSE)
selServ$process
## PROCESS 'file50e6163b37b8.sh', running, pid 21289.
```
The `selenium` function returns a list of functions and a handle representing the running process.
The returned `output`, `error` and `log` functions give access to the stdout/stderr pipes and the cumulative stdout/stderr messages respectively.
```R
selServ$log()
## $stderr
## [1] "13:25:51.744 INFO [GridLauncherV3.parse] - Selenium server version: 4.0.0-alpha-2, revision: f148142cf8"
## [2] "13:25:52.174 INFO [GridLauncherV3.lambda$buildLaunchers$3] - Launching a standalone Selenium Server on port 4567"
## [3] "13:25:54.018 INFO [WebDriverServlet.] - Initialising WebDriverServlet"
## [4] "13:25:54.539 INFO [SeleniumServer.boot] - Selenium Server is up and running on port 4567"
## $stdout
## character(0)
```
The `stop` function sends a signal that terminates the process:
```R
selServ$stop()
## TRUE
```
### Available browsers
By default, the `selenium` function includes paths to chromedriver/geckodriver/phantomjs so that the Chrome/Firefox and PhantomJS browsers are available respectively. All versions (chromever, geckover etc) are given as `"latest"`. If the user passes a value of `NULL` for any driver, it will be excluded.
On Windows operating systems, the option to included the Internet Explorer driver is also given. This is set to `iedrver = NULL` so not ran by default. Set it to `iedrver = "latest"` or a specific version string to include it on your Windows.
## Further details
For further details, please see [the package vignette](https://docs.ropensci.org/wdman/articles/basics.html).
---
[](https://ropensci.org)