pivotal / polonium

Selenium RC with Rails integration and enhanced assertions.

This URL has Read+Write access

Removed dependency on selenium-rc. The server rake tasks give a helpful 
message if selenium-rc is not installed.
Rob Olson & Brian Takita (author)
Fri Jul 31 12:39:19 -0700 2009
commit  bd290a40575e0bc89630a8b266fab53419441e8b
tree    d278b76c0629511df0e5e5b2d982e1b79f92942c
parent  dc98f063501b5a426cfd86c0116858c4c535856c
name age
history
message
file .gitignore Fri Jul 18 16:26:16 -0700 2008 Ignoring pkg directory. git-svn-id: svn+ssh:/... [btakita]
file CHANGES Tue Dec 23 11:33:23 -0800 2008 Fixed integration issues rspec 1.1.11. [Brian Takita]
file README Fri May 30 17:03:44 -0700 2008 mg - docs: cleaned up README a bit, added examp... [grafton]
file Rakefile Fri Jul 31 12:39:19 -0700 2009 Removed dependency on selenium-rc. The server r... [pivotal]
directory core/ Fri Oct 26 18:08:24 -0700 2007 Added selenium core git-svn-id: svn+ssh://ruby... [btakita]
directory examples/ Fri Aug 01 14:53:51 -0700 2008 fixed a nil pointer exception that was keeping ... [jeremylightsmith]
file geminstaller.yml Mon Nov 10 10:24:56 -0800 2008 thewoolleyman - upgrade and clean up rspec depe... [pivotal]
file init.rb Thu Apr 03 00:47:40 -0700 2008 Adding placeholder init.rb. git-svn-id: svn+ss... [btakita]
directory lib/ Fri Jul 31 12:34:08 -0700 2009 WaitFor#wait_for delegates to super if no block... [pivotal]
directory spec/ Fri Jul 31 12:34:08 -0700 2009 WaitFor#wait_for delegates to super if no block... [pivotal]
directory tasks/ Fri Jul 31 12:39:19 -0700 2009 Removed dependency on selenium-rc. The server r... [pivotal]
README
== Introduction

Welcome to Polonium!

Polonium is a wrapper for Selenium that lets your write cleaner Selenium tests
in ruby, and run them with a simple set of rake tasks.

== Installation
Polonium depends on the Selenium gem. To install this dependency, run:
  sudo gem install Selenium

The current version of this plugin can be found at: http://rubyforge.org/var/svn/pivotalrb/polonium/trunk

You may install the plugin with the following command:

  script/plugin install svn://rubyforge.org/var/svn/pivotalrb/polonium/trunk

You may also use Polonium as a gem:

  sudo gem install polonium

== Getting Started
The polonium plugin rake tasks assumes you have a test/selenium directory with a selenium_suite.rb file in
it.  To get started, copy examples/selenium_suite.rb, examples/selenium_helper.rb, and examples/example_test.rb
into your test/selenium directory.

To start the selenium server, run the command:
  selenium
The selenium command was installed with the Selenium Gem.

You can run Polonium tests using rspec or test/unit through the rake tasks.
  rake selenium:test
  # or
  rake selenium:spec

[TODO: this doesn't seem to work on a vanilla project that is using Polonium as a gem & the code in
the examples directory; @selenium_driver is nil.  Is there an extra step necessary to get this working?]

You can also run individual tests straight ruby:

ruby test/selenium/any_selenium_test.rb

== Future Enhancements

There are a few things we'd like to improve, but we wanted to get this out now.  Check the tracker in the pivotal.rb 
RubyForge project for details.

== License

Polonium is distributed under the MIT license. Copyright © 2007-2008 Pivotal Labs, Inc.

== Contributing

Contributions to this plugin are welcome.  Contributions should be accompanied by tests.  See 
http://pivotalrb.rubyforge.org for more details.