test-harness 0.1.0 → 0.2.0

data/VERSION

@@ -1 +1 @@
-0.1.0
+0.2.0

data/lib/configuration.rb

@@ -0,0 +1,6 @@
+class TestHarness
+  class Configuration
+    attr_accessor :browser, :server_host
+
+  end
+end

data/lib/given.rb

@@ -0,0 +1,13 @@
+require 'test_helper'
+class TestHarness
+  class Given
+    include TestHarness::TestHelper
+
+    Dir.glob(File.expand_path('../given/*.rb', __FILE__)).each do |file|
+      klass = ("TestHarness::Given::%s" % File.basename(file, '.rb').camelize).constantize
+      include klass
+    end
+  end
+end
+
+

data/lib/mental_model.rb

@@ -0,0 +1,5 @@
+class TestHarness
+  class MentalModel < OpenStruct
+
+  end
+end

data/lib/test_harness.rb

@@ -0,0 +1,41 @@
+require 'given'
+require 'ui_component'
+
+class TestHarness
+  class << self
+    def configuration
+      @configuation ||= Configuration.new
+    end
+
+    def configure(&block)
+      yield configuration
+    end
+
+    def given
+      @given ||= TestHarness::Given.new
+    end
+
+    def uiv
+      @uiv ||= TestHarness::UIView.new
+    end
+
+    def uid
+      @uid ||= TestHarness::UIDriver.new
+    end
+
+    def mm
+      @mm ||= TestHarness::MentalModel.new
+    end
+
+    def register_instance_option(scope, option_name, default_value = nil)
+      scope.send(:define_method, option_name) do |*args, &block|
+        if !args[0].nil? || block
+          instance_variable_set("@#{option_name}_registered", args[0].nil? ? block : args[0])
+        else
+          instance_variable_get("@#{option_name}_registered") || default_value || yield
+        end
+      end
+    end
+  end
+end
+

data/lib/test_helper.rb

@@ -0,0 +1,9 @@
+class TestHarness
+  module TestHelper
+    delegate :configuration, :given, :uiv, :uid, :mm, :to => TestHarness
+
+    def browser
+      configuration.browser
+    end
+  end
+end

data/lib/ui_component.rb

@@ -0,0 +1,11 @@
+class TestHarness
+  class UIComponent
+    class << self
+      def component
+        @c ||= OpenStruct.new
+        yield @c if block_given?
+        @c
+      end
+    end
+  end
+end

data/lib/ui_component_helper.rb

@@ -0,0 +1,77 @@
+class TestHarness
+  module UIComponentHelper
+    def component
+      self.class.parent.component
+    end
+
+    # If the UIComponent is sent a message it does not understand, it will
+    # forward that message on to its {#browser} but wrap the call in a block
+    # provided to the the browser's `#within` method. This provides convenient
+    # access to the browser driver's DSL, automatically scoped to this
+    # component.
+    def method_missing(name, *args, &block)
+      if respond_to?(name)
+        browser.within(component.within) do
+          browser.send(name, *args, &block)
+        end
+      else
+        super
+      end
+    end
+
+    # Since Kernel#select is defined, we have to override it specifically here.
+    def select(*args, &block)
+      browser.within(component.within) do
+        browser.select(*args, &block)
+      end
+    end
+
+    # We don't want to go through the method_missing above for visit, but go
+    # directly to the browser object
+    def visit(path)
+      path = "%s:%s%s" % [server_host, Capybara.server_port, path] if path !~ /^http/
+
+      browser.visit(path)
+    end
+
+    def show!
+      visit component_path
+    end
+
+    def component_path
+      component.path.gsub(/:\w+/) {|match| mm.subject.send(match.tr(':',''))}
+    end
+
+    def submit!
+      form_hash.each do |k,v|
+        fill_in k.to_s, :with => v
+      end
+
+      if has_css?(locator = component.submit)
+        find(:css, component.submit).click
+      else
+        click_on component.submit
+      end
+    end
+
+    def form_hash
+      form.instance_variable_get("@table")
+    end
+
+    def form
+      @form ||= OpenStruct.new
+    end
+
+    private
+    # @private
+    # (Not really private, but YARD seemingly lacks RDoc's :nodoc tag, and the
+    # semantics here don't differ from Object#respond_to?)
+    def respond_to?(name)
+      super || browser.respond_to?(name)
+    end
+
+    def server_host
+      configuration.server_host || Capybara.default_host || 'http://example.com'
+    end
+  end
+end

data/lib/ui_driver.rb

@@ -0,0 +1,7 @@
+class TestHarness
+  class UIDriver < TestHarness::UIHelper
+    register_ui_components
+  end
+end
+
+

data/lib/ui_helper.rb

@@ -0,0 +1,13 @@
+class TestHarness
+  class UIHelper
+    def self.register_ui_components
+      Dir.glob(File.expand_path('../ui/*.rb', __FILE__)).each do |file|
+        component =  File.basename(file, '.rb')
+        klass = ("TestHarness::%s::%s" % [component.camelize, self.name.split('::').last]).constantize
+        TestHarness.register_instance_option(self, component, klass.new)
+        klass.send(:include, TestHarness::UIComponentHelper)
+        klass.send(:include, TestHarness::TestHelper)
+      end
+    end
+  end
+end

data/lib/ui_view.rb

@@ -0,0 +1,7 @@
+class TestHarness
+  class UIView < TestHarness::UIHelper
+    register_ui_components
+  end
+end
+
+

data/test-harness.gemspec

@@ -5,7 +5,7 @@
 
 Gem::Specification.new do |s|
   s.name = "test-harness"
-  s.version = "0.1.0"
+  s.version = "0.2.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Maher Hawash"]
@@ -25,7 +25,16 @@ Gem::Specification.new do |s|
     "README.rdoc",
     "Rakefile",
     "VERSION",
+    "lib/configuration.rb",
+    "lib/given.rb",
+    "lib/mental_model.rb",
     "lib/test_harness.rb",
+    "lib/test_helper.rb",
+    "lib/ui_component.rb",
+    "lib/ui_component_helper.rb",
+    "lib/ui_driver.rb",
+    "lib/ui_helper.rb",
+    "lib/ui_view.rb",
     "spec/spec_helper.rb",
     "spec/test_harness_spec.rb",
     "test-harness.gemspec"

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: test-harness
 version: !ruby/object:Gem::Version 
-  hash: 27
+  hash: 23
   prerelease: 
   segments: 
   - 0
-  - 1
+  - 2
   - 0
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors: 
 - Maher Hawash
@@ -91,7 +91,16 @@ files:
 - README.rdoc
 - Rakefile
 - VERSION
+- lib/configuration.rb
+- lib/given.rb
+- lib/mental_model.rb
 - lib/test_harness.rb
+- lib/test_helper.rb
+- lib/ui_component.rb
+- lib/ui_component_helper.rb
+- lib/ui_driver.rb
+- lib/ui_helper.rb
+- lib/ui_view.rb
 - spec/spec_helper.rb
 - spec/test_harness_spec.rb
 - test-harness.gemspec