README.md in watir_css-0.1.0 vs README.md in watir_css-0.2.0

- old
+ new

@@ -1,9 +1,15 @@ # WatirCss -CSS-based locator engine for [watir-webdriver](https://github.com/watir/watir-webdriver). +A CSS based locator engine for [watir](https://github.com/watir/watir). +By default Watir translates location approaches into XPath. This gem will replace XPath calls +with CSS calls where possible. + +Some locator strategies supported by Watir cannot be reimplemented with watir_css. +In such cases, it falls back to the XPath implementation in Watir. + ## Installation Add this line to your application's Gemfile: ```ruby @@ -22,53 +28,16 @@ $ gem install watir_css ``` ## Usage -Require after watir-webdriver, the rest should just work. - ```ruby -require 'watir-webdriver' require 'watir_css' ``` -## Comparison with default watir-webdriver locator - -By default Watir converts calls into XPath; this gem will replace XPath calls -with CSS calls where possible. - -This functionality used to be present directly in watir-webdriver. During -the transition to Watir 6.0, a hook was included in the repository to -allow for alternate locator strategies. - -This gem replaces: - -```ruby -Watir.prefer_css -``` - -## Limitations - -Some watir-webdriver locators cannot be reimplemented with watir_css. In such cases, -it fall backs to watir-webdriver, so you should be able to migrate pretty easily. - -## Development - -To install this gem onto your local machine, run `bundle exec rake install`. -To release a new version, update the version number in `version.rb`, -and then run `bundle exec rake release`, which will create a git tag for the version, -push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org). - ## Specs -Watir_css uses [watirspec](https://github.com/watir/watirspec) for testing, so -you should first fetch it: - -```bash -$ git submodule init && git submodule update -``` - -Now, you can run all specs: +WatirCss will run watirspecs from Watir project: ```bash $ bundle exec rake spec ```