kookaburra 0.2.0 → 0.3.0

data/Gemfile

@@ -1,5 +1,6 @@
 source 'http://rubygems.org'
 
+gem 'i18n'
 gem 'activesupport', '>= 3.0'
 gem 'rack-test'
 

data/Gemfile.lock

@@ -4,6 +4,7 @@ GEM
     activesupport (3.1.3)
       multi_json (~> 1.0)
     git (1.2.5)
+    i18n (0.6.0)
     jeweler (1.6.4)
       bundler (~> 1.0)
       git (>= 1.2.5)
@@ -33,6 +34,7 @@ PLATFORMS
 DEPENDENCIES
   activesupport (>= 3.0)
   bundler (~> 1.0.0)
+  i18n
   jeweler (~> 1.6.4)
   minitest
   rack-test

data/VERSION

@@ -1 +1 @@
-0.2.0
+0.3.0

data/kookaburra.gemspec

@@ -5,7 +5,7 @@
 
 Gem::Specification.new do |s|
   s.name = "kookaburra"
-  s.version = "0.2.0"
+  s.version = "0.3.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Renewable Funding, LLC"]
@@ -40,6 +40,7 @@ Gem::Specification.new do |s|
     "lib/kookaburra/ui_driver/ui_component.rb",
     "lib/requires.rb",
     "test/helper.rb",
+    "test/kookaburra/ui_driver_test.rb",
     "test/kookaburra_test.rb"
   ]
   s.homepage = "http://github.com/projectdx/kookaburra"
@@ -52,6 +53,7 @@ Gem::Specification.new do |s|
     s.specification_version = 3
 
     if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<i18n>, [">= 0"])
       s.add_runtime_dependency(%q<activesupport>, [">= 3.0"])
       s.add_runtime_dependency(%q<rack-test>, [">= 0"])
       s.add_development_dependency(%q<minitest>, [">= 0"])
@@ -61,6 +63,7 @@ Gem::Specification.new do |s|
       s.add_development_dependency(%q<rcov>, [">= 0"])
       s.add_development_dependency(%q<reek>, ["~> 1.2.8"])
     else
+      s.add_dependency(%q<i18n>, [">= 0"])
       s.add_dependency(%q<activesupport>, [">= 3.0"])
       s.add_dependency(%q<rack-test>, [">= 0"])
       s.add_dependency(%q<minitest>, [">= 0"])
@@ -71,6 +74,7 @@ Gem::Specification.new do |s|
       s.add_dependency(%q<reek>, ["~> 1.2.8"])
     end
   else
+    s.add_dependency(%q<i18n>, [">= 0"])
     s.add_dependency(%q<activesupport>, [">= 3.0"])
     s.add_dependency(%q<rack-test>, [">= 0"])
     s.add_dependency(%q<minitest>, [">= 0"])

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

@@ -6,11 +6,11 @@ module Kookaburra
       # This will fail if the options hash does not include a value for the key :browser
       def initialize(options = {})
         super()
-        @browserish = options.fetch(:browser)
+        @opts = options
       end
 
       def browser
-        @browserish
+        @browser ||= @opts.fetch(:browser)
       end
 
       def visit(*args)

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

@@ -1,6 +1,10 @@
+require 'active_support/core_ext/string/inflections'
+
 module Kookaburra
   class UIDriver
     module HasUIComponent
+      UIComponentNotFound = Class.new(StandardError)
+
       module ClassMethods
         def ui_component(component_name)
           self.ui_component_names << component_name

data/lib/kookaburra/ui_driver/ui_component.rb

@@ -34,23 +34,28 @@ module Kookaburra
 
       ##### Instance methods #####
 
+      # Returns the CSS locator used to locate the component in the DOM
+      def component_locator
+        raise "You must define component_locator in subclasses of UIComponent!"
+      end
+
       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?
 
+      # Default implementation navigates directly to this UIComponent's
+      # #component_path. If +opts[:query_params] is set to a Hash, the request
+      # will be made with the resulting querystring on the URL.
       def show(opts = {})
+        unless respond_to?(:component_path)
+          raise "You must either set component_path or redefine the #show method in UIComponent subclasses!"
+        end
         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
@@ -66,11 +71,12 @@ module Kookaburra
       end
 
       def at_path?
-        (component_path.to_a + alternate_paths.to_a).include?(browser.current_path)
+        (Array(component_path) + Array(alternate_paths)).include?(browser.current_path)
       end
 
       def component_visible?
-        at_path? && browser.has_css?(component_locator)
+        return false if respond_to?(:component_path) && !at_path?
+        browser.has_css?(component_locator)
       end
 
       def alternate_paths

data/lib/kookaburra/ui_driver.rb

@@ -3,11 +3,21 @@ module Kookaburra
     include HasBrowser
     include HasUIComponent
 
-    attr_reader :test_data
+    def test_data
+      @test_data ||= @opts.fetch(:test_data)
+    end
 
     def initialize(opts = {})
       super
-      @test_data = opts.fetch(:test_data)
+      @opts = opts
+    end
+
+    def navigate_to(component_id, parameters = {})
+      if ui_component_names.include?(component_id)
+        self.send(component_id).show!(parameters)
+      else
+        raise UIComponentNotFound, "The #{component_id} component is not registered"
+      end
     end
   end
 end

data/test/kookaburra/ui_driver_test.rb

@@ -0,0 +1,55 @@
+require 'helper'
+
+describe Kookaburra::UIDriver do
+  describe '#navigate_to' do
+    it 'raises a UIComponentNotFound if the specified UIComponent is not registered' do
+      ui = Kookaburra::UIDriver.new
+      assert_raises Kookaburra::UIDriver::UIComponentNotFound do
+        ui.navigate_to(:nonexistent_component)
+      end
+    end
+
+    Foo = Class.new do
+      @@last_instance = nil
+
+      def self.was_shown
+        @@last_instance.was_shown
+      end
+
+      def self.params
+        @@last_instance.params
+      end
+
+      def initialize(options)
+        @@last_instance = self
+      end
+
+      def show!(params = {})
+        @was_shown = true
+        @params = params
+      end
+      attr_reader :was_shown, :params
+    end
+
+    let(:ui_class) do
+      Class.new(Kookaburra::UIDriver) do
+        def browser; end
+        def test_data; end
+
+        ui_component :foo
+      end
+    end
+
+    it 'delegates to the UIComponent#show! method' do
+      ui = ui_class.new
+      ui.navigate_to :foo
+      assert Foo.was_shown, "#show! was never called on the Foo component"
+    end
+
+    it 'passed any additional options to the UIComponent#show! method' do
+      ui = ui_class.new
+      ui.navigate_to :foo, :bar => :baz
+      assert_equal({:bar => :baz}, Foo.params)
+    end
+  end
+end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: kookaburra
 version: !ruby/object:Gem::Version 
-  hash: 23
+  hash: 19
   prerelease: 
   segments: 
   - 0
-  - 2
+  - 3
   - 0
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors: 
 - Renewable Funding, LLC
@@ -19,6 +19,20 @@ date: 2012-01-17 00:00:00 Z
 dependencies: 
 - !ruby/object:Gem::Dependency 
   version_requirements: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  name: i18n
+  prerelease: false
+  type: :runtime
+  requirement: *id001
+- !ruby/object:Gem::Dependency 
+  version_requirements: &id002 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ">="
@@ -31,9 +45,9 @@ dependencies:
   name: activesupport
   prerelease: false
   type: :runtime
-  requirement: *id001
+  requirement: *id002
 - !ruby/object:Gem::Dependency 
-  version_requirements: &id002 !ruby/object:Gem::Requirement 
+  version_requirements: &id003 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ">="
@@ -45,9 +59,9 @@ dependencies:
   name: rack-test
   prerelease: false
   type: :runtime
-  requirement: *id002
+  requirement: *id003
 - !ruby/object:Gem::Dependency 
-  version_requirements: &id003 !ruby/object:Gem::Requirement 
+  version_requirements: &id004 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ">="
@@ -59,9 +73,9 @@ dependencies:
   name: minitest
   prerelease: false
   type: :development
-  requirement: *id003
+  requirement: *id004
 - !ruby/object:Gem::Dependency 
-  version_requirements: &id004 !ruby/object:Gem::Requirement 
+  version_requirements: &id005 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ~>
@@ -75,9 +89,9 @@ dependencies:
   name: yard
   prerelease: false
   type: :development
-  requirement: *id004
+  requirement: *id005
 - !ruby/object:Gem::Dependency 
-  version_requirements: &id005 !ruby/object:Gem::Requirement 
+  version_requirements: &id006 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ~>
@@ -91,9 +105,9 @@ dependencies:
   name: bundler
   prerelease: false
   type: :development
-  requirement: *id005
+  requirement: *id006
 - !ruby/object:Gem::Dependency 
-  version_requirements: &id006 !ruby/object:Gem::Requirement 
+  version_requirements: &id007 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ~>
@@ -107,9 +121,9 @@ dependencies:
   name: jeweler
   prerelease: false
   type: :development
-  requirement: *id006
+  requirement: *id007
 - !ruby/object:Gem::Dependency 
-  version_requirements: &id007 !ruby/object:Gem::Requirement 
+  version_requirements: &id008 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ">="
@@ -121,9 +135,9 @@ dependencies:
   name: rcov
   prerelease: false
   type: :development
-  requirement: *id007
+  requirement: *id008
 - !ruby/object:Gem::Dependency 
-  version_requirements: &id008 !ruby/object:Gem::Requirement 
+  version_requirements: &id009 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ~>
@@ -137,7 +151,7 @@ dependencies:
   name: reek
   prerelease: false
   type: :development
-  requirement: *id008
+  requirement: *id009
 description: Cucumber + Capybara = Kookaburra? It made sense at the time.
 email: devteam@renewfund.com
 executables: []
@@ -171,6 +185,7 @@ files:
 - lib/kookaburra/ui_driver/ui_component.rb
 - lib/requires.rb
 - test/helper.rb
+- test/kookaburra/ui_driver_test.rb
 - test/kookaburra_test.rb
 homepage: http://github.com/projectdx/kookaburra
 licenses: