Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/watir/watir_meta
Former watir.gem that referenced both watir-webdriver and watir-classic
https://github.com/watir/watir_meta
Last synced: 3 months ago
JSON representation
Former watir.gem that referenced both watir-webdriver and watir-classic
- Host: GitHub
- URL: https://github.com/watir/watir_meta
- Owner: watir
- License: other
- Archived: true
- Created: 2012-03-27T21:30:36.000Z (over 12 years ago)
- Default Branch: master
- Last Pushed: 2016-08-06T21:40:08.000Z (about 8 years ago)
- Last Synced: 2024-07-18T23:35:14.130Z (4 months ago)
- Language: Ruby
- Homepage: http://watir.com
- Size: 6.75 MB
- Stars: 407
- Watchers: 25
- Forks: 45
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGES.md
- License: LICENSE
Awesome Lists containing this project
README
# Status
This code is no longer being used, and this repository exists only as an archive.
# Watir
Watir, pronounced water, is an open-source (BSD) family of Ruby libraries for automating web browsers.
It supports your app no matter what technology it is developed in.
They support Internet Explorer on Windows, Firefox and Chrome on Windows, Mac and Linux.
## About
This is the meta-gem for installing all necessary dependencies and having a convenient way to switch between different Watir drivers.
Currently supported drivers are:
- [watir-classic](https://github.com/watir/watir-classic)
- [watir-webdriver](https://github.com/watir/watir-webdriver)
Visit [Watir website](http://watir.com) or refer to each gem's own README and documentation for better understanding of how to use these libraries.
## Watir Related Libraries
### Integration
* [watir-rails](https://github.com/watir/watir-rails) for using Watir with Rails.
* [watir-rspec](https://github.com/watir/watir-rspec) for writing your tests with RSpec.
* [watir-robot](https://github.com/semperos/watir-robot) for using Watir with Robot Framework.
* [watir-timecop](https://github.com/p0deje/watir-timecop) for making Watir compatible with Timecop.
### Frameworks
* [page-object](https://github.com/cheezy/page-object)
* [test-page](https://github.com/jarmo/test-page)
* [test-factory](https://github.com/rSmart/TestFactory)
* [watirmark](https://github.com/convio/watirmark)
* [watirsome](https://github.com/p0deje/watirsome)
### Other
* [watir-webdriver-performance](https://github.com/90kts/watir-webdriver-performance) for monitoring web application performance.
* [watir-scroll](https://github.com/p0deje/watir-scroll) for scrolling emulation
* [watir-dom-wait](https://github.com/p0deje/watir-dom-wait) for element waiting based on DOM change
* [watir-get-image-content](https://github.com/orangeudav/watir-get-image-content) for getting image content
* [watir-extensions-element-screenshot](https://github.com/ansoni/watir-extensions-element-screenshot) for making screenshot of specific element
## Usage
Add it into your Gemfile:
````ruby
gem "watir", "~>4.0"
````
Or install it manually with the following command:
````
gem install watir
````
Then in your test file:
````ruby
require "watir"
browser = Watir::Browser.new
````
The command above will use watir-classic with Internet Explorer on Windows and
watir-webdriver with Firefox on Linux/OS X by default.
## Switching Between Drivers
There are multiple ways to specify a different driver.
By specifying different browser via ````#initialize````:
````ruby
require "watir"
# will use watir-webdriver with Chrome
browser = Watir::Browser.new :chrome
````
By specifying driver manually via ````Watir.driver#=````:
````ruby
require "watir"
# will use watir-webdriver with Internet Explorer
Watir.driver = :webdriver
browser = Watir::Browser.new :ie
````
Or by using an environment variable ````WATIR_DRIVER````:
````ruby
require "watir"
# will use watir-classic
ENV["WATIR_DRIVER"] = "classic"
browser = Watir::Browser.new
````
## Limitations
Currently it is possible to use only one driver per Ruby process. All the
methods to switch between drivers won't have any effect after you've opened
your first browser window.
## License
See [LICENSE](https://github.com/watir/watir/blob/master/LICENSE) for details.