gizmo 0.0.1

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.gitignore

@@ -0,0 +1,21 @@
+## MAC OS
+.DS_Store
+
+## TEXTMATE
+*.tmproj
+tmtags
+
+## EMACS
+*~
+\#*
+.\#*
+
+## VIM
+*.swp
+
+## PROJECT::GENERAL
+coverage
+rdoc
+pkg
+
+## PROJECT::SPECIFIC

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Luke Cunningham
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,48 @@
+Gizmo
+============
+
+In homage to its humble beginnings as our 'gremlin' testing submodule.<br />
+We were entrusted with it and asked to follow 3 simple rules...
+
+* "Don't get it wet"
+* "Keep it away from bright lights....especially sunlight"
+* "Don't ever feed it after midnight"
+
+We didn't listen, and it got nasty...<br />
+So we've gone back to the drawing board and come up with a friendlier, cuddlier testing helper.
+
+**Gizmo** is a simple page model testing framework used and sponsored by [realestate.com.au](http://www.realestate.com.au). The aim of the project is to DRY up testing assertions by abstracting code that defines your page, resulting in a consistent, easy to maintain test suite. The code is maintained by Contributors from REA, and largely based on concepts brought to REA by [Mark Ryall](http://github.com/markryall) and other [thoughtworkers](http://thoughtworks.com.au/)
+
+**this project is a work in progress, and not really ready to be used for its intended purpose!**
+
+
+## Usage ##
+
+see [this gist](http://gist.github.com/339570) for some code examples
+
+**for cucumber:**
+
+* write your features just like you usually would
+* require 'gizmo' and add the Gizmo::Helpers to the World
+* generate your page mixins and fill them out with your page selectors
+* use the page model when writing your steps
+
+
+**for rspec:**
+
+* require 'gizmo' in your spec_helper and include Gizmo::Helpers methods
+* generate your page mixins and fill them out with your page selectors
+* use the page model when writing your specs
+
+
+## Contributing ##
+
+* Fork the project.
+* Make your feature addition or bug fix.
+* Make sure you write tests. Pull requests will not be accepted unless they have complete coverage.
+* Commit, do not mess with rakefile, version, or history.
+  (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request.
+
+## Sponsored by ##
+[realestate.com.au](http://www.realestate.com.au)

data/Rakefile

@@ -0,0 +1,87 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "gizmo"
+    gem.summary = %Q{simple page model testing framework}
+    gem.description = %Q{gizmo is a simple page model testing framework used and sponsored by 'realestate.com.au'. The aim of the project is to DRY up your testing assertions by abstracting code that defines your page resulting in a consistent, easy to maintain test suit}
+    gem.email = "luke@icaruswings.com"
+    gem.homepage = "http://github.com/icaruswings/gizmo"
+    gem.authors = ["Luke Cunningham"]
+    gem.add_development_dependency "rspec", ">= 1.3.0"
+    gem.add_development_dependency "cucumber", ">= 0.6.3"
+    gem.add_development_dependency "webrat", ">= 0.7.0"
+    gem.add_development_dependency "capybara", ">= 0.3.5"
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+    gem.add_dependency "nokogiri", ">= 1.4.1"
+    gem.add_dependency "activesupport", ">= 2.3.5"
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+
+require 'spec/rake/spectask'
+Spec::Rake::SpecTask.new(:spec) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.spec_files = FileList['spec/**/*_spec.rb']
+end
+
+Spec::Rake::SpecTask.new(:rcov) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+  spec.rcov_opts = ['--failure-threshold', 100, '--exclude', 'features']
+end
+
+task :spec => :check_dependencies
+
+begin
+  require 'cucumber/rake/task'
+  Cucumber::Rake::Task.new(:features)
+
+  task :features => :check_dependencies
+rescue LoadError
+  task :features do
+    abort "Cucumber is not available. In order to run features, you must: sudo gem install cucumber"
+  end
+end
+
+begin
+  require 'reek/adapters/rake_task'
+  Reek::RakeTask.new do |t|
+    t.fail_on_error = true
+    t.verbose = false
+    t.source_files = 'lib/**/*.rb'
+  end
+rescue LoadError
+  task :reek do
+    abort "Reek is not available. In order to run reek, you must: sudo gem install reek"
+  end
+end
+
+begin
+  require 'roodi'
+  require 'roodi_task'
+  RoodiTask.new do |t|
+    t.verbose = false
+  end
+rescue LoadError
+  task :roodi do
+    abort "Roodi is not available. In order to run roodi, you must: sudo gem install roodi"
+  end
+end
+
+task :default => :spec
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "gizmo #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.0.1

data/bin/gizmo

@@ -0,0 +1,62 @@
+#!/usr/bin/env ruby
+# coding: utf-8
+
+require 'optparse'
+require 'active_support'
+
+$LOAD_PATH << File.dirname(__FILE__) + '/../lib'
+require 'gizmo'
+
+@current_mixin = nil
+
+def puts_list methods
+  return puts "[]" if methods.empty?
+  puts methods.sort.join(', ')
+end
+
+opts = OptionParser.new do |opts|
+
+  opts.on("-v", "--version", "what's the frequency kenneth?") do
+    puts "gizmo version: 0.0.0"
+  end
+
+  opts.on("-g", "--generate-mixin [NAME]", "generate a new page mixin") do |mixin_name|
+    File.open("#{Gizmo::Config.mixin_path}/page_with_#{mixin_name}.rb", "w") do |file|
+      content = <<-EOS
+        module PageWith#{mixin_name.camelize}
+          # def valid
+          #  has_selector?('my-container')
+          # end
+        end
+      EOS
+      file.write(content.strip)
+    end
+  end
+
+  opts.on("-p", "--with-page [NAME]") do |mixin_name|
+    Gizmo.load_mixins! File.join(Dir.pwd, Gizmo::Config.mixin_path)
+    mixin = Object.const_get("PageWith" + mixin_name.camelize)
+    @current_mixin = { :name => mixin_name, :obj => Gizmo::Page.new({}, '', {}).extend(mixin) }
+  end
+
+  opts.on('-m', '--list-methods', 'list all the methods for a mixin') do
+    puts "---- methods for #{@current_mixin[:name]} ----"
+    puts_list @current_mixin[:obj].methods
+  end
+
+  opts.on('-f', '--filter-methods [QUERY]', 'filter methods for a mixin') do |query|
+    puts "---- methods for #{@current_mixin[:name]} matching #{query} ----"
+    puts_list @current_mixin[:obj].methods.select { |m| m =~ /#{query}/ }
+  end
+
+end
+
+
+if ARGV.size == 0
+  puts "DRY up your acceptance tests. \ntype --help for a list of commands"
+  exit 1
+end
+
+opts.parse!
+
+@current_mixin = nil

data/features/gizmo.feature

@@ -0,0 +1,12 @@
+Feature:
+    As a behaviour driven developer
+    In order to have a DRY, elegant and maintainable test suite
+    I want 'gizmo' to do it's funky thing
+
+    Scenario: A scenario performs a github search
+        Given the scenario is on the github homepage
+        When the scenario enters "gizmo" into the search box
+        And the scenario clicks the magnifying glass icon
+        And the scenario clicks on the "icaruswings / gizmo" link
+        Then the scenario is on the "gizmo" github repository details page
+        And the scenario is on a github repository details page which belongs to "icaruswings"

data/features/step_definitions/gizmo_steps.rb

@@ -0,0 +1,37 @@
+Given /^the scenario is on the github homepage$/ do
+  visit "http://github.com"
+end
+
+When /^the scenario enters "([^\"]*)" into the search box$/ do |text|
+  on_page_with :github_search do |page|
+    fill_in page.search_form.input.attr('name').value, :with => text
+  end
+end
+
+When /^the scenario clicks the magnifying glass icon$/ do
+  on_page_with :github_search do |page|
+    click page.search_form.submit.attr('alt').value
+  end
+end
+
+When /^the scenario clicks on the "([^\"]*)" link$/ do |text|
+  click_link text
+end
+
+Then /^the scenario is on a github repository details page$/ do
+  on_page_with :github_repo_details do |page|
+    page.should be_valid
+  end
+end
+
+Then /^the scenario is on the "([^\"]*)" github repository details page$/ do |repo_name|
+  on_page_with :github_repo_details do |page|
+    page.repo_details.name == repo_name
+  end
+end
+
+Then /^the scenario is on a github repository details page which belongs to "([^\"]*)"$/ do |author|
+  on_page_with :github_repo_details do |page|
+    page.repo_details.author == author
+  end
+end

data/features/support/env.rb

@@ -0,0 +1,18 @@
+# $LOAD_PATH.unshift(File.dirname(__FILE__) + '/../../lib')
+
+require 'spec/expectations'
+
+#CAPYBARA
+require 'capybara/cucumber'
+require 'capybara/session'
+require 'features/support/patches/capybara'
+Capybara.default_driver = :selenium
+Capybara.run_server = false
+
+#gizmo!!!
+require 'gizmo'
+World(Gizmo::Helpers)
+
+Gizmo.configure do |config|
+  config.mixin_dir = File.dirname(__FILE__) + '/features/support/pages'
+end

data/features/support/pages/page_with_github_repo_details.rb

@@ -0,0 +1,14 @@
+module PageWithGithubRepoDetails
+  
+  def valid?
+    has_selector?("div.repohead")
+  end
+  
+  def repo_details
+    OpenStruct do |repo_details|
+      repo_details.name = @document.css("h1>strong a").inner_text
+      repo_details.author = @document.css("h1>a").inner_text
+    end
+  end
+
+end

data/features/support/pages/page_with_github_search.rb

@@ -0,0 +1,16 @@
+module PageWithGithubSearch
+
+  def valid?
+    has_selector?("div.search")
+  end
+    
+  def search_form
+    OpenStruct do |form|
+      form.container = @document.css("div.search")
+      form.element = container = form.container.css("form")
+      form.input = container.css("input[name=q]")
+      form.submit = container.css("input[alt=search]")
+    end
+  end
+
+end

data/features/support/pages/page_with_github_search_results.rb

@@ -0,0 +1,43 @@
+module PageWithGithubSearchResults
+
+  def valid?
+    has_selector?('div#code_search_results')
+  end
+  
+  
+  def search_results
+    OpenStruct do |results|
+      results.repositories = build_repositories
+    end
+  end
+  
+  
+  private
+  
+  def build_repositories
+    OpenStruct do |repos|
+      container = find_results_container "Repositories"
+      repos.heading = container.css('div.header')
+      repos.results = container.css('div.result').map { |result| build_repository_result result }
+    end
+  end
+  
+  def build_repository_result result
+    OpenStruct do |repo_result|
+      repo_result.title = result.css('h2.title')
+      repo_result.link = repo_result.title.css('a')
+      link_parts = repo_result.link.inner_text.split('/')
+      repo_result.name = link_parts[1].strip
+      repo_result.author = link_parts[0].strip
+    end
+  end
+  
+  def find_results_container heading_text
+    all_headings = @document.css('div.header')
+    header = all_headings.find do |heading_element|
+      heading_element.css('div.title').inner_text =~ /#{heading_text} \((.+)\)/
+    end
+    header.parent unless header.nil?
+  end
+
+end

data/features/support/patches/capybara.rb

@@ -0,0 +1,44 @@
+if Object.const_defined? :Capybara
+
+  module Capybara
+    alias :response :page
+  end
+
+  class Capybara::Driver::Selenium < Capybara::Driver::Base
+    class Node < Capybara::Node
+    
+      def is_radio?
+        tag_name == 'input' and type == 'radio'
+      end
+    
+      def is_checkbox?
+        tag_name == 'input' and type == 'checkbox'
+      end
+    
+      def is_text_field?
+        tag_name == 'textarea' or (tag_name == 'input' and %w(text password hidden file).include?(type))
+      end
+    
+      def radio_input
+        node.select
+      end
+    
+      def checkbox_input
+        node.click
+      end
+    
+      def clear_and_send_keys value
+        node.clear
+        node.send_keys(value.to_s)
+      end
+    
+      def set(value)
+        return clear_and_send_keys(value) if is_text_field?
+        return radio_input if is_radio?
+        return checkbox_input if is_checkbox?
+      end
+    
+    end
+  end
+
+end

data/lib/gizmo.rb

@@ -0,0 +1,20 @@
+require 'rubygems'
+require 'active_support'
+require 'nokogiri'
+
+$LOAD_PATH << File.dirname(__FILE__)
+
+module Gizmo
+
+  autoload :Page,       "gizmo/page"
+  autoload :Helpers,    "gizmo/helpers"
+  autoload :Generate,   "gizmo/generate"
+
+  GizmoError = Class.new(StandardError)
+  MixinNotValidError = Class.new(GizmoError)
+  MixinNotFoundError = Class.new(GizmoError)
+  NilResponseError = Class.new(GizmoError)
+
+end
+require "gizmo/configuration"
+require "gizmo/extras"

data/lib/gizmo/configuration.rb

@@ -0,0 +1,31 @@
+require 'pathname'
+
+module Gizmo
+
+  # Configures Gizmo. If this is not done, Gizmo will use all defaults.
+  def self.configure(configuration = Gizmo.configuration)
+    yield configuration if block_given?
+    @@configuration = configuration
+  end
+
+  def self.configuration
+    @@configuration ||= Gizmo::Configuration.new
+  end
+
+  # Gizmo can be configured using the Gizmo.configure method. For example:
+  #
+  #   Gizmo.configure do |config|
+  #     config.mixin_dir = File.dirname(__FILE__) + '/features/support/pages'
+  #   end
+  class Configuration
+
+    # where to load mixin files from
+    attr_accessor :mixin_dir
+
+    def initialize
+      self.mixin_dir = Pathname.new(Dir.pwd).join("features/support/pages")
+    end
+
+  end
+
+end

data/lib/gizmo/extras.rb

@@ -0,0 +1,6 @@
+# make OpenStruct yield to a block.
+def OpenStruct
+  open_struct = OpenStruct.new
+  yield open_struct if block_given?
+  open_struct
+end

data/lib/gizmo/helpers.rb

@@ -0,0 +1,32 @@
+module Gizmo
+
+  module Helpers
+
+    def on_page &block
+      raise NilResponseError, "Doh! response object is nil. This generally means your scenario has not yet visited a page!" if response.nil?
+      raise ArgumentError, 'You must supply a block argument' unless block.is_a? Proc
+      yield Page.new(self, response.body, current_url)
+    end
+
+    def on_page_with *module_names
+      raise ArgumentError, 'You must supply at least one mixin' if module_names.empty?
+      on_page do |page|
+        module_names.each do |module_name|
+          raise ArgumentError, 'module_name must be a symbol' unless module_name.is_a?(Symbol)
+          const_name = "PageWith#{module_name.to_s.camelize}"
+          begin
+            require "#{Gizmo.configuration.mixin_dir}/page_with_#{module_name}.rb" unless Object.const_defined?(const_name)
+          rescue LoadError
+            raise MixinNotFoundError, "Expected a page mixin file at #{Gizmo.configuration.mixin_dir}/page_with_#{module_name}.rb generate one with gizmo -g #{module_name}"
+          end
+          page.extend(Object.const_get(const_name))
+          raise MixinNotValidError, "Page did not have #{module_name} at #{page.url}" unless page.valid?
+          page.mixins << module_name
+        end
+        yield page if block_given?
+      end
+    end
+
+  end
+
+end

data/lib/gizmo/page.rb

@@ -0,0 +1,30 @@
+module Gizmo
+
+  class Page
+
+    attr_reader :mixins, :url, :document
+
+    def initialize driver, content, url
+      @mixins = []
+      @browser = driver
+      @document = Nokogiri::HTML(content)
+      @url = url
+    end
+
+    # Pages are valid by default -
+    # specific mixins should change this behaviour
+    # to require certain elements on the page
+    # then you will get an error message saying "Page did not have mixin #{name}"
+    #eg.
+    # def valid?
+    #   has_selector('some_element_selector')
+    # end
+    def valid?; true; end
+
+    def has_selector? css_selector
+      @document.css(css_selector).length > 0
+    end
+
+  end
+
+end

data/spec/github_site_example_spec.rb

@@ -0,0 +1,68 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+# Dir[File.dirname(__FILE__) + '/../features/support/pages/*'].each do |path|
+#   require path if path =~ /page_with.+\.rb$/
+# end
+
+require 'capybara'
+require 'capybara/dsl'
+require File.expand_path(File.dirname(__FILE__) + '/../features/support/patches/capybara')
+
+Capybara.default_driver = :selenium
+Capybara.run_server = false
+Spec::Runner.configure do |config|
+  config.include Capybara
+end
+
+
+describe "Github" do
+
+  before do
+    Gizmo.configure do |config|
+      config.mixin_dir = File.join(File.dirname(__FILE__), '../features/support/pages/')
+    end
+  end
+
+  describe "Home Page Search" do
+
+    before(:all) { visit 'http://github.com' }
+
+    it "should have a text input which accepts a search query" do
+      on_page_with :github_search do |page|
+        fill_in page.search_form.input.attr('name').value, :with => 'gizmo'
+      end
+    end
+
+    it "should perform a search when clicking the magnifying glass" do
+      on_page_with :github_search do |page|
+        click page.search_form.submit.attr('alt').value
+      end
+    end
+
+    it "should redirect to the search results page with gizmo as the first result" do
+      on_page_with :github_search_results do |page|
+        page.search_results.repositories.results.first.name.should == 'gizmo'
+      end
+    end
+
+  end
+
+  describe "Repo Details" do
+
+    before(:all) { visit 'http://github.com/icaruswings/gizmo' }
+
+    it "should have the expected repository name" do
+      on_page_with :github_repo_details do |page|
+        page.repo_details.name == 'gizmo'
+      end
+    end
+
+    it "should have the expected repository author" do
+      on_page_with :github_repo_details do |page|
+        page.repo_details.author == 'icaruswings'
+      end
+    end
+
+  end
+
+end

data/spec/gizmo/configuration_spec.rb

@@ -0,0 +1,26 @@
+require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
+
+describe "Gizmo" do
+
+  describe "Configuration" do
+
+    it "should have a mixin_dir reader" do
+        Gizmo.configuration.should respond_to(:mixin_dir)
+    end
+
+    it "should have a mixin_dir writer" do
+        Gizmo.configuration.should respond_to(:mixin_dir=)
+    end
+
+    it "should be configurable with a block" do
+      Gizmo.configure do |config|
+        config.mixin_dir = 'blah'
+      end
+
+      config = Gizmo.configuration
+      config.mixin_dir.should == 'blah'
+    end
+
+  end
+
+end

data/spec/gizmo/extras_spec.rb

@@ -0,0 +1,17 @@
+require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
+
+describe "Gizmo" do
+  
+  describe "Extras" do
+  
+    it "should provide an override for OpenStruct to make it yield to a block" do
+      OpenStruct { |o| o.should be_an OpenStruct }
+    end
+
+    it "should return an OpenStruct if not given a block" do
+      send(:OpenStruct).should be_an OpenStruct
+    end
+  
+  end
+  
+end

data/spec/gizmo/helpers_spec.rb

@@ -0,0 +1,104 @@
+require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
+
+describe "Gizmo" do
+
+  describe "Helpers" do
+
+    before do
+      def response
+        mock_response = <<-eos
+          <html>
+            <head>
+              <title>my awesome web page</title>
+            </head>
+            <body>
+              <p class="one_of_these">paragraph one</p>
+              <p class="two_of_these">paragraph two</p>
+              <p class="two_of_these">paragraph three</p>
+            </body>
+          </html>
+        eos
+        @response ||= mock('response', :body => mock_response)
+      end
+
+      def current_url
+        'http://www.example.com'
+      end
+    end
+
+    it "should provide a method :on_page" do
+      respond_to?(:on_page).should be_true
+    end
+
+    it "should provide a method :on_page_with" do
+      respond_to?(:on_page_with).should be_true
+    end
+
+    describe "#on_page" do
+      it "should raise an error if no block given" do
+        lambda { on_page }.should raise_error(ArgumentError, "You must supply a block argument")
+      end
+
+      it "should not raise an error if given a block" do
+        lambda { on_page { |page| return page } }.should_not raise_error(ArgumentError, "You must supply a block argument")
+      end
+
+      it "should yield a page object" do
+        on_page { |page| page.should be_a Gizmo::Page }
+      end
+
+      it "should raise an error if the response object is nil" do
+        response.stub!(:nil?).and_return(true)
+        lambda { on_page { |page| page } }.should raise_error(Gizmo::NilResponseError, "Doh! response object is nil. This generally means your scenario has not yet visited a page!")
+      end
+
+    end
+
+
+    describe "#on_page_with" do
+      it "should raise an error if one or more module_names are given" do
+        lambda { on_page_with }.should raise_error(ArgumentError, "You must supply at least one mixin")
+      end
+
+      it "should raise an ArgumentError if module_name is not a symbol" do
+        lambda { on_page_with 'my_module_name' }.should raise_error(ArgumentError, "module_name must be a symbol")
+      end
+
+      it "should not raise an error if module_name is a symbol" do
+        lambda { on_page_with :my_mixin }.should_not raise_error
+      end
+
+      it "should not raise ArgumentError if multiple module_names are given" do
+        lambda { on_page_with :my_mixin, :my_other_mixin }.should_not raise_error(ArgumentError, "module_name must be a symbol")
+      end
+
+      it "should raise Gizmo::MixinNotValidError if the mixin is not valid" do
+        lambda { on_page_with :my_invalid_mixin }.should raise_error(Gizmo::MixinNotValidError, "Page did not have my_invalid_mixin at http://www.example.com")
+      end
+
+      it "should raise Gizmo::MixinNotFoundError if the mixin file cannot be loaded from the mixin_path" do
+        lambda { on_page_with :my_non_existent_mixin }.should raise_error(Gizmo::MixinNotFoundError, "Expected a page mixin file at /Users/luke_cunningham/projects/icaruswings/gizmo/spec/pages/page_with_my_non_existent_mixin.rb generate one with gizmo -g my_non_existent_mixin")
+      end
+
+      it "should yield a page object to a block if supplied" do
+        on_page_with(:my_mixin) { |page| page.should_not be_nil }
+      end
+
+      it "should yield a page object to a block" do
+        on_page_with(:my_mixin) { |page| page.should be_a Gizmo::Page }
+      end
+
+      it "should return a page object which has been extended to include the mixin functionality" do
+        on_page_with(:my_mixin) do |page|
+          page.should respond_to :my_method
+        end
+      end
+
+      it "should add the mixin name to the Page's mixin instance attribute" do
+        on_page_with(:my_mixin, :my_other_mixin) do |page|
+          [:my_mixin, :my_other_mixin].each { |mixin| page.mixins.should include mixin }
+        end
+      end
+    end
+  end
+end

data/spec/gizmo/page_spec.rb

@@ -0,0 +1,114 @@
+require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
+
+describe "Gizmo" do
+
+  describe "Page" do
+
+    before do
+      def response
+        mock_response = <<-eos
+          <html>
+            <head>
+              <title>my awesome web page</title>
+            </head>
+            <body>
+              <p class="one_of_these">paragraph one</p>
+              <p class="two_of_these">paragraph two</p>
+              <p class="two_of_these">paragraph three</p>
+            </body>
+          </html>
+        eos
+        @response ||= mock('response', :body => mock_response)
+      end
+
+      def current_url
+        'http://www.example.com'
+      end
+
+      @page = Gizmo::Page.new(self, response.body, current_url)
+    end
+
+    describe "attributes and accessors" do
+
+      it "should have an instance variable @mixins" do
+        @page.instance_variable_get(:@mixins).should_not be_nil
+      end
+
+      it "should have an instance variable @document" do
+        @page.instance_variable_get(:@document).should_not be_nil
+      end
+
+      it "should have an instance variable @url" do
+        @page.instance_variable_get(:@url).should_not be_nil
+      end
+
+      describe "@document" do
+        it "should be a Nokogiri::HTML document" do
+          @page.instance_variable_get(:@document).should be_a Nokogiri::HTML::Document
+        end
+      end
+
+      describe "@url" do
+        it "should return the expected string" do
+          @page.instance_variable_get(:@url).should == "http://www.example.com"
+        end
+      end
+
+      describe "@mixins" do
+        it "should be accessible with .mixins" do
+          @page.mixins.should equal @page.instance_variable_get(:@mixins)
+        end
+
+        it "should return an array" do
+          @page.mixins.should be_an(Array)
+        end
+
+        it "should be writable using instance_variable_set" do
+          mixins = @page.mixins << :new_mixin
+          @page.instance_variable_set :@mixins, mixins
+          @page.mixins.should include :new_mixin
+        end
+      end
+
+      it "should have an attribute reader for @mixins" do
+        @page.should respond_to(:mixins)
+      end
+
+      it "should not have an attribute writer for @mixins" do
+        @page.should_not respond_to(:mixins=)
+      end
+
+      it "should have an attribute reader for @url" do
+        @page.should respond_to(:url)
+      end
+
+      it "should not have an attribute writer for @url" do
+        @page.should_not respond_to(:url=)
+      end
+
+      it "should have attribute reader for @document" do
+        @page.should respond_to(:document)
+      end
+
+      it "should have attribute writer for @document" do
+        @page.should_not respond_to(:document=)
+      end
+
+    end
+
+    describe "#has_selector?" do
+
+      it "should return true if @document contains one or more elements matching the selector" do
+        @page.has_selector?('p.one_of_these').should be_true
+        @page.has_selector?('p.two_of_these').should be_true
+      end
+
+      it "should return false if @document does not contain one or more elements matching the selector" do
+        @page.has_selector?('p.does_not_exist').should be_false
+      end
+
+    end
+
+  end
+
+end

data/spec/pages/page_with_test_mixin_stuff.rb

@@ -0,0 +1,2 @@
+module PageWithTestMixinStuff
+end

data/spec/spec.opts

@@ -0,0 +1,3 @@
+--colour
+--reverse
+--backtrace

data/spec/spec_helper.rb

@@ -0,0 +1,33 @@
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+require 'gizmo'
+
+require 'spec'
+require 'spec/autorun'
+
+begin require 'redgreen' unless ENV['TM_CURRENT_LINE']; rescue LoadError; end
+
+Spec::Runner.configure do |config|
+  include Gizmo::Helpers
+
+  config.before do
+    Gizmo.configure do |config|
+      config.mixin_dir = File.dirname(__FILE__) + '/pages'
+    end
+  end
+
+end
+
+module PageWithMyOpenstruct
+  def my_openstruct; OpenStruct; end
+end
+
+module PageWithMyMixin
+  def my_method; nil; end
+end
+
+module PageWithMyOtherMixin
+end
+
+module PageWithMyInvalidMixin
+  def valid?; false; end
+end

metadata

@@ -0,0 +1,178 @@
+--- !ruby/object:Gem::Specification 
+name: gizmo
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Luke Cunningham
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-03-30 00:00:00 +11:00
+default_executable: gizmo
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 3
+        - 0
+        version: 1.3.0
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: cucumber
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 6
+        - 3
+        version: 0.6.3
+  type: :development
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: webrat
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 7
+        - 0
+        version: 0.7.0
+  type: :development
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: capybara
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 3
+        - 5
+        version: 0.3.5
+  type: :development
+  version_requirements: *id004
+- !ruby/object:Gem::Dependency 
+  name: nokogiri
+  prerelease: false
+  requirement: &id005 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 4
+        - 1
+        version: 1.4.1
+  type: :runtime
+  version_requirements: *id005
+- !ruby/object:Gem::Dependency 
+  name: activesupport
+  prerelease: false
+  requirement: &id006 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 2
+        - 3
+        - 5
+        version: 2.3.5
+  type: :runtime
+  version_requirements: *id006
+description: gizmo is a simple page model testing framework used and sponsored by 'realestate.com.au'. The aim of the project is to DRY up your testing assertions by abstracting code that defines your page resulting in a consistent, easy to maintain test suit
+email: luke@icaruswings.com
+executables: 
+- gizmo
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.md
+files: 
+- .document
+- .gitignore
+- LICENSE
+- README.md
+- Rakefile
+- VERSION
+- bin/gizmo
+- features/gizmo.feature
+- features/step_definitions/gizmo_steps.rb
+- features/support/env.rb
+- features/support/pages/page_with_github_repo_details.rb
+- features/support/pages/page_with_github_search.rb
+- features/support/pages/page_with_github_search_results.rb
+- features/support/patches/capybara.rb
+- lib/gizmo.rb
+- lib/gizmo/configuration.rb
+- lib/gizmo/extras.rb
+- lib/gizmo/helpers.rb
+- lib/gizmo/page.rb
+- spec/github_site_example_spec.rb
+- spec/gizmo/configuration_spec.rb
+- spec/gizmo/extras_spec.rb
+- spec/gizmo/helpers_spec.rb
+- spec/gizmo/page_spec.rb
+- spec/pages/page_with_test_mixin_stuff.rb
+- spec/spec.opts
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: http://github.com/icaruswings/gizmo
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.6
+signing_key: 
+specification_version: 3
+summary: simple page model testing framework
+test_files: 
+- spec/github_site_example_spec.rb
+- spec/gizmo/configuration_spec.rb
+- spec/gizmo/extras_spec.rb
+- spec/gizmo/helpers_spec.rb
+- spec/gizmo/page_spec.rb
+- spec/pages/page_with_test_mixin_stuff.rb
+- spec/spec_helper.rb