test-harness 0.4.7 → 0.4.9

data/.watchr

@@ -0,0 +1,94 @@
+if __FILE__ == $0
+  puts "Run with: watchr #{__FILE__}. \n\nRequired gems: watchr rev"
+  exit 1
+end
+
+# --------------------------------------------------
+# Convenience Methods
+# --------------------------------------------------
+def run(cmd)
+  sleep(2)
+  puts("%s %s [%s]" % ["|\n" * 5 , cmd , Time.now.to_s])
+  $last_test = cmd
+  system(cmd)
+end
+
+def run_all_specs
+  run "bundle exec rake -s spec SPEC_OPTS='--order rand'"
+end
+
+def run_last_test
+  run($last_test)
+end
+
+def run_single_spec *spec
+  spec = spec.join(' ')
+  run "bundle exec rspec  #{spec} --order rand"
+end
+
+def run_specs_with_shared_examples(shared_example_filename, spec_path = 'spec')
+
+  # Returns the names of the shared examples in filename
+  def shared_examples(filename)
+    lines = File.readlines(filename)
+    lines.grep(/shared_examples_for[\s'"]+(.+)['"]\s*[do|\{]/) do |matching_line|
+      $1
+    end
+  end
+
+  # Returns array with filenames of the specs using shared_example
+  def specs_with_shared_example(shared_example, path)
+    command = "grep -lrE 'it_should_behave_like .(#{shared_example}).' #{path}"
+    `#{command}`.split
+  end
+
+  shared_examples(shared_example_filename).each do |shared_example|
+    specs_to_run = specs_with_shared_example(shared_example, spec_path)
+    run_single_spec(specs_to_run) unless specs_to_run.empty?
+  end
+
+end
+
+def run_cucumber_scenario scenario_path
+  if scenario_path !~ /.*\.feature$/
+    scenario_path = $last_scenario
+  end
+  $last_scenario = scenario_path
+  run "bundle exec cucumber #{scenario_path} --tags @dev"
+end
+
+# --------------------------------------------------
+# Watchr Rules
+# --------------------------------------------------
+watch( '^spec/spec_helper\.rb'                    ) {     run_all_specs }
+watch( '^spec/shared_behaviors/.*\.rb'            ) { |m| run_specs_with_shared_examples(m[0]) }
+watch( '^spec/.*_spec\.rb'                        ) { |m| run_single_spec(m[0]) }
+watch( '^app/lib/.*'                        ) { |m| run_last_test }
+watch( '^spec/factories.*'                        ) { |m| run_last_test }
+watch( '^test_harness/.*'                        ) { |m| run_last_test }
+watch( '^app/(.*)\.rb'                            ) { |m| run_single_spec("spec/%s_spec.rb" % m[1]) }
+watch( '^app/views/(.*)\.haml'                    ) { |m| run_single_spec("spec/views/%s.haml_spec.rb" % m[1]) }
+watch( '^lib/(.*)\.rb'                            ) { |m| run_single_spec("spec/other/%s_spec.rb" % m[1] ) }
+watch( '^features/*/.*'                           ) { |m| run_cucumber_scenario(m[0]) }
+watch( '^test_harness/*/.*'                       ) { |m| run_cucumber_scenario(m[0]) }
+
+
+# --------------------------------------------------
+# Signal Handling
+# --------------------------------------------------
+# Ctrl-\
+Signal.trap('QUIT') do
+  puts " --- Running all tests ---\n\n"
+  run_all_specs
+end
+
+# Ctrl-T
+Signal.trap('TSTP') do
+  puts " --- Running last test --\n\n"
+  run_cucumber_scenario nil
+end
+
+# Ctrl-C
+Signal.trap('INT') { abort("\n") }
+
+puts "Watching.." 

data/README.markdown

@@ -13,7 +13,7 @@ Or add to your Gemfile:
     end
 
 ## Structure
-    Rails.root/
+    /
       test_harness/
          /given
          /ui
@@ -157,13 +157,17 @@ In the **feature/support/setup_test_harness.rb**
     require 'test_harness'
     require 'spec/factories'  # if you use factories
 
-** autoload_path**: Allows you to set the path where test_harness files are found.  Putting them in the
+**autoload_path**: Allows you to set the path where test_harness files are found.  Putting them in the
 Rails.root/app folder proves problematic as they get autoloaded in production.  However, depending on how
-you setup you Gemfile, the test-harness gem might be excluded, and the server will fail to load.
+you setup you Gemfile, the test-harness gem might be excluded, and the server will fail to load.  Defaults to 'test_harness'.
+
+**namespace**: Sets the class namespace for your test_harness files.  Specify
+this as a string, not a constant.  Defaults to 'TestHarness'.
 
     TestHarness.configure do |c|
       c.browser = Capybara
       c.autoload_path = Rails.root.join('test_harness')
+      c.namespace = 'MyHarness'
     end
 
     World(TestHarness::TestHelper)

data/VERSION

@@ -1 +1 @@
-0.4.7
+0.4.9

data/lib/configuration.rb

@@ -1,11 +1,11 @@
 class TestHarness
   class Configuration
-    attr_accessor :browser, :server_host, :autoload_path
+    attr_accessor :browser, :server_host, :autoload_path, :namespace
 
     def setup_cucumber_hooks(scope)
-        scope.Before do
-          TestHarness.reset
-        end
+      scope.Before do
+        TestHarness.reset
+      end
     end
   end
 end

data/lib/given.rb

@@ -1,13 +1,20 @@
 require 'test_helper'
 class TestHarness
   class Given
-    include TestHarness::TestHelper
+    def mm
+      TestHarness.mm
+    end
 
-    Dir.glob(Rails.root.join(TestHarness.autoload_path, 'given/*.rb')).each do |file|
-      component =  File.basename(file, '.rb')
-      require Rails.root.join(TestHarness.autoload_path, 'given', component)
-      klass = ("TestHarness::Given::%s" % File.basename(file, '.rb').camelize).constantize
-      include klass
+    def self.autoload
+      Dir.glob(File.join(TestHarness.autoload_path, 'given/*.rb')).each do |file|
+        component =  File.basename(file, '.rb')
+        require File.join(TestHarness.autoload_path, 'given', component)
+        klass = TestHarness::Utilities.constantize("%s::Given::%s" % [
+          TestHarness.namespace,
+          TestHarness::Utilities.camelize(File.basename(file, '.rb'))
+        ])
+        include klass
+      end
     end
   end
 end

data/lib/mental_model.rb

@@ -1,3 +1,5 @@
+require 'ostruct'
+
 class TestHarness
   class MentalModel < OpenStruct
 

data/lib/test_harness.rb

@@ -1,9 +1,16 @@
 require 'configuration'
+require 'utilities'
 
 class TestHarness
   class << self
     def configuration
-      @configuation ||= Configuration.new
+      @configuration ||= Configuration.new
+    end
+
+    def autoload
+      TestHarness::Given.autoload
+      TestHarness::UIView.autoload
+      TestHarness::UIDriver.autoload
     end
 
     def configure(&block)
@@ -35,18 +42,19 @@ class TestHarness
       @path ||= configuration.autoload_path || 'test_harness'
     end
 
+    def namespace
+      @namespace ||= configuration.namespace || 'TestHarness'
+    end
+
     def registered_components
       @components ||= []
     end
 
-    def register_instance_option(scope, option_name, default_value = nil)
-      registered_components << default_value
-      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
+    def register_instance_option(scope, option_name, instance)
+      return if registered_components.any? { |c| c.is_a? instance.class }
+      registered_components << instance
+      scope.send(:define_method, option_name) do
+        instance
       end
     end
   end

data/lib/test_helper.rb

@@ -1,6 +1,12 @@
 class TestHarness
   module TestHelper
-    delegate :configuration, :given, :uiv, :uid, :mm, :to => TestHarness
+    def method_missing(method, *args)
+      if [:configuration, :given, :uiv, :uid, :mm, :to].include?(method)
+        TestHarness.send(method)
+      else
+        super
+      end
+    end
 
     def browser
       configuration.browser

data/lib/ui_component_helper.rb

@@ -1,5 +1,11 @@
+class MissingConfiguration < Exception; end
+
 class TestHarness
   module UIComponentHelper
+    def mm
+      TestHarness.mm
+    end
+
     def component
       self.class.parent.component
     end
@@ -8,6 +14,17 @@ class TestHarness
       @form = nil
     end
 
+    def configuration
+      TestHarness.configuration
+    end
+
+    def browser
+      @browser ||= begin
+        raise MissingConfiguration.new('TestHarness.browser must be defined') if configuration.browser.nil?
+        configuration.browser
+       end
+    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

data/lib/ui_driver.rb

@@ -1,6 +1,5 @@
 class TestHarness
   class UIDriver < TestHarness::UIHelper
-    register_ui_components
   end
 end
 

data/lib/ui_helper.rb

@@ -1,14 +1,17 @@
 class TestHarness
   class UIHelper
-    def self.register_ui_components
-      Dir.glob(Rails.root.join(TestHarness.autoload_path, 'ui/*.rb')).each do |file|
+    def self.autoload
+      Dir.glob(File.join(TestHarness.autoload_path, 'ui/*.rb')).each do |file|
         component =  File.basename(file, '.rb')
-        require Rails.root.join(TestHarness.autoload_path, 'ui', component)
-        klass = ("TestHarness::%s::%s" % [component.camelize, self.name.split('::').last]).constantize
+        require File.join(TestHarness.autoload_path, 'ui', component)
+        klass = TestHarness::Utilities.constantize("%s::%s::%s" % [
+          TestHarness.namespace,
+          TestHarness::Utilities.camelize(component),
+          self.name.split('::').last
+        ])
         TestHarness.register_instance_option(self, component, klass.new)
         klass.send(:include, TestHarness::UIComponentHelper)
-        klass.send(:include, TestHarness::TestHelper)
       end
     end
   end
-end
+end

data/lib/ui_view.rb

@@ -1,6 +1,5 @@
 class TestHarness
   class UIView < TestHarness::UIHelper
-    register_ui_components
   end
 end
 

data/lib/utilities.rb

@@ -0,0 +1,21 @@
+class TestHarness
+  module Utilities
+    module_function
+
+    def camelize(string)
+      string = string.sub(/^[a-z\d]*/) { $&.capitalize }
+      string = string.gsub(/(?:_|(\/))([a-z\d]*)/) { "#{$1}#{$2.capitalize}" }.gsub('/', '::')
+    end
+
+    def constantize(camel_cased_word)
+      names = camel_cased_word.split('::')
+      names.shift if names.empty? || names.first.empty?
+
+      constant = Object
+      names.each do |name|
+        constant = constant.const_defined?(name) ? constant.const_get(name) : constant.const_missing(name)
+      end
+      constant
+    end
+  end
+end

data/spec/fake_harness/given/given_test.rb

@@ -0,0 +1,9 @@
+class FakeHarness
+  class Given
+    module GivenTest
+      def a_boring_test
+        :a_fancy_and_inspiring_result
+      end
+    end
+  end
+end

data/spec/fake_harness/ui/ui_test.rb

@@ -0,0 +1,15 @@
+class FakeHarness
+  class UiTest < TestHarness::UIComponent
+    class UIView
+      def lookies
+        :lovely_landscapes
+      end
+    end
+
+    class UIDriver
+      def dainty_gloves
+        :handy_holders
+      end
+    end
+  end
+end

data/spec/lib/given_spec.rb

@@ -0,0 +1,10 @@
+require 'spec_helper'
+
+describe TestHarness::Given do
+  describe "#mm" do
+    it "delegates to TestHarness" do
+      TestHarness.should_receive(:mm).and_return('no_rainforests_in_iowa')
+      TestHarness::Given.new.mm.should == 'no_rainforests_in_iowa'
+    end
+  end
+end

data/spec/lib/test_harness_spec.rb

@@ -0,0 +1,22 @@
+require 'spec_helper'
+
+describe TestHarness do
+  describe ".autoload" do
+    it "delegates autoload to all three concerns" do
+      TestHarness::UIView.should_receive(:autoload)
+      TestHarness::UIDriver.should_receive(:autoload)
+      TestHarness::Given.should_receive(:autoload)
+
+      TestHarness.autoload
+    end
+
+    it "actually loads all givens and registers all UI components" do
+      TestHarness.autoload
+
+      defined?(FakeHarness::Given::GivenTest).should be_true
+      [FakeHarness::UiTest::UIView, FakeHarness::UiTest::UIDriver].each do |kl|
+        TestHarness.registered_components.map(&:class).should include(kl)
+      end
+    end
+  end
+end

data/spec/lib/test_helper_spec.rb

@@ -0,0 +1,22 @@
+require 'spec_helper'
+
+class TestHelperWrapper
+  extend TestHarness::TestHelper
+end
+
+describe TestHarness::TestHelper do
+  [:configuration, :given, :uiv, :uid, :mm, :to].each do |method|
+    it "delegates #{method} to TestHarness" do
+      TestHarness.should_receive(method).and_return('sleepy_monkeys')
+      TestHelperWrapper.send(method).should == 'sleepy_monkeys'
+    end
+  end
+
+  it "adds methods to access given & ui components" do
+    TestHarness.autoload
+    TestHelperWrapper.given.a_boring_test.should ==
+      :a_fancy_and_inspiring_result
+    TestHelperWrapper.uiv.ui_test.lookies.should == :lovely_landscapes
+    TestHelperWrapper.uid.ui_test.dainty_gloves.should == :handy_holders
+  end
+end

data/spec/lib/ui_component_helper_spec.rb

@@ -0,0 +1,16 @@
+require 'spec_helper'
+
+describe "UIComponentHelper" do
+  describe "#browser" do
+    it "raises error for missing browser" do
+      TestHarness.autoload
+      expect {FakeHarness::UiTest::UIView.new.browser}.to raise_error(MissingConfiguration, 'TestHarness.browser must be defined')
+    end
+
+    it 'returns browser defined in TestHarness.configuration' do
+      TestHarness.configuration.browser = :whatever
+      TestHarness.autoload
+      FakeHarness::UiTest::UIView.new.browser.should == :whatever
+    end
+  end
+end

data/spec/lib/utilities_spec.rb

@@ -0,0 +1,18 @@
+require 'spec_helper'
+require 'utilities'
+
+describe TestHarness::Utilities do
+  describe ".camelize" do
+    it "camelizes underscored word" do
+      TestHarness::Utilities.camelize('furby_catchment_vice').should ==
+        'FurbyCatchmentVice'
+    end
+  end
+
+  describe ".constantize" do
+    it "constantizes camel-cased word" do
+      TestHarness::Utilities.constantize('TestHarness::Utilities').should ==
+        TestHarness::Utilities
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -7,6 +7,11 @@ require 'test_harness'
 # in ./support/ and its subdirectories.
 Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each {|f| require f}
 
+TestHarness.configure do |c|
+  c.namespace = 'FakeHarness'
+  c.autoload_path = File.expand_path('../fake_harness', __FILE__)
+end
+
 RSpec.configure do |config|
   
 end

data/test-harness.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = "test-harness"
-  s.version = "0.4.7"
+  s.version = "0.4.9"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Maher Hawash"]
-  s.date = "2012-10-17"
+  s.date = "2013-01-19"
   s.description = "A test harness for rspec and cucumber which allows for separating responsibility between setting up the context and interacting with the browser, and cleaning up the step definition files."
   s.email = "gmhawash@gmail.com"
   s.extra_rdoc_files = [
@@ -19,6 +19,7 @@ Gem::Specification.new do |s|
   s.files = [
     ".document",
     ".rspec",
+    ".watchr",
     "Gemfile",
     "Gemfile.lock",
     "LICENSE.txt",
@@ -35,8 +36,15 @@ Gem::Specification.new do |s|
     "lib/ui_driver.rb",
     "lib/ui_helper.rb",
     "lib/ui_view.rb",
+    "lib/utilities.rb",
+    "spec/fake_harness/given/given_test.rb",
+    "spec/fake_harness/ui/ui_test.rb",
+    "spec/lib/given_spec.rb",
+    "spec/lib/test_harness_spec.rb",
+    "spec/lib/test_helper_spec.rb",
+    "spec/lib/ui_component_helper_spec.rb",
+    "spec/lib/utilities_spec.rb",
     "spec/spec_helper.rb",
-    "spec/test_harness_spec.rb",
     "test-harness.gemspec"
   ]
   s.homepage = "http://github.com/gmhawash/test_harness"

metadata

@@ -1,104 +1,109 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: test-harness
-version: !ruby/object:Gem::Version 
-  hash: 1
+version: !ruby/object:Gem::Version
+  version: 0.4.9
   prerelease: 
-  segments: 
-  - 0
-  - 4
-  - 7
-  version: 0.4.7
 platform: ruby
-authors: 
+authors:
 - Maher Hawash
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2012-10-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"
-  prerelease: false
-  type: :development
+date: 2013-01-19 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
   name: rspec
-  requirement: *id001
-- !ruby/object:Gem::Dependency 
-  version_requirements: &id002 !ruby/object:Gem::Requirement 
+  requirement: !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        hash: 3
-        segments: 
-        - 0
-        version: "0"
-  prerelease: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
   type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
   name: rdoc
-  requirement: *id002
-- !ruby/object:Gem::Dependency 
-  version_requirements: &id003 !ruby/object:Gem::Requirement 
+  requirement: !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        hash: 3
-        segments: 
-        - 0
-        version: "0"
-  prerelease: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
   type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
   name: bundler
-  requirement: *id003
-- !ruby/object:Gem::Dependency 
-  version_requirements: &id004 !ruby/object:Gem::Requirement 
+  requirement: !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        hash: 3
-        segments: 
-        - 0
-        version: "0"
-  prerelease: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
   type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
   name: jeweler
-  requirement: *id004
-- !ruby/object:Gem::Dependency 
-  version_requirements: &id005 !ruby/object:Gem::Requirement 
+  requirement: !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        hash: 3
-        segments: 
-        - 0
-        version: "0"
-  prerelease: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
   type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
   name: gemcutter
-  requirement: *id005
-description: A test harness for rspec and cucumber which allows for separating responsibility between setting up the context and interacting with the browser, and cleaning up the step definition files.
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: A test harness for rspec and cucumber which allows for separating responsibility
+  between setting up the context and interacting with the browser, and cleaning up
+  the step definition files.
 email: gmhawash@gmail.com
 executables: []
-
 extensions: []
-
-extra_rdoc_files: 
+extra_rdoc_files:
 - LICENSE.txt
 - README.markdown
-files: 
+files:
 - .document
 - .rspec
+- .watchr
 - Gemfile
 - Gemfile.lock
 - LICENSE.txt
@@ -115,41 +120,42 @@ files:
 - lib/ui_driver.rb
 - lib/ui_helper.rb
 - lib/ui_view.rb
+- lib/utilities.rb
+- spec/fake_harness/given/given_test.rb
+- spec/fake_harness/ui/ui_test.rb
+- spec/lib/given_spec.rb
+- spec/lib/test_harness_spec.rb
+- spec/lib/test_helper_spec.rb
+- spec/lib/ui_component_helper_spec.rb
+- spec/lib/utilities_spec.rb
 - spec/spec_helper.rb
-- spec/test_harness_spec.rb
 - test-harness.gemspec
 homepage: http://github.com/gmhawash/test_harness
-licenses: 
+licenses:
 - MIT
 post_install_message: 
 rdoc_options: []
-
-require_paths: 
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
+required_ruby_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      hash: 3
-      segments: 
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
       - 0
-      version: "0"
-required_rubygems_version: !ruby/object:Gem::Requirement 
+      hash: -1093059498372964529
+required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      hash: 3
-      segments: 
-      - 0
-      version: "0"
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
 requirements: []
-
 rubyforge_project: 
 rubygems_version: 1.8.24
 signing_key: 
 specification_version: 3
 summary: Mini test harness for rspec and cucumber
 test_files: []
-

data/spec/test_harness_spec.rb

@@ -1,7 +0,0 @@
-require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
-
-describe "TestHarness" do
-  it "fails" do
-    fail "hey buddy, you should probably rename this file and start specing for real"
-  end
-end