pagemodels 0.1.0

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in page-models.gemspec
+gemspec

data/README.txt

@@ -0,0 +1,58 @@
+Page Models move complex and copy-pasted code out of your acceptance tests and into easily managed Ruby classes with (optional) integration for Rails, Cucumber, and RSpec.
+
+
+~~~~~~~~
+# env.rb
+require 'pagemodels'
+
+PageModels.configure do |config|
+  config.driver = :capybara
+  config.integrate :rspec
+  config.integrate :cucumber
+  config.integrate :rails
+end
+
+
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+# my_cucumber_test.feature
+Given I open the GitHub project page for the user "rickgrundy" and the repo "page-models"
+When I look at the commit history
+Then I should see at least 3 commits
+
+
+~~~~~~~~~~~~~~~~~~~~~~
+# my_cucumber_steps.rb
+When /I look at the commit history/ do
+  page_model.navigate_to_commits
+end
+
+Then /I should see at least (\d+) commits/ do |count|
+  page_model.verify_commit_count(count)
+end
+
+
+~~~~~~~~~~~~~~~~~~~~~~
+# GitHubProjectPage.rb
+class GitHubProjectPage < PageModels::Base
+  def initialize(user, repo)
+    @user, @repo = user, repo
+  end
+  
+  def url
+    "https://www.github.com/#{@user}/#{@repo}/"
+  end
+  
+  def verify!
+    should have_content "#{@user} / #{@repo}"
+    should have_content "Source"
+    should have_content "Commits"
+  end
+  
+  def navigate_to_commits
+    click_link "Commits"
+  end
+  
+  def verify_commit_count(count)
+    all(".commit").should have_at_least(count).things
+  end
+end

data/Rakefile

@@ -0,0 +1,7 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => [:spec]

data/examples/rails_and_cucumber/.gitignore

@@ -0,0 +1,4 @@
+.bundle
+db/*.sqlite3
+log/*.log
+tmp/

data/examples/rails_and_cucumber/Gemfile

@@ -0,0 +1,11 @@
+source 'http://rubygems.org'
+
+gem 'rails', '3.0.7'
+
+group :test do
+  gem 'cucumber-rails'
+  gem 'rspec', '>= 2.5.0'
+  gem 'capybara'
+  gem 'launchy'
+  gem 'pagemodels', :path => File.join(File.dirname(__FILE__), "..", "..")
+end

data/examples/rails_and_cucumber/README.txt

@@ -0,0 +1,23 @@
+This example demonstrates how to use page models to test a Rails app with Cucumber and RSpec, using Capybara/Rack-Test as a driver.
+
+This example demonstrates how to use page models with RSpec to write acceptance tests for any website (in this case Google.com), using Capybara/Selenium/Firefox as a driver.
+
+~~~~~~~~~~
+
+See features/support/env.rb for information about configuring PageModels to integrate with the various frameworks:
+
+PageModels.configure do |config|
+  config.driver = :capybara
+  config.integrate :rails
+  config.integrate :cucumber
+  config.integrate :rspec
+end
+
+env.rb also loads all everything in the pagemodels directory. GoogleSearchPage and GoogleResultsPage provide examples of page models which override PageModels::Base.
+
+~~~~~~~~~~
+
+RSpec integration exposes two convenience methods you may use in your specs: 
+
+open_page(page_model) - switches the current page model to the one provided and calls #open!
+should_see_page(page_model) - switches the current page model and calls #verify!

data/examples/rails_and_cucumber/Rakefile

@@ -0,0 +1,7 @@
+# Add your own tasks in files placed in lib/tasks ending in .rake,
+# for example lib/tasks/capistrano.rake, and they will automatically be available to Rake.
+
+require File.expand_path('../config/application', __FILE__)
+require 'rake'
+
+RailsAndCucumber::Application.load_tasks

data/examples/rails_and_cucumber/app/controllers/application_controller.rb

@@ -0,0 +1,3 @@
+class ApplicationController < ActionController::Base
+  protect_from_forgery
+end

data/examples/rails_and_cucumber/app/controllers/financial_reports_controller.rb

@@ -0,0 +1,7 @@
+class FinancialReportsController < ApplicationController
+  def show
+    @year = params[:year]
+    @txn_type = params[:txn_type]
+    @txns = Transaction.find_all(:year => @year, :type => @txn_type)
+  end
+end

data/examples/rails_and_cucumber/app/models/transaction.rb

@@ -0,0 +1,25 @@
+class Transaction
+  attr_accessor :type, :amount, :year
+  
+  def self.truncate
+    @@all = []  
+  end
+  
+  def self.create(attrs)
+    txn = Transaction.new(attrs)
+    @@all << txn
+    txn
+  end
+  
+  def self.find_all(attrs)
+    @@all.select do |txn|
+      attrs.all? { |k, v| txn.send(k) == v }
+    end
+  end
+  
+  def initialize(attrs)
+    self.type = attrs[:type]
+    self.amount = attrs[:amount]
+    self.year = attrs[:year]
+  end
+end

data/examples/rails_and_cucumber/app/views/financial_reports/show.html.erb

@@ -0,0 +1,20 @@
+<h1>Acme Financial Report for <%= @year %></h1>
+
+<% if @txns.empty? %>
+  <h2>There are no <%= @txn_type %> transactions for <%= @year %></h2>
+<% else %>
+  <h2>All <%= @txn_type.titlecase %> Transactions</h2>
+
+  <table id="report"> 
+    <tr>
+      <th>Type</th>
+      <th>Amount</th>
+    </tr>
+    <% @txns.each do |txn| %>
+      <tr class="transaction">
+        <td class="type"><%= txn.type %></td>
+        <td class="amount"><%= txn.amount %></td>
+      </tr>
+    <% end %>
+  </table>
+<% end %>

data/examples/rails_and_cucumber/app/views/layouts/application.html.erb

@@ -0,0 +1,14 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <title>Acme Financial Reporting</title>
+  <%= stylesheet_link_tag :all %>
+  <%= javascript_include_tag :defaults %>
+  <%= csrf_meta_tag %>
+</head>
+<body>
+
+<%= yield %>
+
+</body>
+</html>

data/examples/rails_and_cucumber/config/application.rb

@@ -0,0 +1,18 @@
+require File.expand_path('../boot', __FILE__)
+
+require "action_controller/railtie"
+
+# If you have a Gemfile, require the gems listed there, including any gems
+# you've limited to :test, :development, or :production.
+Bundler.require(:default, Rails.env) if defined?(Bundler)
+
+module RailsAndCucumber
+  class Application < Rails::Application
+
+    # Configure the default encoding used in templates for Ruby 1.9.
+    config.encoding = "utf-8"
+
+    # Configure sensitive parameters which will be filtered from the log file.
+    config.filter_parameters += [:password]
+  end
+end

data/examples/rails_and_cucumber/config/boot.rb

@@ -0,0 +1,6 @@
+require 'rubygems'
+
+# Set up gems listed in the Gemfile.
+ENV['BUNDLE_GEMFILE'] ||= File.expand_path('../../Gemfile', __FILE__)
+
+require 'bundler/setup' if File.exists?(ENV['BUNDLE_GEMFILE'])

data/examples/rails_and_cucumber/config/cucumber.yml

@@ -0,0 +1,8 @@
+<%
+rerun = File.file?('rerun.txt') ? IO.read('rerun.txt') : ""
+rerun_opts = rerun.to_s.strip.empty? ? "--format #{ENV['CUCUMBER_FORMAT'] || 'progress'} features" : "--format #{ENV['CUCUMBER_FORMAT'] || 'pretty'} #{rerun}"
+std_opts = "--format #{ENV['CUCUMBER_FORMAT'] || 'pretty'} --strict --tags ~@wip"
+%>
+default: <%= std_opts %> features
+wip: --tags @wip:3 --wip features
+rerun: <%= rerun_opts %> --format rerun --out rerun.txt --strict --tags ~@wip

data/examples/rails_and_cucumber/config/environment.rb

@@ -0,0 +1,5 @@
+# Load the rails application
+require File.expand_path('../application', __FILE__)
+
+# Initialize the rails application
+RailsAndCucumber::Application.initialize!

data/examples/rails_and_cucumber/config/environments/development.rb

@@ -0,0 +1,23 @@
+RailsAndCucumber::Application.configure do
+  # Settings specified here will take precedence over those in config/application.rb
+
+  # In the development environment your application's code is reloaded on
+  # every request.  This slows down response time but is perfect for development
+  # since you don't have to restart the webserver when you make code changes.
+  config.cache_classes = false
+
+  # Log error messages when you accidentally call methods on nil.
+  config.whiny_nils = true
+
+  # Show full error reports and disable caching
+  config.consider_all_requests_local       = true
+  config.action_view.debug_rjs             = true
+  config.action_controller.perform_caching = false
+
+  # Print deprecation notices to the Rails logger
+  config.active_support.deprecation = :log
+
+  # Only use best-standards-support built into browsers
+  config.action_dispatch.best_standards_support = :builtin
+end
+

data/examples/rails_and_cucumber/config/environments/test.rb

@@ -0,0 +1,30 @@
+RailsAndCucumber::Application.configure do
+  # Settings specified here will take precedence over those in config/application.rb
+
+  # The test environment is used exclusively to run your application's
+  # test suite.  You never need to work with it otherwise.  Remember that
+  # your test database is "scratch space" for the test suite and is wiped
+  # and recreated between test runs.  Don't rely on the data there!
+  config.cache_classes = true
+
+  # Log error messages when you accidentally call methods on nil.
+  config.whiny_nils = true
+
+  # Show full error reports and disable caching
+  config.consider_all_requests_local       = true
+  config.action_controller.perform_caching = false
+
+  # Raise exceptions instead of rendering exception templates
+  config.action_dispatch.show_exceptions = false
+
+  # Disable request forgery protection in test environment
+  config.action_controller.allow_forgery_protection    = false
+
+  # Use SQL instead of Active Record's schema dumper when creating the test database.
+  # This is necessary if your schema can't be completely dumped by the schema dumper,
+  # like if you have constraints or database-specific column types
+  # config.active_record.schema_format = :sql
+
+  # Print deprecation notices to the stderr
+  config.active_support.deprecation = :stderr
+end

data/examples/rails_and_cucumber/config/initializers/secret_token.rb

@@ -0,0 +1,7 @@
+# Be sure to restart your server when you modify this file.
+
+# Your secret key for verifying the integrity of signed cookies.
+# If you change this key, all old signed cookies will become invalid!
+# Make sure the secret is at least 30 characters and all random,
+# no regular words or you'll be exposed to dictionary attacks.
+RailsAndCucumber::Application.config.secret_token = '223801ad784b8e3e5beea705d599a50bfd6efefaf64b367356d4b808b500cade554c7b2d3efa831dcc931bad3a0d15ed889652e42069b12726b7181f49c44dad'

data/examples/rails_and_cucumber/config/initializers/session_store.rb

@@ -0,0 +1,8 @@
+# Be sure to restart your server when you modify this file.
+
+RailsAndCucumber::Application.config.session_store :cookie_store, :key => '_rails_and_cucumber_session'
+
+# Use the database for sessions instead of the cookie-based default,
+# which shouldn't be used to store highly confidential information
+# (create the session table with "rails generate session_migration")
+# RailsAndCucumber::Application.config.session_store :active_record_store

data/examples/rails_and_cucumber/config/routes.rb

@@ -0,0 +1,3 @@
+RailsAndCucumber::Application.routes.draw do
+  resource :financial_report
+end

data/examples/rails_and_cucumber/features/financial_reporting.feature

@@ -0,0 +1,29 @@
+Feature: Viewing financial reports
+  As an Acme Financial Reporting accountant
+  I want to see reports for specific types of transaction
+  So that I know how much commission to pay my suppliers.
+
+Background:
+  Given the following transactions:
+  | type | amount | year |
+  | visa | $100   | 2011 |
+  | cash | $50    | 2011 |
+  | visa | $30    | 1999 |
+  | visa | $80    | 2011 |
+
+Scenario: Viewing visa transactions for 2011
+  When I open the financial report page for "visa" in "2011"
+  Then I should only see the following transactions:
+  | type | amount |
+  | visa | $100   |
+  | visa | $80    |
+  
+Scenario: Viewing cash transactions for 2011
+  When I open the financial report page for "cash" in "2011"
+  Then I should only see the following transactions:
+  | type | amount |
+  | cash | $50   |  
+
+Scenario: Viewing cash transactions for 1999
+  When I open the financial report page for "cash" in "1999"
+  Then I should not see any transactions

data/examples/rails_and_cucumber/features/pagemodels/financial_report_page.rb

@@ -0,0 +1,29 @@
+class FinancialReportPage < PageModels::Base
+  def initialize(txn_type, year)
+    @txn_type = txn_type.parameterize
+    @year = year
+  end
+  
+  def url
+    financial_report_path(:txn_type => @txn_type, :year => @year)
+  end
+  
+  def verify!
+    should have_content "Acme Financial Report for #{@year}"
+  end
+  
+  def verify_transactions(txns)
+    rows = all("#report .transaction")
+    rows.should have(txns.size).things
+    
+    txns.each_with_index do |txn, i|
+      rows[i].find(".type").should have_content txn["type"]
+      rows[i].find(".amount").should have_content txn["amount"]
+    end    
+  end
+  
+  def verify_no_transactions
+    should have_content "There are no #{@txn_type} transactions for #{@year}"
+    all("#report .transaction").should be_empty
+  end
+end

data/examples/rails_and_cucumber/features/step_definitions/financial_reporting_steps.rb

@@ -0,0 +1,14 @@
+Given /^the following transactions:$/ do |table|
+  Transaction.truncate
+  table.hashes.each do |hash|
+    Transaction.create(hash.symbolize_keys)
+  end
+end
+
+Then /^I should only see the following transactions:$/ do |table|
+  page_model.verify_transactions(table.hashes)
+end
+
+Then /^I should not see any transactions$/ do
+  page_model.verify_no_transactions
+end

data/examples/rails_and_cucumber/features/support/env.rb

@@ -0,0 +1,13 @@
+require 'cucumber/rails'
+Capybara.default_selector = :css
+ActionController::Base.allow_rescue = false
+
+require 'pagemodels'
+Dir.glob(File.join(File.dirname(__FILE__), "pagemodels", "..", "**", "*.rb")).each { |f| require f }
+
+PageModels.configure do |config|
+  config.driver = :capybara
+  config.integrate :rails
+  config.integrate :cucumber
+  config.integrate :rspec
+end

data/examples/rails_and_cucumber/lib/tasks/cucumber.rake

@@ -0,0 +1,57 @@
+# IMPORTANT: This file is generated by cucumber-rails - edit at your own peril.
+# It is recommended to regenerate this file in the future when you upgrade to a 
+# newer version of cucumber-rails. Consider adding your own code to a new file 
+# instead of editing this one. Cucumber will automatically load all features/**/*.rb
+# files.
+
+
+unless ARGV.any? {|a| a =~ /^gems/} # Don't load anything when running the gems:* tasks
+
+vendored_cucumber_bin = Dir["#{Rails.root}/vendor/{gems,plugins}/cucumber*/bin/cucumber"].first
+$LOAD_PATH.unshift(File.dirname(vendored_cucumber_bin) + '/../lib') unless vendored_cucumber_bin.nil?
+
+begin
+  require 'cucumber/rake/task'
+
+  namespace :cucumber do
+    Cucumber::Rake::Task.new({:ok => 'db:test:prepare'}, 'Run features that should pass') do |t|
+      t.binary = vendored_cucumber_bin # If nil, the gem's binary is used.
+      t.fork = true # You may get faster startup if you set this to false
+      t.profile = 'default'
+    end
+
+    Cucumber::Rake::Task.new({:wip => 'db:test:prepare'}, 'Run features that are being worked on') do |t|
+      t.binary = vendored_cucumber_bin
+      t.fork = true # You may get faster startup if you set this to false
+      t.profile = 'wip'
+    end
+
+    Cucumber::Rake::Task.new({:rerun => 'db:test:prepare'}, 'Record failing features and run only them if any exist') do |t|
+      t.binary = vendored_cucumber_bin
+      t.fork = true # You may get faster startup if you set this to false
+      t.profile = 'rerun'
+    end
+
+    desc 'Run all features'
+    task :all => [:ok, :wip]
+  end
+  desc 'Alias for cucumber:ok'
+  task :cucumber => 'cucumber:ok'
+
+  task :default => :cucumber
+
+  task :features => :cucumber do
+    STDERR.puts "*** The 'features' task is deprecated. See rake -T cucumber ***"
+  end
+
+  # In case we don't have ActiveRecord, append a no-op task that we can depend upon.
+  task 'db:test:prepare' do
+  end
+rescue LoadError
+  desc 'cucumber rake task not available (cucumber not installed)'
+  task :cucumber do
+    abort 'Cucumber rake task is not available. Be sure to install cucumber as a gem or plugin'
+  end
+end
+
+end

data/examples/rails_and_cucumber/script/cucumber

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby
+
+vendored_cucumber_bin = Dir["#{File.dirname(__FILE__)}/../vendor/{gems,plugins}/cucumber*/bin/cucumber"].first
+if vendored_cucumber_bin
+  load File.expand_path(vendored_cucumber_bin)
+else
+  require 'rubygems' unless ENV['NO_RUBYGEMS']
+  require 'cucumber'
+  load Cucumber::BINARY
+end

data/examples/rails_and_cucumber/script/rails

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+# This command will automatically be run when you run "rails" with Rails 3 gems installed from the root of your application.
+
+APP_PATH = File.expand_path('../../config/application',  __FILE__)
+require File.expand_path('../../config/boot',  __FILE__)
+require 'rails/commands'

data/examples/rspec_and_capybara/Gemfile

@@ -0,0 +1,6 @@
+source 'http://rubygems.org'
+
+gem 'rspec', '>= 2.5.0'
+gem 'capybara'
+gem 'launchy'
+gem 'pagemodels', :path => File.join(File.dirname(__FILE__), "..", "..")

data/examples/rspec_and_capybara/README.txt

@@ -0,0 +1,19 @@
+This example demonstrates how to use page models with RSpec to write acceptance tests for any website (in this case Google.com), using Capybara/Selenium/Firefox as a driver.
+
+~~~~~~~~~~
+
+See spec/spec_helper.rb for information about configuring PageModels to integrate with the various frameworks:
+
+PageModels.configure do |config|
+  config.driver = :capybara
+  config.integrate :rspec
+end
+
+spec_helper.rb also loads all everything in the pagemodels directory. GoogleSearchPage and GoogleResultsPage provide examples of page models which override PageModels::Base.
+
+~~~~~~~~~~
+
+RSpec integration exposes two convenience methods you may use in your specs: 
+
+open_page(page_model) - switches the current page model to the one provided and calls #open!
+should_see_page(page_model) - switches the current page model and calls #verify!

data/examples/rspec_and_capybara/Rakefile

@@ -0,0 +1,4 @@
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => [:spec]

data/examples/rspec_and_capybara/spec/google_search_spec.rb

@@ -0,0 +1,15 @@
+require File.expand_path(File.dirname(__FILE__) + "/spec_helper")
+
+describe "Searching Google" do
+  it "should show results for Ruby Page Models" do
+    open_page(GoogleSearchPage.new)
+    page_model.search_for("Ruby Page Models")
+
+    should_see_page(GoogleResultsPage.new("Ruby Page Models"))
+    page_model.verify_more_than_one_page_of_results
+    page_model.verify_special_results_option("Images")
+    page_model.verify_special_results_option("News")
+    
+    page_model.verify_top_result("http://www.github.com/rickgrundy/pagemodels")
+  end
+end

data/examples/rspec_and_capybara/spec/pagemodels/google_results_page.rb

@@ -0,0 +1,24 @@
+class GoogleResultsPage < PageModels::Base
+  def initialize(query)
+    @query = query
+  end
+  
+  def verify!
+    should have_content @query
+    should have_content "More search tools"
+  end
+  
+  def verify_more_than_one_page_of_results
+    all("table#nav a.fl").should have_at_least(2).things
+  end
+  
+  def verify_special_results_option(option)
+    within("#leftnav") do
+      should have_content option
+    end
+  end
+  
+  def verify_top_result(url)
+    find("#search cite:first").text.should == url
+  end
+end

data/examples/rspec_and_capybara/spec/pagemodels/google_search_page.rb

@@ -0,0 +1,15 @@
+class GoogleSearchPage < PageModels::Base
+  def url
+    "http://www.google.com.au/"
+  end
+  
+  def verify!
+    should have_content "About Google"
+    should_not have_content "More search tools"
+  end
+  
+  def search_for(query)
+    fill_in "q", :with => query
+    click_button "Google Search"
+  end
+end

data/examples/rspec_and_capybara/spec/spec_helper.rb

@@ -0,0 +1,11 @@
+require 'capybara/rspec'
+require 'pagemodels'
+
+Dir.glob(File.join(File.dirname(__FILE__), "pagemodels", "**", "*.rb")).each { |f| require f }
+
+Capybara.default_driver = :selenium
+
+PageModels.configure do |config|
+  config.driver = :capybara
+  config.integrate :rspec
+end

data/lib/page_models/base.rb

@@ -0,0 +1,28 @@
+module PageModels  
+  class Base    
+    def open!
+      visit(url)
+      verify!
+    end    
+    
+    def method_missing(name, *args, &block)
+      config.driver.send(name, *args, &block)
+    rescue NoMethodError
+      super(name, *args, &block)
+    end
+    
+    def url
+       raise ImplementationError.new(self, __method__)
+    end
+
+    def verify!
+       raise ImplementationError.new(self, __method__)
+    end
+    
+    private
+    
+    def config
+      PageModels::Configuration.instance
+    end
+  end
+end

data/lib/page_models/configuration.rb

@@ -0,0 +1,30 @@
+require 'singleton'
+
+module PageModels  
+  class Configuration
+    include Singleton
+    attr_writer :driver
+    
+    def initialize
+      @driver = :capybara
+      @frameworks = []
+    end
+        
+    def integrate(framework)
+      @frameworks << framework
+    end
+    
+    def integrate!      
+      @frameworks.each { |framework| require "page_models/integration/#{framework}" }
+    end
+    
+    def driver
+      case @driver
+        when :capybara
+          Capybara.current_session
+        else
+          raise ConfigurationError.new("No driver configured.")
+      end
+    end
+  end
+end

data/lib/page_models/core.rb

@@ -0,0 +1,13 @@
+module PageModels
+  def self.configure
+    config = PageModels::Configuration.instance
+    yield(config)
+    config.integrate!
+  end
+  
+  def self.create(page, args)
+    args = args.scan(/"([^"]+)"/).map(&:first)
+    page_model_class_name = page.gsub(/(?:^|[^\w])([a-z])/) { $1.upcase }
+    Kernel.const_get(page_model_class_name).new(*args)
+  end
+end

data/lib/page_models/errors.rb

@@ -0,0 +1,10 @@
+module PageModels
+  class ConfigurationError < StandardError
+  end
+    
+  class ImplementationError < StandardError
+    def initialize(page_model, method)
+      super("#{page_model.class} must implement ##{method}.")
+    end
+  end
+end

data/lib/page_models/integration/cucumber.rb

@@ -0,0 +1,16 @@
+Given /^I open the (.+ page)(.*)$/ do |page, args|
+  self.page_model = PageModels.create(page, args)
+  page_model.open!
+end
+
+Then /^I should see the (.+ page)(.*)$/ do |page, args|
+  self.page_model = PageModels.create(page, args)
+  page_model.verify!
+end
+
+module PageModels
+  module CucumberIntegration
+    attr_accessor :page_model
+  end
+end
+World(PageModels::CucumberIntegration)

data/lib/page_models/integration/rails.rb

@@ -0,0 +1 @@
+PageModels::Base.send(:include, Rails.application.routes.url_helpers)

data/lib/page_models/integration/rspec.rb

@@ -0,0 +1,19 @@
+PageModels::Base.send(:include, RSpec::Matchers)
+
+module PageModels
+  module RSpecIntegration
+    attr_accessor :page_model
+
+    def open_page(page_model)
+      self.page_model = page_model
+      page_model.open!
+    end
+    
+    def should_see_page(page_model)
+      self.page_model = page_model
+      page_model.verify!
+    end
+  end
+end
+
+Object.send(:include, PageModels::RSpecIntegration)

data/lib/page_models/version.rb

@@ -0,0 +1,3 @@
+module PageModels
+  VERSION = "0.1.0"
+end

data/lib/pagemodels.rb

@@ -0,0 +1 @@
+Dir.glob(File.join(File.dirname(__FILE__), "page_models", "*.rb")).each { |f| require f }

data/pagemodels.gemspec

@@ -0,0 +1,23 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "page_models/version"
+
+Gem::Specification.new do |s|
+  s.name        = "pagemodels"
+  s.version     = PageModels::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Rick Grundy"]
+  s.email       = ["rick@rickgrundy.com"]
+  s.homepage    = "http://www.github.com/rickgrundy/pagemodels"
+  s.summary     = "Page models for your browser driving acceptance tests with optional integration for RSpec, Cucumber, and Rails."
+  s.description = "See http://www.github.com/rickgrundy/pagemodels"
+
+  s.rubyforge_project = "pagemodels"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+  
+  s.add_development_dependency 'rspec', '>= 2.5.0'
+end

data/spec/page_models/base_spec.rb

@@ -0,0 +1,58 @@
+require File.expand_path(File.dirname(__FILE__) + "../../spec_helper")
+
+describe PageModels::Base do
+  class UnimplementedPageModel < PageModels::Base
+  end
+  
+  class TestPageModel < PageModels::Base
+    def url
+      "/test-page"
+    end
+    
+    def verify!
+      true
+    end
+  end
+  
+  describe "template methods which must be implemented by your page models" do
+    it "should raise an error if page models do not implement #url" do
+      lambda { UnimplementedPageModel.new.url }.should raise_error(PageModels::ImplementationError)
+    end    
+    
+    it "should raise an error if page models do not implement #verify!" do
+      lambda { UnimplementedPageModel.new.verify! }.should raise_error(PageModels::ImplementationError)
+    end
+  end
+  
+  describe "delegating methods to the driver for less verbose page models" do
+    before(:each) do
+      @driver = Object.new
+      PageModels::Configuration.instance.stub(:driver).and_return(@driver)
+      @page_model = TestPageModel.new
+    end
+    
+    it "should delegate a missing method to the driver" do
+      @driver.should_receive(:do_something_cool).with(:please)
+      @page_model.do_something_cool(:please)
+    end
+    
+    it "should should not hide method missing errors if the method does not exist on the driver" do
+      lambda { @page_model.do_something_else }.should raise_error(NoMethodError, "undefined method `do_something_else' for #{@page_model.inspect}")
+    end
+  end
+  
+  describe "opening a page" do
+    before(:each) do
+      @driver = Object.new
+      PageModels::Configuration.instance.stub(:driver).and_return(@driver)
+      @page_model = TestPageModel.new
+    end
+    
+    it "should visit the page, then call verify" do
+      @page_model.should_receive(:visit).with("/test-page")
+      @page_model.should_receive(:verify!)
+      @page_model.open!
+    end
+    
+  end
+end

data/spec/page_models/configuration_spec.rb

@@ -0,0 +1,37 @@
+require File.expand_path(File.dirname(__FILE__) + "../../spec_helper")
+
+module Capybara
+  def self.current_session
+    @session ||= Object.new
+  end
+end
+
+describe PageModels::Configuration do
+  before(:each) do
+    @config = PageModels::Configuration.instance
+  end
+  
+  describe "providing a driver" do
+    it "should raise an error if no driver is configured" do
+      @config.driver = nil
+      lambda { @config.driver }.should raise_error(PageModels::ConfigurationError)
+    end
+    
+    it "should provide a Capybara session" do
+      @config.driver = :capybara
+      @config.driver.should == Capybara.current_session
+    end
+  end
+  
+  describe "integrating with frameworks" do
+    it "should require the appropriate integration files" do
+      @config.integrate :foo
+      @config.integrate :bar
+      
+      @config.should_receive(:require).with("page_models/integration/foo")
+      @config.should_receive(:require).with("page_models/integration/bar")
+      
+      @config.integrate!
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1 @@
+require File.join(File.dirname(__FILE__), "..", "lib", "pagemodels")

metadata

@@ -0,0 +1,118 @@
+--- !ruby/object:Gem::Specification 
+name: pagemodels
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: 0.1.0
+platform: ruby
+authors: 
+- Rick Grundy
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-06-18 00:00:00 +01:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 2.5.0
+  type: :development
+  version_requirements: *id001
+description: See http://www.github.com/rickgrundy/pagemodels
+email: 
+- rick@rickgrundy.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- README.txt
+- Rakefile
+- examples/rails_and_cucumber/.gitignore
+- examples/rails_and_cucumber/Gemfile
+- examples/rails_and_cucumber/README.txt
+- examples/rails_and_cucumber/Rakefile
+- examples/rails_and_cucumber/app/controllers/application_controller.rb
+- examples/rails_and_cucumber/app/controllers/financial_reports_controller.rb
+- examples/rails_and_cucumber/app/models/transaction.rb
+- examples/rails_and_cucumber/app/views/financial_reports/show.html.erb
+- examples/rails_and_cucumber/app/views/layouts/application.html.erb
+- examples/rails_and_cucumber/config/application.rb
+- examples/rails_and_cucumber/config/boot.rb
+- examples/rails_and_cucumber/config/cucumber.yml
+- examples/rails_and_cucumber/config/environment.rb
+- examples/rails_and_cucumber/config/environments/development.rb
+- examples/rails_and_cucumber/config/environments/test.rb
+- examples/rails_and_cucumber/config/initializers/secret_token.rb
+- examples/rails_and_cucumber/config/initializers/session_store.rb
+- examples/rails_and_cucumber/config/routes.rb
+- examples/rails_and_cucumber/features/financial_reporting.feature
+- examples/rails_and_cucumber/features/pagemodels/financial_report_page.rb
+- examples/rails_and_cucumber/features/step_definitions/financial_reporting_steps.rb
+- examples/rails_and_cucumber/features/support/env.rb
+- examples/rails_and_cucumber/lib/tasks/cucumber.rake
+- examples/rails_and_cucumber/script/cucumber
+- examples/rails_and_cucumber/script/rails
+- examples/rspec_and_capybara/Gemfile
+- examples/rspec_and_capybara/README.txt
+- examples/rspec_and_capybara/Rakefile
+- examples/rspec_and_capybara/spec/google_search_spec.rb
+- examples/rspec_and_capybara/spec/pagemodels/google_results_page.rb
+- examples/rspec_and_capybara/spec/pagemodels/google_search_page.rb
+- examples/rspec_and_capybara/spec/spec_helper.rb
+- lib/page_models/base.rb
+- lib/page_models/configuration.rb
+- lib/page_models/core.rb
+- lib/page_models/errors.rb
+- lib/page_models/integration/capybara.rb
+- lib/page_models/integration/cucumber.rb
+- lib/page_models/integration/rails.rb
+- lib/page_models/integration/rspec.rb
+- lib/page_models/version.rb
+- lib/pagemodels.rb
+- pagemodels.gemspec
+- spec/page_models/base_spec.rb
+- spec/page_models/configuration_spec.rb
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: http://www.github.com/rickgrundy/pagemodels
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+requirements: []
+
+rubyforge_project: pagemodels
+rubygems_version: 1.5.0
+signing_key: 
+specification_version: 3
+summary: Page models for your browser driving acceptance tests with optional integration for RSpec, Cucumber, and Rails.
+test_files: 
+- spec/page_models/base_spec.rb
+- spec/page_models/configuration_spec.rb
+- spec/spec_helper.rb