tobytripp-selenium_specr 0.0.1

data/README

@@ -0,0 +1,54 @@
+= SeleniumSpecr
+
+This is a library/plugin that aims to ease the creation and maintenance of Selenium[http://selenium.openqa.org/] functional tests.
+
+SeleniumSpecr operates in one of two modes: as a Rails[http://rubyonrails.com/] plug-in, or as a stand-alone project to test any running web application.
+
+
+== Using SeleniumSpecr Stand-Alone
+
+Generate your test project using the 'specr' application generator:
+
+  specr my_test_project
+
+This will create a new project directory called 'my_test_project'.  Start creating selenium specs by using the included spec generator:
+  
+  cd my_test_project
+  script/generate selenium_spec open_page
+  
+Run your specs using the included rake task:
+  
+  rake test:selenium
+
+=== Configuration
+
+Your test project will include a YAML configuration file that tells SeleniumSpecr where to find your web application.  You can find it in 'config/selenium.yml'.
+
+If you provide 'start' and 'stop' configurations, SeleniumSpecr will start and stop your application server for you by executing the provided commands in a shell.  For example, the following configuration snippet will instruct SeleniumSpecr to start and stop a mongrel rails server before and after each test run:
+
+  app_server:
+    url:   http://localhost:3800
+    start: mongrel_rails start -d -p 3800 -P log/mongrel.pid
+    stop:  mongrel_rails stop -P log/mongrel.pid && rm -f log/mongrel.pid
+
+
+# Note: P Gross has requested this be converted from YAML to just a Ruby file.  Sounds like a plan.
+
+  
+== Using SeleniumSpecr as a Rails plug-in
+
+=== Installation
+
+You can SeleniumSpecr as a git submodule (if you're using git for your Rails project) like this:
+  git submodule add git://github.com/tobytripp/selenium-specr.git vendor/plugins/selenium_specr
+or, if you're using Rails 2.0.2 or later, you can use script/plugin to install it from github[http://github.com]:
+  ./script/plugin install git://github.com/tobytripp/selenium-specr.git
+
+
+
+= TODO
+
+1. Make Selenium tests easier to run by bundling a set of Rake tasks that manage starting the selenium RC server, starting the application server, running all the specs, and then shutting the whole thing down when it's finished.
+2. Make Selenium tests easier to write by including a set of action macros and spec generators.
+3. Make Selenium tests easier to maintain by making it easier to push specs down into unit or integration tests.
+

data/bin/specr

@@ -0,0 +1,24 @@
+#!/usr/bin/env ruby
+
+require 'rubygems'
+require 'rubigen'
+
+# PROJ_ROOT = File.join("#{File.dirname(__FILE__)}", "..")
+# $LOAD_PATH << "#{PROJ_ROOT}/lib"
+
+if %w(-v --version).include? ARGV.first
+  require 'selenium_specr/version'
+  puts "#{File.basename($0)} #{Specr::VERSION::STRING}"
+  exit 0
+end
+
+require 'rubigen/scripts/generate'
+
+source = RubiGen::PathSource.new(
+  :application,
+  File.join( File.dirname(__FILE__), %w(.. app_generators) )
+)
+
+RubiGen::Base.reset_sources
+RubiGen::Base.append_sources source
+RubiGen::Scripts::Generate.new.run(ARGV, :generator => 'specr')

data/lib/selenium_specr.rb

@@ -0,0 +1,15 @@
+$:.unshift(File.dirname(__FILE__)) unless
+  $:.include?(File.dirname(__FILE__)) ||
+  $:.include?(File.expand_path(File.dirname(__FILE__)))
+
+require "selenium_specr/initializer"
+
+module SeleniumSpecr
+  if defined?( RAILS_ROOT )
+    PROJ_ROOT = RAILS_ROOT
+  else
+    PROJ_ROOT = File.join( "#{File.dirname(__FILE__)}", ".." )
+  end
+  
+  Initializer::execute
+end

data/lib/selenium_specr/version.rb

@@ -0,0 +1,9 @@
+module Specr #:nodoc:
+  module VERSION #:nodoc:
+    MAJOR = 0
+    MINOR = 0
+    TINY  = 1
+
+    STRING = [MAJOR, MINOR, TINY].join('.')
+  end
+end

data/test/selenium/specs/register_spec.rb

@@ -0,0 +1,14 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+
+describe "Register" do
+  it "should open" do
+    @browser.open '/account/1/transfers'
+  end
+  
+  it "should fail" do
+    @browser.open '/account/1/transfers'
+    puts @browser.html
+    raise "FAIL!"
+  end
+
+end

data/test/selenium_spec_generator_test.rb

@@ -0,0 +1,45 @@
+require File.join(File.dirname(__FILE__), "test_generator_helper.rb")
+
+class TestSeleniumSpecGenerator < Test::Unit::TestCase
+  include RubiGen::GeneratorTestHelper
+
+  def setup()    bare_setup; end
+  def teardown() bare_teardown; end
+  
+  # Some generator-related assertions:
+  #   assert_generated_file(name, &block) # block passed the file contents
+  #   assert_directory_exists(name)
+  #   assert_generated_class(name, &block)
+  #   assert_generated_module(name, &block)
+  #   assert_generated_test_for(name, &block)
+  # The assert_generated_(class|module|test_for) &block is passed the body of
+  #   the class/module within the file assert_has_method(body, *methods)
+  #   check that the body has a list of methods (methods with parentheses not
+  #   supported yet)
+  #
+  # Other helper methods are:
+  #   app_root_files - put this in teardown to show files generated by the
+  #     test method (e.g. p app_root_files)
+  #   bare_setup - place this in setup method to create the APP_ROOT folder
+  #     for each test
+  #   bare_teardown - place this in teardown method to destroy the TMP_ROOT or
+  #     APP_ROOT folder after each test
+  def test_generator_without_options
+    name = "my_app"
+    run_generator('selenium_spec', [name], sources)
+    assert_generated_file("spec/selenium/specs/my_app_spec.rb") do |contents|
+      assert_match /^describe "MyApp"/, contents
+    end
+  end
+  
+  private
+  def sources
+    [RubiGen::PathSource.new(
+      :test, File.join(File.dirname(__FILE__), "..", generator_path))
+    ]
+  end
+  
+  def generator_path
+    "lib/generators"
+  end
+end

data/test/specr_generator_test.rb

@@ -0,0 +1,72 @@
+require File.join(File.dirname(__FILE__), "test_generator_helper.rb")
+
+class TestSpecrGenerator < Test::Unit::TestCase
+  include RubiGen::GeneratorTestHelper
+
+  def setup
+    bare_setup
+  end
+  
+  def teardown
+    bare_teardown
+  end
+  
+  # Some generator-related assertions:
+  #   assert_generated_file(name, &block) # block passed the file contents
+  #   assert_directory_exists(name)
+  #   assert_generated_class(name, &block)
+  #   assert_generated_module(name, &block)
+  #   assert_generated_test_for(name, &block)
+  # The assert_generated_(class|module|test_for) &block is passed the body of
+  #   the class/module within the file assert_has_method(body, *methods)
+  #   check that the body has a list of methods (methods with parentheses not 
+  #   supported yet)
+  #
+  # Other helper methods are:
+  #   app_root_files - put this in teardown to show files generated by the
+  #     test method (e.g. p app_root_files)
+  #   bare_setup - place this in setup method to create the APP_ROOT folder
+  #     for each test
+  #   bare_teardown - place this in teardown method to destroy the TMP_ROOT or
+  #     APP_ROOT folder after each test
+  def test_generator_without_options
+    run_generator('specr', [APP_ROOT], sources)
+    
+    assert_directory_exists "lib/tasks"
+    assert_directory_exists "lib/core_ext"
+    assert_directory_exists "config"
+    assert_directory_exists "script"
+    assert_directory_exists "spec/selenium/helpers"
+    assert_directory_exists "generators/selenium_spec"
+    
+    assert_generated_file   "lib/selenium_specr/selenium_rc_server.rb"
+    assert_generated_file   "lib/selenium_specr/application_server.rb"
+    assert_generated_file   "lib/selenium_specr/shell.rb"
+    assert_generated_file   "lib/selenium_specr/formatter/screenshot_formatter.rb"
+    assert_generated_file   "lib/core_ext/string_extensions.rb"
+    assert_generated_file   "lib/tasks/task_loader.rb"
+    assert_generated_file   "lib/tasks/test/selenium.rake"
+    assert_generated_file   "lib/tasks/test/selenium.rb"
+    assert_generated_file   "spec/selenium/spec_helper.rb"
+    assert_generated_file   "spec/selenium/selenium.rb"
+    assert_generated_file   "config/selenium.yml"
+    assert_generated_file   "lib/bin/selenium-server.jar"
+    
+    assert_generated_file   "Rakefile"
+    assert_generated_file   "script/console"
+    assert_generated_file   "script/generate"
+    
+    assert_generated_file   "generators/selenium_spec/selenium_spec_generator.rb"
+  end
+  
+  private
+  def sources
+    [ RubiGen::PathSource.new(
+        :test, File.join( File.dirname(__FILE__), "..", generator_path )
+      ) ]
+  end
+  
+  def generator_path
+    "app_generators"
+  end
+end

metadata

@@ -0,0 +1,104 @@
+--- !ruby/object:Gem::Specification 
+name: tobytripp-selenium_specr
+version: !ruby/object:Gem::Version 
+  version: 0.0.1
+platform: ruby
+authors: 
+- Toby Tripp
+- Lydia Tripp
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-06-25 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.1.3
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: rake
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.8.1
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: diff-lcs
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.1.2
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: rubigen
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.1.2
+    version: 
+description: 
+email: ""
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README
+files: 
+- bin/specr
+- lib/selenium_specr
+- lib/selenium_specr/core_ext
+- lib/selenium_specr/core_ext/string_extensions.rb
+- lib/selenium_specr/version.rb
+- lib/selenium.rb
+- lib/selenium_specr.rb
+- lib/tasks
+- lib/tasks/gem.rake
+- lib/tasks/task_loader.rb
+- lib/tasks/test
+- lib/tasks/test/selenium.rake
+- README
+has_rdoc: true
+homepage: http://ttripp.blogspot.com
+post_install_message: 
+rdoc_options: 
+- --main
+- README
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: Rake tasks and scripts for automating Selenium RSpec testing.
+test_files: 
+- test/selenium_spec_generator_test.rb
+- test/specr_generator_test.rb
+- test/selenium/specs/register_spec.rb