Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/watir/watir
Watir Powered By Selenium
https://github.com/watir/watir
ruby selenium watir
Last synced: 5 days ago
JSON representation
Watir Powered By Selenium
- Host: GitHub
- URL: https://github.com/watir/watir
- Owner: watir
- License: mit
- Created: 2009-11-09T11:40:46.000Z (about 15 years ago)
- Default Branch: main
- Last Pushed: 2024-05-31T14:27:21.000Z (7 months ago)
- Last Synced: 2024-10-29T10:08:50.492Z (about 2 months ago)
- Topics: ruby, selenium, watir
- Language: Ruby
- Homepage: http://watir.github.io
- Size: 8.47 MB
- Stars: 1,523
- Watchers: 73
- Forks: 246
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGES.md
- License: LICENSE
- Support: support/doctest_helper.rb
Awesome Lists containing this project
- awesome-starred-test - watir/watir - Watir Powered By Selenium (Ruby)
README
# watir
Watir Powered By Selenium!
[](http://badge.fury.io/rb/watir)
[](https://github.com/watir/watir/actions/workflows/chrome.yml)
[](https://github.com/watir/watir/actions/workflows/edge.yml)
[](https://github.com/watir/watir/actions/workflows/firefox.yml)
[](https://github.com/watir/watir/actions/workflows/ie.yml)
[](https://github.com/watir/watir/actions/workflows/safari.yml)
[](https://github.com/watir/watir/actions/workflows/unit.yml)
## Using Watir
This README is for people interested in writing code for Watir or gems in the Watir ecosystem
that leverage private-api Watir code.
For our users, everything you'll need is on the [Watir website](https://watir.github.io/):
examples, news, guides, additional resources, support information and more.
## Procedure for Patches/Pull Requests
* Fork the project.
* Clone onto your local machine.
* Create a new feature branch (bonus points for good names).
* Make your feature addition or bug fix.
* Add tests for it. This is important so we don't unintentionally break it in a future version.
* Commit, do not change Rakefile, gemspec, or CHANGES files, we'll take care of that on release.
* Make sure it is passing doctests.
* Make sure it is passing rubocop.
* Push to your forked repository.
* Send a pull request.
## Developing Extensions
When developing a gem intended to be used with Watir, you can run your code with WatirSpec
to make sure that requiring your code does not break something else in Watir.
First, add WatirSpec Rake tasks to your gem:
```ruby
# Rakefile
require 'watirspec/rake_tasks'
WatirSpec::RakeTasks.new
```
Second, initialize WatirSpec for your gem:
```bash
$ bundle exec rake watirspec:init
```
This command will walk you through how to customize your code.
## Automatic Element Generation
The majority of element methods Watir provides is autogenerated from specifications.
This is done by extracting the IDL parts from the spec and processing them with the
[WebIDL gem](https://github.com/jarib/webidl).
Generated elements are currently based on the following specifications:
* [HTML](https://www.w3.org/TR/2017/REC-html52-20171214/) (`lib/watir/elements/html_elements.rb`)
* [SVG](https://www.w3.org/TR/2018/CR-SVG2-20180807/) (`lib/watir/elements/svg_elements.rb`)
To run:
```bash
$ bundle exec rake html:update
$ bundle exec rake svg:update
```
## Specs
#### Github Actions
Watir specs are run with [Github Actions](https://github.com/watir/watir/tree/main/.github/workflows).
Watir code is tested on Linux with latest versions of supported browsers and all active Ruby versions.
#### Doctests
Watir uses [yard-doctest](https://github.com/p0deje/yard-doctest) to directly test
our documentation examples.
```bash
mkdir ~/.yard
bundle exec yard config -a autoload_plugins yard-doctest
rake yard:doctest
```
#### Coveralls
Watir code is run through [Coveralls](https://coveralls.io/github/watir/watir) to encourage PRs
to ensure all paths in their code have tests associated with them.
#### Rubocop
Watir is using [Rubocop](https://github.com/rubocop/rubocop) to ensure a consistent style across the
code base. It is run with our minimum supported Ruby version (2.3)
We have some established exceptions at `.rubocop.yml`
that might need to be tweaked for new code submissions. This can be addressed in the PR as necessary.
#### Statistics
Element specs are run with
[Selenium Statistics gem](https://github.com/titusfortner/selenium_statistics)
to verify that changes to the code do not dramatically decrease the performance based
on wire calls.
## Copyright
See LICENSE for details