kookaburra 0.0.2

data/.document

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

data/.rvmrc

@@ -0,0 +1,2 @@
+rvm use ree-1.8.7@kookaburra --create --install
+bundle check

data/Gemfile

@@ -0,0 +1,17 @@
+source 'http://rubygems.org'
+
+gem 'activesupport', '>= 3.0'
+gem 'rack'
+
+
+
+# Add dependencies to develop your gem here.
+# Include everything needed to run rake, tests, features, etc.
+group :development do
+  gem 'minitest', '>= 0'
+  gem 'yard', '~> 0.6.0'
+  gem 'bundler', '~> 1.0.0'
+  gem 'jeweler', '~> 1.6.4'
+  gem 'rcov', '>= 0'
+  gem 'reek', '~> 1.2.8'
+end

data/Gemfile.lock

@@ -0,0 +1,39 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    activesupport (3.1.3)
+      multi_json (~> 1.0)
+    git (1.2.5)
+    jeweler (1.6.4)
+      bundler (~> 1.0)
+      git (>= 1.2.5)
+      rake
+    minitest (2.9.0)
+    multi_json (1.0.4)
+    rack (1.3.5)
+    rake (0.9.2.2)
+    rcov (0.9.11)
+    reek (1.2.8)
+      ruby2ruby (~> 1.2)
+      ruby_parser (~> 2.0)
+      sexp_processor (~> 3.0)
+    ruby2ruby (1.3.1)
+      ruby_parser (~> 2.0)
+      sexp_processor (~> 3.0)
+    ruby_parser (2.3.1)
+      sexp_processor (~> 3.0)
+    sexp_processor (3.0.9)
+    yard (0.6.8)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  activesupport (>= 3.0)
+  bundler (~> 1.0.0)
+  jeweler (~> 1.6.4)
+  minitest
+  rack
+  rcov
+  reek (~> 1.2.8)
+  yard (~> 0.6.0)

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Renewable Funding, LLC
+
+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.rdoc

@@ -0,0 +1,19 @@
+= kookaburra
+
+Description goes here.
+
+== Contributing to kookaburra
+ 
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
+* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
+* Fork the project
+* Start a feature/bugfix branch
+* Commit and push until you are happy with your contribution
+* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+
+== Copyright
+
+Copyright (c) 2011 Renewable Funding, LLC. See LICENSE.txt for
+further details.
+

data/Rakefile

@@ -0,0 +1,53 @@
+# encoding: utf-8
+
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "kookaburra"
+  gem.homepage = "http://github.com/projectdx/kookaburra"
+  gem.license = "MIT"
+  gem.summary = %Q{WindowDriver testing pattern for Ruby apps}
+  gem.description = %Q{Cucumber + Capybara = Kookaburra? It made sense at the time.}
+  gem.email = "devteam@renewfund.com"
+  gem.authors = ["Renewable Funding, LLC"]
+  # dependencies defined in Gemfile
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/*_test.rb'
+  test.verbose = true
+end
+
+require 'rcov/rcovtask'
+Rcov::RcovTask.new do |test|
+  test.libs << 'test'
+  test.pattern = 'test/**/*_test.rb'
+  test.verbose = true
+  test.rcov_opts << '--exclude "gems/*"'
+end
+
+require 'reek/rake/task'
+Reek::Rake::Task.new do |t|
+  t.fail_on_error = true
+  t.verbose = false
+  t.source_files = 'lib/**/*.rb'
+end
+
+task :default => :test
+
+require 'yard'
+YARD::Rake::YardocTask.new

data/VERSION

@@ -0,0 +1 @@
+0.0.2

data/kookaburra.gemspec

@@ -0,0 +1,84 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = "kookaburra"
+  s.version = "0.0.2"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Renewable Funding, LLC"]
+  s.date = "2012-01-15"
+  s.description = "Cucumber + Capybara = Kookaburra? It made sense at the time."
+  s.email = "devteam@renewfund.com"
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+    ".rvmrc",
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE.txt",
+    "README.rdoc",
+    "Rakefile",
+    "VERSION",
+    "kookaburra.gemspec",
+    "lib/kookaburra.rb",
+    "lib/kookaburra/api_driver.rb",
+    "lib/kookaburra/given_driver.rb",
+    "lib/kookaburra/test_data.rb",
+    "lib/kookaburra/test_data/factory.rb",
+    "lib/kookaburra/ui_driver.rb",
+    "lib/kookaburra/ui_driver/mixins/has_browser.rb",
+    "lib/kookaburra/ui_driver/mixins/has_fields.rb",
+    "lib/kookaburra/ui_driver/mixins/has_strategies.rb",
+    "lib/kookaburra/ui_driver/mixins/has_subcomponents.rb",
+    "lib/kookaburra/ui_driver/mixins/has_ui_component.rb",
+    "lib/kookaburra/ui_driver/ui_component.rb",
+    "lib/kookaburra/world_setup.rb",
+    "lib/requires.rb",
+    "test/helper.rb"
+  ]
+  s.homepage = "http://github.com/projectdx/kookaburra"
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = "1.8.15"
+  s.summary = "WindowDriver testing pattern for Ruby apps"
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<activesupport>, [">= 3.0"])
+      s.add_runtime_dependency(%q<rack>, [">= 0"])
+      s.add_development_dependency(%q<minitest>, [">= 0"])
+      s.add_development_dependency(%q<yard>, ["~> 0.6.0"])
+      s.add_development_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_development_dependency(%q<jeweler>, ["~> 1.6.4"])
+      s.add_development_dependency(%q<rcov>, [">= 0"])
+      s.add_development_dependency(%q<reek>, ["~> 1.2.8"])
+    else
+      s.add_dependency(%q<activesupport>, [">= 3.0"])
+      s.add_dependency(%q<rack>, [">= 0"])
+      s.add_dependency(%q<minitest>, [">= 0"])
+      s.add_dependency(%q<yard>, ["~> 0.6.0"])
+      s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_dependency(%q<jeweler>, ["~> 1.6.4"])
+      s.add_dependency(%q<rcov>, [">= 0"])
+      s.add_dependency(%q<reek>, ["~> 1.2.8"])
+    end
+  else
+    s.add_dependency(%q<activesupport>, [">= 3.0"])
+    s.add_dependency(%q<rack>, [">= 0"])
+    s.add_dependency(%q<minitest>, [">= 0"])
+    s.add_dependency(%q<yard>, ["~> 0.6.0"])
+    s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+    s.add_dependency(%q<jeweler>, ["~> 1.6.4"])
+    s.add_dependency(%q<rcov>, [">= 0"])
+    s.add_dependency(%q<reek>, ["~> 1.2.8"])
+  end
+end
+

data/lib/kookaburra/api_driver.rb

@@ -0,0 +1,43 @@
+module Kookaburra
+  # Pattern:
+  # - Get some data from test_data.factory
+  # - Post it to the API
+  # - Remember the response in test_data
+  class APIDriver
+    include Rack::Test::Methods
+    attr_reader :app, :test_data
+    protected :app, :test_data
+
+    def initialize(opts)
+      @app       = opts.fetch(:app)
+      @test_data = opts.fetch(:test_data)
+    end
+
+  protected
+
+    def raise_unless_status(expected_status, short_description)
+      message = "%s failed (#{last_response.status})\n#{last_response.body}" % short_description
+      raise message unless last_response.status == expected_status
+    end
+
+    ##### JSON Tools #####
+
+    def post_as_json(short_description, path, data = {}, options = {})
+      header 'Content-Type', 'application/json'
+      header 'Accept', 'application/json'
+      post path, data.to_json
+      raise_unless_status options[:expected_status] || 201, short_description
+    end
+
+    def put_as_json(short_description, path, data = {}, options = {})
+      header 'Content-Type', 'application/json'
+      header 'Accept', 'application/json'
+      put path, data.to_json
+      raise_unless_status options[:expected_status] || 201, short_description
+    end
+
+    def hash_from_response_json
+      HashWithIndifferentAccess.new( JSON.parse(last_response.body) )
+    end
+  end
+end

data/lib/kookaburra/given_driver.rb

@@ -0,0 +1,7 @@
+module Kookaburra
+  class GivenDriver
+    def initialize(opts)
+      @api = opts.fetch(:api_driver)
+    end
+  end
+end

data/lib/kookaburra/test_data/factory.rb

@@ -0,0 +1,18 @@
+# Factories for setting up attribute hashes
+module Kookaburra
+  class TestData
+    class Factory
+      attr_reader :test_data
+      def initialize(test_data)
+        @test_data = test_data
+      end
+
+      protected
+      def hash_for_merging(overrides = {})
+        HashWithIndifferentAccess.new( overrides.with_indifferent_access ).tap do |hash_to_merge|
+          yield hash_to_merge if block_given?
+        end
+      end
+    end
+  end
+end

data/lib/kookaburra/test_data.rb

@@ -0,0 +1,51 @@
+# This is the mechanism for sharing state between Cucumber steps.
+# If you're using instance variables, YOU'RE DOING IT WRONG.
+module Kookaburra
+  class TestData
+    def initialize
+      @data = Hash.new do |hash, key|
+        hash[key] = Hash.new { |hash, key| hash[key] = HashWithIndifferentAccess.new }
+      end
+    end
+
+    def __collection(collection_key)
+      @data[collection_key]
+    end
+    def __fetch_data(collection_key, value_key)
+      __collection(collection_key).fetch(value_key)
+    rescue IndexError => e
+      raise e.exception("Key #{value_key.inspect} not found in #{collection_key}")
+    end
+    def __get_data(collection_key, value_key)
+      __collection(collection_key)[value_key]
+    end
+    def __set_data(collection_key, value_key, value_hash = {})
+      __collection(collection_key)[value_key] = HashWithIndifferentAccess.new(value_hash)
+    end
+
+    def self.provide_collection(name)
+      class_eval <<-RUBY
+        def #{name}(key = :default)
+          __get_data(:#{name}, key)
+        end
+        def fetch_#{name}(key = :default)
+          __fetch_data(:#{name}, key)
+        end
+        def set_#{name}(key, value_hash = {})
+          __set_data(:#{name}, key, value_hash)
+        end
+      RUBY
+    end
+
+    Defaults = HashWithIndifferentAccess.new
+    def default(key)
+      # NOTE: Marshal seems clunky, but gives us a deep copy.
+      # This keeps mutations from being preserved between test runs.
+      ( @default ||= Marshal::load(Marshal.dump(Defaults)) )[key]
+    end
+
+    def factory
+      @factory ||= Kookaburra::TestData::Factory.new(self)
+    end
+  end
+end

data/lib/kookaburra/ui_driver/mixins/has_browser.rb

@@ -0,0 +1,29 @@
+module Kookaburra
+  class UIDriver
+    module HasBrowser
+      Unexpected500 = Class.new(StandardError)
+
+      # This will fail if the options hash does not include a value for the key :browser
+      def initialize(options = {})
+        super()
+        @browserish = options.fetch(:browser)
+      end
+
+      def browser
+        @browserish
+      end
+
+      def visit(*args)
+        browser.visit *args
+        no_500_error!
+      end
+
+      def no_500_error!
+        if browser.has_css?('head title', :text => 'Internal Server Error')
+          sleep 30 if ENV['GIMME_CRAP']
+          raise Unexpected500
+        end
+      end
+    end
+  end
+end

data/lib/kookaburra/ui_driver/mixins/has_fields.rb

@@ -0,0 +1,178 @@
+module Kookaburra
+  class UIDriver
+    module HasFields
+      module ClassMethods
+        def submit_button_locator(locator)
+          define_method(:submit_button_locator) { locator }
+        end
+
+        def has_radio_button_for(*names)
+          names.each do |n|
+            input_xpath_builder_names[n] = :build_radio_input_xpath
+          end
+        end
+
+        def has_select_for(*names)
+          names.each do |n|
+            input_xpath_builder_names[n] = :build_select_input_xpath
+          end
+        end
+
+        def input_xpath_builder_names
+          # Inputs without a type attribute, or with a custom or unknown type are
+          # textual, so we need to exclude the types that we don't want.
+          @input_xpath_builder_names ||= HashWithIndifferentAccess.new(:build_textual_input_xpath)
+        end
+
+        def is_select?(name)
+          input_xpath_builder_names[name] == :build_select_input_xpath
+        end
+      end
+
+      module InstanceMethods
+        def build_input_xpath(attribute)
+          "(" +
+            "(.//textarea)|" +
+            "(.//select)|" +
+            "(.//input[(not(@type='button')) and (not(@type='reset')) and (not(@type='submit'))])" +
+          ")[contains(@id,'_#{attribute}')]"
+          # TODO: Avoid false positives by matching to the end of the id
+          #       string for everything but radio buttons and checkboxes
+          #       ... or something better than that.
+        end
+
+        def build_textual_input_xpath(attribute, value=nil)
+          # Since the type attribute might not be present or might contain
+          # just about any value, check for and exclude nodes with type
+          # containing a non-textual value.
+          "(" +
+            "(.//textarea)|" +
+            "(.//input[" +
+              "(not(@type='button')) and (not(@type='checkbox')) and (not(@type='radio')) and " +
+              "(not(@type='reset')) and (not(@type='submit'))" +
+            "])" +
+          ")[" +
+            "substring(@id,string-length(@id)-#{attribute.length-1},#{attribute.length})='#{attribute}'" +
+          "]"
+        end
+
+        def build_radio_input_xpath(attribute, value=nil)
+          # The id will be the attribute suffixed by something representative of
+          # the button value, with an underscore in between, but we don't necessarily
+          # know the correct suffix, so ensure that the "_" is in the id, and then
+          # find the correct match using the value attribute.
+          xpath = ".//input[@type='radio'][contains(@id, #{attribute}_)]"
+          xpath = "(#{xpath})[@value='#{value}']"
+        end
+
+        def build_select_input_xpath(attribute, value=nil)
+          xpath = ".//select[contains(@id, #{attribute})]/option[text()='#{value}']"
+        end
+
+        # Find the specified input by its field name.  The value argument is
+        # used to find the correct input if (as in the case of a radio button)
+        # there might be a separate input element for each value the field might
+        # contain.  Otherwise, it is ignored.  When the name value will be used,
+        # its #to_s value must be valid as an xpath string body expression.
+        def find_input(attribute, value=nil, nth=1, msg=nil)
+          method = self.class.input_xpath_builder_names[attribute]
+          #TODO: Build a qualified attribute name, and pass that to the xpath builder
+          #      to handle forms with multiple models that may have common attribute
+          #      names.
+          xpath = send(method, attribute.to_s, value.to_s)
+          xpath = "(#{xpath})[#{nth}]" if nth > 1
+          browser.find(:xpath, xpath, :message => msg)
+        end
+
+        def submit_button_locator
+          raise "Subclass responsibility!"
+        end
+
+        def submit!
+          click_on submit_button_locator
+          no_500_error!
+        end
+
+        def fill_in_fields(hash, idx = 0)
+          @body = nil
+
+          # If not explicitly ordered, then we must think the fill-in order doesn't
+          # matter, so make the order more assuredly arbitrary to find out sooner
+          # if that's not a correct thought.
+          hash = hash.map.shuffle if Hash === hash && ! ActiveSupport::OrderedHash === hash
+
+          hash.each do |field, value|
+            fill_in_form_element(field, value, idx)
+          end
+        end
+
+      private
+          def fill_in_form_element(attribute, value, idx = 0, opts = {})
+            msg = "cannot find the field for '#{attribute}' with value '#{value}' to fill it in."
+            input = find_input(attribute, value, idx+1, msg)
+            set_value(input, value, attribute)
+          end
+            def set_value(input, value, attribute)
+              if self.class.is_select?(attribute)
+                input.select_option
+              else
+                input.set value
+              end
+            end
+      public
+
+        def tag_visible?(css)
+          browser.has_css?(css, :visible => true)
+        end
+
+        def no_tag_visible?(css)
+          # use of wait_until is supposed to be redundant with #has_no_css?, but
+          # getting intermittent Selenium::WebDriver::Error::StaleElementReferenceError.
+          # Just wrapping in an explicit wait_until did not capture the exception,
+          # so apparently that one is explicitly passed through rather than being
+          # retried.
+          browser.wait_until do
+            begin
+              browser.has_no_css?(css, :visible => true)
+            rescue Selenium::WebDriver::Error::StaleElementReferenceError
+              next false  # Keep trying if not yet timed out.
+            end
+          end
+        end
+
+        private
+
+
+        def find_disableable_inputs(attribute)
+          inputs = []
+          browser.wait_until do
+            inputs = browser.all(:xpath, build_input_xpath(attribute))
+            inputs.present?
+          end
+          inputs
+        end
+
+        def form_element_disabled?(attribute, *_)
+          # TODO (SLG): this will only check the currently-selected radio button, not all of them
+          find_disableable_inputs(attribute).all? { |input| !!input[:disabled] }
+        rescue Capybara::TimeoutError
+          puts "Timed out trying to find disableable inputs for #{attribute}"
+        end
+
+        def all_form_elements_disabled?(desc, attr_names, &b)
+          errs = attr_names.inject([]) do |mem, attr_name|
+            (mem << "#{desc} #{attr_name} is not read-only") unless form_element_disabled?(attr_name)
+            mem
+          end
+          raise errs.join("\n") if errs.present?
+          true
+        end
+      end
+
+      def self.included(receiver)
+        receiver.extend         ClassMethods
+        receiver.send :include, InstanceMethods
+      end
+    end
+  end
+end

data/lib/kookaburra/ui_driver/mixins/has_strategies.rb

@@ -0,0 +1,50 @@
+module Kookaburra
+  class UIDriver
+    module HasStrategies
+      class Strategy
+        class_attribute :tag
+        attr_reader :ui_component
+        def initialize(ui_component)
+          @ui_component, @tag = ui_component
+        end
+      end
+
+      module ClassMethods
+        def strategy(tag, &proc)
+          Class.new(::Kookaburra::UIDriver::HasStrategies::Strategy).tap { |klass|
+            klass.tag = tag
+            klass.module_eval &proc
+            self.strategy_classes << klass
+          }
+        end
+
+        def use_strategy_for(*method_names)
+          def_delegators :current_strategy, *method_names
+        end
+      end
+
+      module InstanceMethods
+        def strategies
+          @strategies ||= strategy_classes.map { |klass| klass.new(self) }
+        end
+
+        def current_strategy
+          strategies.detect(&:applies?) or raise 'No applicable strategy!'
+        end
+
+        def strategy_tag
+          current_strategy.tag
+        end
+      end
+
+      def self.included(receiver)
+        receiver.class_attribute :strategy_classes
+        receiver.strategy_classes = []
+
+        receiver.extend Forwardable
+        receiver.extend         ClassMethods
+        receiver.send :include, InstanceMethods
+      end
+    end
+  end
+end

data/lib/kookaburra/ui_driver/mixins/has_subcomponents.rb

@@ -0,0 +1,10 @@
+module Kookaburra
+  class UIDriver
+    module HasSubcomponents
+      # Nothing to see here, really -- this just gives us a way to logically group subsections in a file
+      def subcomponent(name, &proc)
+        class_eval &proc
+      end
+    end
+  end
+end

data/lib/kookaburra/ui_driver/mixins/has_ui_component.rb

@@ -0,0 +1,37 @@
+module Kookaburra
+  class UIDriver
+    module HasUIComponent
+      module ClassMethods
+        def ui_component(component_name)
+          component_class = component_name.to_s.camelize.constantize
+
+          self.ui_component_names << component_name
+
+          define_method(component_name) do
+            options = { :browser => browser, :test_data => test_data }
+            # TODO: memoize the following line?
+            component_class.new(options)
+          end
+
+          define_method("has_#{component_name}?") do
+            send(component_name).visible?
+          end
+        end
+      end
+
+      module InstanceMethods
+        def ui_components
+          ui_component_names.map { |name| self.send(name) }
+        end
+      end
+
+      def self.included(receiver)
+        receiver.class_attribute :ui_component_names
+        receiver.ui_component_names = []
+
+        receiver.extend         ClassMethods
+        receiver.send :include, InstanceMethods
+      end
+    end
+  end
+end

data/lib/kookaburra/ui_driver/ui_component.rb

@@ -0,0 +1,103 @@
+module Kookaburra
+  class UIDriver
+    class UIComponent
+      include HasBrowser
+      include HasFields
+      include HasStrategies
+      extend HasSubcomponents
+
+      attr_reader :test_data
+
+      # This will fail if the options hash does not include a value for the key :test_data
+      def initialize(options = {})
+        super
+        @test_data = options.fetch(:test_data)
+      end
+
+      ##### Class macros #####
+      def self.component_locator(locator)
+        define_method(:component_locator) { locator }
+      end
+
+      def self.component_path(path)
+        case path
+        when Symbol
+          alias_method :component_path, path
+        else
+          define_method(:component_path) { path }
+        end
+      end
+
+      def self.path_id_regex(regex)
+        define_method(:path_id_regex) { regex }
+      end
+
+      ##### Instance methods #####
+
+      def visible!
+        raise "#{self.class} not currently visible!" unless visible?
+      end
+
+      def visible?
+        no_500_error!
+        _visible?
+      end
+
+      def _visible?
+        component_visible?
+      end
+      private :_visible?
+
+      def show(opts = {})
+        return if visible?
+        raise "Subclass responsibility!" unless self.respond_to?(:component_path)
+        path = component_path
+        path << ( '?' + opts[:query_params].map{|kv| "%s=%s" % kv}.join('&') ) if opts[:query_params]
+        visit path
+      end
+
+      def refresh
+        visit component_path
+      end
+
+      def show!(opts = {})
+        show opts
+        visible!
+      end
+
+      def at_path?
+        (component_path.to_a + alternate_paths.to_a).include?(browser.current_path)
+      end
+
+      def component_visible?
+        at_path? && browser.has_css?(component_locator)
+      end
+
+      def alternate_paths
+        []
+      end
+
+    private
+      def id_from_path
+        browser.current_path =~ path_id_regex
+        $1.present? ? $1.to_i : nil
+      end
+
+      def fill_in(locator, options)
+        in_component { browser.fill_in(locator, options) }
+      end
+
+      def click_on(locator)
+        in_component { browser.find(locator).click }
+      end
+
+      def choose(locator)
+        in_component { browser.choose(locator) }
+      end
+
+      def in_component(&blk)
+        browser.within(component_locator, &blk)
+      end
+    end
+  end
+end

data/lib/kookaburra/ui_driver.rb

@@ -0,0 +1,13 @@
+module Kookaburra
+  class UIDriver
+    include HasBrowser
+    include HasUIComponent
+
+    attr_reader :test_data
+
+    def initialize(opts = {})
+      super
+      @test_data = opts.fetch(:test_data)
+    end
+  end
+end

data/lib/kookaburra/world_setup.rb

@@ -0,0 +1,12 @@
+# Can't use a custom World class, because cucumber-rails is already doing that
+module Kookaburra
+  module WorldSetup
+    def ui;    @drivers[:ui_driver   ]; end
+    def api;   @drivers[:api_driver  ]; end
+    def given; @drivers[:given_driver]; end
+
+    def kookaburra_world_setup
+      @drivers = Kookaburra.drivers
+    end
+  end
+end

data/lib/kookaburra.rb

@@ -0,0 +1,19 @@
+require File.join(File.dirname(__FILE__), *%w[requires])
+
+module Kookaburra
+  def self.drivers
+    test_data = Kookaburra::TestData.new
+    api_driver = Kookaburra::APIDriver.new({
+      :app       => Capybara.app,
+      :test_data => test_data,
+    })
+    given_driver = Kookaburra::GivenDriver.new({
+      :api_driver => api_driver,
+    })
+    ui_driver = Kookaburra::UIDriver.new({
+      :browser   => Capybara.current_session,
+      :test_data => test_data,
+    })
+    { :api_driver => api_driver, :given_driver => given_driver, :ui_driver => ui_driver }
+  end
+end

data/lib/requires.rb

@@ -0,0 +1,17 @@
+def kookaburra_require_glob(path_glob)
+  Dir.glob(path_glob).each do |file|
+    require file
+  end
+end
+
+def kookaburra_require_all_relative_to(base_path, *relative_path_array)
+  path = File.join(base_path, *relative_path_array.flatten)
+  kookaburra_require_glob File.join(path, '*.rb')
+end
+
+# Require specific paths from the bottom up.  Hooray for dependency graphs!
+base = File.dirname(__FILE__)
+kookaburra_require_all_relative_to base, %w[kookaburra ui_driver mixins]
+kookaburra_require_all_relative_to base, %w[kookaburra ui_driver]
+kookaburra_require_all_relative_to base, %w[kookaburra test_data]
+kookaburra_require_all_relative_to base, %w[kookaburra]

data/test/helper.rb

@@ -0,0 +1,19 @@
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'minitest/unit'
+
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+require 'kookaburra'
+
+class MiniTest::Unit::TestCase
+end
+
+MiniTest::Unit.autorun

metadata

@@ -0,0 +1,209 @@
+--- !ruby/object:Gem::Specification 
+name: kookaburra
+version: !ruby/object:Gem::Version 
+  hash: 27
+  prerelease: 
+  segments: 
+  - 0
+  - 0
+  - 2
+  version: 0.0.2
+platform: ruby
+authors: 
+- Renewable Funding, LLC
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2012-01-15 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  version_requirements: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 7
+        segments: 
+        - 3
+        - 0
+        version: "3.0"
+  name: activesupport
+  prerelease: false
+  type: :runtime
+  requirement: *id001
+- !ruby/object:Gem::Dependency 
+  version_requirements: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  name: rack
+  prerelease: false
+  type: :runtime
+  requirement: *id002
+- !ruby/object:Gem::Dependency 
+  version_requirements: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  name: minitest
+  prerelease: false
+  type: :development
+  requirement: *id003
+- !ruby/object:Gem::Dependency 
+  version_requirements: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 7
+        segments: 
+        - 0
+        - 6
+        - 0
+        version: 0.6.0
+  name: yard
+  prerelease: false
+  type: :development
+  requirement: *id004
+- !ruby/object:Gem::Dependency 
+  version_requirements: &id005 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 23
+        segments: 
+        - 1
+        - 0
+        - 0
+        version: 1.0.0
+  name: bundler
+  prerelease: false
+  type: :development
+  requirement: *id005
+- !ruby/object:Gem::Dependency 
+  version_requirements: &id006 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 7
+        segments: 
+        - 1
+        - 6
+        - 4
+        version: 1.6.4
+  name: jeweler
+  prerelease: false
+  type: :development
+  requirement: *id006
+- !ruby/object:Gem::Dependency 
+  version_requirements: &id007 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  name: rcov
+  prerelease: false
+  type: :development
+  requirement: *id007
+- !ruby/object:Gem::Dependency 
+  version_requirements: &id008 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 15
+        segments: 
+        - 1
+        - 2
+        - 8
+        version: 1.2.8
+  name: reek
+  prerelease: false
+  type: :development
+  requirement: *id008
+description: Cucumber + Capybara = Kookaburra? It made sense at the time.
+email: devteam@renewfund.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE.txt
+- README.rdoc
+files: 
+- .document
+- .rvmrc
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.rdoc
+- Rakefile
+- VERSION
+- kookaburra.gemspec
+- lib/kookaburra.rb
+- lib/kookaburra/api_driver.rb
+- lib/kookaburra/given_driver.rb
+- lib/kookaburra/test_data.rb
+- lib/kookaburra/test_data/factory.rb
+- lib/kookaburra/ui_driver.rb
+- lib/kookaburra/ui_driver/mixins/has_browser.rb
+- lib/kookaburra/ui_driver/mixins/has_fields.rb
+- lib/kookaburra/ui_driver/mixins/has_strategies.rb
+- lib/kookaburra/ui_driver/mixins/has_subcomponents.rb
+- lib/kookaburra/ui_driver/mixins/has_ui_component.rb
+- lib/kookaburra/ui_driver/ui_component.rb
+- lib/kookaburra/world_setup.rb
+- lib/requires.rb
+- test/helper.rb
+homepage: http://github.com/projectdx/kookaburra
+licenses: 
+- MIT
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.8.15
+signing_key: 
+specification_version: 3
+summary: WindowDriver testing pattern for Ruby apps
+test_files: []
+