kintama 0.1.1

data/test/runners/verbose_runner_test.rb

@@ -0,0 +1,129 @@
+require 'test_helper'
+
+class VerboseRunnerTest < Test::Unit::TestCase
+  def test_should_print_out_test_names
+    c = context "given something" do
+      should "also pass" do
+        assert true
+      end
+      should "pass" do
+        assert true
+      end
+    end
+    assert_output(/^given something\n  should also pass: \.\n  should pass: \./) do
+      runner(c).run(false)
+    end
+  end
+
+  def test_should_print_out_Ps_beside_pending_test_names
+    c = context "given something" do
+      should "not be implemented"
+      should "pass" do
+        assert true
+      end
+    end
+    assert_output(/^given something\n  should not be implemented: P\n  should pass: \./) do
+      runner(c).run(false)
+    end
+  end
+
+  def test_should_nest_printed_context_and_test_names
+    c = context "given something" do
+      should "pass" do
+        assert true
+      end
+      context "and then this" do
+        should "also pass" do
+          assert true
+        end
+      end
+      context "and something else" do
+        should "pass" do
+          assert true
+        end
+      end
+    end
+    assert_output(/^given something\n  should pass: \.\n  and something else\n    should pass: \.\n  and then this\n    should also pass: \./) do
+      runner(c).run(false)
+    end
+  end
+
+  def test_should_print_out_a_summary_of_the_failing_tests_if_some_fail
+    c = context "given something" do
+      should "fail" do
+        assert 1 == 2, "1 should equal 2"
+      end
+    end
+    assert_output(/given something should fail:\n  1 should equal 2/) { runner(c).run(false) }
+  end
+
+  def test_should_print_out_a_summary_of_the_failing_tests_if_an_exception_occurs_in_a_test
+    c = context "given something" do
+      should "fail" do
+        raise "unexpected issue!"
+      end
+    end
+    assert_output(/given something should fail:\n  unexpected issue!/) { runner(c).run(false) }
+  end
+
+  def test_should_print_out_a_summary_of_the_failing_tests_if_a_nested_test_fails
+    c = context "given something" do
+      context "and something else" do
+        should "fail" do
+          assert 1 == 2, "1 should equal 2"
+        end
+      end
+    end
+    assert_output(/given something and something else should fail:\n  1 should equal 2/) { runner(c).run(false) }
+  end
+
+  def test_should_nest_verbose_output_properly_when_running_tests_from_several_contexts
+    c1 = context "given something" do
+      should "pass" do
+        assert true
+      end
+    end
+    c2 = context "given another thing" do
+      should "also pass" do
+        assert true
+      end
+    end
+    assert_output(/^given something\n  should pass: \.\n\ngiven another thing\n  should also pass: \./) do
+      runner(c1, c2).run(false)
+    end
+  end
+
+  def test_should_print_out_test_names_in_colour_if_colour_is_set
+    c = context "given something" do
+      should "be red" do
+        flunk
+      end
+      should "be green" do
+        assert true
+      end
+      should "be yellow"
+    end
+    assert_output(/^given something\n\e\[32m  should be green\e\[0m\n\e\[31m  should be red\e\[0m\n\e\[33m  should be yellow\e\[0m/) do
+      runner(c).run(colour=true)
+    end
+  end
+
+  def test_should_print_appropriate_test_names_when_given_and_it_aliases_are_used
+    c = context "In a world without hope" do
+      given "a massive gun" do
+        it "should work out well in the end" do
+          assert true
+        end
+      end
+    end
+    assert_output(/^In a world without hope\n  given a massive gun\n    it should work out well in the end: \./) do
+      runner(c).run(false)
+    end
+  end
+
+  private
+
+  def runner(*args)
+    Kintama::Runner::Verbose.new(*args)
+  end
+end

data/test/setup_test.rb

@@ -0,0 +1,107 @@
+require 'test_helper'
+
+class SetupTest < Test::Unit::TestCase
+
+  def test_should_allow_setup_to_provide_instance_variables
+    x = context "Given something" do
+      setup do
+        @name = "james"
+      end
+      should "work" do
+        assert_equal "james", @name
+      end
+    end
+    x.run
+    assert x.passed?
+  end
+
+  def test_should_run_setup_before_every_test
+    x = context "Given something" do
+      setup do
+        @name = "james"
+      end
+      should "work" do
+        @name += " is awesome"
+        assert_equal "james is awesome", @name
+      end
+      should "also work" do
+        @name += " is the best"
+        assert_equal "james is the best", @name
+      end
+    end
+    x.run
+    assert x.passed?, x.failures.join(", ")
+  end
+
+  def test_should_allow_call_all_setup_methods_when_running_tests_in_a_nested_context
+    x = context "Given something" do
+      setup do
+        @name = "james"
+      end
+      context "and another thing" do
+        setup do
+          @name += " is amazing"
+        end
+        should "work" do
+          assert_equal "james is amazing", @name
+        end
+      end
+    end
+    x.run
+    assert x.passed?
+  end
+
+  def test_should_only_run_necessary_setups_where_tests_at_different_nestings_exist
+    x = context "Given something" do
+      setup do
+        @name = "james"
+      end
+      context "and another thing" do
+        setup do
+          @name += " is amazing"
+        end
+        should "work" do
+          assert_equal "james is amazing", @name
+        end
+      end
+      should "work" do
+        assert_equal "james", @name
+      end
+    end
+    x.run
+    assert x.passed?
+  end
+
+  def test_should_run_setup_defined_on_kintama_itself_before_other_setups
+    Kintama.setup do
+      @thing = 'well then'
+    end
+    c = context "Given a context" do
+      setup do
+        assert_equal 'well then', @thing
+        @thing = 'now then'
+      end
+      should "have run the setup defined in the default behaviour" do
+        assert_equal 'now then', @thing
+      end
+    end
+    c.run
+    assert c.passed?, "@thing was not defined!"
+  end
+
+  def test_should_allow_multiple_setups_to_be_registered
+    Kintama.setup do
+      @thing = 1
+    end
+    Kintama.setup do
+      @thing += 1
+    end
+    c = context "Given multiple setups" do
+      should "run them all" do
+        assert_equal 2, @thing
+      end
+    end
+    c.run
+    assert c.passed?, "both setups didn't run - #{c.failures.inspect}"
+  end
+end

data/test/teardown_test.rb

@@ -0,0 +1,92 @@
+require 'test_helper'
+
+class TeardownTest < Test::Unit::TestCase
+
+  def test_should_run_teardown_after_the_test_finishes
+    $called = false
+    x = context "Given a teardown" do
+      teardown do
+        raise "Argh" unless @result == 123
+        $called = true
+      end
+      should "run teardown after this test" do
+        @result = 123
+      end
+    end
+    x.run
+    assert x.passed?
+    assert $called
+  end
+
+  def test_should_run_all_teardowns_in_proximity_of_nesting_order_after_a_nested_test_finishes
+    $called = false
+    x = context "Given a teardown" do
+      teardown do
+        raise "Argh" unless @result == 123
+        $called = true
+      end
+      context "with a subcontext with another teardown" do
+        teardown do
+          raise "Oh no" unless @result == 456
+          @result = 123
+        end
+        should "run teardown after this test" do
+          @result = 456
+        end
+      end
+    end
+    x.run
+    assert x.passed?
+    assert $called
+  end
+
+  def test_should_run_teardown_defined_on_kintama_itself_after_other_teardowns
+    ran = false
+    Kintama.teardown do
+      ran = true
+      assert_equal 'blah', @thing
+    end
+    c = context "Given a context" do
+      should "have run the setup defined in the default behaviour" do
+        # nothing
+      end
+      teardown do
+        @thing = 'blah'
+      end
+    end
+    c.run
+    assert c.passed?, "@thing was not redefined!"
+    assert ran
+  end
+
+  def test_should_allow_multiple_teardowns_to_be_registered
+    Kintama.teardown do
+      $ran = 1
+    end
+    Kintama.teardown do
+      $ran += 1
+    end
+    c = context "Given multiple setups" do
+      should "run them all" do
+        assert true
+      end
+    end
+    c.run
+    assert_equal 2, $ran, "both teardowns didn't run"
+  end
+
+  def test_should_run_teardowns_even_after_exceptions
+    ran = false
+    c = context "Given a test that fails" do
+      should "still run teardown" do
+        raise "argh"
+      end
+      teardown do
+        ran = true
+      end
+    end
+    c.run
+    assert !c.passed?
+    assert ran
+  end
+end

data/test/test_and_subcontext_access_test.rb

@@ -0,0 +1,110 @@
+require 'test_helper'
+
+class TestAndSubcontextAccessTest < Test::Unit::TestCase
+
+  def test_should_stash_all_defined_contexts_so_they_can_be_accessed_later
+    c1 = context "Given some context" do
+      should "stash this" do
+      end
+    end
+    c2 = context "Given some other context" do
+      should "also stash this" do
+      end
+    end
+    assert_equal [c1, c2], Kintama.default_context.subcontexts
+  end
+
+  def test_should_allow_running_of_specific_subcontexts
+    x = context "Given something" do
+      should "not be run" do
+        flunk
+      end
+      context "and another thing" do
+        should "pass" do
+          assert true
+        end
+      end
+    end
+    inner_context = x.and_another_thing
+    inner_context.run
+    assert inner_context.passed?
+  end
+
+  def test_should_allow_running_of_specific_tests
+    x = context "Given something" do
+      should "fail when run" do
+        flunk
+      end
+    end
+    t = x.should_fail_when_run.new
+    t.run
+    assert !t.passed?
+  end
+
+  def test_should_allow_running_of_specific_subcontexts_using_hashlike_syntax
+    x = context "Given something" do
+      should "not be run" do
+        flunk
+      end
+      context "and another thing" do
+        should "pass" do
+          assert true
+        end
+      end
+    end
+    inner_context = x["and another thing"]
+    inner_context.run
+    assert inner_context.passed?
+  end
+
+  def test_should_allow_running_of_specific_tests_using_hashlike_syntax
+    x = context "Given something" do
+      should "fail when run" do
+        flunk
+      end
+    end
+    t = x["should fail when run"].new
+    t.run
+    assert !t.passed?
+  end
+
+  def test_should_return_true_if_running_a_subcontext_passes
+    x = context "Given something" do
+      context "and another thing" do
+        should "pass" do
+          assert true
+        end
+      end
+    end
+    assert_equal true, x.and_another_thing.run
+  end
+
+  def test_should_return_true_if_running_a_test_passes
+    x = context "Given something" do
+      should "pass when run" do
+        assert true
+      end
+    end
+    assert_equal true, x.should_pass_when_run.run
+  end
+
+  def test_should_return_false_if_running_a_subcontext_fails
+    x = context "Given something" do
+      context "and another thing" do
+        should "fail" do
+          flunk
+        end
+      end
+    end
+    assert_equal false, x.and_another_thing.run
+  end
+
+  def test_should_return_false_if_running_a_test_fails
+    x = context "Given something" do
+      should "fail when run" do
+        flunk
+      end
+    end
+    assert_equal false, x.should_fail_when_run.run
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,36 @@
+$LOAD_PATH.unshift File.expand_path("../../lib", __FILE__)
+require 'test/unit'
+
+ENV["KINTAMA_EXPLICITLY_DONT_RUN"] = "true"
+require 'kintama'
+
+require 'stringio'
+
+class Test::Unit::TestCase
+  def setup
+    Kintama.reset
+  end
+
+  private
+
+  module ::Kernel
+    def capture_stdout
+      out = StringIO.new
+      $stdout = out
+      yield
+      out.rewind
+      return out
+    ensure
+      $stdout = STDOUT
+    end
+  end
+
+  def assert_output(expected, &block)
+    output = capture_stdout(&block).read
+    if expected.is_a?(Regexp)
+      assert_match expected, output
+    else
+      assert_equal expected, output
+    end
+  end
+end